PI-Desktop

English

简体中文

English

简体中文

Appearance

PI-DesktopRead the product as a system.

A calm, inspectable desktop workspace for building with AI. Follow the boundaries, understand the contracts, and make changes with context.

Start with context
Open the spec map
system / overviewLOCAL
P
RUNTIME TOPOLOGY
01Rendererpresentation
02Electronorchestration
03Rust hostauthority
04SQLitedurable state
protocol v9schema v11inspectable by default

Locate the boundary

Start from product intent, then move through architecture, runtime, UX, security, delivery, and plugins.

Read the contract

Follow the Rust host core, pi sidecar, NDJSON RPC, storage ownership, and provider model system.

Change with evidence

Connect the relevant spec, ADR, implementation, E2E scenario, and release checklist.

Read by intent

Start with the question you are solving.

This is not a file dump. It is a map for locating, understanding, changing, and validating the system.

01ORIENTBuild the product modelKnow what is shipped and what is deliberately out of scope.02TRACETrace one requestFollow the path through Renderer, Electron, pi, Rust host, and SQLite.03EXTENDBuild a pluginMove from package format to API, permissions, and lifecycle.04SHIPValidate a changeConnect the spec, implementation, E2E scenario, and delivery record.

System map

Four boundaries. One readable thread.

01ShellElectronWindows, preload IPC, lifecycle, and platform capabilities.
02Agentpi sidecarAgent loop, tools, context, and provider-facing model work.
03HostRust corePermissions, processes, filesystem, RPC, and cancellation.
04StateSQLiteSessions, configuration, checkpoints, plugins, and ownership.

Reference shelf

Go deep by topic, not by getting lost in the file tree.

01ProductScope, modes, and non-goals.02ArchitectureProcesses, data, and structure.03RuntimeProtocols, tools, host, and models.04ExperienceIA, internationalization, and interaction.05SecurityPermissions, paths, and isolation.06DeliveryAcceptance, E2E, and release.07PluginsPackages, APIs, and lifecycle.08DecisionsADRs, decisions, and open questions.

Implementation snapshot

The line this documentation describes.

Application line0.5.8
Host wire protocolv9
Storage schemav11
Source languagesEN / 中文

PI-DESKTOP / DOCUMENTATION SYSTEM

Ready to enter the codebase?

Build context with the guide, or open the full specification index.

Start readingOpen spec index

Built for local-first development.

Copyright © 2026 PI-Desktop contributors