cco-shield

ContextShield Status

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:

1. ContextShield Status: Active (it's always active as a PreToolUse hook)
2. Protected Files: List files with 3+ waste sessions — these trigger warnings before Read
3. Tokens Saved: Estimate based on waste history (files that would have been read without shield)
4. 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.