LeanToken

LeanToken

エージェント向けのコードインテリジェンス：重要なコードを見つけて、コンテキストウィンドウとトークンを節約します。

**言語：**英語 · 簡体字中国語 · 日本語 · 韓国語

• MCP Registry 名：mcp-name: io.github.morluto/leantoken

インストール · LeanToken を選ぶ理由 · ツール · CLI · 仕組み · ドキュメント

トークン削減量の実測値： 60 回の実行による統制された調査では、リポジトリの探索を限定した場合、LeanToken はエージェント組み込みツールよりモデルへの入力トークンを 20.1% 削減しました。また、広範囲に探索した場合は、これらのツールより 37.6% 削減しました。測定方法の詳細は、測定手法をご覧ください。

クイックスタート

LeanToken を Claude Code、Cursor、OpenCode、Codex、Gemini CLI、または Antigravity に追加します：

npx leantoken setup

設定したクライアントを再起動または再読み込みしてから、リポジトリで接続と最初の検索結果を確認します：

npx leantoken doctor

次のような広範なタスクを試してください：編集前に、リクエストのキャンセルに関連するコードを見つけます。 LeanToken を使うと、エージェントは leantoken.context から作業を開始でき、編集、ビルド、テストには通常のツールも引き続き利用できます。

リポジトリ内で観測された LeanToken のトークン使用量を確認します：

npx leantoken savings

npx leantoken setup --claude --codex --yes
npx leantoken setup --all --yes

npx leantoken setup --codex --cursor --dry-run

npx leantoken remove

npx leantoken runtime list
npx leantoken runtime prune --dry-run
npx leantoken runtime prune --yes

npx --yes leantoken@latest setup --refresh --yes
npx --yes [email protected] setup --refresh --yes --allow-outdated

LeanToken は、リポジトリ全体を一度にダンプするのではなく、小さなエビデンスループとして使うのが最も効果的です。

1. 1 回の呼び出しで、自律的なトリアージの全体像を把握します。 範囲が広く不確かなタスクを始めるときは、context と plan_only: false を指定し、具体化されたエビデンスをそのまま使います。追加のフォローアップは、カバレッジによって実装や回帰テストの担当箇所が具体的に不足していると特定された場合に限り、焦点を絞って最大 1 回行います。
2. ソースを再送せずに続行します。 次の context 呼び出しでは前回の receipt_id を渡すか、返されたフラグメントハッシュを known_hashes として渡します。レスポンスでは、同じエビデンスに対して黙って再度コストを発生させるのではなく、完全に重複する省略分と一部重複する省略分が報告されます。
3. 確認された障害を調査します。 investigation ワークフローを使い、直接観測された failure_traces、パス、シンボル、またはテストの意図のみを workflow_evidence に指定します。続けて、エビデンスで特定された担当箇所に対し、正確な search、outline、または read 呼び出しを行います。
4. 変更をレビューします。 base_revision に BASE..HEAD を設定し、strict_changed_paths: true を指定して review ワークフローを使います。別のエージェントがコピーされたソース本文なしで、選択済みハッシュ、変更パス、前提条件、完了した検証をまとめた簡潔なマニフェストを必要とする場合は、handoff をリクエストします。

この 1 回の呼び出しという契約は、自律的なリポジトリのトリアージを対象としたものであり、実装エージェントへの制限ではありません。人によるレビューや制御プレーンのワークフローでは、具体化の前に plan_only: true を使って、コストの高い取得やリスクの高い取得を引き続きプレビューできます。複数エージェントによるコンテキストの反復テストでは、反復的な LeanToken プロファイルは thin native より入力総量が 50.9% 多い一方、固定した「1 回の context と、任意の 1 回の search」というプロファイルでは 20.1% 削減され、パスセットの成功率は 15/20 でした。これらの結果は、条件を固定した 4 つのトリアージタスクを対象としており、あらゆる実装ワークフローに当てはまることを証明するものではありません。

明示的なフォーカス制約は契約です。リクエストで focus_paths、正確な focus_symbols、および minimum_fragments_per_focus_path が指定されている場合、LeanToken は文書化されたファイルごとの上限内で候補を生成し、異なる範囲では最小数を満たせない場合にカバレッジエラーを報告します。説明プロファイルのプランと具体化されたレスポンスでは、ランキングを変更することなく、各フォーカス候補を生成、予約、選択、または抑制した上限付き割り当ての境界も特定します。

LeanToken を使う理由

多くのエージェントは、まず広範囲に検索し、ファイル全体を読み込みます。LeanToken は、そうした作業を段階的に絞り込みます。

コーディングエージェントは、編集、コマンド、テスト、会話を引き続き担当します。LeanToken は、そうしたタスクに必要なコードを見つけて返します。

LeanToken は、巨大なプロンプトファイルを 1 つ作るわけではありません。エージェントが必要とする範囲に絞って、検索と読み取りに応答します。

例

シャットダウン中のリクエストキャンセルを修正するといったタスクでは、上限を設けた結果の例は次のようになります。

Budget: 1,200 source tokens

Selected evidence:
  src/services/executor.rs        lines 137-147, 251-259
  src/services/reconciliation.rs lines 148-175, 257-272

エージェントは、両方のファイル全体ではなく、これらの範囲を受け取ります。予算が小さすぎる場合は、何が除外されたかもレスポンスに記載されます。パス、スコア、レシート、JSON、MCP トランスポートラッパーは、このソーストークン予算には含まれません。測定境界については、トークンの計上を参照してください。

利用可能なツール

すべてのツールの説明とスキーマもモデルのコンテキストを消費するため、 カタログは意図的に小さく保たれています。

CLI の使用方法

npx を使って LeanToken を直接実行します。

npx leantoken status
npx leantoken savings
npx leantoken doctor
npx leantoken --root /path/to/repo search handle_request

または、グローバルにインストールしたバイナリを使用します。

npm install --global leantoken@latest

leantoken --root /path/to/repo index
leantoken --root /path/to/repo search handle_request --mode identifier --max-tokens 800
leantoken --root /path/to/repo context \
  --task "fix request cancellation during shutdown" \
  --budget 2000

リポジトリのインデックスを開かずに、既存の秘匿化済み実験またはホストの レポートを監査します。

leantoken episode audit \
  --adapter multi-agent-suite-v1 \
  --input benchmarks/reports/multi-agent-context-suite-v1-codex-0.144.1.json

デフォルトの出力形式は Markdown です。安定した正規化 JSON スキーマを使うには、 グローバルオプション --json を追加します。監査ツールはローカルで動作し、 入力に対して処理範囲が限定され、読み取り専用です。生のプロンプト、ソース、 ツール引数、ツール出力は保持せず、アーティファクトのハッシュを保持します。

npm install leantoken を実行すると、コマンドは現在のプロジェクトの node_modules/.bin にインストールされますが、シェルの PATH に leantoken が追加されるわけではありません。プロジェクトローカルの インストールは、npx leantoken、パッケージスクリプト、または ./node_modules/.bin/leantoken から実行してください。

stdio 経由で MCP サーバーを手動で実行します。

leantoken --root /path/to/repo mcp

{
  "mcpServers": {
    "leantoken": {
      "command": "leantoken",
      "args": ["--root", "/path/to/repo", "mcp"]
    }
  }
}

Cargo 配布版では、公開済みのクレートをインストールし、生成された実行ファイルを MCP クライアントに指定します。

cargo install leantoken --version VERSION
leantoken --root /path/to/repo mcp

公式 MCP Registry のエントリは io.github.morluto/leantoken です。Cargo パッケージに対応する Registry クライアントでは、該当するバージョンの leantoken をインストールし、上記の mcp コマンドを使用できます。

インストール方法

npm パッケージには、以下のプラットフォーム向けのネイティブバイナリが含まれています。

• ARM64 および x64 の macOS
• ARM64 および x64 の glibc Linux
• x64 の Windows

インストール時にライフサイクルスクリプトが実行されることも、postinstall フックから実行可能ファイルがダウンロードされることもありません。musl Linux など、その他のターゲットではソースからビルドする必要があります。 Rust 1.95 以降とネイティブの C/C++ ツールチェーンをインストールし、次を実行してください。

cargo install --locked --git https://github.com/morluto/leantoken leantoken

更新

npx で作成した MCP エントリーは、設定時に使用した正確な LeanToken のバージョンに固定されます。既存のクライアント連携は明示的に更新してください。

npx --yes leantoken@latest setup --refresh --yes

グローバルにインストールした CLI、または Cargo でインストールした CLI の場合：

leantoken upgrade --check
leantoken upgrade --yes

update は upgrade のエイリアスです。プロジェクトローカルに npm をインストールした場合：

npm install leantoken@latest

固定された MCP エントリーが暗黙に @latest に移行することはありません。正確なパッケージがローカルにもオンラインにもない場合、別のバージョンを選択するのではなく、起動に失敗します。CLI を更新しても既存の MCP エントリーは変更されません。ロールバック、キャッシュ管理、バージョンの詳細については、使用ガイドを参照してください。

キャッシュ管理

ローカルリポジトリのキャッシュを確認するか、クリーンアップを適用する前にプレビューしてください。

leantoken cache list
leantoken cache list --summary
leantoken cache list --incompatible-with-current
leantoken cache prune --incompatible-with-current
leantoken cache compact --id v15-0123456789abcdef --dry-run
leantoken cache prune --older-than 30 --dry-run
leantoken cache prune --max-total-bytes 1073741824 --yes

キャッシュの状態、ページネーション、安全なクリーンアップのルールについては、使用ガイドを参照してください。

仕組み

repository
    │
    ▼
file discovery ──► code structure extraction ──► local search index
                                                    │
                                                    ▼
agent request ──► ranked / exact retrieval ──► focused code within a token budget

LeanToken はソースを一度インデックス化し、簡潔なパス、順位付けされた一致箇所、構造的なアウトライン、正確なソース範囲、タスクに応じたコンテキストを提供します。ターンをまたいで変更のない情報を再送信することを避けます。

依存関係の多いワークスペースでは、既定のリポジトリ全体の動作を変更せずに、キャッシュ識別された別個のファーストパーティインデックスを利用できます。

leantoken --index-include 'src/**' --index-include 'tests/**' index

ステータスとすべての取得結果には、アクティブなインデックスが全体かスコープ限定かが示されるため、スコープ内で結果が空でも、リポジトリ全体に存在しないとは誤って示されません。上限、キャッシュの識別情報、MCP 登録の例については、使用ガイドを参照してください。

LeanToken は、エージェントが必要とするコードを、より少ない入力トークンで返すことを目指しています。

ドキュメント

ライセンス

以下のいずれかのライセンスを選択して適用できます。

• Apache License, Version 2.0
• MIT License