Skip to main content
This page documents the commands exposed by the current repost binary.

​
Global flags

Config directory

--config <dir> uses a specific config directory for local preferences and encrypted token fallback.

No color

--no-color disables terminal styling for plain output.

Skip update check

--skip-update-check disables the background update check on startup. REPOST_NO_UPDATE_CHECK=1 has the same effect.

​
Command map

auth

Sign in, store a token, check status, or log out.

bucket

List buckets available to the authenticated account.

forwarder

List, pause, resume, or disable forwarders.

forward

Connect internal forwarders to the local CLI TUI.

​
auth

Opens browser login, receives a local callback, and stores an API token securely.
repost auth login
If a token is already saved, this command does not replace it. Run repost auth logout first when you need to switch accounts.
Stores an API token for non-browser authentication. If [TOKEN] is omitted, the CLI reads from stdin or prompts interactively. Tokens must start with rp_ and be 43 characters long.
repost auth token rp_your_token_here
Shows whether authentication is valid. When server validation succeeds, it prints token name, type, prefix, scopes, creation time, last-used time, expiration, and auth method. If a stored token was revoked, the CLI removes it locally.
repost auth status
Attempts to revoke the stored token on the server, then removes the token saved in secure storage. It does not unset REPOST_TOKEN.
repost auth logout

​
bucket

repost bucket list prints every bucket the authenticated account can access. 
repost bucket list
Output columns:
ColumnMeaning
IDBucket identifier.
NAMEHuman-readable bucket name.
SLUGBucket slug. Use this with repost forward -b.
DOMAINPublic bucket domain.
STATUSactive or inactive.
Shortcut: repost bl.

​
forwarder

​
List forwarders

repost forwarder list
Without flags, the CLI lists forwarders across every accessible bucket. Add --bucket <bucket-id> to list forwarders for one bucket. 
repost forwarder list --bucket bkt_123
Output columns:
ColumnMeaning
IDForwarder identifier.
NAMEForwarder name.
TYPEForwarder type, such as INTERNAL.
STATUSactive, paused, or inactive.
TARGETTarget URL, topic display, or -.
Shortcut: repost fl.

​
Pause, resume, or disable

Run without flags for an interactive selector. 
repost forwarder pause
repost forwarder resume
repost forwarder disable
For scripts, pass a bucket slug and one or more forwarder names. 
repost forwarder pause \
  --bucket-slug stripe-prod \
  --forwarder local-webhooks
Action output uses the same table shape for pause, resume, and disable: repost forwarder resume also reactivates a disabled forwarder.
ColumnMeaning
OUTCOMEPAUSED, RESUMED, DISABLED, or FAILED.
NAMEForwarder name.
TYPEForwarder type.
TARGETTarget URL, topic display, or the API error when the action failed.
Shortcuts:
ShortcutEquivalent command
repost fprepost forwarder pause
repost frrepost forwarder resume
repost fdrepost forwarder disable
repost flrepost forwarder list

​
forward

repost forward connects selected internal forwarders to your local machine. 
repost forward
Flags:
FlagMeaning
-b, --bucket-slug <slug>Bucket slug. Required when --forwarder is present.
-f, --forwarder <name>Internal forwarder name. Repeatable. Required when --bucket-slug is present.
--pending-firstProcess pending events before new real-time events.
--skip-pendingSkip pending events for this session and receive new events only.
--headlessRun without the TUI. Intended for CI and tests.
Do not combine --pending-first and --skip-pending. If both are present, --skip-pending takes precedence. Target resolution:
InputRule
Bucket--bucket-slug matches the bucket slug from repost bucket list.
Forwarder--forwarder matches an internal forwarder name in that bucket.
Partial flagsPassing only --bucket-slug or only --forwarder is rejected.
Multiple forwardersRepeat --forwarder for each internal forwarder name.
Headless mode prints HEADLESS_READY after connection setup, then runs without the terminal UI. For automation, pass --skip-pending so startup does not wait on an interactive pending-event decision.

​
TUI shortcuts

ContextKeysAction
Event listj / k, arrow keysMove selection.
Event listg / home, G / endJump to top or bottom.
Event listspaceOpen details.
Event listcCopy the selected row context.
Event listtGenerate types from the selected JSON request body.
Event listctrl+lClear local rows from the TUI.
Detailsspace, escClose details.
DetailscCopy the detail view.
DetailstGenerate types from the selected JSON request body.
Generate typesh / l, arrow keysSwitch language.
Generate typestabEdit the type name.
Generate typesoOpen options.
Generate typesspace, enterToggle an option, cycle a value, or commit an edited value.
Generate typescCopy generated code.
Generate typesescClose the overlay.
Any main viewq, ctrl+cQuit.

​
Maintenance

Version

repost version prints the binary version, and may include commit and build date metadata.

Update

repost update checks for a newer release. Add --force to redownload the latest release.
repost update
repost update --force

​
Environment variables

VariablePurpose
REPOST_TOKENAPI token for non-interactive authentication. Takes priority over stored credentials.
REPOST_CONFIG_DIRConfig directory override.
REPOST_NO_UPDATE_CHECK=1Disable update checks.
REPOST_BASE_URLDerive API, web, and WebSocket URLs from one base domain.
REPOST_API_URLOverride the CLI API URL.
REPOST_WEB_URLOverride the app URL used by browser login.
REPOST_WS_URLOverride the WebSocket URL used by repost forward.
When REPOST_BASE_URL=example.com, the CLI derives https://cli.example.com, https://app.example.com, and wss://ws.example.com/ws. Set REPOST_API_URL, REPOST_WEB_URL, or REPOST_WS_URL when one endpoint needs a different value.