Repolode
potpie-ai

potpie-ai/potpie

コードベース、Issue、チームの知識をインデックス化するCLI主導のコンテキストグラフ。AIコーディングエージェントにプロジェクト固有の背景情報を提供します。

スター
5,748
フォーク
686
未解決の Issue
113
最終コミット
6 時間前

これは何?

Potpieは、コードベースとソフトウェア開発ライフサイクルから、コードの構造、意思決定、ソースの履歴、チームの知識、エンジニアリングのワークフローを網羅した、常に更新されるコンテキストグラフを構築します。コーディングエージェントはこのグラフに問い合わせることで、質問への回答、変更の計画、障害のデバッグ、プロジェクトに合ったコードの作成ができます。

このプロジェクトはCLIを中心に設計されており、人間とエージェントの両方が利用できます。セットアップウィザードでは、ローカル設定、ストレージ、デーモン、デフォルトのワークスペース(potと呼ばれます)、エージェントスキルを用意します。resolveやsearchなどのコマンドでタスクに必要なコンテキストを取得でき、recordコマンドではプロジェクトの知見を長期的に保存できます。ローカルのWeb UIからグラフを閲覧することもできます。

現在、GitHub、Linear、Jira、Confluenceと連携できます。対応するコーディングハーネスはClaude Code、OpenAI Codex、Cursor、OpenCodeです。PyPIで配布され、Apache 2.0ライセンスを採用しています。

主な機能

  • 01コードの構造、プルリクエスト、Issue、ソースの履歴を1つのコンテキストグラフにインデックス化します。
  • 02resolveコマンドとsearchコマンドで、エージェントがタスクに関連するコンテキストを取得できます。
  • 03recordコマンドを使って、エージェントがプロジェクトの意思決定や知見を長期的に記録できます。
  • 04GitHub、Linear、Jira、Confluenceの情報源に接続できます。
  • 05Claude Code、Codex、Cursor、OpenCode向けのエージェントスキルをインストールします。

ユースケース

  • 不慣れなリポジトリでコードを計画・編集する前に、コーディングエージェントへプロジェクトの背景情報を与える。
  • コードベース全体から、認証フロー、バグ、コーディング規約がどこにあるかを調べる。
  • アーキテクチャ上の意思決定を記録し、今後のエージェントセッションから参照できるようにする。
  • コードの履歴を関連するIssueやドキュメントと結び付けて、障害をデバッグする。

クイックスタート

  1. 1

    uv を使って PyPI から Potpie CLI をインストールします

    uv tool install potpie
  2. 2

    Potpie のセットアップウィザードを実行します

    potpie setup
  3. 3

    設定済みのコーディングハーネスを開き、リポジトリで Potpie を使うよう依頼します

使う前に知っておきたいこと

  • アカウント連携機能やマネージド機能を利用するには、Potpie へのサインインが必要です。
  • GitHub、Linear、Jira、Confluence などの連携には、接続用の個別の認証情報が必要です。

トピック

よくある質問

potpie とは?
コードベース、Issue、チームの知識をインデックス化するCLI主導のコンテキストグラフ。AIコーディングエージェントにプロジェクト固有の背景情報を提供します。 Potpieは、コードベースとソフトウェア開発ライフサイクルから、コードの構造、意思決定、ソースの履歴、チームの知識、エンジニアリングのワークフローを網羅した、常に更新されるコンテキストグラフを構築します。コーディングエージェントはこのグラフに問い合わせることで、質問への回答、変更の計画、障害のデバッグ、プロジェクトに合ったコードの作成ができます。
potpie は無料で使えますか?ライセンスは?
potpie は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
potpie は今もメンテナンスされていますか?
活発にメンテナンス中。potpie の最終コミットは 2026年10月22日 です。
potpie は何に使えますか?
不慣れなリポジトリでコードを計画・編集する前に、コーディングエージェントへプロジェクトの背景情報を与える。 コードベース全体から、認証フロー、バグ、コーディング規約がどこにあるかを調べる。 アーキテクチャ上の意思決定を記録し、今後のエージェントセッションから参照できるようにする。 コードの履歴を関連するIssueやドキュメントと結び付けて、障害をデバッグする。
potpie のインストール方法は?
uv を使って PyPI から Potpie CLI をインストールします: uv tool install potpie Potpie のセットアップウィザードを実行します: potpie setup 設定済みのコーディングハーネスを開き、リポジトリで Potpie を使うよう依頼します
potpie はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/potpie-ai/potpie

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト