RTK

https://www.rtk-ai.app/docs/
Admin
RTK is a CLI proxy that sits between your AI assistant and your development tools. It filters...
Tokens:11,877
Snippets:183
Trust Score:6.8
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install RTK for GitHub Copilot (VS Code Chat + CLI)

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK for GitHub Copilot. Supports both project-scoped and user-scoped installations. Project-scoped installs to `.github/hooks/` and `.github/copilot-instructions.md`. User-scoped installs to `~/.copilot/hooks/` and `~/.copilot/copilot-instructions.md`, respecting `$COPILOT_HOME`.

```bash
rtk init --copilot            # project-scoped (.github/hooks/)
rtk init --global --copilot   # user-scoped (~/.copilot/hooks/, respects $COPILOT_HOME)
```

--------------------------------

### Install RTK for Pi

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK for Pi. Supports both project-local and global installations. Pi auto-discovers extensions from both paths on startup.

```bash
# Project-local (default)
rtk init --agent pi


# Global — all projects
rtk init --agent pi --global
```

--------------------------------

### Quick Install RTK (Linux/macOS)

Source: https://www.rtk-ai.app/docs/getting-started/installation

Use this command to quickly install RTK on Linux and macOS systems by downloading and executing an installation script.

```bash
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh
```

--------------------------------

### Initialize RTK for OpenCode

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

Install the RTK hook for OpenCode and restart the editor. Verify the installation status.

```bash
rtk init --global --opencode
# restart OpenCode
rtk init --show    # should show "OpenCode: plugin installed"
```

--------------------------------

### Run Unsupported Commands via Passthrough

Source: https://www.rtk-ai.app/docs/resources/what-rtk-covers

RTK runs commands not explicitly supported through a passthrough mechanism, sending their output unchanged to the LLM. This example shows how `make install` is executed and its usage tracked without filtering.

```bash
rtk proxy make install    # runs make install, tracks usage, no filtering
```

--------------------------------

### Install RTK via Cargo (Explicit Git URL)

Source: https://www.rtk-ai.app/docs/getting-started/installation

To avoid installing the wrong package when using Cargo, explicitly use the Git URL to ensure you get the Rust Token Killer.

```bash
cargo install --git https://github.com/rtk-ai/rtk rtk
```

--------------------------------

### Install RTK for Gemini CLI

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK globally for Gemini CLI.

```bash
rtk init --global --gemini
```

--------------------------------

### Install RTK for OpenCode

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK globally for OpenCode. This creates a plugin file in `~/.config/opencode/plugins/rtk.ts` and uses the `tool.execute.before` hook.

```bash
rtk init --global --opencode
```

--------------------------------

### Troubleshoot RTK installation compilation errors

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

Ensure you have Rust 1.70+ installed. Update Rust, clean the cargo cache, and rebuild the release version before installing.

```bash
rustup update stable
rustup default stable
cargo clean
cargo build --release
cargo install --path . --force
```

--------------------------------

### Install RTK for Codex CLI

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK for Codex CLI. Supports both project-scoped and user-global installations.

```bash
rtk init --codex           # project-scoped (AGENTS.md)
rtk init --global --codex  # user-global (~/.codex/AGENTS.md)
```

--------------------------------

### Install RTK for Windsurf

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK globally for Windsurf. This command creates a `.windsurfrules` file in the current project.

```bash
rtk init --global --agent windsurf    # creates .windsurfrules in current project
```

--------------------------------

### Verify RTK Installation

Source: https://www.rtk-ai.app/docs/getting-started/quick-start

Check if RTK is installed and view its version. Run a sample command to see token savings dashboard.

```bash
rtk --version   # rtk x.y.z
rtk gain        # shows token savings dashboard
```

--------------------------------

### Verify RTK installation and hook initialization

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

Check if RTK is installed and initialize the global hook for AI assistants. Use '--cursor' or '--opencode' for specific editors.

```bash
rtk --version
rtk gain
```

```bash
rtk init --global    # Claude Code
rtk init --global --cursor    # Cursor
rtk init --global --opencode  # OpenCode
```

```bash
rtk init --show
```

```bash
cat ~/.claude/settings.json | grep rtk
```

--------------------------------

### Install RTK Hook for Claude Code

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs the RTK hook globally for Claude Code. This command installs the hook and patches the settings.json file. Remember to restart Claude Code after installation.

```bash
rtk init --global    # installs hook + patches settings.json
```

--------------------------------

### Install OpenClaw Plugin

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs the OpenClaw plugin from a local directory. This plugin uses the `before_tool_call` hook and delegates to `rtk rewrite`.

```bash
openclaw plugins install ./openclaw
```

--------------------------------

### Initialize RTK Globally or for a Project

Source: https://www.rtk-ai.app/docs/getting-started/quick-start

Install the RTK hook to automatically rewrite commands for your AI assistant. Restart your assistant after initialization.

```bash
# For Claude Code (global — applies to all projects)
rtk init --global


# For a single project only
cd /your/project && rtk init
```

--------------------------------

### Install RTK via Homebrew

Source: https://www.rtk-ai.app/docs/getting-started/installation

Install RTK on macOS and Linux using the Homebrew package manager.

```bash
brew install rtk-ai/tap/rtk
```

--------------------------------

### Verify RTK Installation

Source: https://www.rtk-ai.app/docs/getting-started/installation

Run these commands to check if RTK is installed and functioning correctly. If 'rtk gain' fails but 'rtk --version' succeeds, you might have installed the wrong package.

```bash
rtk --version   # should print: rtk x.y.z
rtk gain        # should show token savings stats
```

```bash
rtk --version   # rtk x.y.z
rtk gain        # token savings dashboard
```

--------------------------------

### Run RTK installation diagnostic script

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

Execute the provided bash script from the RTK repository root to check for common installation problems, including PATH, version, features, and integration status.

```bash
bash scripts/check-installation.sh
```

--------------------------------

### Install RTK for Cursor

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs the RTK hook for Cursor. The hook uses `preToolUse` with Cursor’s `updated_input` format.

```bash
rtk init --global --agent cursor
```

--------------------------------

### Install RTK for Hermes

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK for Hermes. This creates a plugin in `~/.hermes/plugins/rtk-rewrite/` and enables it. The plugin mutates the Hermes `terminal` tool `command` before execution.

```bash
rtk init --agent hermes
```

--------------------------------

### Install RTK for Google Antigravity

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK for Google Antigravity. This command creates a `.agents/rules/antigravity-rtk-rules.md` file in the current project. RTK adds guidance to Antigravity to prefer `rtk <cmd>` over raw commands.

```bash
rtk init --agent antigravity    # creates .agents/rules/antigravity-rtk-rules.md in current project
```

--------------------------------

### Enable full hook support on Windows using WSL

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

For full hook support on Windows, use WSL. Install RTK within WSL and initialize the hook there. Native Windows falls back to CLAUDE.md injection.

```bash
# Inside WSL
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
rtk init -g    # full hook mode works in WSL
```

--------------------------------

### Uninstall RTK (if installed via Cargo)

Source: https://www.rtk-ai.app/docs/getting-started/installation

If you installed RTK using Cargo and need to uninstall it, use this command.

```bash
cargo uninstall rtk
```

--------------------------------

### Install RTK for Kilo Code

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK for Kilo Code. This command creates a `.kilocode/rules/rtk-rules.md` file in the current project. RTK adds guidance to Kilo Code to prefer `rtk <cmd>` over raw commands.

```bash
rtk init --agent kilocode    # creates .kilocode/rules/rtk-rules.md in current project
```

--------------------------------

### Initialize RTK Project Hook

Source: https://www.rtk-ai.app/docs/getting-started/installation

Run this command once per project to enable the Claude Code hook. Use the --global flag for a global installation that automatically patches settings.json.

```bash
rtk init
```

```bash
rtk init --global
```

--------------------------------

### Install RTK for Cline / Roo Code

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Installs RTK for Cline / Roo Code. This command creates a `.clinerules` file in the current project, which Cline reads as custom instructions. RTK adds guidance to prefer `rtk <cmd>` over raw commands.

```bash
rtk init --agent cline    # creates .clinerules in current project
```

--------------------------------

### Verify RTK Hook Installation for Claude Code

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Verifies the status of the RTK hook installation for Claude Code. This command shows the hook status.

```bash
rtk init --show    # shows hook status
```

--------------------------------

### Fix 'rtk gain' not a command

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

Uninstall the incorrect RTK and install the correct one from rtk-ai. Run 'rtk gain' to verify.

```bash
$ rtk gain
rtk: 'gain' is not a rtk command. See 'rtk --help'.
```

```bash
cargo uninstall rtk
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh
rtk gain    # should now show token savings stats
```

--------------------------------

### Automate Weekly RTK Stats with GitHub Actions

Source: https://www.rtk-ai.app/docs/analytics/gain

Configure a GitHub Actions workflow to run weekly, install RTK, generate a weekly JSON report, and commit/push the stats. This automates the reporting process.

```yaml
on:
  schedule:
    - cron: '0 0 * * 1'
jobs:
  stats:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: cargo install rtk
      - run: rtk gain --weekly --format json > stats/week-$(date +%Y-%W).json
      - run: git add stats/ && git commit -m "Weekly rtk stats" && git push
```

--------------------------------

### Uninstall RTK via Homebrew

Source: https://www.rtk-ai.app/docs/getting-started/installation

If RTK was installed using Homebrew, use this command to remove the binary.

```bash
brew uninstall rtk
```

--------------------------------

### Fix Node.js tools not found on Windows

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

Update RTK to v0.23.1 or later to resolve issues with finding Node.js tools installed as .CMD/.BAT wrappers on Windows.

```bash
rtk vitest --run
Error: program not found
```

```bash
cargo install --git https://github.com/rtk-ai/rtk
rtk --version    # should be 0.23.1+
```

--------------------------------

### Uninstall RTK for Pi

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Uninstalls RTK for Pi. This command removes only the installed Pi extension file.

```bash
rtk init --uninstall --agent pi
rtk init --uninstall --agent pi --global
```

--------------------------------

### Verify Token Counts with Tiktoken

Source: https://www.rtk-ai.app/docs/analytics/gain

For precise token counts, install the 'tiktoken' library and use it to encode the content of a file. This is an alternative to RTK's heuristic estimation.

```bash
pip install tiktoken
git status > output.txt
```

```python
import tiktoken
enc = tiktoken.get_encoding('cl100k_base')
print(len(enc.encode(open('output.txt').read())), 'actual tokens')
```

--------------------------------

### Show and Create RTK Configuration

Source: https://www.rtk-ai.app/docs/getting-started/configuration

Use these commands to view the current RTK configuration or create a new configuration file with default settings.

```bash
rtk config            # show current configuration
rtk config --create   # create config file with defaults
```

--------------------------------

### Preview RTK Init Changes with --dry-run

Source: https://www.rtk-ai.app/docs/getting-started/quick-start

See what changes `rtk init` would make without modifying any files. Use `-v` to print the full content that would be written.

```bash
rtk init --global --dry-run
```

```bash
rtk init --global --dry-run -v
```

--------------------------------

### Troubleshoot No Data Showing

Source: https://www.rtk-ai.app/docs/analytics/gain

If no data is showing, verify the history database file exists and check the command count. Running any tracked command, like 'git status', will generate new data.

```bash
ls -lh ~/.local/share/rtk/history.db
sqlite3 ~/.local/share/rtk/history.db "SELECT COUNT(*) FROM commands"
git status    # run any tracked command to generate data
```

--------------------------------

### Monthly Budget Review with JSON and jq

Source: https://www.rtk-ai.app/docs/analytics/gain

Generate a monthly budget review report in JSON format and process it with 'jq' to calculate the percentage of the quota used. This helps in monitoring resource consumption.

```bash
rtk gain --monthly --format json | jq '.monthly[] |
  {month, saved_tokens, quota_pct: (.saved_tokens / 6000000 * 100)}'
```

--------------------------------

### RTK Workflow Visualization

Source: https://www.rtk-ai.app/docs

Illustrates the process of how RTK intercepts and filters command output before it reaches the LLM, showing token savings.

```text
Your AI assistant runs:  git status
                              ↓
              Hook intercepts (PreToolUse)
                              ↓
              rtk git status  (transparent rewrite)
                              ↓
     Raw output: 40 lines     →     Filtered: 3 lines
     ~800 tokens              →     ~60 tokens  (92% saved)
                              ↓
              LLM sees the compact output
```

--------------------------------

### Backup RTK Database

Source: https://www.rtk-ai.app/docs/analytics/gain

Create a backup of the local SQLite database with a timestamped filename. This helps in data recovery and versioning.

```bash
cp ~/.local/share/rtk/history.db ~/backups/rtk-history-$(date +%Y%m%d).db
```

--------------------------------

### Generate Weekly CSV Report

Source: https://www.rtk-ai.app/docs/analytics/gain

Create a weekly progress report in CSV format, saved to a timestamped file. This is useful for tracking progress over time.

```bash
rtk gain --weekly --format csv > reports/week-$(date +%Y-%W).csv
```

--------------------------------

### Run RTK from Windows terminal

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

RTK is a command-line tool. To use it on Windows, open a terminal (cmd, PowerShell, or Windows Terminal) and run commands from there.

```bash
rtk --version
```

--------------------------------

### RTK Gain Command Summary

Source: https://www.rtk-ai.app/docs/analytics/gain

Provides a default summary of RTK token savings. Use temporal breakdown flags for specific time periods or classic flags for historical data and quota estimates.

```bash
rtk gain
```

```bash
rtk gain --daily          # all days since tracking started
```

```bash
rtk gain --weekly         # aggregated by week
```

```bash
rtk gain --monthly        # aggregated by month
```

```bash
rtk gain --all            # all breakdowns at once
```

```bash
rtk gain --graph          # ASCII graph, last 30 days
```

```bash
rtk gain --history        # last 10 commands
```

```bash
rtk gain --quota          # monthly quota savings estimate (default tier: 20x)
```

```bash
rtk gain --quota -t pro   # use pro tier token budget for estimate
```

--------------------------------

### Daily JSON Snapshot for Dashboard

Source: https://www.rtk-ai.app/docs/analytics/gain

Schedule a daily task to create a JSON snapshot of all RTK gain data. This snapshot is used to update a dashboard for real-time monitoring.

```bash
0 0 * * * rtk gain --all --format json > /var/www/dashboard/rtk-stats.json
```

--------------------------------

### Track RTK Adoption with rtk session

Source: https://www.rtk-ai.app/docs/analytics/discover

Use 'rtk session' to view RTK adoption rates across recent Claude Code sessions, showing the number of shell commands that ran through RTK versus raw commands.

```bash
rtk session
```

--------------------------------

### Inspect Raw RTK Database Data

Source: https://www.rtk-ai.app/docs/analytics/gain

Query the local SQLite database to view the last 10 commands, their timestamps, and saved tokens. This is useful for understanding historical usage.

```bash
sqlite3 ~/.local/share/rtk/history.db \
  "SELECT timestamp, rtk_cmd, saved_tokens FROM commands
   ORDER BY timestamp DESC LIMIT 10"
```

--------------------------------

### Full RTK Configuration Structure

Source: https://www.rtk-ai.app/docs/getting-started/configuration

This TOML structure represents the complete configuration for RTK, covering tracking, display, filters, tee system, telemetry, and hooks.

```toml
[tracking]
enabled = true              # enable/disable token tracking
history_days = 90           # retention in days (auto-cleanup)
database_path = "/custom/path/history.db"   # optional override


[display]
colors = true               # colored output
emoji = true                # use emojis in output
max_width = 120             # maximum output width


[filters]
# These apply to file-reading commands (ls, find, grep, cat/rtk read).
# Paths matching these patterns are excluded from output, keeping noise low.
ignore_dirs = [".git", "node_modules", "target", "__pycache__", ".venv", "vendor"]
ignore_files = ["*.lock", "*.min.js", "*.min.css"]


[tee]
enabled = true              # save raw output on failure
mode = "failures"           # "failures" (default), "always", "never"
max_files = 20              # rotation: keep last N files
# directory = "/custom/tee/path"  # optional override


[telemetry]
enabled = true              # anonymous daily ping — see Telemetry & Privacy for full details


[hooks]
exclude_commands = []       # commands to never auto-rewrite
```

--------------------------------

### RTK Gain Weekly and Monthly Breakdowns

Source: https://www.rtk-ai.app/docs/analytics/gain

Use the --weekly flag for Sunday-Saturday weekly breakdowns and the --monthly flag for calendar month breakdowns. These commands provide aggregated data similar to daily breakdowns.

```bash
rtk gain --weekly
```

```bash
rtk gain --monthly
```

--------------------------------

### Fix 'rtk --version' command not found

Source: https://www.rtk-ai.app/docs/resources/troubleshooting

Add ~/.cargo/bin to your PATH if 'rtk --version' returns 'command not found'. Reload your shell configuration after updating.

```bash
$ rtk --version
zsh: command not found: rtk
```

```bash
export PATH="$HOME/.cargo/bin:$PATH"
```

```fish
set -gx PATH $HOME/.cargo/bin $PATH
```

```bash
source ~/.zshrc    # or ~/.bashrc
rtk --version
```

--------------------------------

### Handle Unsupported Commands with Passthrough

Source: https://www.rtk-ai.app/docs/getting-started/quick-start

Commands that RTK does not recognize are run through passthrough, meaning their output is unchanged and usage is tracked.

```bash
rtk proxy make install
```

--------------------------------

### Daily Token Savings Breakdown

Source: https://www.rtk-ai.app/docs/analytics/gain

Displays a daily breakdown of RTK token savings, including commands executed, input/output tokens, and percentage saved. This command shows data for the last 3 days.

```bash
rtk gain --daily
```

--------------------------------

### Process RTK Gain CSV Data with Pandas

Source: https://www.rtk-ai.app/docs/analytics/gain

Use Python's subprocess module to execute the 'rtk gain --all --format csv' command and then parse the output using pandas to create a DataFrame. This allows for programmatic analysis and visualization of daily savings percentage.

```python
import pandas as pd
import subprocess


result = subprocess.run(['rtk', 'gain', '--all', '--format', 'csv'],
                       capture_output=True, text=True)
lines = result.stdout.split('\n')
daily_start = lines.index('# Daily Data') + 2
daily_end = lines.index('', daily_start)
daily_df = pd.read_csv(pd.StringIO('\n'.join(lines[daily_start:daily_end])))
daily_df['date'] = pd.to_datetime(daily_df['date'])
daily_df.plot(x='date', y='savings_pct', kind='line')
```

--------------------------------

### Uninstall RTK Hook and Configuration

Source: https://www.rtk-ai.app/docs/getting-started/installation

Use this command to remove the RTK hook, RTK.md file, and the settings.json entry.

```bash
rtk init -g --uninstall
```

--------------------------------

### Analyze Missed Savings with rtk discover

Source: https://www.rtk-ai.app/docs/analytics/discover

Use 'rtk discover' to analyze your Claude Code command history and identify commands that ran without RTK filtering. Options include analyzing the current project, all projects, or filtering by date.

```bash
rtk discover                    # analyze current project history
```

```bash
rtk discover --all              # all projects
```

```bash
rtk discover --all --since 7    # last 7 days, all projects
```

--------------------------------

### Apply Ultra-compact Flag for Git Log

Source: https://www.rtk-ai.app/docs/resources/what-rtk-covers

Use the --ultra-compact flag to reduce token usage for Git log output. This flag is recommended over the short form `-u` for Git commands to avoid confusion with Git's own `--set-upstream` flag.

```bash
# Ultra-compact: even smaller output
rtk git log --ultra-compact
```

--------------------------------

### RTK Usage Discovery Commands

Source: https://www.rtk-ai.app/docs

Commands to discover commands that ran without RTK, indicating potential missed savings, and to check RTK adoption rates per session.

```bash
rtk discover       # find commands that ran without RTK (missed savings)
rtk session        # RTK adoption rate per Claude Code session
```

--------------------------------

### RTK Savings Analysis Commands

Source: https://www.rtk-ai.app/docs

Commands to analyze token savings achieved by RTK. Use `rtk gain` for total savings and `--daily` or `--weekly` for time-based breakdowns.

```bash
rtk gain           # total savings across all sessions
rtk gain --daily   # day-by-day breakdown
rtk gain --weekly  # weekly aggregation
```

--------------------------------

### Check RTK Telemetry Status

Source: https://www.rtk-ai.app/docs/resources/telemetry

Use this command to view your device hash, which is necessary for various telemetry management operations and GDPR requests.

```bash
rtk telemetry status
```

--------------------------------

### Check RTK Token Savings

Source: https://www.rtk-ai.app/docs/getting-started/quick-start

After using RTK for a while, check the total commands processed, input/output tokens, and percentage saved.

```bash
rtk gain
```

--------------------------------

### Manage RTK Telemetry Consent

Source: https://www.rtk-ai.app/docs/resources/telemetry

Use these commands to check the current telemetry consent state, enable it, disable it, or forget all local telemetry data.

```bash
rtk telemetry status     # Check current consent state
```

```bash
rtk telemetry enable     # Give consent (interactive prompt)
```

```bash
rtk telemetry disable    # Withdraw consent
```

```bash
rtk telemetry forget     # Withdraw consent + delete local data + request server erasure
```

--------------------------------

### Agent Command Rewrite Flow

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Illustrates the sequence of events when an agent intercepts a CLI command, sends it to RTK for rewriting, and then executes the modified command.

```text
Agent runs "cargo test"
  -> Hook intercepts (PreToolUse / plugin event)
  -> Calls rtk rewrite "cargo test"
  -> Returns "rtk cargo test"
  -> Agent executes filtered command
  -> LLM sees 90% fewer tokens
```

--------------------------------

### Disable Telemetry via Configuration File

Source: https://www.rtk-ai.app/docs/getting-started/configuration

Set `enabled = false` under the `[telemetry]` section in your `config.toml` file to disable telemetry.

```toml
# Via config.toml
[telemetry]
enabled = false
```

--------------------------------

### Reset RTK Database

Source: https://www.rtk-ai.app/docs/analytics/gain

Remove the local SQLite database file. The database will be recreated automatically on the next command execution.

```bash
rm ~/.local/share/rtk/history.db    # recreated on next command
```

--------------------------------

### Uninstall RTK for GitHub Copilot

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Uninstalls RTK for GitHub Copilot. This command removes only RTK’s hook file and the RTK block in `copilot-instructions.md`, leaving other files untouched.

```bash
rtk init --uninstall --copilot
rtk init --uninstall --global --copilot
```

--------------------------------

### Estimate RTK Token Savings

Source: https://www.rtk-ai.app/docs/analytics/gain

Use the `--quota` flag with `rtk gain` to estimate token savings relative to your monthly subscription budget. Specify the tier (e.g., 'pro', '5x', '20x') to match your Anthropic Claude API plan.

```bash
rtk gain --quota          # uses 20x tier by default
rtk gain --quota -t pro   # Claude Pro plan budget
rtk gain --quota -t 5x    # 5× usage plan budget
rtk gain --quota -t 20x   # 20× usage plan budget
```

--------------------------------

### Export RTK Token Savings Data

Source: https://www.rtk-ai.app/docs/analytics/gain

Exports all token savings data in JSON or CSV format. Redirect the output to a file to save the data.

```bash
rtk gain --all --format json > savings.json
```

```bash
rtk gain --all --format csv  > savings.csv
```

--------------------------------

### Disable Telemetry via Environment Variable

Source: https://www.rtk-ai.app/docs/getting-started/configuration

Set the `RTK_TELEMETRY_DISABLED=1` environment variable to opt out of sending anonymous telemetry data.

```bash
# Via environment variable
export RTK_TELEMETRY_DISABLED=1
```

--------------------------------

### Forget RTK Telemetry Data

Source: https://www.rtk-ai.app/docs/resources/telemetry

Execute this command to delete local telemetry data, including your device salt and ping marker, and to send an erasure request to the server. This is part of the GDPR erasure procedure.

```bash
rtk telemetry forget
```

--------------------------------

### Enable Verbose Debugging for Git Status

Source: https://www.rtk-ai.app/docs/resources/what-rtk-covers

Use the -vvv flag with `rtk git status` to enable maximum verbosity for debugging. This shows detailed filtering information on stderr, helping to understand RTK's internal processes.

```bash
# Debug: see what RTK is doing
rtk git status -vvv
```

--------------------------------

### Disable RTK Telemetry via Environment Variable

Source: https://www.rtk-ai.app/docs/resources/telemetry

Set the RTK_TELEMETRY_DISABLED environment variable to 1 to block telemetry collection, overriding any consent settings.

```bash
export RTK_TELEMETRY_DISABLED=1
```

--------------------------------

### Exclude Commands from Auto-Rewrite

Source: https://www.rtk-ai.app/docs/getting-started/configuration

Configure the `exclude_commands` list in your TOML file to prevent specific commands from being automatically rewritten by the RTK hook. Patterns can be exact matches or regular expressions.

```toml
[hooks]
exclude_commands = ["git rebase", "git cherry-pick", "docker exec"]
```

```toml
[hooks]
exclude_commands = ["^curl", "^wget", "git rebase"]
```

--------------------------------

### RTK Gain JSON Export Format

Source: https://www.rtk-ai.app/docs/analytics/gain

Export RTK gain data in JSON format for programmatic analysis and integration with dashboards. The JSON output includes a summary and detailed breakdowns for daily, weekly, and monthly data.

```json
{
  "summary": {
    "total_commands": 196,
    "total_input": 1276098,
    "total_output": 59244,
    "total_saved": 1220217,
    "avg_savings_pct": 95.62
  },
  "daily": [...],
  "weekly": [...],
  "monthly": [...]
```

--------------------------------

### Disable RTK Telemetry Collection

Source: https://www.rtk-ai.app/docs/resources/telemetry

Run this command to immediately stop all data collection. This can be used for restricting processing under GDPR or as an objection to data collection.

```bash
rtk telemetry disable
```

--------------------------------

### RTK Token Estimation Calculation

Source: https://www.rtk-ai.app/docs/analytics/gain

RTK estimates tokens using the formula `text.len() / 4`. This provides an estimate accurate to ±10% for trend analysis. The snippet shows how input, output, saved tokens, and savings percentage are calculated.

```text
Input Tokens  = estimate_tokens(raw_command_output)
Output Tokens = estimate_tokens(rtk_filtered_output)
Saved Tokens  = Input - Output
Savings %     = (Saved / Input) × 100
```

--------------------------------

### Disable RTK for a Single Invocation

Source: https://www.rtk-ai.app/docs/getting-started/configuration

Use the `RTK_DISABLED=1` environment variable to prevent RTK from processing a specific command.

```bash
RTK_DISABLED=1 git rebase main
```

--------------------------------

### Exclude Commands Permanently

Source: https://www.rtk-ai.app/docs/getting-started/supported-agents

Permanently exclude specific commands from RTK processing by listing them in the exclude_commands array within the [hooks] section of your rtk config.toml file.

```toml
[hooks]
exclude_commands = ["git rebase", "git cherry-pick"]
```
Tokens:
Raw