{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "jaxton07-percho--install-percho-desktop-app",
 "repo": "Jaxton07/percho",
 "repo_url": "https://github.com/Jaxton07/percho",
 "repo_slug": "jaxton07-percho",
 "title": "Install Percho and start your first agent chat",
 "page_title": "How to install Percho and start your first agent chat with Percho",
 "summary": "Download a prebuilt installer and open a visual chat with the Pi coding agent.",
 "who": "A developer who wants a visual desktop interface for the Pi coding agent instead of a terminal-only workflow.",
 "problem": "Setting up a coding agent with a visual chat, tool approvals, and themes usually means building or wiring up tools by hand.",
 "outcome": "A working Percho app on your desktop with a first chat session open, ready to send prompts to the Pi engine.",
 "steps": [
  "Open the Releases page at https://github.com/Jaxton07/percho/releases and download the installer for your system.",
  "On macOS, if Gatekeeper blocks the app, open System Settings, go to Privacy & Security, and click Open Anyway next to Percho.",
  "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.",
  "Open Percho and sign in to a provider with the in-app OAuth flow or an API key.",
  "Create a new session in a project and send a first prompt."
 ],
 "agent_prompt": "Using the repo Jaxton07/percho, find the installer for <platform> on its Releases page and report the exact file name. Confirm the file name appears in the README download table for that platform.",
 "agents": [
  "any"
 ],
 "difficulty": "Beginner",
 "time": "15 minutes",
 "basis": "readme",
 "caveat": "Builds are ad-hoc signed, so macOS may show a malware warning on first launch and Windows may show a SmartScreen prompt.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "typescript",
 "requirements": [
  "A desktop computer running macOS, Windows, or Linux (x64), or Node.js 22.19 or newer for running from source",
  "Access to a model provider through a supported subscription login or an API key",
  "For the shared-session use case, Pi CLI sessions stored in ~/.pi/agent/ on the same machine"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/jaxton07-percho/install-percho-desktop-app/",
 "md": "https://dedupedai.com/use-cases/jaxton07-percho/install-percho-desktop-app/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/jaxton07-percho--install-percho-desktop-app.json",
 "api_version": "v1"
}