A native desktop for
AI coding agents

pi-gui is a Codex-style macOS desktop app for the pi coding agent. Manage workspaces, run sessions, and review agent work — all from a native interface.

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 @mariozechner/pi-coding-agent.

Electron 34React 19TypeScriptVitepi-coding-agent
RendererReact UI · Session views · Composer
PreloadSecure IPC bridge
MainSessionDriver · Catalogs · Persistence
Runtimepi-coding-agent · Model providers

Get started

Up and running in minutes

# Clone the repo git clone https://github.com/minghinmatthewlam/pi-gui.git cd pi-gui # Install dependencies and run pnpm install pnpm dev
View on GitHub