Rodeo CLI

The official command-line tool for webhook.rodeo - the easiest way to receive, inspect, and forward webhooks to your local development environment.

Installation

npm install -g @webhook-rodeo/cli

Basic usage

The most common workflow is forwarding webhooks to your local server:

# 1. Authenticate with your webhook.rodeo account
rodeo login

# 2. View your webhooks
rodeo webhooks

# 3. Forward a webhook to your local server
rodeo forward 3000 my-webhook

That's it! Webhooks sent to webhook.rodeo will now forward to http://localhost:3000.

Commands

`rodeo login`

Authenticate with your webhook.rodeo account. Opens your browser for secure authentication (supports SSO).

rodeo login

`rodeo webhooks`

List all your active webhooks with their URLs and current forwarding status.

rodeo webhooks

`rodeo forward [PORT] [WEBHOOK-NAME]`

Forward webhook events to your local development server. If you don't provide a port or webhook name, the CLI will prompt you interactively.

# Forward to a specific port
rodeo forward 3000 my-webhook

# Forward to a full URL
rodeo forward http://localhost:8080/webhooks my-webhook

# Interactive mode (prompts for port and webhook)
rodeo forward

Options:

PORT - Port number (e.g., 3000) or full URL (e.g., http://localhost:8080/webhook)
WEBHOOK-NAME - Name of your webhook from webhook.rodeo
--url - Explicitly specify the full URL to forward to

`rodeo status`

Check your current authentication status.

rodeo status

`rodeo logout`

Sign out from your webhook.rodeo account.

rodeo logout

Use cases

Local development

Test webhooks from services like Stripe, GitHub, Twilio, etc. on your local machine without deploying:

# Start your local server
npm run dev  # Running on port 3000

# In another terminal, forward webhooks
rodeo forward 3000 stripe-webhooks

Now Stripe webhooks go directly to your local server!

Testing different environments

Forward the same webhook to different local services:

# Forward to your API server
rodeo forward 8080 my-webhook

# Or to a specific endpoint
rodeo forward http://localhost:8080/api/webhooks my-webhook

Debugging

See the complete request and response data in real-time:

Full request headers and body
Response headers and body
Response time and status codes
Syntax-highlighted JSON

Troubleshooting

Session storage

CLI sessions are stored in ~/.config/rodeo/config.json. To reset:

rodeo logout
# Or manually delete
rm ~/.config/rodeo/config.json