Hookify Plugin

Features

• Create custom hooks via markdown files
• Analyze conversations for unwanted behaviors
• Define rules for bash, file, stop, and prompt events
• Block or warn on rule matches
• Interactive rule management commands

Use Cases

• Preventing the use of dangerous bash commands like `rm -rf`
• Warning about sensitive information in file edits
• Ensuring best practices like running tests before stopping
• Enforcing coding standards by detecting debug statements

Non-Goals

• Replacing core Claude Code functionality
• Managing external dependencies
• Providing a full-fledged security auditing tool

Workflow

1. User invokes `/hookify` command
2. Plugin analyzes conversation or uses provided instructions
3. User selects behaviors and actions (warn/block)
4. Plugin generates `.claude/hookify.{rule-name}.local.md` files
5. Hooks dynamically load rules on next tool use
6. Plugin enforces defined rules during agent execution

Practices

• Rule definition
• Behavioral analysis
• Workflow enforcement

Prerequisites

• Python 3.7+