Skip to content

README_ja.md

Latest commit

 

History

History
153 lines (116 loc) · 5.54 KB

README_ja.md

File metadata and controls

153 lines (116 loc) · 5.54 KB

rtk-plus

RTK の拡張フォーク — LLM トークン消費を 60-90% 削減する高性能 CLI プロキシ

CI Release License: MIT

インストール • トラブルシューティング • アーキテクチャ • 上流プロジェクト

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

rtk-ai/rtk（Rust Token Killer）の拡張フォークです。 バイナリ名は既存のフックとワークフローとの完全な互換性のために rtk のままです。

rtk-plus はコマンド出力を LLM コンテキストに届く前にフィルタリング・圧縮します。単一の Rust バイナリ、依存関係ゼロ、オーバーヘッド 10ms 未満。

トークン節約（30分の Claude Code セッション）

操作 頻度 標準 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%

インストール

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

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

Cargo

cargo install --git https://github.com/dioptx/rtk-plus

確認

rtk --version   # "rtk-plus 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つの戦略：

  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日間）
rtk discover                    # 見逃した節約機会を発見

ドキュメント

コントリビュート

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

上流プロジェクトへの貢献は rtk-ai/rtk に PR を提出してください。

ライセンス

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