Complete reference of all Hooklistener CLI commands.
Global flags
These flags are available on all commands:
| Flag | Default | Description |
|---|
--json | false | Output as JSON (non-interactive commands only) |
--log-level | info | Log level: trace, debug, info, warn, error |
--log-dir | ~/.config/hooklistener/logs | Custom log directory |
--log-stdout | false | Also output logs to stdout |
--help | — | Show help |
--version | — | Show version |
Authentication
| Command | Description |
|---|
hooklistener login | Authenticate via device code flow |
hooklistener login --force | Force re-authentication |
hooklistener logout | Sign out and clear stored token |
Organization
| Command | Description |
|---|
hooklistener org list | List available organizations |
hooklistener org use <id> | Set default organization |
hooklistener org clear | Clear default organization |
Configuration
| Command | Description |
|---|
hooklistener config show | Display current configuration |
hooklistener config set <key> <value> | Set a config value |
Endpoints
| Command | Description |
|---|
hooklistener endpoint create <name> | Create a debug endpoint |
hooklistener endpoint list | List debug endpoints |
hooklistener endpoint show <id> | Show endpoint details |
hooklistener endpoint delete <id> | Delete an endpoint |
Flags: --slug, --org
Requests
| Command | Description |
|---|
hooklistener endpoint requests <endpoint-id> | List captured requests |
hooklistener endpoint request <endpoint-id> <request-id> | Show a request |
hooklistener endpoint delete-request <endpoint-id> <request-id> | Delete a request |
Flags: --page, --page-size, --org
Forwarding
| Command | Description |
|---|
hooklistener endpoint forward-request <endpoint-id> <request-id> <url> | Forward a request |
hooklistener endpoint forwards <endpoint-id> <request-id> | List forwards |
hooklistener endpoint forward <forward-id> | Show forward details |
Flags: --method, --page, --page-size, --org
Listen
| Command | Description |
|---|
hooklistener listen <endpoint-slug> | Forward webhooks in real time |
Flags: --target / -t, --ws-url
Tunnel
| Command | Description |
|---|
hooklistener tunnel | Start an HTTP tunnel |
Flags: --port / -p, --host, --org / -o, --slug / -s
Static tunnels
| Command | Description |
|---|
hooklistener static-tunnel list | List reserved slugs |
hooklistener static-tunnel create <slug> | Reserve a slug |
hooklistener static-tunnel delete <id> | Delete a slug |
Flags: --name, --org
Shell completions
| Command | Description |
|---|
hooklistener completions <shell> | Generate completions |
Shells: bash, zsh, fish, powershell, elvish
Maintenance
| Command | Description |
|---|
hooklistener diagnostics | Generate diagnostic bundle |
hooklistener clean-logs | Remove old log files |
Flags: --output / -o, --keep / -k
Exit codes
| Code | Meaning |
|---|
0 | Success |
1 | Error (authentication, connection, validation, etc.) |