$ cat ~/map/pi-studio.md
Pi Studio
Local web UI for pi: project folders, searchable history, streaming replies, and live token and cost meters.
tools✓ Sep 11
Facts
- repository
- github.com/niuyizh/pi-studio ↗
- GitHub Stars
- ★ 2
- Forks
- 0
- license
- MIT
- npm / mo
- —
- last push
- Sep 10, 2026
install
git clone https://github.com/niuyizh/pi-studio.git && cd pi-studio && node server.mjs## TL;DR
A local web interface for pi: projects as folders with sessions underneath, history read from pi's sessions directory, streaming replies with collapsible thinking, cross-session search, and live token and cost readouts.
## Key points
- $Projects map to folders on disk with tasks (sessions) grouped underneath; history is read from pi's own sessions directory, so past conversations continue where they left off.
- $The chat surface streams output, folds thinking, renders tool calls as expandable cards showing inputs and outputs, and renders Markdown with tables and copyable code blocks; images can be pasted into the prompt.
- $Ctrl+Shift+F searches all historical conversations and jumps to the matching message; Ctrl+F searches the current conversation, and Ctrl+K opens the command palette.
- $Six color themes in light and dark, a resizable sidebar, thinking-depth switching within the current model's supported range, and a top-bar token total with estimated cost.
- $Runs via node server.mjs and serves the UI on local port 4317, scanning up to 4336 when busy; requires Node.js 18+ and a globally installed pi.
- $Windows helpers start the server in the background (start-hidden.vbs), in the foreground with logs (start-debug.bat), or stop it (stop.bat).
## FAQ
Q Is there an online demo?
Yes — a static demo shows the complete interface with preset data and never calls a model; it is linked from the repository.
Q Where does my data live?
Project and task metadata and logs live under the repository's data directory, project working directories default to the ~/PiWorkspace folder (an existing folder can be picked instead), and pi's session files stay in ~/.pi/agent/sessions managed by pi itself.
## References
## Related entries
$ Pi Chat
Minimal local browser chat for pi: streaming replies, persistent sessions, and in-pi launching via /pi-chat-start.
$ pi-remote
Phone remote control for pi: one Python process wraps pi --mode rpc — self-hosted, relay-free, built for native Windows.
$ vagusPI
Web GUI sharing the pi CLI's ~/.pi/agent config — chat, sessions, models, and packages from your browser.
## Guides
Last updated: Sep 11, 2026