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
1---2name: rtk-token-optimization3description: >4 High-performance CLI proxy that reduces LLM token consumption by 60-90%.5 Transparently rewrites 100+ common dev commands (git, gh, cargo, npm, docker, kubectl, aws, etc.)6 via PreToolUse hook. Single Rust binary, zero dependencies.7source: https://github.com/rtk-ai/rtk8license: Apache-2.09trust_tier: B-proven-community10metadata:11 source: https://skillmd.com/skills/hashgraph-online/rtk-token-optimization12---1314## Purpose1516Reduce LLM token consumption in Claude Code sessions by 60-90% without changing developer workflow.17All Bash commands are transparently rewritten to their `rtk` equivalents via a PreToolUse hook.1819## How It Works2021```22Without rtk: With rtk:23Claude --git status--> shell --> git Claude --git status--> RTK --> git24 ^ ~2,000 tokens (raw) | ^ ~200 tokens | |25 +-------------------------------+ +---- (filtered) ----+-------+26```2728Four strategies applied per command type:29301. **Smart Filtering** - Removes noise (comments, whitespace, boilerplate)312. **Grouping** - Aggregates similar items (files by directory, errors by type)323. **Truncation** - Keeps relevant context, cuts redundancy334. **Deduplication** - Collapses repeated log lines with counts3435## Supported Commands3637| Category | Commands | Typical Savings |38|----------|----------|----------------|39| Files | ls, read, find, grep, diff | 70-80% |40| Git | status, diff, log, add, commit, push | 75-92% |41| GitHub CLI | pr list, issue list, run list | 80% |42| Test Runners | cargo test, npm test, pytest, go test, vitest, playwright | 90% |43| Build & Lint | cargo build, tsc, next build, eslint, ruff, clippy | 80-85% |44| Package Managers | pnpm list, pip list, bundle install | 80% |45| Containers | docker ps/logs, kubectl pods/logs | 80% |46| AWS | sts, ec2, lambda, logs, s3, cloudformation | 80% |47| Data | json, env, log, curl, wget | 70-80% |4849## Token Savings (30-min Session Estimate)5051| Operation | Frequency | Standard | rtk | Savings |52|-----------|-----------|----------|-----|---------|53| ls / tree | 10x | 2,000 | 400 | -80% |54| cat / read | 20x | 40,000 | 12,000 | -70% |55| grep / rg | 8x | 16,000 | 3,200 | -80% |56| git status | 10x | 3,000 | 600 | -80% |57| git diff | 5x | 10,000 | 2,500 | -75% |58| cargo test / npm test | 5x | 25,000 | 2,500 | -90% |59| **Total** | | **~118,000** | **~23,900** | **-80%** |6061## Usage6263After installation, rtk works automatically via the PreToolUse hook. No manual changes needed.6465### Analytics Commands6667```bash68rtk gain # Summary stats69rtk gain --graph # ASCII graph (last 30 days)70rtk gain --daily # Day-by-day breakdown71rtk discover # Find missed savings opportunities72rtk session # Show RTK adoption across recent sessions73```7475### Manual Usage7677```bash78rtk git status # Compact git status79rtk read file.rs # Smart file reading80rtk test cargo test # Show failures only81rtk lint # ESLint grouped by rule/file82rtk docker ps # Compact container list83```8485## Prerequisites8687- `rtk` binary: `brew install rtk` or `curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh`88- `jq`: required by the hook script8990## Integration9192- Hook: `hooks/rtk-rewrite.sh` (PreToolUse:Bash, last in chain)93- Config: `~/.config/rtk/config.toml` for customization94- Tee recovery: failed command full output saved to `~/.local/share/rtk/tee/`9596## References9798- [rtk GitHub](https://github.com/rtk-ai/rtk)99- [rtk Website](https://www.rtk-ai.app)100- [Troubleshooting](https://github.com/rtk-ai/rtk/blob/master/docs/TROUBLESHOOTING.md)