Clients for the pi coding agent.

Scope: Single-user personal deployment. No multi-user, no user accounts, no per-user isolation.

pi-apps/ ├── server/ │ ├── relay/ # Relay API server (Node.js/Hono/SQLite) │ ├── sandboxes/ │ │ ├── cloudflare/ # CF Containers sandbox (Worker + bridge + Dockerfile) │ │ └── docker/ # Docker sandbox images for local/self-hosted relay │ └── scripts/ # Utility scripts (nuke-sessions, list-containers) ├── clients/ │ ├── dashboard/ # Relay admin UI (React Router v7 SPA/Vite/Tailwind) │ └── native/ # Native Swift apps and packages (iOS, macOS) │ ├── apps/ios/ # PiNative Xcode project (XcodeGen) │ └── packages/ # Swift packages (pi-core, pi-ui) └── packages/ # Shared packages (currently empty) 

nix develop # enter nix shell just dev # start relay server + dashboard (parallel, hot reload)

API server that wraps Pi sessions, manages repos, and bridges WebSocket clients.

cd server/relay pnpm install pnpm dev # run dev server (hot reload) pnpm test # run tests

Admin UI for managing secrets, GitHub token, and viewing sessions.

cd clients/dashboard pnpm install pnpm dev # run dev server (hot reload)

Swift apps built with XcodeGen. Requires Xcode.

just setup # generate Xcode project just xcode # open in Xcode just build # build macOS (debug) just build-ios # build iOS simulator (debug)

Run just for all available tasks. Key ones:

• just dev - start relay server and dashboard in parallel
• just build / just build-ios - build native apps
• just test - run native tests
• just clean - remove generated projects and build artifacts
• just sandboxes build-docker <name> - build sandbox Docker images

Pre-built images are published to GitHub Container Registry on pushes to main.

Sandbox images (used by the relay to run pi sessions):

• Nix (for development shell)
• Node.js 22+
• pnpm
• Xcode (for native apps)