# AI use cases for Percho (Jaxton07/percho) Repo: [Jaxton07/percho](https://github.com/Jaxton07/percho) | Use cases: 5 | Page: https://dedupedai.com/use-cases/jaxton07-percho/ Percho is a free, open-source desktop GUI that runs the Pi coding agent's engine in a visual chat interface with tool approvals and themes. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Install Percho and start your first agent chat: https://dedupedai.com/use-cases/jaxton07-percho/install-percho-desktop-app/ - Continue a Pi CLI session in the Percho window: https://dedupedai.com/use-cases/jaxton07-percho/continue-terminal-pi-session-in-gui/ - Approve or deny each agent tool call visually: https://dedupedai.com/use-cases/jaxton07-percho/review-tool-calls-with-visual-approvals/ - Watch a running agent session from a phone browser: https://dedupedai.com/use-cases/jaxton07-percho/monitor-agent-session-from-phone/ - Run Percho from source to customize its themes: https://dedupedai.com/use-cases/jaxton07-percho/run-percho-from-source-to-customize/ ## How to install Percho and start your first agent chat with Percho Repo: [Jaxton07/percho](https://github.com/Jaxton07/percho) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Download a prebuilt installer and open a visual chat with the Pi coding agent. **Who it is for:** A developer who wants a visual desktop interface for the Pi coding agent instead of a terminal-only workflow. **The problem:** Setting up a coding agent with a visual chat, tool approvals, and themes usually means building or wiring up tools by hand. **The outcome:** A working Percho app on your desktop with a first chat session open, ready to send prompts to the Pi engine. ### Steps 1. Open the Releases page at https://github.com/Jaxton07/percho/releases and download the installer for your system. 2. On macOS, if Gatekeeper blocks the app, open System Settings, go to Privacy & Security, and click Open Anyway next to Percho. 3. On Linux, run `chmod +x percho-linux-x86_64.AppImage` before the first launch, and install libfuse2 first on Ubuntu 22.04 or 24.04 and derivatives. 4. Open Percho and sign in to a provider with the in-app OAuth flow or an API key. 5. Create a new session in a project and send a first prompt. ### Prompt to paste into your agent ```text Using the repo Jaxton07/percho, find the installer for on its Releases page and report the exact file name. Confirm the file name appears in the README download table for that platform. ``` ### Caveat Builds are ad-hoc signed, so macOS may show a malware warning on first launch and Windows may show a SmartScreen prompt. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/jaxton07-percho/install-percho-desktop-app/ ## How to continue a Pi CLI session in the Percho window with Percho Repo: [Jaxton07/percho](https://github.com/Jaxton07/percho) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README Pick up a terminal Pi session in the visual app without losing its history. **Who it is for:** A developer who started a task in the Pi CLI in a terminal and wants a visual view to keep working on it. **The problem:** Switching from a terminal agent to a visual interface often means losing context or re-entering settings. **The outcome:** The same session appears in Percho with its history, because both tools read the same configuration directory. ### Steps 1. Start a session with the Pi CLI in your terminal and let it run or save its state. 2. Open Percho on the same machine. 3. Find the session in the project and session sidebar (inferred: the session should be listed under the same project). 4. Open the session and continue the conversation in the composer. ### Prompt to paste into your agent ```text In the repo Jaxton07/percho, check that the shared ~/.pi/agent/ directory is the one used for sessions, auth, and model settings. Report which session from is visible in the Percho sidebar and whether its prior messages load. ``` ### Caveat Percho embeds the Pi SDK and is not a fork, so behavior depends on the Pi engine version bundled with the app. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/jaxton07-percho/continue-terminal-pi-session-in-gui/ ## How to approve or deny each agent tool call visually with Percho Repo: [Jaxton07/percho](https://github.com/Jaxton07/percho) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Review every tool request in a dock and allow or block it before it runs. **Who it is for:** A developer who lets a coding agent act on files or commands and wants a visible checkpoint before each action. **The problem:** An agent running tools without a clear review step can change files or run commands you did not expect. **The outcome:** Each tool call waits in a visual dock until you approve or deny it, with rules applied per tool. ### Steps 1. Open a project in Percho and start a session. 2. Send a prompt that asks the agent to use a tool, such as reading or editing a file. 3. When the tool call appears in the approval dock, read the requested action. 4. Click approve or deny for that call. 5. Adjust the per-tool rules so that routine calls follow your chosen policy. ### Prompt to paste into your agent ```text Using the repo Jaxton07/percho, start a session in and send a prompt that triggers one tool call. Report the tool name and the approval decision you made, and verify that the tool did not run before approval. ``` ### Caveat Approval rules only cover the tool calls Percho sees, so review the per-turn diff sidebar for changes made during a turn. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/jaxton07-percho/review-tool-calls-with-visual-approvals/ ## How to watch a running agent session from a phone browser with Percho Repo: [Jaxton07/percho](https://github.com/Jaxton07/percho) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Scan a QR code to follow a session from a tablet or phone and act on approvals. **Who it is for:** A developer who starts a long agent task at a desk and wants to check progress from another room or device. **The problem:** A long-running coding task forces you to stay at the desktop to see progress or answer approval prompts. **The outcome:** You see the session on a phone or tablet browser and can respond to approvals while away from the desk. ### Steps 1. Open Percho on the desktop and start or open the session you want to watch. 2. Turn on the cross-device option and show the QR code (inferred: the setting lives in the app's session or settings panel). 3. Scan the QR code with your phone or tablet browser. 4. Monitor the session, and only if needed enable remote prompts, stop generation, or allow-once and deny approval decisions. ### Prompt to paste into your agent ```text In the repo Jaxton07/percho, enable the cross-device QR view for the session and report the URL scheme you see on the QR code. Verify that a second device can load the session read-only before any remote action is enabled. ``` ### Caveat The README does not describe how the phone connection is secured, so verify the network path before using remote prompts. Risk, credentials: Remote prompts and approval decisions can drive tools on the desktop machine, so enable them only on a network you trust. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/jaxton07-percho/monitor-agent-session-from-phone/ ## How to run Percho from source to customize its themes with Percho Repo: [Jaxton07/percho](https://github.com/Jaxton07/percho) | Difficulty: Advanced | Time: 30 minutes | Basis: From the README Install dependencies, start the dev build, and run the checks before changing the UI. **Who it is for:** A developer who wants to change Percho's themes, UI plugins, or tool-call cards, or contribute a fix. **The problem:** Customizing a desktop app's interface requires a working development environment and a way to verify changes. **The outcome:** A running development build of Percho with typecheck and tests passing, ready for UI changes. ### Steps 1. Install Node.js 22.19 or newer. 2. Run `npm install` in the repository folder. 3. Run `npm run dev` to start Percho in development mode. 4. Run `npm run typecheck` and `npm run test` after each change. (inferred, check the README) 5. If the Electron binary download stalls in China, set `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/` before installing. ### Prompt to paste into your agent ```text Using the repo Jaxton07/percho, install dependencies and start the development build, then run `npm run typecheck` and `npm run test`. Report the results and confirm the three packages (shared, backend, desktop) are present. ``` ### Caveat The README warns that the backend package is the only place importing the Pi SDK, so keep Pi SDK changes inside that package. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/jaxton07-percho/run-percho-from-source-to-customize/