はじめに
Claude Code や各種コーディングエージェントを使っていると、cat・grep・git diff・cargo test といったコマンドの出力がまるごと LLM のコンテキストに流し込まれます。
この生出力はノイズが多く、コンテキストを圧迫し、トークン課金を膨らませ、肝心の情報を薄めます。
そこで作ったのが bdo(Bushido)です。
コマンドの出力を LLM に渡す前に圧縮・要約する透過プロキシで、単一の Rust バイナリ、100 以上のコマンド対応、オーバーヘッド 10ms 未満。実測で 60〜90% のトークン削減を狙えます。
上流の rtk (Rust Token Killer) を武士道テーマでフォーク・拡張したものです。コマンド名は
bdo、npm パッケージはbdo-cli。
インストール
# npm(bdo コマンドが入ります)
npm install -g bdo-cli
# または Homebrew
brew install tedorigawa001/tap/bushido
動作確認:
bdo --version
bdo gain # トークン削減の集計
何が起きるのか — before / after
bdo は「native コマンドの薄いラッパ」として振る舞います。
出力から余計な装飾・空白・重複・成功ノイズを削り、エージェントが必要とする信号だけを残します。
# 従来: 生の git status は装飾と空行だらけ
$ git status
On branch main
Your branch is up to date with 'origin/main'.
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: src/main.rs
...
# bdo: 同じ情報を最小トークンで
$ bdo git status
M src/main.rs
cat や grep、cargo test も同様です。テスト系は失敗だけを残すので、2.5 万トークンの実行ログが数百トークンになります。
効果(30分の Claude Code セッション想定)
| 操作 | 回数 | 標準 | bdo | 削減 |
|---|---|---|---|---|
ls / tree
|
10x | 2,000 | 400 | -80% |
cat / read
|
20x | 40,000 | 12,000 | -70% |
grep / rg
|
8x | 16,000 | 3,200 | -80% |
git status |
10x | 3,000 | 600 | -80% |
git diff |
5x | 10,000 | 2,500 | -75% |
cargo test / npm test
|
5x | 25,000 | 2,500 | -90% |
pytest / go test
|
7x | 14,000 | 1,400 | -90% |
| 合計 | 約118,000 | 約23,900 | -80% |
中規模の TypeScript / Rust プロジェクトでの概算。実際の削減率はプロジェクト規模で変わります。
削減量は bdo gain でいつでも集計できます(コマンド別・エージェント別の内訳も出ます)。
本命の使い方 — Claude Code フック連携
一番の価値は、エージェントが自分で bdo を打つ必要がない点です。
bdo init で Claude Code の PreToolUse フックを仕込むと、エージェントが投げた git status が自動で bdo git status に書き換えられます。
bdo init -g --auto-patch # グローバルにフック設置(要 Claude Code 再起動)
以降はエージェントが普段どおりコマンドを打つだけで、透過的に 0 トークンのオーバーヘッドで削減が効きます。Gemini / Antigravity / Cursor / Copilot 向けの連携も用意しています。
bdo ならではのコマンド
単なる圧縮だけでなく、「LLM に読ませる」ことに特化した独自コマンドがあります。
bdo read -l outline / bdo map — コードの地図
ファイルのシグネチャだけを残して本体 { … } を畳みます。bdo map はディレクトリ全体のトップレベル宣言だけを出すので、src/core が 74k → 3.5k トークン(約95%減)に。API 面を把握したいときに刺さります。
bdo review / bdo stale — 変更レビューと残骸監査
-
bdo review… 変更セットの要約(変更ファイル・紛れ込んだ生成物・stale マーカー・走らせるべきテスト) -
bdo stale… tracked tree 全体の残骸監査。見つかれば非ゼロ終了で CI ゲートに使える
機能強化(NEW) bdo ci — プリマージ・ゲート(1コマンド)
上記を束ねた統合ゲート。
review(変更サマリ)+ stale(残骸ゲート)+ test --changed(変更セットのテスト)を実行し、単一の exit code を返します。
$ bdo ci
━━━ bdo ci (1/3) — change summary ━━━
...
━━━ bdo ci (2/3) — residue audit ━━━
...
━━━ bdo ci (3/3) — changed tests ━━━
...
━━━ bdo ci: PASS ━━━
review shown (informational)
stale ok
tests ok
軽い検査を先に・遅いテストを最後に走らせつつ、全ステージを実行して1パスで全ブロッカーを提示します。
設計思想 — 「正しさ > 圧縮率」
圧縮ツールで一番怖いのは「削りすぎて情報を失う」ことです。
bdo はフェイルセーフを最優先にしています。
- 各フィルタは
catch_unwindで保護され、敵対的な出力で panic しても生出力にフォールバックする(情報を失わない) - exit code は必ず保持する(
bdo cargo testが失敗すれば非ゼロで返る) - 圧縮しても情報が壊れないコマンドだけをフィルタ対象にする
「LLM がその出力を信頼して使える」ことを保証する方向に振っているので、コードや diff のような 1 文字が致命的な対象でも安心して噛ませられます。
なお、巷で流行っている画像に圧縮する手法は圧縮効果は絶大ですが、わずかながらにデータの完全性が落ちるため、採用してません。コード・数式・固有名詞・厳密な数値など「1文字の誤りが致命的」になるため。
(画像は密度でトークンを稼ぐ仕組み(1タイルに複数文字を畳み込める)のようですが、モデル側の課金方式に依存し、将来的にAI会社に対策されるリスクもあるため)
まとめ
- bdo はコマンド出力を LLM に渡す前に圧縮する透過プロキシ(単一 Rust バイナリ)
-
npm install -g bdo-cli/brew install tedorigawa001/tap/bushido -
bdo initで Claude Code に仕込めば、エージェントが何も変えなくても 60〜90% 削減 -
bdo map/review/stale/ciなど「LLM に読ませる」ための独自コマンドも - 設計は「正しさ > 圧縮率」。壊れたら生出力へフォールバック
トークン課金とコンテキスト圧迫に悩んでいる方は、まず bdo gain で自分のセッションがどれだけ削れるか試してみてください。


