# Potpie

A CLI tool that turns a codebase's structure, decisions, history and team knowledge into a context graph, so AI coding agents can answer questions, plan changes, debug failures and write code with project-specific context.

Potpie installs from PyPI with `uv tool install potpie` or `pip install potpie`, then `potpie setup` runs a wizard that provisions local config, storage, a background daemon, a default project ('pot') and agent skills, and lets a user choose integrations and a coding harness to configure.

Its main commands include `potpie login`, `potpie github login` or `potpie linear login` to connect source integrations, `potpie status` and `potpie doctor` for readiness and diagnostics, `potpie source add repo .` to register the current repository, `potpie pot list`/`pot use` to manage workspaces, `potpie resolve` to pull the context an agent should read before a task, and `potpie search` to look up a file, workflow or behavior; a `potpie ui` command opens a graph explorer in the browser.

It is written in Python and licensed under Apache-2.0.

Website: https://potpie.ai