| name | rtk |
| description | Prefix shell commands with rtk to apply the token-optimizing proxy (60–90% savings on Git, pytest, ruff, Fabric CLI, file ops). |
RTK Token Optimizer
RTK reduces token consumption 60–90% by filtering and compressing shell output before it reaches the AI.
- Claude Code: The Bash hook intercepts commands automatically — no manual prefix needed.
- Codex: No hook is available — prefix commands manually with
rtk.
Golden Rule
Prefix every shell command with rtk. RTK applies its filter if one exists; otherwise the command runs unchanged.
Key Commands for This Project
| Workflow | Command |
|---|
| Git | rtk git status · rtk git log · rtk git diff |
| Python / ruff | rtk pytest · rtk ruff check · rtk pip |
| Fabric helpers | rtk fabric-vibe notebook ... · rtk fabric-vibe workspace ... · rtk fabric-vibe pipeline manage ... |
| Files | rtk ls · rtk find · rtk grep |
| Build | rtk tsc · rtk cargo build |
Analytics
rtk gain — token savings summary for this session
rtk discover — scan shell history to find new optimization opportunities
rtk session — adoption tracking