このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。英語版

実行証拠

状態: 有効範囲: 現行状態最終確認: 2026-08-25 担当: AX Code ランタイム

すべての AX Code セッションは、実行中に記録されます。このページは、その記録をレビュー、比較、エクスポート、取り消しできるものに変えるコマンドを扱います。

エージェントが終わったあと、何をしたか、どれだけリスクがあったか、別の試みとどう比べるか、どう戻るかを答える必要があるときに使います。

記録されるもの

実行中、AX Code は独立した 2 つのものを書き込みます。

型付きイベントログ — ルーティングの決定、モデルの活動、ステップ境界、ツール呼び出し、ツール結果。これは graph、replay、compare、trace、audit の源です。
ファイルスナップショット — リポジトリの外、AX Code データディレクトリ配下の Git オブジェクトストアへ、refs/snapshots/<hash> を使って取得されます。作業ツリーとプロジェクトの .git/ は、それらを保存するために変更されません。

どちらもローカルです。何もアップロードされません。

実行を再構成する

ax-code graph <sessionID>

セッションを実行グラフとして再構築します。所要時間、リスク要約、トークン数、使ったエージェント、ツール呼び出しとタイミングを伴うすべてのステップです。

## Session ses_01H8XK

Duration: 9m 54s | Risk: HIGH (53/100) | Tokens: 167,650 in / 18,494 out
Agents: architect

### Step 1 (8s) | tokens: 12263/587

- read: api.ts → ok (5ms)
- grep: rateLimit → ok (12ms)

別のツールでグラフが欲しいとき、--format は Mermaid とトポロジ表示を含む代替出力を選びます。

これは セッション実行グラフ、つまりエージェントがしたことです。リポジトリのコードグラフではありません。それは ax-code index とコードインテリジェンスレイヤーです。

2 つの実行を比較する

ax-code session compare <sessionA> <sessionB>
ax-code session compare <sessionA> <sessionB> --deep

リスクの差分、変更されたファイル、ツール失敗の数、各実行が取った決定経路、イベント種別ごとの数を報告します。--deep は、再生比較を通してステップ単位の分岐分析を追加します。

これは実行を比較し、ソースコードは比較しません。「2 回目の試みの得点は悪かった。どこで分岐したか」に答え、「コードの差分を見せて」には答えません。

典型的な使い方は、同じタスクの 2 つの戦略の間で決めることです。

  Risk Comparison
  ----------------------------------------
  Score: 53 → 93 (+40) ↑
  Level: HIGH → CRITICAL
  Files: 8 → 25
  Failures: 0 → 15

記録されたイベントログを調べる

ax-code session replay <sessionID> --mode summary
ax-code session replay <sessionID> --mode verify
ax-code session replay <sessionID> --mode reconstruct
ax-code session replay <sessionID> --mode export

verify は記録されたログの一貫性を確認します。reconstruct はイベントからステップストリームを再構築します。export は移植可能な再生パッケージを書き出します。

再生は再構成します。再実行はしません。 モデルを再実行せず、ツールを再呼び出しせず、外部状態を再現しません。execute モードは、元と比較するための再構成ストリームをプログラム用に準備し、テスト向けであり、作業の再実行向けではありません。

リスク信号を読む

ax-code risk <sessionID>
ax-code risk <sessionID> --explain
ax-code risk <sessionID> --json

得点は、記録された信号から導かれる 決定的なヒューリスティック です。変更されたファイル数、変更が複数の最上位領域にまたがるか、失敗したツール呼び出しの数、検証が走ったか、差分スナップショットが存在するか、影響を受ける API 表面の大きさ、実行がどう終わったか（ブロックされた完了ゲート、またはステップ上限や停滞による終了はどちらも重みを足します）、セキュリティに敏感なパスに触れたか、が含まれます。寄与する各要因は重みとともに列挙され、提案される緩和も付きます。

