😎

【Entire CLI】AIエージェントの「思考プロセス」をGitで完全管理！次世代の開発プラットフォーム解説

に公開
CLI
tech

昨今、Claude CodeやGemini CLIといったAIエージェントを活用した開発が一般的になりつつあります。しかし、「AIが生成したコード」は残っても、「どのようなプロンプトで、どのような推論を経てそのコードになったか」というコンテキストは失われがちです。

今回は、AIエージェントのセッションをGitワークフローに統合し、コードとその背景にある文脈を自動記録・管理できるEntire CLIについて詳しく解説します。

Entire CLI とは？

Entire CLIは、AIエージェント（Claude Code, Geminiなど）とのセッションを自動的に記録・管理する開発者向けプラットフォームです。

最大の特徴は、「コードの変更」と「AIの推論・コンテキスト」を統合的に管理できる点です。これにより、単にソースコードをバージョン管理するだけでなく、開発プロセスそのものを資産化することが可能になります。

主な特徴

  • Git完全統合: Gitフックを利用してバックグラウンドで動作。
  • 非破壊的: ビルドプロセスやCI/CD、依存関係に影響を与えません。
  • コンテキストの可視化: entire explain で、なぜその修正が行われたかをAIが解説。
  • タイムマシンのような操作: git stash 不要で、任意のチェックポイントへ巻き戻し可能。

アーキテクチャと仕組み

Entire CLIは、通常のコードコミットとは別に、独自のシャドウブランチ（entire/checkpoints/v1）を使用してメタデータを保存します。

ストレージ構造のイメージ

あなたのブランチ (mainなど)      entire/checkpoints/v1 (シャドウブランチ)
│                             │
▼                             │
[Base Commit]                 │
│                             │
│ ┌─── エージェントの作業 ───┐   │
│ │  Prompt / Response    │   │
│ │  File Changes         │   │
│ └───────────────────────┘   │
│                             │
▼                             ▼
[あなたのコミット] ──────────► [セッションメタデータ]
                              (トランスクリプト、プロンプト、
                               変更されたファイルのスナップショット)

セッションとチェックポイント

  • セッション: AIエージェントとの一連のインタラクション（プロンプト、レスポンス、ファイル変更、タイムスタンプ）を記録。
    • ID形式: YYYY-MM-DD-<UUID>
  • チェックポイント: セッション内の特定時点のスナップショット。「セーブポイント」として機能します。
    • ID形式: 12文字の16進数（例: a3b2c4d5e6f7）

2つの運用戦略 (Strategy)

Entire CLIには、チェックポイントを作成するタイミングを制御する2つの戦略があります。

  1. Manual-commit（デフォルト）
    • ユーザーまたはエージェントが git commit を実行したタイミングでチェックポイントを作成。
  2. Auto-commit（推奨）
    • エージェントの各レスポンス後に自動的にチェックポイントを作成。
    • コミットを意識せずに、粒度の細かいセーブポイントを確保できるため、AIコーディングにおいてはこちらが推奨されます。
# 推奨設定での初期化コマンド
entire enable --strategy auto-commit

主要コマンドリファレンス

1. セットアップ・基本

コマンド 説明
entire enable リポジトリでEntireを初期化し、Gitフックをインストール。
--agent: claude-code(既定) / gemini
--strategy: manual-commit(既定) / auto-commit
entire status 現在のセッション状態と戦略情報を表示。
entire version バージョン情報を表示。

2. セッション管理（タイムマシン機能）

コマンド 説明
entire rewind 強力なUndo機能。以前のチェックポイントを対話的に選択し、コードの状態をスナップバックさせます。git stash等は不要です。
entire resume 別のマシンやブランチで作業を再開する際に使用。最新のセッションメタデータを復元し、継続するための手順を表示します。
entire explain セッションやコミットの内容をAIが要約・解説。元のプロンプトと結果を紐付けて表示します。
entire reset 現在のHEADコミットに関連するシャドウブランチとセッション状態を削除します。

3. 保守・クリーンアップ

コマンド 説明
entire clean 孤立したシャドウブランチ、不完全なデータ、古い参照を削除してリポジトリを整理します。
entire doctor 問題のあるセッションをスキャンし、修正方法を提案します。
entire disable フックを削除し、記録を停止します（既存データは保持）。

実践ワークフロー例

実際にEntire CLIを使って開発を進める際の流れです。

Step 1: プロジェクトでの有効化

推奨の auto-commit 戦略で有効化します。

cd your-project
entire enable --strategy auto-commit

Step 2: AIエージェントによる開発

普段どおり Claude Code や Gemini CLI を使用します。Entireがバックグラウンドで全て記録しています。

claude "Reactコンポーネントのリファクタリングをして"

Step 3: 問題発生時の巻き戻し

AIが意図しない破壊的な変更を行った場合、即座に前の状態に戻せます。

entire rewind
# 対話形式で戻りたいポイントを選択

Step 4: 文脈の確認

「なぜこのように修正されたのか？」を確認したい場合、AIによる解説を生成します。

entire explain

Step 5: 別環境での作業再開

オフィスから自宅へ移動した場合など、別のマシンでもセッションを引き継げます。

git pull origin main
entire enable --force
entire resume
# 中断した箇所からスムーズに再開

まとめ：なぜEntire CLIを使うのか？

Entire CLIは、AIとのコーディングセッションを**「バージョン管理可能な資産」**に変えるツールです。

  • 「なぜ」が検索可能に: コードだけでなく、思考プロセスが残る。
  • マルチマシン対応: どのマシンからでも同じセッションコンテキストにアクセス可能。
  • 安心感: いつでも rewind できるため、大胆なAIリファクタリングも怖くありません。

AIネイティブな開発フローを構築したいチームや個人開発者にとって、必須のツールとなるでしょう。

Discussion