Repolode
提交项目
potpie-ai

potpie-ai/potpie

一个以 CLI 为核心的上下文图谱，为 AI 编码代理索引代码、工单和团队知识，让代理掌握项目背景。

在 GitHub 查看官网
Star
5,748
Fork
686
未关闭 Issue
113
最近提交
7小时前

这是什么？

Potpie 将代码库及其软件开发全流程构建为一张持续更新的上下文图谱，涵盖代码结构、设计决策、源码历史、团队知识和工程工作流。编码代理可以查询这张图谱来回答问题、规划改动、排查故障，并编写符合项目风格的代码。

项目以 CLI 为核心，同时面向人和代理设计。运行 potpie setup 后会自动配置本地环境、存储、守护进程、默认工作区（称为 pot）以及代理技能。resolve 和 search 命令可在执行任务前拉取相关上下文，record 命令则用于记录可持久保存的项目经验。另外提供本地 Web 界面，可浏览图谱。

目前支持的集成包括 GitHub、Linear、Jira 和 Confluence，支持的编码工具有 Claude Code、OpenAI Codex、Cursor 和 OpenCode。项目通过 PyPI 发布，采用 Apache 2.0 许可证。

核心功能

  • 01将代码结构、Pull Request、工单和源码历史索引到同一张上下文图谱中。
  • 02提供 resolve 和 search 命令，为代理拉取与任务相关的上下文。
  • 03通过 record 命令让代理记录可持久保存的项目决策和经验。
  • 04可接入 GitHub、Linear、Jira 和 Confluence 作为数据源。
  • 05为 Claude Code、Codex、Cursor 和 OpenCode 安装代理技能。

适用场景

  • 在陌生代码库中，让编码代理在规划或修改代码前先获取项目背景。
  • 在整个代码库中查找认证流程、缺陷或编码规范所在位置。
  • 记录架构决策，供之后的代理会话引用。
  • 结合代码历史与相关工单、文档排查故障。

快速上手

  1. 1

    使用 uv 从 PyPI 安装 Potpie CLI

    uv tool install potpie
  2. 2

    运行 Potpie 设置向导

    potpie setup
  3. 3

    打开已配置的编码工具，并让它为该仓库使用 Potpie

使用前须知

  • 部分账户相关和托管功能需要登录 Potpie 账户。
  • GitHub、Linear、Jira 和 Confluence 等集成需要单独的凭据才能连接。

标签

#ai-agents#knowledge-graph#context-engineering#developer-tools#code-search#rag#cli#agents#ai-agents-framework#artificial-intelligence

常见问题

potpie 是什么？
一个以 CLI 为核心的上下文图谱，为 AI 编码代理索引代码、工单和团队知识，让代理掌握项目背景。 Potpie 将代码库及其软件开发全流程构建为一张持续更新的上下文图谱，涵盖代码结构、设计决策、源码历史、团队知识和工程工作流。编码代理可以查询这张图谱来回答问题、规划改动、排查故障，并编写符合项目风格的代码。
potpie 可以免费使用吗？用的什么许可证？
potpie 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
potpie 还在维护吗？
活跃维护中。potpie 最近一次提交是在 2026年10月22日。
potpie 适合用来做什么？
在陌生代码库中，让编码代理在规划或修改代码前先获取项目背景。 在整个代码库中查找认证流程、缺陷或编码规范所在位置。 记录架构决策，供之后的代理会话引用。 结合代码历史与相关工单、文档排查故障。
potpie 怎么安装和运行？
使用 uv 从 PyPI 安装 Potpie CLI: uv tool install potpie 运行 Potpie 设置向导: potpie setup 打开已配置的编码工具，并让它为该仓库使用 Potpie
在哪里获取 potpie？
源代码和安装说明在 GitHub 上：https://github.com/potpie-ai/potpie

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目