Command-line interface

The chronapilot CLI is the fastest way to inspect, test, and tunnel webhooks during development.

Install

text
# macOS / Linux
brew install chronapilot/tap/chronapilot

# Windows (Scoop)
scoop bucket add chronapilot https://github.com/chronapilot/scoop-bucket
scoop install chronapilot

# Or via npm
npm install -g @chronapilot/cli

Sign in

OAuth device flow — no copy-pasting API keys:

text
chronapilot login

Common commands

text
chronapilot events list --limit 10
chronapilot events retrieve evt_1abc2def3ghi
chronapilot events create --title "Test" --start-time 2026-05-22T12:00:00-07:00

chronapilot connections list

chronapilot webhooks tail
chronapilot webhooks listen --forward-to http://localhost:3000/webhooks
chronapilot webhooks resend whe_8x9y0z1a2b

chronapilot logs tail
chronapilot openapi > openapi.yaml

Webhook tunnel

chronapilot listen registers a temporary webhook endpoint, terminates the public URL on ChronaPilot's edge, and forwards each delivery to your local port. It also re-signs deliveries so signature verification works against the same secret.

text
$ chronapilot listen --forward-to http://localhost:3000/webhooks
Ready! Endpoint: https://wh-tunnel.chronapilot.com/cli_8a7d2e
Forwarding: http://localhost:3000/webhooks
2026-05-20 11:01:23  event.created       whe_a1b2c3d4   200 (32ms)
2026-05-20 11:01:24  departure.updated   whe_a4b5c6d7   200 (44ms)

Test events

text
chronapilot trigger event.created
chronapilot trigger departure.threshold_reached

Picks a realistic fixture and fires it through your test webhook routing.