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

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:hooks status

Install all itp-hooks

/itp:hooks install

Uninstall hooks

/itp:hooks uninstall

List available backups

/itp:hooks restore

Restore most recent backup

/itp:hooks 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