Pi Desktop Knowledge Bundle
Bundle OKF 0.1 · 11 conceitos · gannonh/pi-desktop
Open source Repository Open in the app JSON README (API)
About
# Pi Desktop Knowledge Bundle
Start here before substantial Pi Desktop work. This OKF bundle organizes roadmap, specs, decisions, and durable project knowledge.
# Core Map
* [Specs roadmap](specs/) - Active, planned, blocked, completed, and archived work.
* [Architecture decisions](adrs/) - Accepted ADRs that constrain implementation choices.
* [Product roadmap](/pi-desktop-high-level-roadmap.md) - Product requirements and high-level milestone roadmap.
* [Documentation map](/docs-map.md) - Legacy documentation pointer map retained for continuity.
* [Diagrams](diagrams/) - HTML diagrams and visual architecture references.
# Current Work
* [Orca Git Parity Roadmap](/specs/2026-06-08-orca-git-parity-roadmap.md) - Active source-control follow-up roadmap after M07C.
* [Worktree and runtime scope follow-up triggers](/specs/2026-06-10-worktree-scope-followups.md) - Decision gates for reopening worktree and runtime Git boundaries.
* [Hosted review deferred scope](/specs/2026-06-10-hosted-
Details
- Kind
- OKF bundles
- Topic
- Maps, weather & travel
- Publisher
- gannonh
- Origin
- okf_github
- Category
- dados
- Version
- 0.1
- Stars
- 1
- Open pull requests
- 4
- Last push
- 2026-07-20T02:55:20Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-09-09 05:03:59
- Updated
- 2026-09-09 05:03:59
- Origin id
gannonh/pi-desktop:docs/index.md
README
# pi-desktop `pi-desktop` is an open-source macOS desktop command center for the Pi coding agent CLI. Product context and roadmap live in [docs/pi-desktop-high-level-roadmap.md](docs/pi-desktop-high-level-roadmap.md). ## Prerequisites * macOS * Node.js 24.x * pnpm 11.1.1 Use Corepack to activate the pinned pnpm version: ```bash corepack enable corepack prepare pnpm@11.1.1 --activate ``` ## Install ```bash pnpm install ``` ## Develop ```bash pnpm dev ``` ```bash pnpm dev:desktop ``` `pnpm dev` aliases desktop development. Starts the Electron desktop app in development mode. ```bash pnpm dev:web ``` Starts the browser preview and a local app data bridge. The preview uses the same persisted project/chat store and Pi session runtime boundary as the desktop app. Native folder picker operations return a visible unsupported-operation error in web preview. ## Check ```bash pnpm check:pre-push ``` `pnpm check:pre-push` runs the fast local gate: formatting, linting, typechecking, and unit tests. The pre-push hook uses this gate by default. ```bash pnpm check ``` `pnpm check` runs formatting, linting, typechecking, unit tests, coverage, and Electron/web smoke tests. To run the full gate during push, use `FULL_PRE_PUSH=1 git push`. Smoke tests run headless by default so they do not steal focus while you work. To watch them locally, use `pnpm test:smoke:headed` or set `PI_DESKTOP_SMOKE_HEADED=1`. Run the current UAT evidence check with `pnpm test:uat`. ## Package Locally ```bash pnpm package ``` Milestone 0 produces an unsigned local macOS package. Signing, notarization, CD, and release publishing are deferred.