Skip to main content

Hooklistener CLI

The Hooklistener CLI is a fast, Rust-based command-line tool for managing debug endpoints, forwarding webhooks to your local server, and exposing local services with HTTP tunnels.

Key features​

  • Real-time forwarding — stream webhook requests from existing endpoints to localhost
  • HTTP tunneling — expose your local server to the internet with a public URL (like ngrok)
  • Interactive TUI — browse requests with keyboard shortcuts, search, and filtering
  • Endpoint management — create, list, and delete debug endpoints
  • Request inspection — view headers, body, and metadata from the terminal
  • Request replay — forward captured requests to any URL
  • JSON output — machine-readable output for scripting and automation
  • Shell completions — tab completion for bash, zsh, fish, PowerShell, and elvish
  • Secure authentication — device code OAuth flow (no API keys stored locally)

How it works​

The CLI connects to Hooklistener's API and WebSocket servers to provide real-time interaction with your debug endpoints. Two primary modes:

Listen mode​

Forward webhooks from an existing Hooklistener endpoint to your local development server:

hooklistener listen my-endpoint --target http://localhost:3000

Tunnel mode​

Expose a local server to the internet with a public URL:

hooklistener tunnel --port 3000

Requirements​

  • A Hooklistener account (free tier works)
  • macOS, Linux, or Windows

Quick start​

# Install
brew tap hooklistener/tap
brew install hooklistener

# Authenticate
hooklistener login

# Forward webhooks to localhost
hooklistener listen my-endpoint

See Installation for all installation methods.