Experimental Electron desktop shell for pi sessions.
This repo packages a desktop UI around @mariozechner/pi-coding-agent. It is not a standalone coding agent runtime. The app depends on the upstream pi package for session management, model/auth setup, and agent execution.
- Experimental
- macOS-first desktop app
- Public source repo, not currently configured for npm publication
- Opens local workspaces in a desktop shell
- Lists and resumes
pisessions associated with each workspace - Creates new sessions and sends prompts through the
piruntime - Persists desktop UI state such as selected workspace, selected session, and composer draft
- Node.js
pnpm- A working
piruntime environment through@mariozechner/pi-coding-agent - Valid model/provider authentication supported by
pi
Because this app wraps pi, you will need whatever auth and local setup pi itself requires before live agent runs will work.
Install dependencies:
pnpm installRun the desktop app in development:
pnpm devBuild everything:
pnpm buildRun the default test suite:
pnpm testDesktop E2E lanes and setup are documented in apps/desktop/README.md. The default desktop test command runs the core lane; use pnpm --filter @pi-gui/desktop run test:e2e:all when you need core, live, and native.
Regenerate the README demo assets:
pnpm --filter @pi-gui/desktop demo:readmeapps/desktop: Electron app and renderer UIpackages/session-driver: shared session driver typespackages/catalogs: lightweight workspace/session catalog statepackages/pi-sdk-driver: adapter from the desktop app to@mariozechner/pi-coding-agent
- The app currently relies on upstream
pibehavior and local auth state. - Live end-to-end validation may require model credentials not stored in this repo.
- Package manifests remain
private: true; this repo is intended for source collaboration first.
- Built on top of
@mariozechner/pi-coding-agent - Upstream runtime and ecosystem by
badlogic/pi-mono
MIT. See LICENSE.
