rtk

rtk - AI コーディングエージェント向け Rust Token Killer

キーワード：rtk · rust token killer · rtk init · rtk gain

対象のリポジトリは、rtk-ai/rtk のフォークである akillness/rtk です。このフォークはアップストリームのコードを追跡していますが、同梱の install.sh は引き続き rtk-ai/rtk からリリース成果物をダウンロードします。

RTK は高性能な CLI プロキシで、一般的なシェルコマンドを書き換えて、出力が AI エージェントに届く前にトークンを最適化します。このスキルを使って、正しい RTK バイナリかを確認し、インストールまたは修復し、ユーザーのエージェントに適した rtk init モードを選び、自動フックがない場合は rtk の直接コマンドに切り替えてください。

このスキルを使う場面

• RTK がすでにインストールされているか、正しいプロジェクトのものかを確認する
• よくある cargo install rtk の名前衝突による誤インストールを修復する
• Homebrew、リポジトリの install.sh、または Cargo で RTK をインストールする
• Claude Code、Codex、Gemini CLI、Cursor、Copilot、Windsurf、Cline、OpenCode 向けに RTK を初期化する
• ローカルプロジェクトのセットアップより rtk init -g が適している場面を説明する
• rtk git status、rtk read、rtk grep、rtk test、rtk lint などの rtk ラッパーを直接使う
• 自動書き換えが行われない原因を診断する
• 組み込みのファイルツールがシェルフックを経由しない理由と、代わりに rtk の直接コマンドを使う場面を説明する

手順

ステップ 1：再インストールする前に現在のインストールを確認する

まず、ローカルのステータスヘルパーを実行します。

bash scripts/check-status.sh --show

次の順に結果を解釈してください。

1. rtk gain が動作する場合、正しい RTK がすでにインストールされています。ユーザーがアップグレードを希望していない限り、再インストールしないでください。
2. rtk --version は動作するのに rtk gain が失敗する場合、ユーザーは別の rtk パッケージ（通常は Rust Type Kit）をインストールしている可能性があります。
3. rtk がまったく見つからない場合は、インストールに進みます。

インストールと確認の判断ツリーは、references/install-and-verify.md にあります。

ステップ 2：状況に合った最小限の方法で RTK をインストールまたは修復する

ラッパーを使います。

bash scripts/install.sh

インストーラーの選択で重要な点：

• デフォルトの auto は、利用可能な場合は macOS で Homebrew を優先し、次にフォークの install.sh、その後 Cargo を使用します。
• Homebrew が利用可能で、ユーザーが標準のシステム管理下でのインストールを希望する場合は、--method brew を使います。
• リポジトリのインストールスクリプトを使う場合は、--method script を使います。
• ユーザーが Git ソースからのビルドを明示的に希望する場合、またはフォークで作業している場合は、--method cargo を使います。
• ユーザーがすでに誤った rtk をインストールしている場合は、--force-uninstall-wrong を使います。

例：

bash scripts/install.sh --method brew
bash scripts/install.sh --method script
bash scripts/install.sh --method cargo --repo akillness/rtk
bash scripts/install.sh --force-uninstall-wrong

以下のインストールルールを明確にしてください。

• インストール後は必ず rtk gain で確認します。
• ユーザーが正しいパッケージであることをすでに確認していない限り、cargo install rtk は安全ではないものとして扱います。
• インストールスクリプトを使う場合は、引き続き rtk-ai/rtk からリリース成果物がダウンロードされることに留意します。

ステップ 3：エージェントに適した rtk init モードを選ぶ

フラグを手作業で組み立てる代わりに、init ラッパーを使います。

bash scripts/init-agent.sh --agent claude --global

デフォルトの対応関係：

• Claude Code：フック優先のセットアップには --agent claude --global
• Codex：--agent codex --global またはローカルの --agent codex --local
• Gemini CLI：--agent gemini --global
• Cursor：--agent cursor --global
• Copilot：--agent copilot --global
• OpenCode：--agent opencode --global
• Windsurf：--agent windsurf --local
• Cline / Roo Code：--agent cline --local

初期化後の確認例：

bash scripts/init-agent.sh --agent claude --global --auto-patch
bash scripts/init-agent.sh --agent codex --global
bash scripts/init-agent.sh --agent opencode --global
bash scripts/init-agent.sh --agent claude --show

エージェントごとのフックの種類、適用範囲、アンインストールの動作については、references/platform-init.md を参照してください。

ステップ 4：フックがない、または不十分な場合は、RTK コマンドを直接使用する

自動書き換えが適用されるのは、エージェントが対応するフックまたはプラグインを通じて実際にシェルコマンドを実行する場合のみです。Codex、Windsurf、Cline などのプロンプトのみの連携でも、rtk コマンドを明示的に使うと効果がありますが、組み込みのファイルツールが透過的に変更されることはありません。

次の場合は、コマンドを直接使用してください。

• エージェントがシェルではなく、組み込みの Read、Grep、または Glob ツールを使用する場合
• Codex でのワークフローで、ユーザーがすぐにコンパクトな出力を求めている場合
• フックの状態に依存しない、確定的な検証をユーザーが求めている場合

一般的なコマンド：

rtk git status
rtk read src/main.rs
rtk grep "pattern" .
rtk test cargo test
rtk lint
rtk gain

コマンドの種類と設定項目については、references/commands-and-config.md にまとめています。

ステップ 5：失敗を明示的に診断する

最初の診断として bash scripts/check-status.sh --show を実行し、その後、状況に応じて対応します。

• 誤ったバイナリがインストールされている：名前の競合を解消して再インストールします
• フックがない、または古い：適切な rtk init モードを再実行します
• エージェントの出力が依然として冗長：タスクでシェルコマンドと組み込みツールのどちらが使われたかを確認します
• PATH の問題：~/.local/bin または ~/.cargo/bin が PATH に含まれていることを確認します
• Windows ラッパーの失敗：RTK 0.23.1+ を推奨します

トラブルシューティングの一覧は references/troubleshooting.md にあります。

例

例 1：正しい RTK がすでにインストールされているか確認する

bash scripts/check-status.sh --show

例 2：フォークを考慮したスクリプトパスからインストールする

bash scripts/install.sh --method script --repo akillness/rtk

例 3：誤った cargo install rtk パッケージを修復する

bash scripts/install.sh --force-uninstall-wrong --method cargo

例 4：Claude Code のグローバルフックを設定する

bash scripts/init-agent.sh --agent claude --global --auto-patch

例 5：Codex のグローバルプロンプトを設定する

bash scripts/init-agent.sh --agent codex --global

例 6：OpenCode プラグインをインストールする

bash scripts/init-agent.sh --agent opencode --global

例 7：RTK を直接使ってコンパクトな出力を得る

rtk read Cargo.toml
rtk grep "rtk init" README.md
rtk test cargo test

例 8：1 つのコマンドで書き換えを一時的に無効にする

RTK_DISABLED=1 git status

ベストプラクティス

1. 再インストールする前に rtk gain を確認します。正しい RTK と誤ったパッケージを見分ける最も手早い方法です。
2. ユーザーのニーズを満たす最も簡素なインストール方法を選びます。手軽さを重視するなら Homebrew、リリースバイナリならインストールスクリプト、ソースを中心としたワークフローなら Cargo を使用します。
3. フックに対応するエージェントでは rtk init -g を通常の方法として扱い、Windsurf と Cline ではローカルのルールファイルを通常の方法として扱います。
4. セットアップやアップグレードの後に rtk init --show を実行し、古いフックの状態をすぐに確認できるようにします。
5. 組み込みの読み取り／検索ツールはシェルフックを通らないことに注意します。トークンを節約したい場合は、シェルコマンドまたは rtk の直接ラッパーに切り替えます。
6. フックをアンインストールする代わりに、単発のパススルーコマンドでは RTK_DISABLED=1 を使用できることを覚えておきます。
7. RTK のアップグレード後は、インストーラーと rtk init を再実行します。フックの成果物はリリース間で変わることがあります。
8. ユーザーから「RTK が動かない」と言われた場合は、修正を提案する前に、インストールの正しさ、フックの登録、実際のコマンド経路を切り分けます。

参考資料

• references/install-and-verify.md
• references/platform-init.md
• references/commands-and-config.md
• references/troubleshooting.md
• scripts/install.sh
• scripts/init-agent.sh
• scripts/check-status.sh
• RTK Repository Fork
• Upstream RTK Project