Hooks Daemon Management

Manage your Claude Code Hooks Daemon installation with these commands.

Available Commands

Upgrade Daemon

Update to a new version of the hooks daemon:

/hooks-daemon upgrade          # Auto-detect and upgrade to latest version
/hooks-daemon upgrade 2.14.0   # Upgrade to specific version
/hooks-daemon upgrade --force  # Force reinstall current version

See upgrade.md for detailed upgrade documentation.

Restart Daemon

Required after editing .claude/hooks-daemon.yaml or project handlers:

/hooks-daemon restart

The daemon caches config at startup — restart picks up any config or handler changes.

See restart.md for details.

Check Health & Status

Verify daemon is running correctly:

/hooks-daemon health           # Quick health check
/hooks-daemon logs             # View last 50 lines of logs
/hooks-daemon logs --follow    # Stream logs in real-time

See health.md for health check details.

Develop Project Handlers

Scaffold new project-level handlers:

/hooks-daemon dev-handlers     # Interactive handler scaffolding

See dev-handlers.md for handler development guide.

Quick Start

After editing .claude/hooks-daemon.yaml:

/hooks-daemon restart   # Apply config changes
/hooks-daemon health    # Verify it's running

If you're experiencing issues:

# 1. Check daemon status
/hooks-daemon health

# 2. View recent logs
/hooks-daemon logs

# 3. Generate a bug report with full diagnostics
/hooks-daemon bug-report "description of the issue"

# 4. Restart to recover
/hooks-daemon restart

Troubleshooting

See references/troubleshooting.md for common issues and solutions.

Implementation

Parse subcommand and route to appropriate script:

# Get skill directory (where this SKILL.md is located)
SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# Parse subcommand from $ARGUMENTS
SUBCOMMAND="${1:-help}"
shift || true  # Remove subcommand from arguments

# Route to appropriate script
case "$SUBCOMMAND" in
    upgrade)
        bash "$SKILL_DIR/scripts/upgrade.sh" "$@"
        ;;

    health)
        bash "$SKILL_DIR/scripts/health-check.sh" "$@"
        ;;

    dev-handlers)
        bash "$SKILL_DIR/scripts/init-handlers.sh" "$@"
        ;;

    logs|status|restart|handlers|validate-config|bug-report)
        # Forward to daemon CLI wrapper
        bash "$SKILL_DIR/scripts/daemon-cli.sh" "$SUBCOMMAND" "$@"
        ;;

    help|--help|-h|"")
        # Show help (this SKILL.md content)
        echo "Usage: /hooks-daemon <command> [args...]"
        echo ""
        echo "Available commands:"
        echo "  restart               Restart daemon (required after config changes)"
        echo "  health                Check daemon health and status"
        echo "  upgrade [VERSION]     Upgrade daemon to new version"
        echo "  dev-handlers          Scaffold new project handlers"
        echo "  logs [--follow]       View daemon logs"
        echo "  status                Show daemon status"
        echo "  handlers              List loaded handlers"
        echo "  bug-report DESC       Generate bug report with diagnostics"
        echo ""
        echo "After editing .claude/hooks-daemon.yaml, always run: /hooks-daemon restart"
        echo ""
        echo "For detailed documentation, see the skill files or run:"
        echo "  /hooks-daemon <command> --help"
        ;;

    *)
        echo "Error: Unknown subcommand: $SUBCOMMAND"
        echo ""
        echo "Usage: /hooks-daemon <command> [args...]"
        echo "Run '/hooks-daemon help' for available commands."
        exit 1
        ;;
esac

Note: All daemon management commands require manual user approval. The daemon will not auto-invoke these operations.