RevKeen CLI

A single Go binary that brings the RevKeen API to your terminal. List customers, create invoices, tail webhook events, pair terminals, and hit any endpoint from the shell — with typed flags, JSON output, and shell completions on every major platform.

Install

macOS

brew install revkeen/tap/revkeen

Linux (Debian / Ubuntu / RHEL)

curl -fsSL https://releases.revkeen.com/cli/install.sh | bash

Windows (Scoop)

scoop bucket add revkeen https://github.com/RevKeen/scoop-bucket
scoop install revkeen

Go install

go install github.com/RevKeen/cli/cmd/revkeen@latest

Verify:

revkeen --version

Quick start

# 1. Log in
revkeen login

# 2. List customers
revkeen customers list

# 3. Create an invoice
revkeen invoices create \
  --customer-id cus_01HT... \
  --currency USD \
  --line "Pro plan — January 2026,9999,1"

# 4. Forward live webhook events to your local server
revkeen listen --forward-to localhost:3000/webhook

Top-level commands

Command	Purpose
revkeen login / logout	Browser OAuth flow, credentials stored in ~/.revkeen/.
revkeen config	Read or write CLI configuration.
revkeen profile	Switch between named profiles.
revkeen listen	Forward live webhook events to a local URL.
revkeen trigger <event>	Emit a test webhook event.
revkeen logs	Tail request / response logs.
revkeen api	Raw, typed access to any REST endpoint.
revkeen completion <shell>	Generate shell completions.
revkeen version	Print CLI version.

Resource commands

Every REST resource is available as a subcommand — shape is revkeen <resource> <action>. Auto-generated from the OpenAPI spec so the CLI is always in lockstep with the API.

revkeen customers list --limit 100
revkeen invoices get inv_01HT...
revkeen subscriptions cancel sub_01HT... --at-period-end
revkeen refunds create --payment-id pay_... --amount-minor 500
revkeen webhook-endpoints list

Run revkeen <resource> --help for the full action list.

Output formats

revkeen customers list --output json     # default: table
revkeen customers list --output ndjson   # streaming large result sets
revkeen customers list --output yaml
revkeen customers list --output csv

Documentation

• CLI docs — every command, every flag
• Authentication — profiles, OAuth, env vars
• API reference — the REST API resource commands map to
• Webhooks guide — use revkeen listen for local development

Contributing

See CONTRIBUTING.md for development setup, test instructions, and the release process.

Please file issues and feature requests on the issue tracker. For security disclosures, see SECURITY.md.

License

MIT — © RevKeen.