AgentTape

1 回の失敗した Codex 実行を、ポータブルな回帰テストに変える。

AgentTape は、オープンソースでローカルファーストの Codex プラグインです。サポートされているツールの失敗を、編集（redaction）済みでバージョン管理された .tape エビデンスとして記録します。何が失敗したかを調べ、キャプチャした実行を制御された境界でフォークし、その結果を、追加のモデル呼び出しなしで CI で実行できるオフライン回帰テストとして保存します。

ほとんどのトレースツールは、失敗を観察するのに役立ちます。AgentTape は、その失敗を、同じバグの再発を防ぐ、小さくレビュー可能なアーティファクトに変えるために作られています。

Codex tool failure
        ↓
redacted .tape evidence
        ↓
inspect → inject one condition → compare branches
        ↓
save assertions → run offline in CI

AgentTape を選ぶ理由

• ダッシュボードではなく、失敗のアーティファクト。 .tape は、バグ修正と一緒に検査、レビュー、共有、コミットできるポータブルなエビデンスです。

• Codex ネイティブのキャプチャ。 バンドルされたフックは、ユーザーがレビューして信頼した後に、サポートされているライフサイクル、権限、ツールのイベントを記録します。アプリケーションの計装は不要です。

• ローカルでプライバシーに配慮。 ランタイムのキャプチャはアクティブなプロジェクト内に留まり、一般的な秘密情報を含むフィールドはエクスポート前に再帰的に編集（redaction）されます。

• 制御された失敗の注入。 権限拒否、タイムアウト、不正な JSON、切り詰められたレスポンスの結果で、記録されたエビデンスをフォークします。

• オフライン回帰テスト。 構造的リプレイとアサーションは、モデル呼び出しゼロ、ライブツール呼び出しゼロでキャプチャされたエビデンスを使用します。

• 正直なリプレイ信頼度。 AgentTape は、すべての外部システムを完全に再現できると主張するのではなく、カバレッジと制限を報告します。

Related MCP server: MCP QA Lab

GitHub からインストール

前提条件: Codex と Node.js 20 以降。

codex plugin marketplace add jiangkoumo/agenttape
codex plugin add agenttape@agenttape

インストール後、新しい Codex タスクを開始し、バンドルされたフックを信頼する前にレビューしてください。キャプチャは、アクティブなプロジェクトの .agent-tape/ ディレクトリの下に保存されます。

2 分でできるワークフロー

まず、サポートされているローカルツールの呼び出しが失敗するまで、通常どおり Codex を使用します。次に、次のように尋ねます:

Use tool search to find AgentTape. List captured runs, inspect the latest
failed run, and explain the first recorded failure and replay confidence.

AgentTape は 4 つの MCP ツールを公開します:

保存された回帰テストをローカルまたは CI で実行します:

node plugins/agenttape/scripts/agenttape.mjs test \
  tests/agenttape/fixture_permission_denied-timeout.tape

アサーションが成功すると、コード 0 で終了します。検証またはアサーションの失敗は非ゼロで終了し、キャプチャされた比較値は失敗出力から除外されます。

.tape がキャプチャするもの

Tape v1 は、構造的デバッグに必要なエビデンスを保持します:

• 実行 ID、タイムスタンプ、ソースカバレッジ、明示的な制限。

• 順序付けられたライフサイクル、権限、サポートされているローカルツールのイベント。

• ツールの入力、出力、明示的な失敗、最初の失敗境界。

• 値が削除された場所を記録する編集（redaction）マニフェスト。

• オプションのフォークメタデータ、注入された条件、構造的アサーション。

• リプレイ信頼度の入力。コンシューマーが強いエビデンスと再生専用トレースを区別できるようにします。

tape スキーマは UI やレコーダーの実装から独立しています。Tape Schema v1 を参照してください。

回帰アサーション

AgentTape は現在、以下の決定的なチェックをサポートしています:

• フィールドが期待値と等しい。

• ツールが存在する、または存在しない。

• リトライ回数が最大値を下回っている。

• 最終的な実行ステータスが期待されるステータスと一致する。

• リプレイ信頼度が最小しきい値を満たしている。

レビュー済みの回帰アーティファクトは tests/agenttape/ の下に書き込まれ、デフォルトでは上書きされません。

リプレイの境界

AgentTape は現在、完全なエージェントの再実行ではなく、構造的リプレイを提供します。キャプチャされた状態を再利用し、記録された 1 つのツール結果を置き換え、注入された境界で停止します。下流のモデル推論を再生成することはありません。

ホスト型ツール、キャプチャされていない外部状態、サードパーティシステムの変更は存在しない可能性があります。編集（redaction）マーカーは、AgentTape のレダクターが実行されたことを証明しますが、任意の自由形式テキストに秘密情報が含まれていないことを証明することはできません。共有する前に、すべての .tape をレビューしてください。

完全な信頼境界については、プライバシー と セキュリティ を参照してください。

リポジトリ構成

plugins/agenttape/
  .codex-plugin/plugin.json   # Codex plugin manifest
  hooks/hooks.json            # Recorder lifecycle hooks
  skills/capture-failure/     # Guided capture workflow
  dist/mcp-server.mjs         # Self-contained bundled MCP server
  scripts/                    # Recorder, schema, and assertion CLI
  schemas/                    # Versioned .tape schema

リポジトリには、src/ の下にオプションの Branch Canvas プロトタイプと、remote/ の下に実験的なステートレス HTTP MCP も含まれています。これらは同じ tape とリプレイの概念を使用していますが、Codex プラグインのインストールや使用には必要ありません。

ローカル開発

git clone https://github.com/jiangkoumo/agenttape.git
cd agenttape
npm ci
npm run test:plugin-release
npm run build:plugin
codex plugin marketplace add .
codex plugin add agenttape@agenttape

コミットされた plugins/agenttape/dist/mcp-server.mjs により、マーケットプレイスからのインストールはリポジトリをビルドせずに実行できます。MCP ソースを変更するときは、再ビルドしてコミットしてください。

オプションの Branch Canvas、Sites adapter、またはリモート HTTP MCP サーフェスを変更するときは、npm test と npm run build を実行してください。

アンインストール

codex plugin remove agenttape@agenttape
codex plugin marketplace remove agenttape

コントリビューション

Issue とプルリクエストを歓迎します。コントリビューション、行動規範、変更履歴 を参照してください。

ライセンス

MIT。LICENSE を参照してください。