$ cat ~/map/vagus-pi-web.md

vagusPI

Web GUI sharing the pi CLI's ~/.pi/agent config — chat, sessions, models, and packages from your browser.

tools✓ Sep 2

pi install npm:@versot/vaguspi

## TL;DR

A web GUI that reads and writes the same ~/.pi/agent configuration as the pi CLI — chat with visible thinking and tool-call cards, resumable session history, provider and model management, built-in MCP, and token/cost usage stats.

## Key points

• $Shares the CLI's ~/.pi/agent configuration — models, sessions, packages, and settings — so browser and terminal stay in sync and data stays on your machine.
• $Chat streams responses with visible thinking, tool-call cards, and multi-turn conversations; session history uses the real pi session files and can be resumed from either side, with long conversations lazy-loading as you scroll.
• $Model management configures providers (API type, base URL, key, model list, reasoning level) with live credential checks.
• $MCP servers work per-session without a separate adapter package; the / palette lists pi commands, extension commands, skills, and templates.
• $Usage stats roll up tokens and cost across all sessions.

## FAQ

## References

• README ↗

Last updated: Sep 2, 2026