Pi Desktop Knowledge Bundle

Bundle OKF 0.1 · 11 conceitos · gannonh/pi-desktop

Open site Project Open in the app JSON README (API)

# 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-

README

Loading documentation…

# 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](https://github.com/gannonh/pi-desktop/blob/HEAD/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.

Details

Type: OKF bundles
Topic: Maps, weather & travel
Publisher: gannonh
Source: okf_github
Category: Data
Version: 0.1
Stars: 1
Proposed changes: 4
Last update: 2026-07-20T02:55:20Z
Project status: Active
Language: TypeScript
License: MIT
Added: 2026-09-09 05:03:59
Updated: 2026-09-09 05:03:59
Source id: gannonh/pi-desktop:docs/index.md

Pi Desktop Knowledge Bundle

README

More