LibreAI / Dev Tools / potpie
// devtools · potpie-ai/potpie

potpie

A context graph for the AI-native SDLC — so agents and humans share one map of the codebase.

★ 5.7k stars⑂ 685 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

potpie is an open-source dev tools project by potpie-ai (potpie-ai/potpie on GitHub). It has 5,739 GitHub stars and 685 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
5,739
Forks
685
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your context problem

    If agents keep misunderstanding your repo's architecture or past decisions, Potpie is the shared context layer to add.

  2. Install the CLI

    Install Potpie with uv tool or pip.

  3. Run setup for your repo

    Run the setup wizard against your repository and connect your coding harness (for example Claude Code) and GitHub.

  4. Query the graph

    Ask what you should know before working in the repo, search the graph, and record decisions as you make them.

// features

Why people love it

Codebase context graph

Builds a knowledge graph over your repository so agents retrieve structured context instead of guessing from file scans.

Natural-language resolve

potpie resolve answers questions like what you should know before working in a repository, grounded in the graph.

Semantic code search

potpie search finds code by meaning — for example, the authentication flow — across the indexed repo.

Decision recording

potpie record stores decisions and other typed notes in the graph, preserving project memory for future sessions.

Harness integrations

Works with coding harnesses such as Claude Code, with GitHub login and auth/status commands for connected workflows.

Setup wizard and UI

potpie setup configures everything interactively, and potpie ui opens the configured harness interface.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone Potpie if you want the source; most users install the CLI in the next step.

    git clone https://github.com/potpie-ai/potpie.git
    cd potpie
  2. Install the CLI

    Install Potpie from PyPI with uv (or pip) and run the setup wizard.

    uv tool install potpie
    potpie setup
  3. Use the graph

    Point Potpie at your repo and ask your first question.

    potpie setup --repo . --agent claude
    potpie resolve "what should I know before working in this repository?"
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Potpie?

Potpie is maintained by potpie-ai, with a hosted product at potpie.ai alongside the open-source CLI.

Is Potpie free?

The CLI in this repository is Apache-2.0 licensed; Potpie also offers hosted services with their own terms.

Does it need a paid API key?

Potpie works with your coding harness and its model access; check the setup wizard for what your chosen configuration requires.

How does it compare to Semble or a plain RAG index?

Semble focuses on fast code search; Potpie builds a persistent context graph for the whole SDLC, including recorded decisions, and integrates it into your coding harness's workflow.

How do I get started?

uv tool install potpie, run potpie setup in your repo, then potpie resolve your first question.

// keep exploring

Similar tools

Dev Tools

code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked con…

★ 31.9k starsMIT
View guide →
Dev Tools

rea

Reverse engineer anything with agents - from app behavior down to native binaries

★ 21.4k starsMIT
View guide →
Dev Tools

GrapeRoot

MCP graph engine that compounds context across AI coding assistants.

★ 1.0k starsApache-2.0
View guide →
Dev Tools

WrenAI

GenBI for AI agents - governed text-to-SQL and dashboards through an open context layer

★ 17.8k starsNOASSERTION
View guide →
Dev Tools

SocratiCode

Enterprise-grade codebase intelligence for AI agents — hybrid semantic search over 40M+ LOC, locally.

★ 3.3k starsAGPL-3.0
View guide →
Dev Tools

context-mode

Context optimization for coding agents: sandbox tool output, keep sessions lean, remember more

★ 25.7k starsElastic License 2.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if potpie is not the right fit.

Get potpie

Free and open — grab the source, star the repo, and start creating.