Pi Desktop

Desktop control surface for Pi app-server v2.

This project uses a modified fork of Pi with additional app-server features not yet in the upstream release.

demo.mp4

Features

• Workspace management — add and switch between local workspaces
• Thread control — list, resume, rename, archive, pin, and search threads
• Agent chat — send prompts, stream responses with markdown rendering, collapse tool results
• Model selection — switch between providers and models with a custom dropdown
• Approval handling — respond to structured tool approvals inline
• Activity panel — view tool calls, diffs, git status, and worktrees
• Git integration — stage, unstage, commit files, create and open worktrees
• Terminal — run workspace shell commands from the bottom dock
• File browser — preview project files in a read-only editor surface
• Responsive layout — collapsible panels, resizable sidebars, adaptive to window size

Requirements

• Node.js >= 22.19.0
• A Pi build with pi app-server support (see Ray0907/pi)

Development

npm install
npm run dev

Override the Pi command to use a local build:

PI_DESKTOP_PI_COMMAND="/path/to/pi app-server" npm run dev

Or set it persistently in the app's Settings panel.

Build

npm run build
npm run typecheck