Repolode
Submit
minghinmatthewlam

minghinmatthewlam/pi-gui

Electron desktop app for the pi coding agent, running parallel agent threads with git worktrees, a diff review tab and an integrated terminal.

View on GitHubWebsite
Stars
1,414
Forks
203
Open issues
27
Last commit
5 days ago

What is it?

pi-gui is a desktop shell for the pi coding agent. Sessions, models, authentication and tools all run through pi itself, so anything configured with the pi CLI carries over. Each task gets its own thread, which can start in your current checkout or in a fresh git worktree, so several agents can work in parallel.

The window combines the conversation with a workbench that holds a real terminal, a file explorer and editor, a Review tab for comparing uncommitted work, branches or single turns, and tabs from desktop extensions. Keyboard shortcuts cover search, file opening, thread switching and queuing or steering a running agent. Scheduled prompts, skills and extensions, and provider sign-in via OAuth or API key are also supported.

The app runs on macOS (Apple Silicon), Linux (x64) and Windows (x64), and can be installed from releases or via Homebrew on macOS. It is built with Electron, React and TypeScript, and reads pi's JSONL session files directly.

Key features

  • 01Runs multiple agent threads in parallel, each optionally in its own git worktree.
  • 02Review tab shows diffs for uncommitted work, branches or single turns, with per-file staging.
  • 03Integrated terminal, file explorer and editor sit beside the conversation.
  • 04Shares sessions, credentials and skills with the pi CLI.
  • 05Scheduled tasks, notifications and command palette with keyboard shortcuts.
  • 06Supports OAuth, API keys and custom endpoints for model providers.

Use cases

  • Letting several coding agents work on separate features or bug fixes at the same time.
  • Reviewing an agent's changes file by file before committing them.
  • Running tests in a terminal next to the agent conversation without switching windows.
  • Scheduling recurring prompts, such as weekly dependency checks, while the app is open.

Quick start

  1. 1

    Install pi-gui with Homebrew: tap the repository

    brew tap minghinmatthewlam/tap
  2. 2

    Trust the tap (required on first install)

    brew trust minghinmatthewlam/tap
  3. 3

    Install the pi-gui cask

    brew install --cask pi-gui
  4. 4

    Open pi-gui, connect a model provider in Settings → Providers, then add a workspace and send your first prompt

Things to know

  • Native builds cover macOS (Apple Silicon), Linux (x64) and Windows (x64) only.
  • Windows builds are not code-signed yet, so SmartScreen may show a warning.
  • It is a desktop shell that needs the pi coding agent and a model provider or API key to do useful work.

In collections

Tools for running coding agents in parallelAI coding assistants & agentsCLI & terminal toolsDesktop GUI apps & toolkits

Topics

#coding-agent#electron#git-worktree#desktop-app#typescript#terminal#code-review

FAQ

What is pi-gui?
Electron desktop app for the pi coding agent, running parallel agent threads with git worktrees, a diff review tab and an integrated terminal. pi-gui is a desktop shell for the pi coding agent. Sessions, models, authentication and tools all run through pi itself, so anything configured with the pi CLI carries over. Each task gets its own thread, which can start in your current checkout or in a fresh git worktree, so several agents can work in parallel.
Is pi-gui free to use? What license does it have?
pi-gui is open source under the MIT license. Check the license terms before using it in commercial products.
Is pi-gui still maintained?
Actively maintained. The last commit to pi-gui was on Nov 2, 2026.
What can I use pi-gui for?
Letting several coding agents work on separate features or bug fixes at the same time. Reviewing an agent's changes file by file before committing them. Running tests in a terminal next to the agent conversation without switching windows. Scheduling recurring prompts, such as weekly dependency checks, while the app is open.
How do I install pi-gui?
Install pi-gui with Homebrew: tap the repository: brew tap minghinmatthewlam/tap Trust the tap (required on first install): brew trust minghinmatthewlam/tap Install the pi-gui cask: brew install --cask pi-gui Open pi-gui, connect a model provider in Settings → Providers, then add a workspace and send your first prompt
Where can I get pi-gui?
The source code and installation instructions are on GitHub: https://github.com/minghinmatthewlam/pi-gui

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects