Sign inCreate account
Sign inCreate account

potpie

From public sources

Context Graph for AI Native SDLC

CLI toolCategory: Developer Tools · AI codingOpen sourcedata checked Oct 15, 2026
Add to compareAdd to collection

Overview

  • agents
  • ai-agents
  • ai-agents-framework
  • artificial-intelligence
  • context-graph
  • developer-tools
  • devtools
  • generative-ai
  • knowledge-graph
  • rag

Installation

Commands are shown, never run by the marketplace. Check them against the official documentation.
  • Official websiteFrom public sourcesfrom catalog metadata
    potpie.ai/ ↗
  • Official release filesFrom public sourcesfrom the latest official release
    github.com/potpie-ai/potpie/releases/tag/v2.0.1 ↗
  • Language package registrypythonFrom public sourcesfrom the package manifest — publication on the registry is not verified
    pipx install potpie

    Not verified: check that this package in the registry belongs to this project before installing.

    pypi.org/project/potpie/ ↗
  • Build from sourceFrom public sourcesfrom catalog metadata

    Build from source: no validated build recipe — follow the repository instructions.

    github.com/potpie-ai/potpie ↗

Compatibility

Unknown means no evidence was found — not that the product is incompatible.
PlatformStatusArchitectureEvidenceConfidence
WindowsUnknown———
macOSUnknown———
LinuxUnknown———
Container (OCI)Unknown———
PythonCompatible—official build in release v2.0.1: potpie-2.0.1-py3-none-any.whl0.60

Releases

checked Oct 29, 2026
v2.0.1LatestAug 31, 2026Official source ↗

Files in 2.0.1

The marketplace does not host these files: downloads go to the official source. Files have not been scanned by us.
FilePlatformSizeSHA-256Download from the official source
potpie-2.0.1-py3-none-any.whlpython · wheel532.5 KB3481a2bdcdde…Official source ↗
potpie-2.0.1.tar.gzUnknown453.4 KB526ac666d98d…Official source ↗
potpie_context_engine-0.2.0-py3-none-any.whlpython · wheel798.7 KB827b20f14e60…Official source ↗
SHA256SUMS.txtchecksums337 B06c3f8e05796…Official source ↗

Release history

Quality profile

algorithm quality-v1.0 · assessed Oct 15, 2026
Quality Score99
Risk Score0
Confidence 1.00
Quality Score and Risk Score are different measures. A high score does not guarantee safety.

Score components

Maintenance · 2020
last activity 0 days ago
Documentation · 1515
README 8092 chars, description present
Ready to use · 1515
install instructions: yes; releases: yes
Metadata · 1010
4/4 of description, homepage, license, topics
Releases · 1010
10 release(s), latest 45 days ago
Category confidence · 1010
classifier confidence 0.95
Adoption · 109
5744 stars (log-dampened, 10k = max)
License clarity · 55
SPDX Apache-2.0
Community · 55
issues enabled, 683 forks

License

Apache-2.0
Known licensefrom the repository host

This is the catalog policy status, not legal advice.

Sources

github.com/potpie-ai/potpiePrimary★ 5,744 starslast activity Oct 15, 2026Primary repository · Confidence 1.00

Reviews

Sign in to write a review

No reviews yet.

Alternatives

julepSimilar
Julep — durable, composable AI agents. Flows that crash and resume, retry safely, and explain every step.Apache-2.0 · Developer Tools
herdrSimilar
the runtime your coding agents live onApache-2.0 · Developer Tools
agentacctSimilar
See what your coding agents did and what it cost. Breaks each task down into work steps — tools used, files changed, tests run, time and tokens spent. Local-first dashboard for Claude Code, Codex, OpenCode, and more. No login, no telemetry.MIT · Developer Tools
supersetSimilar
Superset is an agentic IDE to orchestrate 100+ coding agents in parallel. Run any agent with your own subscription.Developer Tools
FalkorDBSimilar
A super fast Graph Database uses GraphBLAS under the hood for its sparse adjacency matrix graph representation. Our goal is to provide the best Knowledge Graph for LLM (GraphRAG).Developer Tools
OpenAgentsControlSimilar
AI agent framework for plan-first development workflows with approval-based execution. Multi-language support (TypeScript, Python, Go, Rust) with automatic testing, code review, and validation built for OpenCodeMIT · Developer Tools

README

From potpie-ai/potpie · license Apache-2.0 · fetched Oct 29, 2026

Potpie turns your codebase and software development lifecycle into a living context graph for AI agents. It indexes code, structure, decisions, source history, team knowledge and engineering workflows, so agents can answer questions, plan changes, debug failures, and write code with project-specific context.

[Potpie context graph demo]

Install and setup Potpie

Step 1: install the CLI through PyPI with uv or pip:

uv tool install potpie

or:

python3 -m pip install --user potpie

[!NOTE] uv tool install potpie is recommended for CLI installs because global mutation of Python packages is generally not recommended.

Step 2: Run the Potpie setup wizard

potpie setup

The setup wizard provisions local config, storage, the daemon, a default pot, and agent skills. It also lets you choose integrations and the coding harness Potpie should configure.

[Potpie setup wizard]

Step 3: Open your configured harness

Potpie is already integrated into your selected harness. You can start using Potpie with the repo of your choice.

Open your previously selected harness and ask it to use Potpie for the repo. [Potpie in OpenAI Codex]

[!NOTE] You don't need to run a separate manual ingest command. The CLI registers sources and the configured agent can ingest or update project context when the task requires it.

You can view your context graph in the web UI:

potpie ui

This will open a graph explorer in your browser. [Potpie web UI]

Basic CLI user checklist

The main CLI commands are:

CommandPurpose
potpie setupRun first-time local setup for config, daemon, default pot, and agent skills.
potpie loginSign in to Potpie for account-backed and managed features.
potpie github login / potpie linear loginConnect source integrations you want agents to use.
potpie statusShow context readiness for the active pot, including daemon, graph, and skill checks.
potpie auth statusShow configured integration auth status.
potpie auth status --verifyVerify integration credentials with lightweight API checks.
potpie doctorRun local diagnostics for daemon, backend capabilities, and skill drift.
potpie source add repo .Register the current repo as a source for the resolved pot.
potpie pot list / potpie pot use <id-or-name>List pots and choose the active workspace.
potpie resolve "<task>"Pull the context an agent should read before doing a task.
potpie search "<query>"Look up a specific file, workflow, bug, decision, or convention.
potpie record --type <type> --summary "<summary>"Write a durable project learning.
potpie graph ...Use lower-level graph reads, quality checks, proposals, and commits.
potpie uiOpen the local graph explorer served by the daemon.
potpie skills install --agent <agent>Install or refresh Potpie guidance for an agent harness.

Examples:

potpie setup --repo . --agent claude
potpie github login
potpie auth status
potpie status
potpie source add repo .
potpie resolve "what should I know before working in this repository?"
potpie search "authentication flow"
potpie record --type decision --summary "Prefer the Potpie CLI for graph work"

You can find an exhaustive list with more examples in our docs.

Integrations and Coding Harnesses

Potpie supports a variety of integrations and coding harnesses, with more coming. If your team needs a new integration or harness, please raise a ticket.

Integrations

ToolDescription
[GitHub]Index repositories, pull requests, issues, reviews and source history.
[Linear]Index teams, issues, projects and documents.
[Jira]Index projects, issues, status and changelog context.
[Confluence]Index spaces, pages, runbooks and decisions.

Coding harnesses

ToolDescription
[Claude Code]Install Potpie instructions and skills for Claude Code.
[OpenAI Codex]Install Potpie instructions and skills for OpenAI Codex.
[Cursor]Install Potpie instructions and skills for Cursor.
[OpenCode]Install Potpie skills for OpenCode.

Architecture

Potpie's current architecture is CLI-first. CLI is designed to be used by both humans and agents. Read the deeper architecture notes in docs/context-graph/architecture.md.

License

This project is licensed under the Apache 2.0 License. See LICENSE.

Community & Support

  • GitHub Issues: bugs and repository-scoped requests
  • Discord: community discussion and support
  • Docs: setup, product guides, and integration details

New contributions are always welcome. Read the Contributing Guide to set up your environment, understand the workflow, and open a pull request.

Open the repository ↗