PI-Desktop

This is a community package of PI-Desktop, maintained independently and unaffiliated with PI-Desktop or its author. It repackages the official upstream Linux build unmodified.

PI-Desktop is a local-first desktop workspace for AI agents: projects, sessions, models, plugins and workflows live in one persistent environment, with no mandatory account and no telemetry. Models are a replaceable component — cloud providers, open-compatible gateways, or local runtimes such as Ollama and LM Studio.

• Persistent projects and sessions that survive app restarts.
• Switch provider, model and reasoning level per session.
• Delegate to subagents or coordinate parallel worker sessions.
• Plugins add panels, views, agent tools, MCP servers, themes and background services.

Permissions: this package keeps a tight sandbox by default — network, display, GPU, audio (playback and recording) and notifications. File picking goes through the desktop portal; no broad filesystem access is granted. The app's own state (sessions, provider credentials and window state) is kept in the per-app data directory. Global ~/.pi and ~/.agents are not accessible by default; enable the optional overrides below to use your host Pi configuration, skills and agents. The tray icon is unavailable: enabling its PID-specific D-Bus name required spoofing Electron's PID, which caused the app not to close properly in testing. Stored credentials are encrypted with a key kept in the same directory, which keeps them out of plain sight but does not protect them from anyone who can read your files. Commands the agent runs execute inside the sandbox with the runtime's own shell and core tools — this package does not bridge the sandbox out to host tools.

A few optional capabilities are not granted by default; enable the ones you need with "flatpak override":

• Open projects stored anywhere in your home directory and share your real ~/.pi, ~/.agents, ~/.claude and ~/.codex with agent tools installed on your system (including session import): flatpak override --user --filesystem=home net.aiuo.pi-desktop
• Use global Pi configuration, skills and agent files in ~/.pi and ~/.agents without granting access to the rest of your home directory. These paths are created if missing: flatpak override --user --filesystem=~/.pi:create --filesystem=~/.agents:create net.aiuo.pi-desktop
• Connect to remote hosts: the app keeps their pairing tokens only in the system keyring (GNOME Keyring / KWallet): flatpak override --user --talk-name=org.freedesktop.secrets net.aiuo.pi-desktop