Open Source Alpha

A desktop GUI for the
Pi and oh-my-pi coding agents

Chat, review changes, browse files, and run commands in one window. Works with the standard Pi CLI or oh-my-pi. Free and open source.

↓ Download for Linux View on GitHub
Pi Desktop — Home launcher with activity stats and recent work Pi Desktop — chat view with the composer and sidebar Pi Desktop — chat with the file tree open Pi Desktop — Review rail with permissions and changed files Pi Desktop — diff viewer with Commit, Push, and PR actions above the terminal Pi Desktop — packages and skills browser Pi Desktop — New Task launcher with the isolated worktree option Pi Desktop — notes Pi Desktop — settings with the agent installation picker

What's inside

Everything you need in one window

Streaming chat

Real-time streaming with thinking blocks and tool-use visibility. Rich rendering: inline SVG preview, clickable file links, color emoji. Consecutive tool calls fold into collapsible groups; file reads show as line-numbered, highlighted code and edits as diffs. Find within a conversation with Ctrl/Cmd+F, mention workspace files with @, and recall earlier prompts with the arrow keys.

Multiple workspaces

Every live session runs its own agent process, so a turn keeps going after you switch away from it. Mission Control shows what is running across every project, and New Task launches work into a fresh background session, optionally in its own Git worktree.

Review rail

See changed files, permissions, and session status at a glance. Approve or deny tool calls without leaving the chat, and define custom allow/deny rules per tool, globally or per workspace.

Pi or OMP

Run the standard Pi CLI or the compatible omp binary from oh-my-pi. Each keeps its own sessions and the app reads both, so switching engines never hides your history. Rows are tagged when both appear, and opening one starts the engine that wrote it.

File tree & diff viewer

Browse your project and review diffs inline. Preview code, images, PDFs, and HTML in a side pane. File search with Ctrl+Shift+F.

Code editor

Open and edit files in a real CodeMirror 6 editor with syntax highlighting for 15+ languages. Save/Revert controls and instant feedback.

Integrated terminal

Full PTY terminal with ANSI color support, right inside the app, so you don't have to switch windows.

Package browser

Browse and install Pi packages from pi.dev/packages without leaving the app.

Themes

Dark, Light, System, Nord, Gruvbox, Breeze Dark, Breeze Light, and Breeze Claudius, or build your own from 7 seed colors with a live-previewing editor. Import, export, install from a URL, or browse the community gallery.

Model switching

Cycle between models with Ctrl+P. Session tags keep your work organized.

Session naming

Session names read straight from Pi, with inline rename right in the sidebar. Delete confirmations are themed and in-app, so no native dialog steals window focus.

Activity dashboard

Home shows usage stats over 7 days to a year: messages, tokens, active-day streaks, peak hour, and per-model breakdown. The stats persist even if you delete the session.

Get started

Up and running in two steps

1

Install Pi

Pi Desktop wraps the Pi coding agent. Install it first:

npm install -g @earendil-works/pi-coding-agent

2

Download and run

Grab the latest build for your platform from Releases: Linux AppImage, macOS DMG (Apple Silicon), or Windows installer/portable.

chmod +x Pi-Desktop-*.AppImage
./Pi-Desktop-*.AppImage

macOS and Windows builds are unsigned (community-tested); see the README for the one-time Gatekeeper/SmartScreen steps, or build from source to skip them entirely.