Pi Agent

This is a community package of Pi Agent, maintained independently. It repackages the official upstream Linux Debian build unmodified.

Pi Agent puts the pi coding agent in a desktop window. It bundles the Next.js server, the Node.js runtime and the Pi SDK, so the local server starts with the app — no terminal, no separate Node installation and no manually started web server.

• Browse and resume past Pi sessions by project instead of digging through session files.
• Watch a run live, with thinking, tool calls, context usage, cost and compaction state visible.
• Continue from any earlier message as a branch, or fork a conversation into its own session.
• Manage models, OAuth and API keys, custom model configuration, skills and plugins.
• Switch Git worktrees from the sidebar and preview source, diffs, Markdown, images, audio, PDF and DOCX.

Pi Agent reads pi's own data directory, ~/.pi/agent, so an existing terminal setup — sessions, models and authentication — is picked up on first launch. Installing this package does not install a global pi command; the CLI is a separate install from the pi project.

A provider account or API key is required for the agent itself; the app is free to install.

Permissions: this package grants network, display, GPU, audio, notifications and tray access, plus its own ~/.pi directory. It does not grant broad home-directory access by default.

The agent shells out to developer tools that no Flatpak runtime ships — Git above all, which the worktree switching and the diff views are built on. This package puts a bridge on the app's PATH that forwards those commands to the same tools on your host, so your existing Git, Node and language toolchains, and the credentials you have already authorized there, are what run. FlatPark does not bundle or authenticate any of them.

Because host commands run against real host paths, grant access to where your projects live so the app and those commands agree on what a path means:

• Open host projects at their real paths: flatpak override --user --filesystem=home io.github.abcwyc.pi-agent-desktop
• Or scope it to one directory: flatpak override --user --filesystem=~/Projects io.github.abcwyc.pi-agent-desktop
• Reuse your host SSH keys for Git remotes: flatpak override --user --filesystem=~/.ssh:ro io.github.abcwyc.pi-agent-desktop

Updates come through Flatpak: this package tracks upstream's GitHub releases, so use flatpak update rather than the in-app upgrade button, which installs into a location the sandbox does not own.