RevKeen CLI
Install and use the RevKeen command-line client for billing, payments, and operations workflows
The RevKeen CLI is a single, self-contained binary for operator and developer workflows — customers, invoices, subscriptions, payments, refunds, webhooks, and reporting, all from your terminal. Its commands are generated from the RevKeen API contract, so they stay in sync with the API.
The CLI uses a subcommand model (revkeen invoices list), not flags like
--list. See the command reference →.
Install
brew install revkeen/tap/revkeenAll three install the same revkeen binary — pick the one that fits your
environment. Verify the install:
revkeen --version
revkeen --helpAuthentication
Authenticate once with OAuth (PKCE or device) or an API key:
# Interactive OAuth PKCE (recommended for humans)
revkeen login
# Device grant (SSH / headless)
revkeen login --device
# API key (recommended for scripts/CI)
revkeen login --api-key
revkeen config set api-key rk_live_your_api_key
export REVKEEN_API_KEY=rk_live_your_api_key
# Per-invocation override
revkeen --api-key rk_live_your_api_key customers listSecrets prefer the OS keyring (credentials.toml fallback). See
CLI authentication → for the full precedence and
staging setup.
Quick start
revkeen dashboard
revkeen customers list
revkeen customers get cus_01HT3N...
revkeen invoices list --json
revkeen analytics revenue-mrr-summary
revkeen cart status
revkeen doctor --cms sanityHow the CLI is shaped
revkeen <resource> <action> [arguments] [flags]Resource commands map to the RevKeen API. Common actions are list, create,
get, and update, plus resource-specific actions (e.g.
invoices finalize, subscriptions cancel). Run revkeen <resource> --help to
see the exact actions and flags for any resource.
Commands at a glance
Resource commands (generated from the API):
Generated from the API contract — 25 resource groups, 118 commands. Run revkeen <resource> --help for the exact actions and flags for your installed version.
| Group | Actions |
|---|---|
analytics | revenue-mrr-summary, revenue-time-series |
cart-api-keys | status, ensure, rotate |
cart-sessions | create, get, add-line-item, update-line-item, remove-line-item, toggle-add-on, apply-discount-code, set-contact, convert |
checkout-sessions | create, get, expire |
credit-notes | list, create, get, void, list-lines, preview |
customer-meters | list, get |
customer-portal | sessions-create, customer-get, subscriptions-list, subscriptions-get, subscriptions-cancel, invoices-list, invoices-get, mandates-list, mandates-reauthorize, mandates-cancel, mandates-reauthorize-send-otp, mandates-reauthorize-verify-otp |
customers | create, list, get, update, payment-rails-get, preferred-rails-get, payment-methods-list |
dd | mandate-requests-get, validate, preview |
entitlements | list, check |
events | list, get, resend |
integrations | accounting-invoice-payment-requests-create, accounting-invoice-payment-requests-get |
invoice-line-items | list-usage-events |
invoices | list, create, get, update, margin-estimate, finalize, void, send |
mandates | create, list, get, cancel, suspend, reinstate, schedule-collection |
payment-intents | create, list, get, confirm, capture, cancel |
payment-links | create, list, get, expire, update, deactivate, activate, archive |
prices | list, create, get, update, archive |
products | list, create, get, update |
refunds | list, create, get |
storefront | products-list, products-get, origins-list, origins-create, origins-delete, status-get |
subscriptions | create, list, get, update, cancel |
transactions | list, get |
webhook-deliveries | list, get, retry |
webhook-endpoints | list, create, get, update, delete, rotate-secret |
Operator commands (hand-written):
| Command | Purpose |
|---|---|
dashboard | Interactive Bubble Tea merchant dashboard (also bare revkeen on a TTY) |
auth | login (API key) / logout / status |
config | set / list |
api | Raw authenticated request to any endpoint |
cart | Cart status, keys, origins, webhooks setup |
doctor | CMS health check (--cms sanity) |
init | Scaffold or patch Sanity Cart (--cms sanity) |
terminal | POS terminal commands (not implemented yet) |
listen / trigger | Forward webhooks to localhost; send fixture events |
webhooks | listen alias + list helper (list → use webhook-endpoints) |
Output formats
Output defaults to a human-readable table. Use the global flags for other forms:
| Flag | Output |
|---|---|
| (default) | Styled table (Lip Gloss on TTY) |
--json | Pretty-printed JSON |
--output yaml / --output csv | YAML / CSV |
--agent | Compact JSON, no color/TUI, errors as JSON on stderr (for tools/LLMs) |