Overview

Use the Repost CLI to connect internal forwarders to your local machine, inspect webhook traffic, and manage forwarding from the terminal.

The Repost CLI connects your terminal to an internal forwarder. Use it when webhook traffic should reach a development machine, when you need to inspect a live request, or when forwarding needs to be paused during operational work.

Quickstart

Start forwarding

Stripe

Shopify

GitHub

$ repost forward

BucketWebhook ingress

Internal forwarderWaits for CLI listener

CLI to localhostInspect, copy, generate types

Model

How the CLI fits into receiving

Buckets receive webhook events. Internal forwarders hold those events for a connected CLI session. The CLI delivers each event to a local HTTP endpoint and reports the outcome back to Repost.

Select a bucket

Choose the webhook stream you want to work with.

Attach forwarders

Listen to one or more internal forwarders from that bucket.

Inspect traffic

See request and response details as events move through your local app.

TUI

Working in the forward session

repost forward opens an interactive terminal session. Incoming events stream in as they arrive, each is forwarded to your local endpoint, and the response code, status, and duration are recorded for every attempt.

Listening onhttps://nuvera-dev.bucket.repost.sh
Forwarding tohttp://localhost:5000
TimeMethodPathDestCodeStatusDuration
11:40:18.204POST/webhooks/stripeLocal→http://localhost:5000/webhooks/stripe200OK24ms11:40:17.991POST/webhooks/githubLocal→http://localhost:5000/webhooks/github200OK31ms11:40:15.620POST/webhooks/clerkLocal→http://localhost:5000/webhooks/clerk500FAILED1.21s11:40:13.882POST/v1/eventsLocal→http://localhost:5000/v1/events202OK18ms▶11:40:12.342POST/webhooks/smokeLocal→http://localhost:5000/webhooks/smoke404FAILED54ms
CONNECTEDnuvera-dev✓3✗2… 0
↑/kupspacedetailccopyctrl+lclearqquit8cf7709repost.sh

Interactive. Run repost forward with no flags to select the bucket and internal forwarders from prompts.
Non-interactive. Pass --bucket and one or more --forwarder flags to start a session without prompts.
Generate types. Press t on a selected event to generate type definitions from its request body.

Start

First commands

Install the binary, authenticate, then connect an internal forwarder to your local service.

curl -fsSL https://releases.repost.sh/cli/install.sh | sh
repost auth login
repost forward

Docs

Build from here

The CLI documentation is split by task so each page stays short.

Quickstart

Install the binary, sign in, and forward your first event to localhost.

Get started

Local forwarding

Connect internal forwarders, handle pending events, and use the TUI.

Forward events

CI & automation

Token auth, headless forwarding, and pausing forwarders during a deploy.

Automate

Authentication

Browser login, API tokens, environment auth, credential storage, and configuration.

Auth & config

Schema

Define, validate, version, and generate a type-safe SDK and JSON Schema for webhook contracts.

Contracts

Command reference

Review commands, flags, shortcuts, and environment variables.

See commands

Blocks Quickstart