Test webhooks locally like Stripe CLI
Forward production webhooks to localhost, test WebSocket connections, and trigger async requests without exposing your dev server.
Visual
CLI workflow
Authenticate, listen for webhooks, and forward to your local server — no public URL needed.
Login & configure
One-time setup with API key
CLI connects via WebSocket
Secure channel established
Receive webhook events
Real-time from production
Forward to localhost
http://localhost:3000/webhook
Your dev server processes
Test, debug, and iterate locally
# Install globally npm install -g @modelriver/cli # Login (one-time setup) modelriver login # Start listening for webhooks modelriver listen --print # Or use quick forward modelriver forward
No public URL required
Like Stripe CLI — receive webhooks via WebSocket, no ngrok or tunnel needed.
Test WebSocket flows
Connect to WebSocket channels and receive real-time AI responses.
Trigger test requests
Send async AI requests from command line and get channel details.
Installation
npm global
Or run with npx for quick testing.
Authentication
Secure tokens
24-hour WebSocket tokens for CLI.
Configuration
Auto-saved
API key and URL saved to config file.
modelriver listen
Receive webhook events via WebSocket (like stripe listen --print).
modelriver forward
Quick webhook forwarding using saved config.
modelriver websocket
Test WebSocket connections and receive real-time responses.
modelriver trigger
Send async AI requests and get channel details.
Use cases
- ● Test webhook integrations during development.
- ● Debug WebSocket connections and async flows.
- ● Trigger test AI requests from the command line.
What's unique
- ● No public URL or ngrok tunnel required.
- ● Built-in WebSocket testing for async workflows.
- ● Interactive login and saved configuration.
Installation and Usage
Install globally or use with npx
# Install globally npm install -g @modelriver/cli # Or use npx (no installation) npx @modelriver/cli listen --print # Login and configure (one-time) modelriver login # Start listening for webhooks modelriver listen --print # Test WebSocket connection modelriver websocket --workflow my-workflow --message "Hello" # Trigger async request modelriver trigger --workflow my-workflow --message "Test"
Full command reference and examples in the CLI documentation.
Test webhooks without exposing your dev server
Install the CLI and start receiving production webhooks on localhost in under a minute.