rtk-ai__rtk/README_ja.md

LLM トークン消費を 60-90% 削減する高性能 CLI プロキシ

ウェブサイト • インストール • トラブルシューティング • アーキテクチャ • Discord

English • Francais • 中文 • 日本語 • 한국어 • Espanol

---

rtk はコマンド出力を LLM コンテキストに届く前にフィルタリング・圧縮します。すべての AI コーディングエージェントに対応し、コマンドの前に rtk を付けるだけで使えます。単一バイナリ、依存関係ゼロ、オーバーヘッド 10ms 未満。

トークン節約（30分のコーディングセッション）

操作	頻度	標準	rtk	節約
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%
cargo test / npm test	5x	25,000	2,500	-90%
合計		~118,000	~23,900	-80%

インストール

Homebrew（推奨）

brew install rtk

クイックインストール（Linux/macOS）

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

Cargo

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

確認

rtk --version   # "rtk 0.27.x" と表示されるはず
rtk gain        # トークン節約統計が表示されるはず

クイックスタート

任意のエージェントで直接使用：

rtk git status              # コンパクトなステータス
rtk cargo test              # 失敗のみ (-90%)
rtk grep "pattern" .        # グループ化された結果

または Claude Code で自動書き換え：

rtk init --global           # フックをインストール
# Claude Code を再起動 — コマンドが自動的に書き換えられます
git status                  # → rtk git status（透過的）

RTK はスタンドアロンバイナリです。Claude Code フックはコマンドを自動書き換えしますが、rtk をプレフィックスとして付けることで任意のエージェントで動作します。

仕組み

  rtk なし：                                       rtk あり：

  Agent  --git status-->  shell  -->  git           Agent  --git status-->  RTK  -->  git
    ^                                   |             ^                      |          |
    |        ~2,000 tokens（生出力）     |             |   ~200 tokens        | フィルタ |
    +-----------------------------------+             +------- （圧縮済）----+----------+

4つの戦略：

1. スマートフィルタリング - ノイズを除去（コメント、空白、ボイラープレート）
2. グルーピング - 類似項目を集約（ディレクトリ別ファイル、タイプ別エラー）
3. トランケーション - 関連コンテキストを保持、冗長性をカット
4. 重複排除 - 繰り返しログ行をカウント付きで統合

コマンド

ファイル

rtk ls .                        # 最適化されたディレクトリツリー
rtk read file.rs                # スマートファイル読み取り
rtk find "*.rs" .               # コンパクトな検索結果
rtk grep "pattern" .            # ファイル別グループ化検索

Git

rtk git status                  # コンパクトなステータス
rtk git log -n 10               # 1行コミット
rtk git diff                    # 圧縮された diff
rtk git push                    # -> "ok main"

テスト

rtk test cargo test             # 失敗のみ表示（-90%）
rtk vitest run                  # Vitest コンパクト
rtk pytest                      # Python テスト（-90%）
rtk go test                     # Go テスト（-90%）

ビルド & リント

rtk lint                        # ESLint ルール別グループ化
rtk tsc                         # TypeScript エラーグループ化
rtk cargo build                 # Cargo ビルド（-80%）
rtk ruff check                  # Python リント（-80%）

分析

rtk gain                        # 節約統計
rtk gain --graph                # ASCII グラフ（30日間）

Claude Code 専用（~/.claude/projects/ セッションファイルを読み取ります）：

rtk discover                    # セッション履歴から見逃した節約機会を発見
rtk discover --all --since 7    # 全プロジェクト、過去7日間
rtk learn                       # エラー履歴から CLI 修正を学習
rtk cc-economics                # Claude Code セッション別トークンコスト分析

近日公開：Aider、Cline、Goose、シェル履歴（全エージェント対応）で rtk discover をサポート予定。#273 をフォロー。

ドキュメント

• TROUBLESHOOTING.md - よくある問題の解決
• INSTALL.md - 詳細インストールガイド
• ARCHITECTURE.md - 技術アーキテクチャ

コントリビュート

コントリビューション歓迎！GitHub で issue または PR を作成してください。

Discord コミュニティに参加。

ライセンス

MIT ライセンス - 詳細は LICENSE を参照。

免責事項

詳細は DISCLAIMER.md を参照。