A native desktop for
AI coding agents
pi-gui is a Codex-style macOS and Linux desktop app for the pi coding agent. Manage workspaces, run sessions, and review agent work — all from a native interface.
Beta for macOS arm64 and Linux AppImage. Install from GitHub Releases on either platform, or Homebrew on macOS.
From quick fixes to complex refactors, pi-gui gives you a persistent desktop workspace for AI-powered coding sessions — with full visibility into what the agent is doing and why.
Features
Everything you need in one window
A desktop-native experience built for multi-project AI coding workflows.
Multi-workspace sessions
Open project folders as workspaces, each with independent session histories. Context-switch between projects without losing state.
Real-time agent timeline
Watch every tool execution, code change, and reasoning step in a scrollable timeline with full input and output detail.
Persistent session history
Sessions survive restarts. Resume any previous conversation, review transcripts, and continue exactly where you left off.
Skills & slash commands
Extend pi-gui with workspace-specific skills and slash commands for model switching, thinking levels, settings, and custom workflows.
Architecture
Built for durability
The desktop shell is separated from the agent runtime through a durable SessionDriver interface — making the frontend independent of backend changes and ready for future runtime swaps. Built on top of @earendil-works/pi-coding-agent.
Get started
Install the beta your way
# Direct install from GitHub Releases
open https://github.com/minghinmatthewlam/pi-gui/releases/latest
# Or install with Homebrew
brew tap minghinmatthewlam/tap
brew install --cask pi-gui
# Later, update the Homebrew install
brew upgrade --cask pi-gui
# Source install is for local development
git clone https://github.com/minghinmatthewlam/pi-gui.git
cd pi-gui
# Install dependencies and run
pnpm install
pnpm devDMG installs update from GitHub Releases. Homebrew installs update with brew upgrade --cask pi-gui. During beta, Homebrew upgrades may require re-confirming some macOS permissions or Dock placement after reinstall-style updates.