PiDeck is an open-source desktop workbench designed for unified management of pi Agent sessions within local project directories. It caters to developers who manage multiple AI programming assistant sessions across various projects, offering a consolidated view of session history, Git status, and pi configurations. The application provides a traceable, configurable, and unified experience for local AI coding assistants in multi-project environments.

How It Works

Built on Electron and TypeScript, PiDeck acts as a lightweight desktop shell that orchestrates multiple pi --mode rpc processes. This architecture ensures session isolation, with each Agent tab running as an independent pi RPC process, allowing pi to manage its native capabilities. The application integrates project management, session handling, dialogue interfaces, configuration management, and tool orchestration into a cohesive native desktop experience.

Quick Start & Requirements

Pre-built installers for Windows, macOS, and Linux are available on GitHub Releases. Alternatively, PiDeck can be run from source.

• Primary Install: Download pre-built installer or run from source.
• Prerequisites: Node.js 20+, pi CLI installed and accessible in system PATH, pi Provider/Login/API Key configuration completed.
• Run from Source:

  git clone https://github.com/ayuayue/PiDeck.git
  cd pi-desktop
  npm install
  npm run dev
  

• Links: GitHub Releases, QQ Group: 1026218644.

Highlighted Details

• Prompt Management: Features a new prompt template system with management, built-in templates, / picker, and variable placeholders. Includes a Prompt/Skill store integrating prompts.chat and Yao Open Prompts.
• Workspace & Session: Supports multi-project workspaces with isolated pi Agents. Offers Git Worktree integration for branch management and session grouping. Allows importing Codex and Claude local sessions.
• User Interface: Includes a built-in browser preview with multi-tab support, an embedded terminal dock, slash commands (/) and ! shell execution in the input, and a scratchpad.
• Configuration: Provides visual editors for pi models, authentication, and settings, along with extension management.
• Workflow Enhancements: Features Plan Mode for step-by-step execution confirmation, message editing/deletion, and answer-level modification summaries showing files changed.

Maintenance & Community

The latest version is v0.6.5, released on 2026-07-13. Contributors are listed in CONTRIBUTORS.md. Community interaction and feedback are encouraged via the QQ Group: 1026218644.

Licensing & Compatibility

PiDeck is released under the MIT License. This license is permissive and generally compatible with commercial use and linking in closed-source projects.

Limitations & Caveats

PiDeck requires the pi CLI to be installed and configured separately. Users should only run trusted source code due to the application launching external pi processes and utilizing Electron IPC for file operations. Anonymous telemetry (app_heartbeat) is enabled by default but can be disabled in settings; it does not collect sensitive project or session data.