Skip to content

README.md

Latest commit

 

History

History
103 lines (91 loc) · 4.63 KB

README.md

File metadata and controls

103 lines (91 loc) · 4.63 KB
Raw

PI-Desktop Spec

Frozen baseline: 0.4.16 · current app line: 0.14.x Updated: 2026-09-10 Language: English-first Stack: Electron + Rust host core + pi Agent Harness + user-installable plugins

The baseline is a frozen decision artifact, not a complete list of every feature in the current app. The current implementation adds Goal contracts, standalone MCP/Skills/Subagents, plugin marketplace and launcher flows, session import, scheduled tasks, next-turn composer configuration, and host-owned session collaboration messages. The host wire protocol is v11; storage schema is v16 (see 00-baseline.md).

Quick entry

Doc Description
NAV.md One-page full navigation
00-baseline.md Frozen baseline
08-meta/decisions-log.md Frozen detail decisions
01-product/00-overview.md Overview
01-product/01-product-scope.md Current product scope and operating modes
02-architecture/01-architecture.md Architecture
02-architecture/05-remote-agent-control.md Remote Agent Host and Gateway target
03-runtime/05-host-core-rust.md Rust host core
03-runtime/19-remote-agent-control-protocol.md Remote control protocol
05-security/02-remote-control-security.md Remote control security
04-ux/02-i18n-english-first.md i18n policy
04-ux/07-ui-design-system.md Design system (tokens, motion, density)
04-ux/01-ui-ia.md Shipped shell and destination map
../project/plan-mode-implementation-plan.md Plan operating-state implementation plan
07-plugins/01-plugin-system.md Plugin system
06-delivery/03-ai-development-workflow.md AI dev workflow rules
06-delivery/04-e2e-test-plan.md E2E test plan & scenarios
06-delivery/05-change-checklist.md Change checklist

Directory map

docs/spec/
├── 00-baseline.md
├── 01-product/
├── 02-architecture/
├── 03-runtime/
├── 04-ux/
├── 05-security/
├── 06-delivery/
├── 07-plugins/
└── 08-meta/

Reading paths

Product

  1. 00-baseline.md
  2. 01-product/00-overview.md
  3. 01-product/01-product-scope.md
  4. 06-delivery/01-mvp-milestones.md

Implementation

  1. 00-baseline.md
  2. 02-architecture/01-architecture.md
  3. 02-architecture/05-remote-agent-control.md when implementing remote control
  4. 03-runtime/05-host-core-rust.md
  5. 03-runtime/02-agent-runtime.md
  6. 03-runtime/01-ipc-protocol.md
  7. 03-runtime/19-remote-agent-control-protocol.md when implementing remote control
  8. 03-runtime/11-provider-model-system.md
  9. 07-plugins/01-plugin-system.md

Plugin authors

  1. ../plugin-development.md
  2. 07-plugins/01-plugin-system.md
  3. 07-plugins/02-plugin-manifest-schema.md
  4. 07-plugins/03-plugin-api.md
  5. 07-plugins/10-plugin-devex.md
  6. examples/plugins/hello

Frozen decisions (short)

  1. Electron shell
  2. English-first product/docs
  3. Rust host backend core
  4. pi agent engine in Node sidecar
  5. Host RPC = stdio JSON-RPC NDJSON
  6. SQLite owned by Rust only
  7. Default mode = Agent; operating selector = Agent | Plan | Goal. Plan and Goal are contract states of the same Agent and are not strict read-only security profiles because Bash follows the selected permission mode
  8. SubmitPlan writes exact Markdown bytes to a new host-owned .pi/plan/*.md artifact; title/question stay structured in plan_approvals, approval opens the artifact, is approve/reject only, and expires after 30 absolute minutes with PLAN_APPROVAL_TIMEOUT
  9. Protocol v11 and storage schema v16 are authoritative for Plan/Goal checkpoints, plan_approvals execution fields, startup interruption, shell identity, and host-owned session collaboration. v11 withdraws the A2A method domain added in v10.
  10. Local permission approvals have no automatic deadline; Bash timeout 60s by default
  11. Local user-installable plugins (market later)
  12. Tag releases = macOS arm64 and Intel x64, Windows x64, and Linux x64 (D126/D285)
  13. Universal provider/model coverage (native + OpenAI-compatible + custom)