From 318ba915de32d12208d1cad8ede0885484706e05 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Tue, 10 Mar 2026 19:06:11 +0100
Subject: [PATCH] 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>
---
 CHANGELOG.md                         |  6 +++
 README.md                            |  4 +-
 VERSION                              |  2 +-
 guide/cheatsheet.md                  |  4 +-
 guide/ecosystem/third-party-tools.md | 18 ++++---
 guide/ultimate-guide.md              | 74 ++++++++++++++++++++++++----
 machine-readable/reference.yaml      | 16 +++---
 7 files changed, 95 insertions(+), 29 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bcf786c..01b905c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -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
diff --git a/README.md b/README.md
index d685e15..f385882 100644
--- a/README.md
+++ b/README.md
@@ -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,
diff --git a/VERSION b/VERSION
index 949654d..a91ceb0 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.33.0
+3.33.1
diff --git a/guide/cheatsheet.md b/guide/cheatsheet.md
index acc2265..cce7e92 100644
--- a/guide/cheatsheet.md
+++ b/guide/cheatsheet.md
@@ -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*
diff --git a/guide/ecosystem/third-party-tools.md b/guide/ecosystem/third-party-tools.md
index 705cbbe..38879bf 100644
--- a/guide/ecosystem/third-party-tools.md
+++ b/guide/ecosystem/third-party-tools.md
@@ -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)
 
diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md
index e2f0263..23f3b6f 100644
--- a/guide/ultimate-guide.md
+++ b/guide/ultimate-guide.md
@@ -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
diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml
index ccf0dcd..5307cab 100644
--- a/machine-readable/reference.yaml
+++ b/machine-readable/reference.yaml
@@ -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]