Quickstart

Get Potpie running against your codebase in three steps.

1. Install the CLI

uv (recommended)pip

uv tool install potpie

python3 -m pip install --user potpie

Tip

uv tool install is recommended because it avoids global mutation of your Python environment.

2. Run the setup wizard

potpie setup

The setup wizard handles:

• Local config and storage provisioning
• Daemon startup
• Default pot (workspace) creation
• Agent skill installation
• Integration and harness selection

You can also pass options directly:

potpie setup --repo . --agent claude

3. Start using Potpie

Once setup completes, open your configured coding harness (Claude Code, Cursor, Codex, etc.) and start working. Potpie is already integrated — the agent will use the context graph automatically when tasks require it.

To explore the graph visually:

potpie ui

This opens a local graph explorer in your browser.

Verify your installation

potpie status --host

This checks daemon health, pot readiness, graph status, and skill availability.

Next steps

• Introduction — what Potpie is and a complete end-to-end scenario
• CLI Commands Reference — full list of available commands
• Context Graph — understand the project-memory layer
• Prebuilt Agents — learn about Ask, Build, and Debug modes
• Tutorials — hands-on walkthroughs