minghinmatthewlam/pi-gui

What it solves

pi-gui provides a native desktop interface for the pi coding agent, removing the need to interact with the agent solely via a command-line interface. It organizes agent interactions into a visual, manageable environment with integrated development tools.

How it works

It functions as an Electron-based UI shell that wraps the @earendil-works/pi-coding-agent runtime. Rather than reimplementing the agent's logic, it uses pi's own JSONL session files as the source of truth for session history and relies on the upstream pi package for model authentication, session management, and execution.

Who it’s for

Developers who use the pi coding agent and prefer a graphical user interface with features like visual diffs, integrated terminals, and organized session timelines.

Highlights

• Threaded Timeline: Visualizes agent sessions as a Codex-style timeline of messages and collapsible tool calls.
• Git Worktrees: Allows starting threads in the local workspace or in isolated git worktrees to prevent parallel work collisions.
• Multi-agent Orchestration: Supports orchestrator threads that can create and supervise child worker threads.
• Integrated Tooling: Includes a built-in PTY terminal and an inline diff viewer for reviewing file changes.
• Composer Features: Supports @-mentioning files and drag-and-drop image attachments in prompts.
• Session Management: Provides the ability to archive old threads and manage pi skills and extensions through a dedicated view.