/auto-retrospective — Configure Auto-Trigger Settings
Manage the auto-scale hook that triggers /rrr and /forward based on context window usage.
CRITICAL: Auto = Silent
When auto-triggered, run /rrr and /forward SILENTLY.
- Do NOT ask the user "should I run /rrr?" — just do it
- Do NOT announce "I'm about to run /rrr" — just do it
- Do NOT prompt for confirmation — the user already opted in by having auto enabled
- Write the retro files quietly, then continue with whatever the user was doing
- If the user notices and asks "why did you do that?" → explain: "Auto-retrospective is enabled. You can disable it with
/auto-rrr off"
The whole point is zero distraction. Auto means auto.
Usage
/auto-rrr # Show current status
/auto-rrr on # Enable auto-triggers
/auto-rrr off # Disable auto-triggers
/auto-rrr status # Show thresholds + next triggers
/auto-rrr rrr:150k # Set /rrr interval to every 150k tokens
/auto-rrr fwd:200k # Set /forward interval to every 200k tokens
/auto-rrr rrr:100k fwd:195k # Set bothHow It Works
Auto-scale hook (~/.claude/hooks/auto-scale.sh) runs on every UserPromptSubmit:
- Reads context usage from
/tmp/statusline-raw.json - Shows status line:
10:20 | 46k (rrr:100k fwd:195k) | white.local | auto:on - At threshold: injects system message to run /rrr or /forward silently
- Uses flag files per session to avoid re-triggering
Steps
status (default, no args)
TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
HOOK="$HOME/.claude/hooks/auto-scale.sh"
# Current intervals
grep "RRR_INTERVAL=" "$HOOK" | head -1
grep "FWD_INTERVAL=" "$HOOK" | head -1
# Toggle status
[ -f "$TDIR/claude-auto-scale-off" ] && echo "auto: OFF" || echo "auto: ON"
# Current context
cat "$TDIR/statusline-raw.json" 2>/dev/null | jq -r '"Context: \(.context_window.used_percentage)% (\((.context_window.current_usage | ((.input_tokens//0)+(.cache_creation_input_tokens//0)+(.cache_read_input_tokens//0)+(.output_tokens//0))) / 1000 | floor))k)"'Display:
Auto-RRR Status:
/rrr every 100k tokens
/forward every 195k tokens
Toggle: ON
Context: 14% (46k)
Next /rrr: 100k
Next /forward: 195kon
TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
rm -f "$TDIR/claude-auto-scale-off"off
TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
touch "$TDIR/claude-auto-scale-off"rrr:k / fwd:k
Update the interval in the hook script:
HOOK="$HOME/.claude/hooks/auto-scale.sh"
# For rrr:150k
sed -i 's/RRR_INTERVAL=.*/RRR_INTERVAL=150/' "$HOOK"
# For fwd:200k
sed -i 's/FWD_INTERVAL=.*/FWD_INTERVAL=200/' "$HOOK"Then clear session flags to apply immediately:
TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
rm -f "$TDIR/claude-auto-rrr-"* "$TDIR/claude-auto-fwd-"*Show updated status after any change.
Hook Location
~/.claude/hooks/auto-scale.sh — registered in ~/.claude/settings.json under UserPromptSubmit.
If hook doesn't exist, tell user to create it or run the setup.
When User Asks "Why Did You Do That?"
If the user notices a retro was written automatically and asks about it:
Auto-retrospective is enabled — it runs /rrr silently when context
reaches the threshold (default: every 100k tokens).
/auto-rrr off # disable auto-triggers
/auto-rrr on # re-enable
/auto-rrr rrr:150k # change threshold
/auto-rrr status # see current settingsNever be defensive. Just explain and show the controls.
Default Behavior
- Default: ON (auto, silent)
- Memory consent = auto (from /awaken): auto-rrr is expected
- Memory consent = manual (from /awaken): auto-rrr is OFF until user enables it
- Check CLAUDE.md Demographics table for Memory field
ARGUMENTS: $ARGUMENTS