CLI

The webhooks.cc CLI forwards webhooks to your local development server with one command. No port forwarding, no ngrok, no configuration files — just whk tunnel.

Updated Mar 2026

Install

brew install kroqdotdev/tap/whk

See all installation options (shell script, GitHub Releases).

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
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.

Learn more

Command reference

All commands and flags.

Tunneling deep dive

Advanced tunneling configuration.