percho

Name: percho
Author: Jaxton07

Pending

pi-desktop 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.

88stars

6forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/Jaxton07/percho

Getting Started

Guides for using ai agents skills like percho.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

README.md

Frequently Asked Questions

What is percho?

percho is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Jaxton07. pi-desktop 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. It has 88 GitHub stars.

Is percho safe to use?

percho's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install percho?

Clone the repository with "git clone https://github.com/Jaxton07/percho" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is percho written in?

percho is primarily written in TypeScript. It is open-source under Jaxton07 on GitHub, so you can review or fork the full source.

Are there alternatives to percho?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh percho against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

239,787

disp8ch ralph

Demo

percho chat page

Chat

Chat page demo

Custom background & dark theme

Chat with custom background image in dark theme

Settings — providers & models

Settings page demo

Settings — appearance (theme & background)

Appearance settings

Why percho?

percho embeds the official Pi SDK (@earendil-works/pi-coding-agent) in the Electron main process. It is not a fork and not a reimplementation — it runs the same engine as the Pi CLI and inherits Pi's native strengths:

Extensibility — TypeScript extensions, skills, and prompt templates installed for the Pi CLI work here too, including project-local ones (with a trust prompt before loading). Adapt Pi to your workflows, no forking required.
Shared configuration — same ~/.pi/agent/ directory as the CLI: sessions, auth, and model settings carry over. Start a session in the terminal, continue it in the GUI.
Providers — subscriptions (Claude Pro/Max, ChatGPT Plus/Pro Codex, GitHub Copilot) and API keys for Anthropic, OpenAI, Gemini, DeepSeek, Bedrock, and more.

And for those who prefer a GUI over a TUI:

Minimalist by design — a clean, uncluttered interface that stays true to Pi's aesthetic
Visual permission gates — approve or deny each tool call from a dock, backed by a per-tool rule engine
Multi-session sidebar, per-session composer drafts, follow-up queue with undo
Streaming markdown rendering, image previews, message copy
Agent-initiated image display — a built-in show_image tool lets the agent deliberately show you images inline (single or grouped), without turning every tool result into noise
Custom background image with adjustable overlay dimming, light/dark/system themes

Download

Prebuilt installers are published on the Releases page.

Platform	Download
macOS (Apple Silicon)	`percho-mac-arm64.dmg`
macOS (Intel)	`percho-mac-x64.dmg`
Windows	`percho-windows-x64.exe`

Builds are ad-hoc signed (no Developer ID certificate). On macOS, the first launch after a download may show "Apple cannot verify Percho is free from malware" — that's Gatekeeper blocking an un-notarized app. To open it:

System Settings → Privacy & Security → scroll to the bottom → click Open Anyway next to the Percho entry, then confirm with your password or Touch ID (recommended).

Or in Terminal: xattr -cr "/Applications/Percho.app".

Only the first launch of each downloaded version needs this — later updates install automatically in-app and skip Gatekeeper entirely. On Windows, click "More info" → "Run anyway" when SmartScreen appears.

Configuration

API keys are never stored in this repo or written into the app bundle. ~/.pi/agent/models.json references environment variables (e.g. $AI_OPS_API_KEY) and keys stay in your shell environment. If you already use the Pi CLI, your existing setup just works.

Development

Prerequisites: Node.js >= 22.19.

npm install
npm run dev

npm workspaces monorepo, three packages: packages/shared (IPC contracts), packages/backend (the only place that imports the Pi SDK), packages/desktop (Electron + React 19 + Tailwind 4 + Zustand). Common commands: npm run typecheck / test / lint / build / dist.

See CONTRIBUTING.md for the full guide. If you are in China and the Electron binary download stalls, set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ first.

Disclaimer

percho is a community project. It is not built by or affiliated with the Pi team (earendil-works).

License

MIT