@marrona/webhookharbor

Stream captured webhooks from Webhook Harbor straight to your localhost — a durable, ngrok-free forwarder with auto-retry and offline buffering.

Usage

npx @marrona/webhookharbor forward --token <source-token> --to localhost:3000/webhooks

<source-token> is the part after /in/ in your source's capture URL (find it on the Sources page in the app).

Options

| Flag | Description | |------|-------------| | --token, -t | Source capture token. Required (or set WEBHOOKHARBOR_TOKEN). | | --to | Local target, e.g. localhost:3000 or http://localhost:3000/webhooks. Required. | | --host | Server URL (default https://webhookharbor.marrona.app, or WEBHOOKHARBOR_HOST). | | --since <iso> | Replay events received after an ISO timestamp on connect. | | --insecure | Allow http:// targets without a warning. | | --quiet, -q | Less output. |

How it durably forwards

The forwarder polls a cursor-based endpoint that is the source of truth — every event newer than the last cursor is drained in order, so nothing is missed across reconnects or while your machine is offline. A Server-Sent-Events channel adds low-latency "new event" pings that trigger an immediate poll; if it drops, the poll loop keeps working. On any network error the cursor is preserved and the forwarder retries with backoff.

Running from the repo

Until this package is published to npm, run it from the repo:

pnpm --filter @webhookharbor/cli build
node packages/cli/dist/index.js forward -t <token> --to localhost:3000