Pi GPUI
Pi GPUI is a native desktop GUI for the pi coding agent on macOS and Linux. It runs your installed pi and brings projects, sessions, tool calls, and answers into one window.
Visit bytesbay/pi-gpuiOverview
Pi GPUI is a native desktop app for the pi coding agent on macOS and Linux. It is written in Rust with GPUI and drawn with Metal on macOS and Vulkan on Linux, without Electron or a webview. Each session starts your installed pi over RPC with the same models, extensions, skills, and sessions you use in the terminal.
Key Features
- Projects and pi sessions in a sidebar, with open sessions in tabs; each open session runs its own pi.
- Session tree with keyboard navigation, branch summaries, and forking from any message.
- Slash commands include extension commands, prompt templates, skills, and built-ins such as /compact, /model, /name, /copy, and /export.
- Paste or drop files and images into the message field; they appear as chips and are sent as paths.
- A context ring shows context usage, compaction timing, cache metrics, plan limits, and token totals.
- Extension questions appear inline as cards and can be answered by click, number, arrow keys, or typing.
Use Cases
- Working across several pi projects and sessions in one window while sessions keep running.
- Trying a different direction from any message by forking without touching the original session.
- Using pi's installed models, extensions, skills, and prompt templates through a native desktop interface.
- Running plugins that add buttons, tools, or live views inside tool calls.
Getting Started
- Install pi 1.4 or newer if it is not already installed, then log in to connect a subscription or API key.
- On macOS, install with brew install --cask bytesbay/tap/pi-gpui or use the release zip.
- On Linux, use the provided install script; it needs no root and places the app under ~/.local.
- Open Pi GPUI; it finds pi on its own and lists your projects and sessions.
Deployment & Requirements
- Requires pi 1.4 or newer within pi 1.x installed on the machine.
- macOS 13 or newer on Apple silicon.
- Linux on x86_64 and arm64, on X11 and Wayland, with glibc 2.35 or newer and a Vulkan driver.
- The app finds pi in PI_EXECUTABLE, PATH, or your login shell.
- Windows is not supported.
Before You Adopt
- License: MIT. Review its terms before using, modifying, or distributing the project.
- Pi GPUI requires a separately installed pi 1.4 or newer within pi 1.x.
- The app does not install or update pi itself.
- Linux support is beta and has limited reported testing.
- Some extension UI surfaces are not displayed yet.
- A pi session already running in a terminal is not detected by the app.