Agentpack

Agentpack

AI コーディングエージェントのための、リポジトリに根ざしたタスク継続機能です。

エージェントのメモリは、作業の進め方を覚えます。Agentpack は、タスクがどこまで進んだかを覚えます。

エージェントがタスクに1時間取り組みました。原因を突き止め、2つのアプローチを退け、次の手順を書き留めました。その後、コンテキストが圧縮されたり、チャットが終了したりしました。次のセッションはゼロから始まり、同じ調査を繰り返します。

Agentpack はタスクの状態をリポジトリ内に保持します。接続されたエージェントは作業中に、目標、決定事項、行き詰まった方法、検証の証拠、チェックポイントを .agentpack/ に記録します。次のセッションではその状態を読み込み、続きから再開できます。圧縮後の同じエージェントでも、別のクライアントでも、翌週のあなたでも同様です。

実際の動作を紹介します。セッション1では、エージェントが不安定なテストに取り組み、Agentpack MCP ツールを使って決定事項、行き詰まった方法、チェックポイントを記録します。翌日のセッション2では、コンテキストが空の状態でも、load_context を1回呼び出すだけでタスクを再開できます。

▶ 音声付きの80秒の解説を見る

CLI から同じ手順を手動で試すには、docs/DEMOS.md をご覧ください。

• ローカルファースト。 リポジトリ内のプレーンファイルを使います。クラウド、テレメトリー、ネットワーク呼び出しはありません。
• エージェント向け。 ローカル MCP サーバーと、生成されたプロジェクト指示（AGENTS.md、CLAUDE.md、Cursor ルール）が、状態を読み込んで記録するタイミングをエージェントに伝えます。
• 人にも開かれています。 CLI に同じ状態が表示されるため、自分で確認、修正、引き継ぎができます。

エージェントメモリとはどう違いますか？

Claude Code のメモリ、Codex のメモリ、CLAUDE.md や AGENTS.md は、作業の進め方を保持します。つまり、好み、プロジェクトの規約、変わらない事実です。Agentpack は、作業の進捗状況を保持します。つまり、現在のタスクの目標、制約、決定事項、行き詰まった方法、次のアクション、検証結果です。

	エージェントメモリ	Agentpack
保持する内容	好み、規約、長期にわたって有効な事実	1つのタスクの状態
保存場所	1つのクライアントのプロファイルまたはアカウント	リポジトリ内の .agentpack/。デフォルトではローカルに保存され、タスクバンドルで持ち運べます
読み取る対象	そのクライアントのみ	任意の MCP クライアント：Claude Code、Codex、Cursor、Claude Desktop
形式	関連性に基づいて呼び出される自由形式のメモ	タスクごとの Task Passport：目標、ライフサイクル、変更可能なパス、コミットに紐づいた検証
古さへの対応	ファイルの変更と連動しません	ファイルについてのメモにはファイルハッシュが保存されるため、ファイルが変更されると Agentpack がメモにフラグを立てます

両方を使いましょう。メモリは、あなたがどのように作業したいかを保持します。Agentpack は、タスクを次に進めるために必要なことを保持します。

クイックスタート

Agentpack には Node.js 20 以降が必要です。

npm install -g agentpack-cli

cd path/to/your/repo
agentpack init                     # once per repo
agentpack install claude --write   # per client: codex | claude | cursor | claude-desktop
agentpack install git-hooks --write  # optional: task gate check before each commit

コーディングエージェントを再起動するか再接続し、クライアントから求められたら Agentpack サーバーまたはフックを承認してください。それ以降、エージェントはセッション開始時にタスクの状態を読み込み、作業中に決定事項や証拠を記録し、重要な節目でチェックポイントを作成します。

セットアップを確認するには、agentpack doctor を実行してください。タスクの状態を自分で確認するには、agentpack resume --preset agent --query "<topic>" を実行してください。

Git リポジトリでは、init によってローカルの Agentpack ファイルが .git/info/exclude に追加されます。リストには .agentpack/、.mcp.json、.claude、.codex、.cursor、AGENTS.md、CLAUDE.md が含まれます。Agentpack は .gitignore を変更しません。Git がすでに追跡しているファイルは、引き続き追跡されます。

各クライアントについて、docs/INTEGRATIONS.md にインストーラーが何を書き込むか、その理由が示されています。

仕組み

1. セッション開始時に、エージェントはコンパクトな要約を読み込みます。内容は、現在の Task Passport、最近のチェックポイント、決定事項、ソースに関する結論です。
2. 作業中、エージェントは残しておく価値のある情報を記録します。決定事項、うまくいかなかった方法、検証の証拠などです。また、ソースに関する結論も記録できます。これはファイルのハッシュとともに保存される、そのファイルの役割についての短いメモです。後でファイルが変更されると、Agentpack が結論にフラグを立てます。ハッシュが一致していることから分かるのはファイルが変更されていないことであり、結論が正しいということではありません。
3. 作業を自然に中断するタイミングで、エージェントはステータス、次のアクション、Git の状態を含むチェックポイントを作成します。
4. 次のセッションでは、どの MCP クライアントでも、その状態から作業を続けられます。チャット履歴からタスクを再構築する必要はありません。

