CLI

Install

brew install kroqdotdev/tap/whk
# or
curl -fsSL https://webhooks.cc/install.sh | sh
# without root: any directory you can write to (created when missing)
curl -fsSL https://webhooks.cc/install.sh | WHK_INSTALL_DIR="$HOME/.local/bin" sh

See all installation options (GitHub Releases too).

Interactive mode

Run whk with no arguments to launch the interactive TUI:

whk

The main menu gives you access to every feature:

• Tunnel: create an endpoint and forward webhooks to localhost
• Listen: stream incoming requests in real time
• Endpoints: create, list, and delete endpoints
• Send: send a test webhook to an endpoint
• Search: search captured requests
• Usage: your plan, quota, and billing
• Auth: log in and out
• Update: check for new versions

Requests are streamed in real time with color-coded HTTP methods, timestamps, and forward results. Press Enter on any request to inspect its headers and body. Navigation uses arrow keys or vim-style j/k.

Subcommand mode

Every feature is also available as a direct subcommand, useful for scripting or when you prefer plain text output.

Authenticate

whk auth login

Opens your browser to verify a device code. Credentials are stored at ~/.config/whk/token.json.

Forward to localhost

whk tunnel 3000

Creates an endpoint, prints its URL, and forwards every incoming webhook to localhost:3000 in real time.

To disable the TUI entirely, pass --nogui or set WHK_NOGUI=1.

For AI agents

An agent can capture webhooks without an account, and without a browser:

whk sandbox create --json
whk sandbox wait <slug> --json

whk sandbox connect --email <address> then prints a link and a code for its human; once they enter it, the regular commands act for their account. Every whk sandbox command is non-interactive and supports --json. See sandbox for the limits and the shared credential file.

Learn more