Skip to content

Quickstart

Get Potpie running against your codebase in three steps.

1. Install the CLI

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