About this project

Pi Agent (pi-agent-desktop) is a local AI agent desktop app for macOS (Apple Silicon), Windows 10/11 x64, and Linux x64. It wraps the Pi coding agent from earendil-works/pi and the pi-web interface into a single installable application built with Next.js, Tauri, and Rust. The app bundles the Node.js runtime and Pi SDK so the local server starts automatically — no separate terminal, Node.js installation, or manual web server needed. Key features include browsing and resuming past Pi sessions by project, real-time conversation with the agent showing thinking, tool calls, context usage, cost, and compaction state, branching conversations from any message, managing models/OAuth/API keys/custom models/skills/plugins, switching Git worktrees from the sidebar, and previewing source code, diffs, Markdown, images, audio, PDF, and DOCX files. The UI supports dark mode, automatic session naming, completion sounds, and restored run state. Updates are handled via a weekly check against the latest stable GitHub Release of pi-agent-desktop, with a one-click upgrade button that downloads a complete signed build containing Pi, pi-web, and the desktop app at matched versions, then restarts automatically. The app reads existing Pi data from ~/.pi/agent/ by default and respects HTTP_PROXY/HTTPS_PROXY/NO_PROXY environment variables for server-side requests. The project uses automated daily sync workflows that merge upstream changes from pi and pi-web while preserving local modifications, with risk-based gating and full test/build verification before releases. Official releases are signed and notarized (macOS) or Authenticode-signed (Windows). The codebase is MIT-licensed, while the three component projects retain their own licenses.