pi-token-killer

RTK (Rust Token Killer) extension for pi-coding-agent. It transparently routes eligible bash commands through rtk to reduce LLM token consumption by 60-90%.

This extension requires rtk: https://github.com/rtk-ai/rtk

The goal is minimalism. This package simply hooks an existing RTK installation into pi. Other RTK-related npm packages I found appear to reimplement RTK output filtering or add extra behavior.

This extension does not replace the functionality of the original rtk tool. It only uses pi hooks to route eligible shell commands through RTK, while keeping RTK responsible for command execution and output optimization.

Install

Install via git:

pi install git:https://github.com/r3b1s/pi-token-killer

Or add it to your pi agent extensions config (for example, .pi/extensions/ or settings.json) if you are using a local checkout:

/path/to/pi-token-killer

rtk must be installed and available on your PATH.

How it works

1. On startup, it parses rtk help and stores the available RTK subcommands.
2. It removes systemic/meta RTK commands from that set, keeping only optimizer commands.
3. It intercepts bash tool calls and prefixes matching optimizer commands with rtk.
4. It maps common aliases where RTK uses a different subcommand, such as cat → rtk read and rg → rtk grep.
5. It skips commands that are already prefixed with rtk, interactive commands, heredocs, and commands RTK does not expose as optimizers.
6. It fails open: if rtk is missing or parsing fails, the original command runs unchanged. If RTK appears later, the extension retries parsing on the next rewrite attempt.
7. It injects RTK meta-command documentation into the system prompt.

Meta commands

rtk gain              # Show token savings analytics
rtk gain --history    # Show command usage history
rtk discover          # Find missed optimization opportunities
rtk session           # Show RTK adoption across recent sessions
rtk proxy <cmd>       # Run command without rtk filtering
rtk rewrite <cmd>     # Show how RTK would rewrite a raw command