Purpose
Reduce LLM token consumption in Claude Code sessions by 60-90% without changing developer workflow.
All Bash commands are transparently rewritten to their rtk equivalents via a PreToolUse hook.
How It Works
Without rtk: With rtk:
Claude --git status--> shell --> git Claude --git status--> RTK --> git
^ ~2,000 tokens (raw) | ^ ~200 tokens | |
+-------------------------------+ +---- (filtered) ----+-------+
Four strategies applied per command type:
- Smart Filtering - Removes noise (comments, whitespace, boilerplate)
- Grouping - Aggregates similar items (files by directory, errors by type)
- Truncation - Keeps relevant context, cuts redundancy
- Deduplication - Collapses repeated log lines with counts
Supported Commands
| Category |
Commands |
Typical Savings |
| Files |
ls, read, find, grep, diff |
70-80% |
| Git |
status, diff, log, add, commit, push |
75-92% |
| GitHub CLI |
pr list, issue list, run list |
80% |
| Test Runners |
cargo test, npm test, pytest, go test, vitest, playwright |
90% |
| Build & Lint |
cargo build, tsc, next build, eslint, ruff, clippy |
80-85% |
| Package Managers |
pnpm list, pip list, bundle install |
80% |
| Containers |
docker ps/logs, kubectl pods/logs |
80% |
| AWS |
sts, ec2, lambda, logs, s3, cloudformation |
80% |
| Data |
json, env, log, curl, wget |
70-80% |
Token Savings (30-min Session Estimate)
| Operation |
Frequency |
Standard |
rtk |
Savings |
| 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% |
| git diff |
5x |
10,000 |
2,500 |
-75% |
| cargo test / npm test |
5x |
25,000 |
2,500 |
-90% |
| Total |
|
~118,000 |
~23,900 |
-80% |
Usage
After installation, rtk works automatically via the PreToolUse hook. No manual changes needed.
Analytics Commands
rtk gain # Summary stats
rtk gain --graph # ASCII graph (last 30 days)
rtk gain --daily # Day-by-day breakdown
rtk discover # Find missed savings opportunities
rtk session # Show RTK adoption across recent sessions
Manual Usage
rtk git status # Compact git status
rtk read file.rs # Smart file reading
rtk test cargo test # Show failures only
rtk lint # ESLint grouped by rule/file
rtk docker ps # Compact container list
Prerequisites
rtk binary: brew install rtk or curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
jq: required by the hook script
Integration
- Hook:
hooks/rtk-rewrite.sh (PreToolUse:Bash, last in chain)
- Config:
~/.config/rtk/config.toml for customization
- Tee recovery: failed command full output saved to
~/.local/share/rtk/tee/
References
Source: hashgraph-online/awesome-codex-plugins → plugins/Colin4k1024/tsp/skills/rtk-token-optimization/SKILL.md
1---2name: rtk-token-optimization3description: > High-performance CLI proxy that reduces LLM token consumption by 60-90%. Transparently rewrites 100+ common dev commands (git, gh, cargo, npm, docker, kubectl, aws, etc.) via PreToolUse hook. Single Rust binary, zero dependencies.4---567## Purpose89Reduce LLM token consumption in Claude Code sessions by 60-90% without changing developer workflow.10All Bash commands are transparently rewritten to their `rtk` equivalents via a PreToolUse hook.1112## How It Works1314```15Without rtk: With rtk:16Claude --git status--> shell --> git Claude --git status--> RTK --> git17 ^ ~2,000 tokens (raw) | ^ ~200 tokens | |18 +-------------------------------+ +---- (filtered) ----+-------+19```2021Four strategies applied per command type:22231. **Smart Filtering** - Removes noise (comments, whitespace, boilerplate)242. **Grouping** - Aggregates similar items (files by directory, errors by type)253. **Truncation** - Keeps relevant context, cuts redundancy264. **Deduplication** - Collapses repeated log lines with counts2728## Supported Commands2930| Category | Commands | Typical Savings |31|----------|----------|----------------|32| Files | ls, read, find, grep, diff | 70-80% |33| Git | status, diff, log, add, commit, push | 75-92% |34| GitHub CLI | pr list, issue list, run list | 80% |35| Test Runners | cargo test, npm test, pytest, go test, vitest, playwright | 90% |36| Build & Lint | cargo build, tsc, next build, eslint, ruff, clippy | 80-85% |37| Package Managers | pnpm list, pip list, bundle install | 80% |38| Containers | docker ps/logs, kubectl pods/logs | 80% |39| AWS | sts, ec2, lambda, logs, s3, cloudformation | 80% |40| Data | json, env, log, curl, wget | 70-80% |4142## Token Savings (30-min Session Estimate)4344| Operation | Frequency | Standard | rtk | Savings |45|-----------|-----------|----------|-----|---------|46| ls / tree | 10x | 2,000 | 400 | -80% |47| cat / read | 20x | 40,000 | 12,000 | -70% |48| grep / rg | 8x | 16,000 | 3,200 | -80% |49| git status | 10x | 3,000 | 600 | -80% |50| git diff | 5x | 10,000 | 2,500 | -75% |51| cargo test / npm test | 5x | 25,000 | 2,500 | -90% |52| **Total** | | **~118,000** | **~23,900** | **-80%** |5354## Usage5556After installation, rtk works automatically via the PreToolUse hook. No manual changes needed.5758### Analytics Commands5960```bash61rtk gain # Summary stats62rtk gain --graph # ASCII graph (last 30 days)63rtk gain --daily # Day-by-day breakdown64rtk discover # Find missed savings opportunities65rtk session # Show RTK adoption across recent sessions66```6768### Manual Usage6970```bash71rtk git status # Compact git status72rtk read file.rs # Smart file reading73rtk test cargo test # Show failures only74rtk lint # ESLint grouped by rule/file75rtk docker ps # Compact container list76```7778## Prerequisites7980- `rtk` binary: `brew install rtk` or `curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh`81- `jq`: required by the hook script8283## Integration8485- Hook: `hooks/rtk-rewrite.sh` (PreToolUse:Bash, last in chain)86- Config: `~/.config/rtk/config.toml` for customization87- Tee recovery: failed command full output saved to `~/.local/share/rtk/tee/`8889## References9091- [rtk GitHub](https://github.com/rtk-ai/rtk)92- [rtk Website](https://www.rtk-ai.app)93- [Troubleshooting](https://github.com/rtk-ai/rtk/blob/master/docs/TROUBLESHOOTING.md)9495---9697**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/Colin4k1024/tsp/skills/rtk-token-optimization/SKILL.md`