From 782f7970ad07eccaaf0c53c968f64bd43eecabbe Mon Sep 17 00:00:00 2001 From: mrskwiw Date: Thu, 6 Aug 2026 04:53:47 -0500 Subject: [PATCH] docs(hooks): document tee fallback and RTK_DISABLED in Claude template `hooks/claude/rtk-awareness.md` becomes ~/.claude/RTK.md and is the only RTK documentation a Claude Code agent reliably sees. It documented neither the tee file nor the RTK_DISABLED=1 escape hatch, so an agent needing full output had no recorded option but to distrust the filtering entirely. Adds a "When You Need the Full Output" section that routes to the tee file first (byte-complete ground truth, and Read bypasses the hook) and presents RTK_DISABLED=1 second, for when raw output is needed in the same call. Docs only, no behavior change. Co-Authored-By: Claude Opus 5 --- hooks/claude/rtk-awareness.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/hooks/claude/rtk-awareness.md b/hooks/claude/rtk-awareness.md index f68d972a2e..2c2101cc21 100644 --- a/hooks/claude/rtk-awareness.md +++ b/hooks/claude/rtk-awareness.md @@ -26,4 +26,30 @@ which rtk # Verify correct binary All other commands are automatically rewritten by the Claude Code hook. Example: `git status` → `rtk git status` (transparent, 0 tokens overhead) +## When You Need the Full Output + +Filtering is not lossy — it is deferred. The complete unmodified output is +written to disk and its path is printed at the end of the compact output: + +``` +[full output: /_.log] +``` + +This happens on failures by default, or on every command with +`[tee] mode = "always"` in `config.toml`. + +**Read that path first.** It is byte-for-byte ground truth, and the `Read` +tool bypasses the hook entirely, so retrieving it costs nothing extra. + +If you need raw output *in the same call* — chasing a bug through warnings, or +parsing output whose exact shape matters — prefix the command: + +```bash +RTK_DISABLED=1 # skip rewriting for this one call +``` + +Use it deliberately. The tee file already covers most "I need the full output" +cases, and disabling the filter gives up the token savings that make long +sessions possible. + Refer to CLAUDE.md for full command reference.