Open Source Alpha

A desktop GUI for the
Pi coding agent

Chat with Pi, review changes, browse files, and run commands — all in one window. Free and open source.

↓ Download for Linux View on GitHub
Pi Desktop — Home launcher screen Pi Desktop — main chat view Pi Desktop — chat view with workspace switcher Pi Desktop — sessions list Pi Desktop — agent timeline and session tree Pi Desktop — packages and skills browser Pi Desktop — skills panel Pi Desktop — notes Pi Desktop — settings

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, collapsible tool results, clickable file links, color emoji. Watch Pi reason through problems step by step.

🗂

Multiple workspaces

Each workspace gets its own Pi process and session history. Switch between projects instantly without losing context.

🔍

Review rail

See changed files, permissions, and session status at a glance. Approve or deny tool calls without leaving the chat.

📂

File tree & diff viewer

Browse your project and review diffs inline. 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. No switching 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. Every setting live-previews before you save.

⚡

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. Themed in-app confirmation for delete — no native dialogs stealing 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. Persists 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/deb/rpm, 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.