If you are new to Potpie, start with the Introduction and Installation pages before reading the reference.
CLI Reference
Entry point for the Potpie command tree, command families, install flow, and recommended local workflow.
CLI Manual
Complete man-page style reference with all commands, options, exit codes, environment variables, and file paths.
Setup & Lifecycle
First-run setup, readiness checks, diagnostics, local identity, UI launch, and config management.
Context Commands
resolve, search, and record for task-scoped context retrieval and durable project learning.Integrations & Auth
Potpie account login plus GitHub, Linear, Jira, and Confluence integration commands.
Pots & Sources
Workspace boundaries, repo-local default routing, source registration, and ingestion entry points.
Graph & Operations
Daemon, services, ledger, graph workbench, timeline, backend, skills, and managed-cloud sync.
Runtime Architecture
Host facade, agent contract, service protocols, and setup lifecycle DTOs behind the engine.