tether

ITP Hooks Manager

Manage itp-hooks installation in ~/.claude/settings.json.

Claude Code only loads hooks from settings.json, not from plugin.json files. This command installs/uninstalls three itp-hooks:

• PreToolUse guard - Blocks ASCII diagrams without graph-easy source blocks
• PostToolUse reminder - Prompts ADR/spec sync after file modifications
• Fake-data-guard - Detects fake/synthetic data patterns (np.random, Faker, etc.) in new Python files

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

Actions

Action	Description
status	Show current installation state
install	Add itp-hooks to settings.json
uninstall	Remove itp-hooks from settings.json
restore	List available backups with numbers
restore latest	Restore most recent backup
restore <n>	Restore backup by number

Execution

Parse $ARGUMENTS and run the management script:

/usr/bin/env bash << 'HOOKS_SCRIPT_EOF'
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/itp}"
ACTION="${ARGUMENTS:-status}"
bash "$PLUGIN_DIR/scripts/manage-hooks.sh" $ACTION
HOOKS_SCRIPT_EOF

Post-Action Reminder

After install/uninstall/restore operations:

IMPORTANT: Restart Claude Code session for changes to take effect.

The hooks are loaded at session start. Modifications to settings.json require a restart.

Examples

# Check current installation status
/itp:tether status

# Install all itp-hooks
/itp:tether install

# Uninstall hooks
/itp:tether uninstall

# List available backups
/itp:tether restore

# Restore most recent backup
/itp:tether restore latest

Troubleshooting

Issue	Cause	Solution
jq not found	jq not installed	brew install jq
bun not found	bun/node not installed	mise install bun
Already installed	Hook already in settings	Run uninstall first to reinstall
Hooks not working	Session not restarted	Restart Claude Code session
Script not found	Plugin not installed	Re-install plugin via marketplace
Invalid JSON	Corrupted settings.json	Use restore latest to recover

Post-Execution Reflection

After this skill completes, check before closing:

1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.