Quick Start

Get from zero to seeing events in under 2 minutes.

Prerequisites

• Bun runtime installed
• Claude Code CLI installed

Install

# Clone and install
git clone https://github.com/PabloLION/claude-hookwatch.git
cd claude-hookwatch
bun install

Run

# Start Claude Code with hookwatch
claude --plugin-dir "$PWD"

Use Claude normally — every hook event is captured automatically.

Browse Events

# Open the web UI
hookwatch ui

The web UI opens at http://localhost:6004 with a live-updating event timeline.

What You'll See

Once Claude Code starts with hookwatch active, you'll see events captured for every action: tool calls, permission requests, session lifecycle, and more. The web UI shows:

• Event timeline — chronological list of all captured events
• Session filter — narrow down to a specific Claude Code session
• Event detail — full stdin payload for any event
• Wrap viewer — stdout/stderr/exit code for wrapped commands

Plugin Install (Alternative)

Instead of --plugin-dir, you can register hookwatch as a permanent plugin:

hookwatch install

This generates the plugin manifest and hooks configuration. To remove:

hookwatch uninstall

Plugin System

The Claude Code plugin system has known issues that may affect installation. If claude plugin install fails, use --plugin-dir as shown above.

Next Steps

• Features — explore what hookwatch can do
• Hook Events Reference — all 18 event types explained
• Use Cases — real-world patterns for using hookwatch