codeledger

CodeLedger

AI コーディングエージェントが作業を始める前に適切なリポジトリのコンテキストを与え、変更内容を検証します。

CodeLedger は、ローカルファーストの AI コーディングエージェント向けコンテキスト管理ツールです。リポジトリをスキャンし、タスクに関連するファイルを上限付きで選択して、エージェントが作業を始める前に、根拠に基づくコンテキストバンドルを作成します。

Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、その他の CLI または MCP 対応コーディングエージェントで利用できます。

試してみる

npm install -g @codeledger/cli
cd your-project
codeledger ready --task "Fix null handling in user service"

CodeLedger は必要に応じてリポジトリを初期化し、インデックスを更新して、タスク固有のバンドルを .codeledger/active-bundle.md に作成します。エージェントはまずこの成果物を読み込み、タスクに最も関連するファイルを把握してから作業を開始します。

実行時の分析は、デフォルトでローカルで行われます。インストール時やアップデート時には、npm や GitHub Releases からパッケージやリリース成果物を取得する場合があります。デフォルトでは、CodeLedger の実行時分析によってソースコードが CodeLedger のテレメトリーに送信されることはありません。

ベンチマークの例

中規模の Node.js サービスでの結果例です。結果はリポジトリ、タスク、エージェント、シナリオによって異なります。

指標	CodeLedger なし	CodeLedger あり	変化
テスト合格率	78%	94%	+16%
イテレーション数	4	2	-50%
変更ファイル数	17	9	-47%
完了までの時間	6m 12s	3m 40s	-41%
トークン使用量	28k	18k	-36%

ベンチマークの結果を鵜呑みにせず、ご自身のリポジトリで CodeLedger を測定してください。

codeledger compare \
  --scenario .codeledger/harness/scenarios/auth-rate-limit.json \
  --guided

CodeLedger によってコーディングエージェントのワークフローが改善した場合は、リポジトリにスターを付けて、リリース情報を確認し、ほかの開発者にも見つけてもらいやすくしてください。

まずはこちら

• はじめに
• CLI リファレンス
• 仕組み
• MCP サーバー
• 機能ティア
• セキュリティ
• コントリビューション
• 最新リリース
• npm パッケージ

仕組み

1. CodeLedger は、依存関係の構造、変更頻度、テスト、契約、タスクキーワードなど、決定論的なローカルシグナルをリポジトリからスキャンします。
2. タスクに関連するファイルを上限付きでランク付けし、パッケージ化します。
3. コーディングエージェント向けに .codeledger/active-bundle.md を作成します。
4. 作業後は、検証、レシート、セッションサマリーによって、変更内容や選択したコンテキストが役立ったかどうかを確認できます。

同じリポジトリの状態で同じタスクを実行すると、ファイルのランキングも同じになります。

主な機能

• エージェントに適切なコンテキストを提供： 決定論的なファイル選択、スコープ推定、上限付き予算、影響範囲のヒント、共同変更のコンテキスト。
• 作業を継続： セッションサマリー、チェックポイント、セッション中の再調整、引き継ぎ／復旧コマンド。
• エージェントをタスクの範囲内に維持： スコープ契約、意図のガバナンス、ループ検出、複数エージェント間の競合チェック。
• 作業内容を証明： レビューインテリジェンス、レシート、来歴、監査エクスポート、リリースの証拠。

利用可能なコマンドの全容については、CLI リファレンスをご覧ください。

エージェント連携

codeledger ready でリポジトリを初期化すると、Claude Code は CodeLedger のフックを利用できます。Cursor、Codex、GitHub Copilot、Gemini CLI、Aider、Windsurf、その他のエージェントは、CLAUDE.md と .codeledger/active-bundle.md を読み込むか、利用可能な場合はリポジトリ内のラッパーを使用できます。

CodeLedger には、対応ティア向けの MCP サーバーも含まれています。

codeledger mcp start
codeledger mcp status

設定方法とティアの詳細については、MCP サーバーおよび機能ティアをご覧ください。

信頼性と検証

• ランタイムのソース分析は、デフォルトでローカルに実行されます。
• ソースコードは、デフォルトでは CodeLedger のテレメトリーを通じて送信されません。
• ローカル CLI のフローでは、アカウントは不要です。
• 公開リリースには、SHA256SUMS とリリースの証拠資料が含まれます。
• codeledger doctor は、ローカルのインストール、フック、設定、インデックス、レジャーの状態を確認します。
• 公開ラッパー、ドキュメント、ハーネス、スキャン機能はこのリポジトリで確認できます。保護された強化ランタイムには LICENSE-CORE が適用されます。

インストール

npm install -g @codeledger/cli
codeledger --version

または、リリース ZIP を使用します。

1. 最新リリースをダウンロードします。
2. 展開します。
3. install.sh を実行します。

インストーラーは ZIP に同梱されたパッケージを使用するため、インストールされるラッパーのバージョンはリリースと一致します。その後、ラッパーは、環境に該当するものがすでに用意されていない限り、GitHub のリリースから対応する強化バイナリを取得します。

日常的なワークフロー

cd your-project
codeledger ready
codeledger ready --task "Fix null handling in user service"

初期化済みのリポジトリ内では、次のコマンドも使用できます。

codeledger activate --task "Fix null handling in user service"
codeledger doctor

ブラウザー、クラウド、サンドボックス環境では、初期化またはベンダリング後に .codeledger/bin/ にデプロイされたリポジトリ内のランタイムを使用できます。

アーキテクチャ

CodeLedger には、公開されている機能と保護された強化ランタイムがあります。

PUBLIC:    CLI wrapper, types, repo scanner, harness, reports, docs, hooks
PROTECTED: Scoring engine, selection algorithm, confidence internals

codeledger about、codeledger doctor、および各コマンドの --explain 出力を使うと、保護された実装の内部を公開せずに、動作と証拠を確認できます。

プライバシー

• インストールでは npm と GitHub Releases が使用される場合があります。
• ランタイム分析は、デフォルトでローカルマシン上で実行されます。
• ランタイム分析では、デフォルトでソースコードに関するテレメトリー呼び出しは一切行われません。
• ローカル CLI のフローでは、ソースコードをマシンの外部に送信する必要はありません。
• いつでもアンインストールできます。

ライセンス

• 公開ラッパー、型、リポジトリスキャン、ハーネス、レポート、ドキュメント、サンプル： MIT
• ダウンロードされる強化バイナリ：CodeLedger Core License

このリポジトリには MIT が適用される公開ファイルと、別途ライセンス条件が適用される保護ランタイムの両方が含まれているため、GitHub ではライセンス構成全体が「Other」に分類される場合があります。ライセンスファイルの変更は、法律の専門家が判断してください。

ContextECF の一部

CodeLedger は、Intelligent Context AI のコンテキスト制御アーキテクチャをソフトウェアエンジニアリングに適用します。アプリケーションやエージェント全体で、ガバナンスの効いたコンテキストを実現するエンタープライズ向けソリューションについては、ContextECF をご覧ください。

CodeLedger は Intelligent Context AI, Inc. が開発しています。codeledger.dev をご覧ください。