Documentation

modelriver forward

Forward webhooks to localhost using your saved configuration. One command to start receiving production events locally.

Overview

The forward command uses your saved configuration (from modelriver login) to forward production webhook events to your local development server. It's the simplest way to test webhook integrations locally.

Usage

Bash
# Simple: uses saved config from login
modelriver forward
 
# Override port
modelriver forward --port 4001
 
# Verbose output
modelriver forward --verbose

Prerequisites

Before using forward, run modelriver login to configure:

  • API Key: Your ModelRiver API key
  • Forward URL: Where to send webhooks (e.g., http://localhost:4000/webhook/modelriver)

Options

OptionDescription
--port <number>Override the port in forward URL
--verboseShow detailed logging
--api-key <key>Override saved API key

How it differs from listen

Featurelistenforward
ConfigurationManual flagsUses saved config
Setup requiredNonemodelriver login first
Best forQuick testingOngoing development
Local serverOptionalAlways forwards

Next steps

  • Listen: More control over webhook reception
  • Trigger: Send test async requests
  • WebSocket: Test WebSocket connections