これはレビューの補助です。確率でも、較正された信頼度でも、コードが安全だという声明でもありません。未検証の変更に対する LOW 得点は、その変更が未検証であることのままです。

正確に取り消す

ファイルスナップショットは、Git がインストールされ snapshot が有効なとき、Git リポジトリと通常のプロジェクトディレクトリで働きます。AX Code はスナップショット用 Git ストアをプロジェクトの外に保ちます。プロジェクトの .git ディレクトリは作りません。無視ルールと、非対応パスの除外は引き続き適用されます。

TUI の Revert は、メッセージと取得されたファイル変更を取り消します。snapshot: false がある場合、またはベースラインを一度も取得しなかった古いターンでは、メッセージだけを取り消せます。ファイル編集はディスクに残ります。今スナップショットを有効にしても、以前のファイル内容は再構成できません。ファイル変更のない取得済みターンにも、戻すものはありません。

ax-code session rollback <sessionID> --list      # show recoverable points
ax-code session rollback <sessionID> --dry-run   # show what would change
ax-code session rollback <sessionID> --step 4    # restore one step
ax-code session rollback <sessionID>             # restore the whole session

--list は、耐久性のあるステップイベントと実行グラフの詳細を組み合わせるため、実行全体を戻すのではなく特定のステップを対象にできます。--dry-run は apply と同じロールバック計画を使い、結果にファイル台帳が寄与する委任セッションを列挙します。

ロールバックは、親の正確な作業ディレクトリへ書き込んだとき、入れ子の子セッションに従います。それらの境界後のファイル変更を復元し、トランスクリプトは保持します。別の worktree やディレクトリで動いている子孫は除外され、含まれるセッションがまだ実行中なら、ロールバックはフェイルクローズドになります。

頼る前に知っておくべき境界: ロールバックは、実行中に取られたスナップショットから復元します。セッションの外で変更された、または回復可能な状態になかったために一度もスナップショットされなかったファイルは、この方法では復元できません。影響の大きいものには、先に --dry-run を使ってください。

別の戦略を試す

ax-code session branch <sessionID>
ax-code session branch <sessionID> --from <messageID>

セッションの保存状態をフォークし、2 回目の試みが最初からではなく、選んだ地点から始まるようにします。

これは セッション状態、つまりメッセージとゴールをフォークします。Git ブランチでも worktree でもありません。隔離された Git 候補については、検証済みの複数モデル変更を参照してください。

診断する

ax-code session trace <sessionID>
ax-code session trace <sessionID> --logs

リスク得点付きタイムラインを伴う、再生に裏付けられた診断です。--logs は、再生イベントではなく従来のログファイル分析へ切り替えます。変更のレビューではなく運用上の問題を調べているときに有用です。

証拠をエクスポートする

ax-code audit export --all --since 2026-08-01     # JSON Lines
ax-code audit export --all --risk HIGH            # filter by minimum risk
ax-code audit report <sessionID>                  # Markdown report
ax-code audit otlp <sessionID>                    # OpenTelemetry spans
ax-code audit prune --days 90                     # delete old events

JSONL と OTLP は、実行記録を自分のレビューまたは可観測性パイプラインで消費できるようにします。Markdown レポートは、PR や変更記録に証拠を付ける人向けです。

閲覧する

ax-code run-report                 # latest session
ax-code run-report --index         # session index

実行要約、タイムライン、変更、検証状態、リスク詳細、ブランチ情報、ロールバック地点とともに、ローカルの実行レポートをブラウザで開きます。サーバーはループバックにのみバインドします。

ゴール保証 — 長いゴールのための実行可能な受け入れチェックとソースの鮮度
AX Code を選ぶ理由 — この証拠レイヤーの目的
検証済みの複数モデル変更 — 比較する価値のある候補を作る
セマンティックレイヤー — グラフと LSP の回答に付く来歴エンベロープ
実行レポート — ワークスペース単位の表示とセッションごとのレポート