エージェントが読む bash 出力を最大 90% 削減する高性能 CLI プロキシ
ウェブサイト • インストール • トラブルシューティング • アーキテクチャ • Discord
English • Francais • 中文 • 日本語 • 한국어 • Espanol
--- rtk はコマンド出力を LLM コンテキストに届く前にフィルタリング・圧縮します。単一の Rust バイナリ、依存関係ゼロ、オーバーヘッド 10ms 未満。 ## RTK がすること RTK はシェルコマンドを横取りし、エージェントが読む前にその出力を圧縮します。 | 操作 | RTK が出力に対して行うこと | |------|----------------------------| | `ls` / `tree` | 1 エントリ 1 行ではなく、ファイル数付きのツリー形式 | | `cat` / `read` | スマートなファイル読み取り：本文全体ではなくシグネチャと構造 | | `grep` / `rg` | 長い行を切り詰め、マッチをファイル単位でグループ化 | | `git status` | コンパクトな stat 形式、状態ごとにグループ化 | | `git diff` | コンテキストを削減、ヘッダーを除去 | | `git log` | ハッシュ、作者、件名のみ | | `git add/commit/push` | 進捗出力全体の代わりに確認行 1 行 | | `cargo test` / `npm test` | 失敗のみ、成功したテストは件数に集約 | | `ruff check` | ルールとファイルごとにグループ化 | | `pytest` | 失敗のみ、トレースバックを短縮 | | `go test` | NDJSON をパースし、失敗のみ | | `docker ps` | 必須フィールドのみ | ## 節約の仕組み RTK はエージェントが読む **bash 出力を最大 90% 削減**します。これが RTK の測定対象であり、請求額が 90% 減ることと同じではありません。 bash 出力は、あなたのプロンプト、システムプロンプト、会話履歴と並ぶ**入力トークンの構成要素のひとつ**にすぎません。そして入力トークン自体も、出力トークンを含む**請求額の一部**でしかありません。削減効果は各段階で薄まります。 RTK が報告するトークン数は `バイト数 / 4` で見積もられています。RTK はトークナイザーを同梱していないため、**割合は信頼できますが、トークンの絶対値はあくまで概算**です。 > 詳しい解説：[RTK の節約の仕組み](docs/guide/resources/savings-explained.md) ## インストール ### Homebrew（推奨） ```bash brew install rtk ``` ### クイックインストール（Linux/macOS） ```bash curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh ``` ### Cargo ```bash cargo install --git https://github.com/rtk-ai/rtk ``` ### 確認 ```bash rtk --version # "rtk 0.27.x" と表示されるはず rtk gain # トークン節約統計が表示されるはず ``` ## クイックスタート ```bash # 1. Claude Code 用フックをインストール（推奨） rtk init --global # 2. Claude Code を再起動してテスト git status # 自動的に rtk git status に書き換え ``` ## 仕組み ``` rtk なし： rtk あり： Claude --git status--> shell --> git Claude --git status--> RTK --> git ^ | ^ | | | ~2,000 tokens（生出力） | | ~200 tokens | フィルタ | +-----------------------------------+ +------- （圧縮済）----+----------+ ``` 4つの戦略： 1. **スマートフィルタリング** - ノイズを除去（コメント、空白、ボイラープレート） 2. **グルーピング** - 類似項目を集約（ディレクトリ別ファイル、タイプ別エラー） 3. **トランケーション** - 関連コンテキストを保持、冗長性をカット 4. **重複排除** - 繰り返しログ行をカウント付きで統合 ## コマンド > 以下の割合は **bash 出力バイト数の削減率**であり、RTK の `バイト数 / 4` 推定器で測定しています。[節約の仕組み](#節約の仕組み)を参照してください。 ### ファイル ```bash rtk ls . # 最適化されたディレクトリツリー rtk read file.rs # スマートファイル読み取り rtk find "*.rs" . # コンパクトな検索結果 rtk grep "pattern" . # ファイル別グループ化検索 ``` ### Git ```bash rtk git status # コンパクトなステータス rtk git log -n 10 # 1行コミット rtk git diff # 圧縮された diff rtk git push # -> "ok main" ``` ### テスト ```bash rtk jest # Jest コンパクト rtk vitest # Vitest コンパクト rtk pytest # Python テスト（-90%） rtk go test # Go テスト（-90%） rtk test