pi-app

Desktop app for the pi coding agent: streaming timeline, Git review with hunk staging, session tree, native UI for pi extensions. Windows · macOS · Linux. pi 编

What is pi-app?

Desktop app for the pi coding agent: streaming timeline, Git review with hunk staging, session tree, native UI for pi extensions. Windows · macOS · Linux. pi 编程 Agent 桌面客户端

Overview of pi-app

What it is

pi Desktop is a desktop application for the pi coding agent. It runs the pi SDK in a background worker and reads the same files as the CLI — sessions, model logins, settings.json, installed extensions. The app provides a streaming timeline, Git review with hunk staging, a session tree, and native UI for pi extensions. It is available for Windows, macOS, and Linux, and includes an Android companion app called pi Remote.

Key features

  • Timeline: Tool calls stream in as flat steps and fold into a summary line. Each edit shows +N −M; the turn ends with a Files changed card that opens the file in Files or Review.
  • Review: Pick a scope (this turn, this session, or the whole Git working tree) and expand a file for its diff. Hunks can be staged or unstaged one at a time; line comments go back into the conversation.
  • Composer: @ searches project files (respects .gitignore, uses fd) and inserts them as references. / lists pi's built-in commands and extension commands. Paste or drop images and files. While the agent works, Enter steers the current turn and Alt+Enter queues a follow-up.
  • Parallel sessions: Each session runs in its own worker. Start multiple turns; the sidebar marks working sessions and the status bar counts them. Settings → General sets worker limits and idle reclamation.
  • Built-in terminal: Ctrl+` opens a terminal in the current project. It starts the same shell pi uses (Git Bash on Windows) with pi's tools on PATH. Multiple shells, tabs, and up to four side-by-side panes are supported.
  • pi Remote (Android): Connects to the desktop app via QR code. Sessions are mirrored on the phone; you can read along, answer questions, send prompts with images, review changes, and switch branches. Connection is end-to-end encrypted and stays on your network.

Use cases

  • Continue terminal pi sessions from the desktop app; sessions started in the terminal appear in the sidebar.
  • Review Git changes with hunk staging and line comments during a coding session.
  • Use the pi agent on the go with the Android companion app, including reading turn output and sending prompts.
  • Manage multiple parallel agent sessions simultaneously, each in its own worker.

Getting started

Installers are available from the GitHub Releases page. To build from source, ensure Node.js ≥ 22.19 and run: bash git clone https://github.com/justhil/pi-app.git cd pi-app npm install npm run dev # development npm run build # production bundle in out/ npm run package # installers via electron-builder For first-time usage, open a folder, pick a session, and send a message. See the repository README for detailed instructions.

License and pricing

The project is open source under the MIT license. No pricing information is stated.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/justhilpi-app.svg)](https://yunodb.com/tools/justhilpi-app?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/justhilpi-app?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/justhilpi-app.svg" alt="Featured on YunoDB" height="20"></a>