Jaxton07/percho

Percho: Minimalist desktop GUI for the Pi coding agent — the same engine as the Pi CLI, in a clean visual interface. Multi-session chat, visual tool approvals, and custom themes.

What it solves

percho provides a highly customizable desktop graphical user interface (GUI) for the Pi coding agent. It bridges the gap for users who prefer a visual interface over a terminal-based (TUI) experience while maintaining full compatibility with the Pi CLI's engine, configurations, and extensions.

How it works

The application embeds the official Pi SDK (@earendil-works/pi-coding-agent) within an Electron main process. Because it uses the same engine as the CLI, it shares the same configuration directory (~/.pi/agent/), allowing users to switch between the terminal and the GUI seamlessly. It supports various AI providers via API keys or OAuth flows (including Claude, ChatGPT, Gemini, and DeepSeek) and implements a visual layer for tool approvals and session management.

Who it’s for

Developers who use the Pi coding agent but want a visual workspace with features like multi-session tabs, image previews, and a more intuitive way to manage agent tool calls and sub-sessions.

Highlights

  • Full Pi CLI Compatibility: Supports the same TypeScript extensions, skills, and prompt templates as the CLI.
  • Visual Tool Management: Includes visual permission gates to approve or deny tool calls and a per-tool rule engine.
  • Advanced Session Control: Features draggable multi-session tabs, message forking, and a follow-up queue with undo.
  • Agentic Capabilities: Built-in support for subagents, parallel task fan-outs, and a show_image tool for inline image display.
  • Context Optimization: Uses "context evaporation" to turn stale tool outputs into compact stubs to save token budget.
  • Customization: Supports UI plugins, custom themes, and background images.

Related

  • Project
    AnnenkovLabs/girl-agent

    A state-driven AI persona engine for Telegram that simulates human behavior through sleep schedules, relationship stages, and long-term memory to avoid typical chatbot patterns.

  • Project
    xr843/fojin

    An open, cross-canon Buddhist knowledge infrastructure that uses RAG and LLM-verified alignments to provide cited, verifiable AI answers from over 600 sources.

  • Project
    Merit-Systems/OpenInstinct

    A self-hostable personal iMessage assistant that uses a cloud browser to perform digital chores like booking tickets and managing groceries while keeping user secrets private.

  • Project
    WordPress/ai

    An experimental WordPress plugin that provides a modular framework for integrating AI-powered content creation, moderation, and SEO tools directly into the Block Editor.