blog.dopana

戻る

AIコーディングツールが git status、cargo test、ls -la などのコマンドを実行するたび、定型ヘッダー、過剰な空白行、ASCIIアート、重複ログといった不要な出力によって、何千もの貴重なコンテキストトークンが無駄に消費されています。

RTK(Rust Token Killer) は、まさにこの課題を解決するために作られたCLIプロキシです。AIエージェントとシェルの中間に位置し、端末の出力をその場でフィルタリング・圧縮してLLMのコンテキストに送ります。

RTKとは?#

RTKは、Rustで完全に記述されたオープンソースのCLIプロキシ(GitHubスター数67,000以上)です。ランタイム依存関係ゼロ(Zero Dependency)で動作し、エージェントがシェルコマンドを実行した際に出力される不要なノイズを自動的に取り除きます。

1. Run Command2. Execute3. Raw Output: ~2,000 Tokens4. Filter & Compress5. Clean Output: ~200 TokensAI AgentRTK ProxySystem ShellRTK EngineFilter / Group / Truncate

どれくらいトークンを節約できるのか?#

Claude Codeを使用した実際の30分間の開発セッションでの比較データです:

コマンド元のトークン数RTK適用後削減率
cat / read40,00012,000-70%
git diff10,0002,500-75%
git status3,000600-80%
cargo test / npm test25,0002,500-90%
ls / tree2,000400-80%
合計~118,000~23,900-80%

[!TIP] トークン消費量を80%削減することは、API利用料を抑えるだけでなく、LLMのコンテキスト圧迫(情報見落とし現象)を防ぎ、回答生成速度を大幅に向上させる効果があります。

インストール方法#

RTKは主要なパッケージマネージャーに対応しています。

Homebrew(macOS / Linux):

brew install rtk
bash

公式ワンライナースクリプト:

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
bash

Cargoからのビルド:

cargo install --git https://github.com/rtk-ai/rtk
bash

インストールの確認:

rtk --version
rtk gain # トークン節約の累積統計を表示
bash

使い方#

1. お使いのAIツール向けに初期化する#

RTKは各種開発環境向けのシェルフックを提供しています。使用中のツールに合わせて以下のコマンドを実行します:

rtk init -g # Claude Code / Copilot(デフォルトのグローバル設定)
rtk init -g --gemini # Gemini CLI
rtk init -g --agent cursor # Cursor
rtk init -g --opencode # OpenCode
rtk init --agent cline # Cline / Roo Code
bash

実行後にAIツールや端末を再起動するだけで、すべてのシェルコマンドが自動的にRTK経由で最適化されます。

2. フックなしで直接実行する#

シェルの全体設定を変更せず、スタンドアロンコマンドとしても直接利用可能です:

rtk ls . # コンパクトなディレクトリツリー
rtk read file.rs # 構文を考慮した賢いファイル読み取り
rtk git status # すっきり整理されたgitステータス
rtk git diff # 圧縮・構造化されたgit差分
rtk cargo test # テスト結果(失敗箇所のみ表示、-90%)
rtk pytest # Pythonテスト(エラーとトレースバックのみ)
rtk docker ps # 整頓されたコンテナ一覧
rtk kubectl pods # 見やすいPod一覧
bash

4つのフィルタリング戦略#

RTKは実行されるコマンドの種類に応じて、4つの最適化戦略を組み合わせて適用します:

  1. スマートフィルタリング(Smart Filtering): 定型コメント、余分な空白、アスキーアートロゴを自動除去します。
  2. グルーピング(Grouping): 変更ファイルを親ディレクトリごとにまとめ、類似のエラーメッセージを1箇所に集約します。
  3. 文脈に応じた切り捨て(Truncation): 成功したテストの長いログは切り捨て、失敗した重要なコンテキストのみを残します。
  4. 重複排除(Deduplication): 連続する同一ログ行を1行にまとめ、発生回数を付与します(例: [repeats 42 times])。

cargo test の具体例:

# 元の出力(200行以上の冗長なログ)
running 15 tests
test utils::test_parse ... ok
test utils::test_format ... ok
test services::test_login ... ok
...
test edge_case ... FAILED
test overflow ... FAILED

# RTK適用後(約20行の要点のみ)
FAILED: 2/15 tests
  test_edge_case: assertion failed
  test_overflow: panic at utils.rs:18
bash

Teeシステム: 完全な情報の保護#

出力を要約すると「デバッグに必要な詳細情報が消えてしまうのではないか」という懸念が生じます。RTKは独自の Teeシステム でこの問題を解決しています。

コマンドが失敗(エラー終了)した場合、RTKは自動的に完全な無加工ログをローカルディスクに保存します:

FAILED: 2/15 tests
[full output: ~/.local/share/rtk/tee/1707753600_cargo_test.log]
txt

[!NOTE] AIエージェントや開発者が完全なスタックトレースを必要とする場合は、保存されたログファイルを参照できるため、診断情報が失われる心配はありません。

14種類以上のAIツールをサポート#

RTKは、Claude Code、GitHub Copilot、Cursor、Cline、Gemini CLI、OpenCode、Windsurf、Codex、Hermesなど、最新の主要AIコーディングツールに標準対応しています。以下のコマンドで各ツールを有効化できます:

rtk init -g --agent <tool>
bash

他のアプローチとの比較#

評価項目RTKプロンプト指示(「簡潔に出力して」)コンテキスト枠の拡大
トークン節約効果60% 〜 90%0% 〜 20%0%(請求額増加)
自動化レベル完全自動(シェルフック)手動(毎回プロンプトが必要)手動
ツール費用無料 / OSS0円月額費用の増大
実行オーバーヘッド10ms未満(ネイティブRust)0ms推論レイテンシの悪化

RTKはデータを収集するのか?#

ソースコード、ファイルパス、秘密情報が外部に送信されることは一切ありません。RTKのテレメトリ(利用状況計測)は デフォルトで完全に無効 です(オプトイン方式)。有効化した場合でも、コマンド実行数やトークン節約数などの匿名集計値のみが送信されます。

rtk telemetry status # 状態確認(デフォルトは無効)
rtk telemetry enable # 有効化(希望する場合のみ)
bash

まとめ#

日々の開発でAIコーディングエージェントを活用しているなら、RTKは導入必須のツールです。トークン消費の80%削減は、利用料金の80%節約、より広いコンテキストの確保、そして応答の高速化を意味します。しかも開発者の作業フローを変える必要はありません。

単一のRustバイナリ、ランタイム依存関係なし、10秒でセットアップ完了 — 導入したその瞬間から確実な投資対効果が得られます。

参考文献#