Files
rtk-ai__rtk/docs/guide/resources/what-rtk-covers.md
Florian BRUNIAUX 4c9b528206 docs: Adrien review — hierarchy, counts, consistency, gaps
Hierarchy:
- Move troubleshooting.md and what-rtk-covers.md to guide/resources/
- Add guide/resources/telemetry.md (adapted from docs/TELEMETRY.md,
  user-facing: consent, opt-out, GDPR rights — without internal sections)

Content fixes:
- Remove all hardcoded counts (9 ecosystems, 12 agents, 60+, 7 more)
  replaced with qualitative language throughout
- Unify DB filename: tracking.db → history.db everywhere
  (canonical: src/core/constants.rs HISTORY_DB)
- installation.md: replace bare `cargo install rtk` with warning +
  explicit git URL to avoid Rust Type Kit name collision
- supported-agents.md: remove hardcoded agent count
- quick-start.md: remove hardcoded ecosystem list, link to what-rtk-covers

New content:
- gain.md: add --quota section explaining pro/5x/20x tier meanings
- gain.md: add callout linking to discover.md (find missed savings)
- index.md: add "Analyze your usage" section (rtk discover, rtk session)
- configuration.md: clarify ignore_dirs/ignore_files scope, add prose
  link to telemetry.md
- what-rtk-covers.md: clarify --ultra-compact vs git -u short flag conflict

Cross-references:
- All internal links updated for new resources/ paths
- index.md: link to troubleshooting, telemetry, what-rtk-covers, analytics
- discover.md: updated relative link to troubleshooting

README:
- Add Core team section (Patrick Szymkowiak, Florian Bruniaux, Adrien Eppling)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 14:17:58 +02:00

5.1 KiB

title, description, sidebar
title description sidebar
What RTK Optimizes Commands and ecosystems automatically optimized by RTK with typical token savings
order
1

What RTK Optimizes

Once RTK is installed with a hook, these commands are automatically intercepted and filtered. You run them normally — the hook rewrites them transparently before execution.

Typical savings: 60-99%.

Git

Command Savings What changes
git status 75-93% Compact stat format, grouped by state
git log 80-92% Hash + author + subject only
git diff 70% Context reduced, headers stripped
git show 70% Same as diff
git stash list 75% Compact one-line per entry

GitHub CLI

Command Savings What changes
gh pr view 87% Removes ASCII art and verbose metadata
gh pr checks 79% Status + name only, failures highlighted
gh run list 82% Compact workflow run summary
gh issue view 80% Body only, no decoration

Graphite (Stacked PRs)

Command Savings What changes
gt log 75% Stack summary only
gt status 70% Current branch context

Cargo / Rust

Command Savings What changes
cargo test 90% Failures only, passed tests suppressed
cargo nextest 90% Same as test
cargo build 80% Errors and warnings only
cargo check 80% Errors and warnings only
cargo clippy 80% Lint warnings grouped by file

JavaScript / TypeScript

Command Savings What changes
jest 94-99% Failures only
vitest 94-99% Failures only
tsc 75% Type errors grouped by file
eslint 84% Violations grouped by rule
pnpm list 70-90% Compact dependency tree
pnpm outdated 70% Package + current + latest only
next build 80% Route summary + errors only
prisma migrate 75% Migration status only
playwright test 90% Failures + trace links only

Python

Command Savings What changes
pytest 80-90% Failures only
ruff check 75% Violations grouped by file
mypy 75% Type errors grouped by file
pip install 70% Installed packages only, progress stripped

Go

Command Savings What changes
go test 80-90% Failures only
golangci-lint run 75% Violations grouped by file
go build 75% Errors only

Ruby

Command Savings What changes
rspec 80-90% Failures only
rubocop 75% Offenses grouped by file
rake 70% Task output, build errors highlighted

.NET

Command Savings What changes
dotnet build 80% Errors and warnings only
dotnet test 85-90% Failures only
dotnet format 75% Changed files only

Docker / Kubernetes

Command Savings What changes
docker ps 65% Essential columns (name, image, status, port)
docker images 60% Name + tag + size only
docker logs 70% Deduplicated, last N lines
docker compose up 75% Service status, errors highlighted
kubectl get pods 65% Name + status + restarts only
kubectl logs 70% Deduplicated entries
Command Savings What changes
ls 80% Tree format with file counts
find 75% Tree format
grep 70% Truncated lines, grouped by file
diff 65% Context reduced
wc 60% Compact counts
cat / head / tail <file> 60-80% Smart file reading via rtk read
rtk smart <file> 85% 2-line heuristic code summary (signatures only)

Cloud and Data

Command Savings What changes
aws 70% JSON condensed, relevant fields only
psql 65% Query results without decoration
curl 60% Response body only, headers stripped

Global flags

These flags apply to all RTK commands and can push savings even higher:

Flag Description
--ultra-compact ASCII icons, inline format — extra token reduction on top of normal filtering
-v / --verbose Show filtering details on stderr (-v, -vv, -vvv for increasing detail)
# Ultra-compact: even smaller output
rtk git log --ultra-compact

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

:::note Use --ultra-compact (long form) rather than -u when working with Git commands. Git's own -u flag means --set-upstream and the short form can cause confusion. :::

Commands that are not rewritten

If a command isn't in the list above, RTK runs it through passthrough — the output reaches the LLM unchanged. You can explicitly track unsupported commands:

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

To check which commands were missed opportunities: rtk discover.