https://github.com/felipeelias/hook-lab
A web dashboard for watching Claude Code hook events in real time.
https://github.com/felipeelias/hook-lab
claude-code docker elixir hooks liveview phoenix
Last synced: 3 months ago
JSON representation
A web dashboard for watching Claude Code hook events in real time.
- Host: GitHub
- URL: https://github.com/felipeelias/hook-lab
- Owner: felipeelias
- License: mit
- Created: 2026-02-28T17:37:03.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-04T07:13:09.000Z (3 months ago)
- Last Synced: 2026-04-04T08:25:10.456Z (3 months ago)
- Topics: claude-code, docker, elixir, hooks, liveview, phoenix
- Language: Elixir
- Homepage:
- Size: 418 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# HookLab
A web dashboard for watching Claude Code hook events in real time.
## Quickstart
```yaml
services:
app:
image: ghcr.io/felipeelias/hook-lab:latest
ports:
- "4000:4000"
volumes:
- hook_lab_data:/app/data
environment:
SECRET_KEY_BASE: ${SECRET_KEY_BASE}
DATABASE_PATH: /app/data/hook_lab.db
PHX_HOST: localhost
volumes:
hook_lab_data:
```
```bash
export SECRET_KEY_BASE=$(openssl rand -base64 64)
docker compose up -d
```
Open http://localhost:4000.
## Hook configuration
This repo includes a [`docs/claude-settings.example.json`](docs/claude-settings.example.json) that sends every hook event to HookLab over HTTP. Each hook has a 1-second timeout. If HookLab isn't running, Claude Code moves on.
Copy the `hooks` block from that file into `~/.claude/settings.json` or your project's `.claude/settings.json`. Here's a stripped-down version with just two events if you want to start small:
```json
{
"hooks": {
"PreToolUse": [
{
"hooks": [
{
"type": "http",
"url": "http://localhost:4000/api/hooks",
"timeout": 1
}
]
}
],
"PostToolUse": [
{
"hooks": [
{
"type": "http",
"url": "http://localhost:4000/api/hooks",
"timeout": 1
}
]
}
]
}
}
```
Hook settings are read at session start, so open a new Claude Code session after changing them.
### Custom URL
If HookLab is running on a different host or port, replace `http://localhost:4000/api/hooks` in each hook entry with your URL. HTTP hooks don't support environment variable interpolation in the `url` field, so the URL must be edited directly in the settings file.
## Development
```bash
mix setup
mix phx.server
# http://localhost:4000
```
```bash
mix ci
```
```bash
docker compose build
SECRET_KEY_BASE=$(openssl rand -base64 64) docker compose up
```