Show the user the current ContextShield protection status and historical waste prevention stats.
Subcommands
If the user asked for suggestions (/cco-shield suggest) or to apply them
(/cco-shield apply), run instead:
node ${CLAUDE_PLUGIN_ROOT}/src/context-shield.js suggest # preview .contextignore candidates
node ${CLAUDE_PLUGIN_ROOT}/src/context-shield.js apply # append them to ./.contextignore
suggest lists files wasted in 3+ sessions as ready-to-use .contextignore
patterns with per-session token savings. apply appends them (deduped against
existing rules) so those reads are blocked permanently. Show the output as-is.
Status report (default)
Run the following command to get pattern data:
node ${CLAUDE_PLUGIN_ROOT}/src/tracker.js patterns
From the patterns data, present:
- ContextShield Status: Active (it's always active as a PreToolUse hook)
- Protected Files: List files with 3+ waste sessions — these trigger warnings before Read
- Tokens Saved: Estimate based on waste history (files that would have been read without shield)
- Co-occurrence Groups: Files that are usually edited together
Format as a clean status report. If no pattern data exists yet, tell the user: "ContextShield is warming up! It learns from your usage patterns and will start giving you smart suggestions after a few sessions."
End the report with:
ContextShield runs automatically on every Read. No configuration needed.