各タスクには、目標、ステータス、制約、書き込み範囲（タスクで変更できるパス）、次のアクション、検証を記した Task Passport があります。タスクを開始、一時保留、切り替え、完了できるため、引き継ぎが明確になります。

タスクゲートは、現在の Passport に照らして編集を確認します。クライアント用インストーラーは、Claude Code、Codex、Cursor 向けのネイティブフックを追加します。install git-hooks は、コミット前チェックを追加します。デフォルトでは、ゲートは警告のみを出します。.agentpack/config.json の "gateMode" を "block" に設定すると、書き込み範囲外またはアクティブなタスクの範囲外での編集を停止できます。"off" に設定すると、ゲートが無効になります。フックは安全策であり、サンドボックスではありません。docs/CLI.md を参照してください。

要約はトークン予算内に収まります。エージェントが受け取るのは、履歴全体ではなく、役立つ状態情報です。

その他の機能

• タスクバンドル。 タスクを 1 つの JSON ファイルにエクスポートし、新しいクローンや別のマシンにインポートできます。docs/TASK-PASSPORT.md を参照してください。
• 複数のリポジトリにまたがるタスク。 1 つの Passport で、複数のリポジトリにまたがる変更を対象にできます。各リポジトリには、それぞれの書き込み範囲を設定できます。
• モノレポのフォーカス。 モノレポの各部分（api/、frontend/、cron/）に、それぞれの書き込み範囲を持つ短いタスクを割り当てられます。エージェントがその範囲を外れると、タスクゲートが警告します。
• 使用状況レポート。 agentpack usage report は、ローカルにある Claude Code と Codex のトランスクリプトを読み込み、Agentpack の使用分も含めたタスクのトークン使用量を表示します。マシンの外部にデータが送信されることはありません。
• 読み取り専用インスペクター。 agentpack tui は、タスク、証拠、チェックポイントをターミナルに表示します。docs/TUI.md を参照してください。
• ビルダーサブエージェント。 Codex、Claude Code、Cursor のインストールには、大規模な実装作業向けのオプションのビルダーが含まれます。メインのエージェントは、ビルダーを使う前に、何を引き継ぐかを伝えます。小さなタスクはメインのエージェントが担当します。

役立つ場面

• タスクの途中でコンテキストが圧縮され、次のターンで状態を復元する必要があるとき。
• まだ開いているタスクについて、新しいチャットを始めるとき。
• Claude Code、Cursor、Codex、または別の MCP クライアントに切り替えるとき。
• 数日後にリファクタリングやバグ修正に戻るとき。
• 別のエージェントがチェックポイントから作業を引き継ぐとき。

Agentpack のコンテキストもトークンを使用します。コンパクトな出力により、台帳の履歴全体を含めずにタスクの状態を把握できます。

セキュリティ体制

• ランタイム依存関係はゼロで、開発依存関係を厳密に固定し、ロックファイルをコミットしています。また、ignore-scripts=true を設定しています。
• 通常の CLI または MCP の動作中に、テレメトリやネットワーク通信はありません。
• 保存されるコンテキストと引き継ぎ出力では、シークレットらしき値をベストエフォートで秘匿します。
• GitHub Actions は、各リリースを npm provenance 付きで公開します（Trusted Publisher を使用し、長期間有効なトークンは使用しません）。検証するには、npm audit signatures を実行してください。

Agentpack がリポジトリ外で読み取る情報を含むポリシー全文については、SECURITY.md をご覧ください。

ドキュメント

• docs/INTEGRATIONS.md：Codex、Claude Code、Cursor、Claude Desktop、Git フックのセットアップ
• docs/TASK-PASSPORT.md：タスクのライフサイクル、引き継ぎ、追加リポジトリ、タスクバンドル
• docs/CLI.md：CLI の完全なリファレンス、予算、手動ワークフロー
• docs/MCP.md：MCP サーバーの仕様とツール
• docs/DEMOS.md：自分で実行できる短い継続性デモ
• docs/TUI.md：読み取り専用のターミナルインスペクター
• docs/LEDGER-HYGIENE.md：台帳を小さく、役立つ状態に保つ方法

コントリビューション

リポジトリをクローンし、Node.js 20 以降を使用してください：

npm ci --ignore-scripts
npm test
npm run mcp:smoke
node dist/src/agentpack.js --help

開発環境のセットアップについては docs/SETUP.md を、リリース手順については docs/RELEASING.md をご覧ください。

---

ミラー：Codeberg。Issue、リリース、npm provenance は GitHub にあります。