docs(rtk): update RTK coverage from v0.16.0 to v0.28.0
New modules: docker compose, mypy, aws, psql, cargo nextest, Graphite CLI (gt), wc. Major features: TOML Filter DSL (declarative filters, 33+ built-in, no Rust required), rtk rewrite single source of truth (migration note: rtk init --global after upgrade), rtk gain -p per-project savings, rtk init --global settings.json auto-patch, exclude_commands config, SHA-256 hook integrity. Updated: ultimate-guide.md, third-party-tools.md, reference.yaml (version_tested bump). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX
parent
2332ddcacf
commit
318ba915de
7 changed files with 95 additions and 29 deletions
|
|
@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
|
|||
|
||||
## [Unreleased]
|
||||
|
||||
## [3.33.1] - 2026-03-10
|
||||
|
||||
### Updated
|
||||
|
||||
- **RTK documentation updated to v0.28.0** — Synced RTK coverage across `guide/ultimate-guide.md`, `guide/ecosystem/third-party-tools.md`, `machine-readable/reference.yaml`, and global `~/.claude/{CLAUDE.md,RTK.md}`. New content: TOML Filter DSL (declarative filters without Rust, 33+ built-in filters, `.rtk/filters.toml` project-local and `~/.config/rtk/filters.toml` global lookup chain); `rtk rewrite` command (v0.25.0 single source of truth for hook rewrites, migration note: `rtk init --global` required after upgrade); new modules — `rtk docker compose`, `rtk mypy`, `rtk aws`, `rtk psql`, `rtk cargo nextest`, `rtk gt` (Graphite CLI), `rtk wc`; `rtk gain -p` per-project savings; `rtk init --global` with settings.json auto-patch; `exclude_commands` config; SHA-256 hook integrity verification; hook outdated warning.
|
||||
|
||||
## [3.33.0] - 2026-03-10
|
||||
|
||||
### Fixed
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@
|
|||
|
||||
<p align="center">
|
||||
<a href="https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers"><img src="https://img.shields.io/github/stars/FlorianBruniaux/claude-code-ultimate-guide?style=for-the-badge" alt="Stars"/></a>
|
||||
<a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Mar_10,_2026_·_v3.33.0-brightgreen?style=for-the-badge" alt="Last Update"/></a>
|
||||
<a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Mar_10,_2026_·_v3.33.1-brightgreen?style=for-the-badge" alt="Last Update"/></a>
|
||||
<a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-271_questions-orange?style=for-the-badge" alt="Quiz"/></a>
|
||||
<a href="./examples/"><img src="https://img.shields.io/badge/Templates-204-green?style=for-the-badge" alt="Templates"/></a>
|
||||
<a href="./guide/security/security-hardening.md"><img src="https://img.shields.io/badge/🛡️_Threat_DB-15_vulnerabilities_·_655_malicious_skills-red?style=for-the-badge" alt="Threat Database"/></a>
|
||||
|
|
@ -872,7 +872,7 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
|
|||
|
||||
---
|
||||
|
||||
*Version 3.33.0 | Updated daily · Mar 10, 2026 | Crafted with Claude*
|
||||
*Version 3.33.1 | Updated daily · Mar 10, 2026 | Crafted with Claude*
|
||||
|
||||
<!-- SEO Keywords -->
|
||||
<!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,
|
||||
|
|
|
|||
2
VERSION
2
VERSION
|
|
@ -1 +1 @@
|
|||
3.33.0
|
||||
3.33.1
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ tags: [cheatsheet, reference]
|
|||
|
||||
**Written with**: Claude (Anthropic)
|
||||
|
||||
**Version**: 3.33.0 | **Last Updated**: February 2026
|
||||
**Version**: 3.33.1 | **Last Updated**: February 2026
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -638,4 +638,4 @@ Speed: `rg` (~20ms) → Serena (~100ms) → ast-grep (~200ms) → grepai (~500ms
|
|||
|
||||
**Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
|
||||
|
||||
*Last updated: February 2026 | Version 3.33.0*
|
||||
*Last updated: February 2026 | Version 3.33.1*
|
||||
|
|
|
|||
|
|
@ -142,17 +142,21 @@ A CLI proxy that filters command outputs **before** they reach Claude's context.
|
|||
| **Website** | [rtk-ai.app](https://www.rtk-ai.app/) |
|
||||
| **Install** | `brew install rtk-ai/tap/rtk` or `cargo install rtk` |
|
||||
| **Language** | Rust (standalone binary) |
|
||||
| **Version** | v0.16.0 |
|
||||
| **Version** | v0.28.0 |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- `rtk git log` (92% reduction), `rtk git status` (76% reduction), `rtk git diff` (56% reduction)
|
||||
- `rtk vitest run`, `rtk prisma`, `rtk pnpm` (70-90% reduction)
|
||||
- `rtk python pytest`, `rtk go test` (multi-language support)
|
||||
- `rtk cargo test/build/clippy` (Rust toolchain)
|
||||
- `rtk init` - hook-first install, `rtk tree` - project structure, `rtk learn` - interactive learning
|
||||
- `rtk gain` - token savings analytics (SQLite tracking)
|
||||
- `rtk discover` - find missed optimization opportunities
|
||||
- `rtk python pytest`, `rtk mypy`, `rtk go test` (multi-language support)
|
||||
- `rtk cargo test/build/clippy/nextest` (Rust toolchain)
|
||||
- `rtk aws`, `rtk psql`, `rtk docker compose`, `rtk gt` (Graphite CLI)
|
||||
- `rtk wc` - compact word/line/byte counts
|
||||
- `rtk init --global` - hook-first install with settings.json auto-patch
|
||||
- `rtk gain` / `rtk gain -p` - token savings analytics (global + per-project)
|
||||
- **TOML Filter DSL**: add custom output filters for any command without writing Rust — `.rtk/filters.toml` (project) or `~/.config/rtk/filters.toml` (global), 33+ built-in filters
|
||||
- `rtk rewrite` - single source of truth for hook command mapping (v0.25.0+, requires `rtk init --global` after upgrade)
|
||||
- `exclude_commands` config to exclude specific commands from auto-rewriting
|
||||
|
||||
**When to choose RTK vs ccusage/ccburn**:
|
||||
|
||||
|
|
@ -160,7 +164,7 @@ A CLI proxy that filters command outputs **before** they reach Claude's context.
|
|||
- ccusage/ccburn **monitor** it (postprocessing)
|
||||
- Use both together for maximum efficiency
|
||||
|
||||
**Limitations**: Rapid development cadence (30 releases in 23 days). Not suitable for interactive commands or very small outputs.
|
||||
**Limitations**: Not suitable for interactive commands or very small outputs (<100 chars).
|
||||
|
||||
> **Cross-ref**: Full docs at [ultimate-guide.md Section 9](./ultimate-guide.md#command-output-optimization-with-rtk)
|
||||
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@ tags: [guide, reference, workflows, agents, hooks, mcp, security]
|
|||
|
||||
**Last updated**: January 2026
|
||||
|
||||
**Version**: 3.33.0
|
||||
**Version**: 3.33.1
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -5034,7 +5034,7 @@ The `.claude/` folder is your project's Claude Code directory for memory, settin
|
|||
| Personal preferences | `CLAUDE.md` | ❌ Gitignore |
|
||||
| Personal permissions | `settings.local.json` | ❌ Gitignore |
|
||||
|
||||
### 3.33.0 Version Control & Backup
|
||||
### 3.33.1 Version Control & Backup
|
||||
|
||||
**Problem**: Without version control, losing your Claude Code configuration means hours of manual reconfiguration across agents, skills, hooks, and MCP servers.
|
||||
|
||||
|
|
@ -15977,10 +15977,10 @@ cargo install rtk
|
|||
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/main/install.sh | bash
|
||||
|
||||
# Verify installation
|
||||
rtk --version # v0.16.0+
|
||||
rtk --version # v0.28.0+
|
||||
```
|
||||
|
||||
**Proven Token Savings (Benchmarked on v0.2.0):**
|
||||
**Proven Token Savings (Benchmarked on real output):**
|
||||
|
||||
| Command | Baseline | RTK | Reduction |
|
||||
|---------|----------|-----|-----------|
|
||||
|
|
@ -15993,7 +15993,7 @@ rtk --version # v0.16.0+
|
|||
|
||||
**Average: 60-90% token reduction depending on commands**
|
||||
|
||||
**Key Features (v0.16.0):**
|
||||
**Key Features (v0.28.0):**
|
||||
|
||||
```bash
|
||||
# Git operations
|
||||
|
|
@ -16008,23 +16008,44 @@ rtk prisma migrate status # Migration status filtered
|
|||
|
||||
# Python
|
||||
rtk python pytest # Python test output condensed
|
||||
rtk mypy # Type errors grouped by file
|
||||
|
||||
# Go
|
||||
rtk go test # Go test results filtered
|
||||
|
||||
# Rust
|
||||
rtk cargo test # Cargo test output condensed
|
||||
rtk cargo nextest # cargo-nextest failures-only output
|
||||
rtk cargo build # Build output filtered
|
||||
rtk cargo clippy # Lints grouped by severity
|
||||
|
||||
# Project Setup & Learning
|
||||
rtk init # Initialize RTK in a project (hook-first install)
|
||||
# Cloud & Database
|
||||
rtk aws # AWS CLI output filtered
|
||||
rtk psql # psql query results condensed
|
||||
rtk docker # Docker output condensed
|
||||
rtk docker compose # docker compose support
|
||||
|
||||
# Version control (extra)
|
||||
rtk gt # Graphite CLI support
|
||||
|
||||
# File & Text Utilities
|
||||
rtk tree # Project structure condensed
|
||||
rtk wc # Compact word/line/byte counts
|
||||
rtk read file.ts # File contents condensed
|
||||
|
||||
# Project Setup & Learning
|
||||
rtk init # Initialize RTK with hook auto-install
|
||||
rtk init --global # Install hook globally (settings.json auto-patch)
|
||||
rtk learn # Interactive RTK learning
|
||||
|
||||
# Analytics
|
||||
rtk gain # Token savings dashboard (SQLite tracking)
|
||||
rtk gain -p # Per-project token savings breakdown
|
||||
rtk discover # Find missed optimization opportunities
|
||||
|
||||
# Hook & Config Management
|
||||
rtk rewrite <cmd> # Single source of truth for hook rewrites
|
||||
rtk verify # Validate TOML filter rules
|
||||
```
|
||||
|
||||
**Real-World Impact:**
|
||||
|
|
@ -16036,11 +16057,30 @@ rtk discover # Find missed optimization opportunities
|
|||
- Savings: 109K tokens (72.6% reduction)
|
||||
```
|
||||
|
||||
**TOML Filter DSL (v0.28.0 — add filters without writing Rust):**
|
||||
|
||||
RTK now supports a declarative filter engine via TOML config. You can add custom output filters for any command without touching Rust code.
|
||||
|
||||
```toml
|
||||
# .rtk/filters.toml (project-local) or ~/.config/rtk/filters.toml (user-global)
|
||||
|
||||
[[filters]]
|
||||
match_command = "my-build-tool"
|
||||
strip_lines_matching = "^(DEBUG|TRACE|INFO):"
|
||||
max_lines = 50
|
||||
```
|
||||
|
||||
Lookup chain: `.rtk/filters.toml` (project) → `~/.config/rtk/filters.toml` (global) → 33 built-in filters (brew, poetry, dotnet, swift, uv, tofu, ansible, helm, etc.)
|
||||
|
||||
Available primitives: `strip_ansi`, `replace`, `match_output`, `strip/keep_lines_matching`, `truncate_lines_at`, `head/tail_lines`, `max_lines`, `on_empty`
|
||||
|
||||
Debug: `RTK_NO_TOML=1` bypasses all TOML filters. `RTK_TOML_DEBUG=1` shows which filter fires.
|
||||
|
||||
**Integration Strategies:**
|
||||
|
||||
1. **Hook-first install** (recommended):
|
||||
```bash
|
||||
rtk init # Sets up PreToolUse hook automatically
|
||||
rtk init --global # Sets up PreToolUse hook + patches settings.json automatically
|
||||
```
|
||||
|
||||
2. **CLAUDE.md instruction** (manual wrapper):
|
||||
|
|
@ -16063,6 +16103,22 @@ rtk discover # Find missed optimization opportunities
|
|||
- PreToolUse hook intercepts bash commands
|
||||
- Applies RTK wrapper when beneficial
|
||||
|
||||
**Configuration Options:**
|
||||
|
||||
```toml
|
||||
# ~/.config/rtk/config.toml
|
||||
exclude_commands = ["my-interactive-tool", "fzf"] # Never rewrite these
|
||||
```
|
||||
|
||||
**Migration Note (v0.25.0+):**
|
||||
|
||||
After upgrading from v0.24.0 or earlier, run `rtk init --global` to install the new thin-delegator hook. The old hook still works, but won't pick up new command mappings automatically.
|
||||
|
||||
```bash
|
||||
cargo install rtk # Upgrade binary
|
||||
rtk init --global # Replace hook with thin delegator
|
||||
```
|
||||
|
||||
**Recommendation:**
|
||||
|
||||
- ✅ **Use RTK**: Full-stack projects (JS/TS, Rust, Python, Go), testing workflows, analytics
|
||||
|
|
@ -22810,4 +22866,4 @@ We'll evaluate and add it to this section if it meets quality criteria.
|
|||
|
||||
**Contributions**: Issues and PRs welcome.
|
||||
|
||||
**Last updated**: January 2026 | **Version**: 3.33.0
|
||||
**Last updated**: January 2026 | **Version**: 3.33.1
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
# Source: guide/ultimate-guide.md
|
||||
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
|
||||
|
||||
version: "3.33.0"
|
||||
version: "3.33.1"
|
||||
updated: "2026-03-03"
|
||||
|
||||
# ════════════════════════════════════════════════════════════════
|
||||
|
|
@ -107,7 +107,7 @@ deep_dive:
|
|||
rtk_skill: "examples/skills/rtk-optimizer/SKILL.md"
|
||||
rtk_hook: "examples/hooks/bash/rtk-auto-wrapper.sh"
|
||||
rtk_purpose: "Command output filtering before LLM context (60-90% avg reduction)"
|
||||
rtk_version_tested: "v0.16.0"
|
||||
rtk_version_tested: "v0.28.0"
|
||||
rtk_score: "5/5"
|
||||
rtk_installation: "cargo install rtk or brew install rtk-ai/tap/rtk"
|
||||
# Google Antigravity (Agent-First IDE)
|
||||
|
|
@ -1510,7 +1510,7 @@ ecosystem:
|
|||
- "Cross-links modified → Update all 4 repos"
|
||||
history:
|
||||
- date: "2026-01-20"
|
||||
event: "Code Landing sync v3.33.0, 66 templates, cross-links"
|
||||
event: "Code Landing sync v3.33.1, 66 templates, cross-links"
|
||||
commit: "5b5ce62"
|
||||
- date: "2026-01-20"
|
||||
event: "Cowork Landing fix (paths, README, UI badges)"
|
||||
|
|
@ -1522,7 +1522,7 @@ ecosystem:
|
|||
onboarding_matrix_meta:
|
||||
version: "2.1.0"
|
||||
last_updated: "2026-03-09"
|
||||
aligned_with_guide: "3.33.0"
|
||||
aligned_with_guide: "3.33.1"
|
||||
changelog:
|
||||
- version: "2.1.0"
|
||||
date: "2026-03-09"
|
||||
|
|
@ -1553,7 +1553,7 @@ onboarding_matrix:
|
|||
core: [rules, sandbox_native_guide, commands]
|
||||
time_budget: "5 min"
|
||||
topics_max: 3
|
||||
note: "SECURITY FIRST - sandbox before commands (v3.33.0 critical fix)"
|
||||
note: "SECURITY FIRST - sandbox before commands (v3.33.1 critical fix)"
|
||||
|
||||
beginner_15min:
|
||||
core: [rules, sandbox_native_guide, workflow, essential_commands]
|
||||
|
|
@ -1642,7 +1642,7 @@ onboarding_matrix:
|
|||
- default: agent_validation_checklist
|
||||
time_budget: "60 min"
|
||||
topics_max: 6
|
||||
note: "Dual-instance pattern for quality workflows (v3.33.0)"
|
||||
note: "Dual-instance pattern for quality workflows (v3.33.1)"
|
||||
|
||||
learn_security:
|
||||
intermediate_30min:
|
||||
|
|
@ -1653,7 +1653,7 @@ onboarding_matrix:
|
|||
- default: permission_modes
|
||||
time_budget: "30 min"
|
||||
topics_max: 4
|
||||
note: "NEW goal (v3.33.0) - Security-focused learning path"
|
||||
note: "NEW goal (v3.33.1) - Security-focused learning path"
|
||||
|
||||
power_60min:
|
||||
core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
|
||||
|
|
@ -1678,7 +1678,7 @@ onboarding_matrix:
|
|||
core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
|
||||
time_budget: "60 min"
|
||||
topics_max: 6
|
||||
note: "Security foundation + core workflow (v3.33.0 sandbox added)"
|
||||
note: "Security foundation + core workflow (v3.33.1 sandbox added)"
|
||||
|
||||
intermediate_120min:
|
||||
core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue