README_ja.md
rtk はコマンド出力を LLM コンテキストに届く前にフィルタリング・圧縮します。単一の Rust バイナリ、依存関係ゼロ、オーバーヘッド 10ms 未満。
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 の節約の仕組み
brew install rtk
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
cargo install --git https://github.com/rtk-ai/rtk
rtk --version # "rtk 0.27.x" と表示されるはず
rtk gain # トークン節約統計が表示されるはず
# 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つの戦略：
以下の割合は bash 出力バイト数の削減率であり、RTK の
バイト数 / 4推定器で測定しています。節約の仕組みを参照してください。
rtk ls . # 最適化されたディレクトリツリー
rtk read file.rs # スマートファイル読み取り
rtk find "*.rs" . # コンパクトな検索結果
rtk grep "pattern" . # ファイル別グループ化検索
rtk git status # コンパクトなステータス
rtk git log -n 10 # 1行コミット
rtk git diff # 圧縮された diff
rtk git push # -> "ok main"
rtk jest # Jest コンパクト
rtk vitest # Vitest コンパクト
rtk pytest # Python テスト（-90%）
rtk go test # Go テスト（-90%）
rtk test <cmd> # 失敗のみ表示（-90%）
rtk lint # ESLint ルール別グループ化
rtk tsc # TypeScript エラーグループ化
rtk cargo build # Cargo ビルド（-80%）
rtk ruff check # Python リント（-80%）
rtk gain # 節約統計
rtk gain --graph # ASCII グラフ（30日間）
rtk discover # 見逃した節約機会を発見
コントリビューション歓迎！GitHub で issue または PR を作成してください。
Discord コミュニティに参加。
Apache 2.0 ライセンス - 詳細は LICENSE を参照。
詳細は DISCLAIMER.md を参照。