BillerAPI CLI

Try it before signup

npx -y billerapi-cli@1.1.0 demo

This read-only command does not create an account or write local configuration.

Local webhook loop

npm install -g billerapi-cli
billerapi login
billerapi doctor
billerapi samples create node-express
billerapi listen --forward-to http://localhost:3000/webhook

# In another terminal
billerapi trigger bill.created --link_id=lnk_1 --amount=4200

The listener reconnects with exponential backoff and falls back to delivery polling after repeated stream failures. Forwarded requests use the production-compatible signature scheme.

Create now, claim later

Create an immediate sandbox profile without signup or prompts. The receipt contains a sensitive, one-shot claim_url; give it only to the intended human who will attach the sandbox and accept the current legal documents later on the web. Production is the default; use --environment to select canonical local, staging, or production API Gateway and sandbox-data hosts together.

billerapi sandbox create

Configure your coding agents

After installing the verified published CLI, preview the detected Claude Code, Cursor, and Codex changes, review the secret-free receipt, then apply only that exact bundle. This first release supports macOS on Apple silicon only; other runtimes fail before download or mutation. Existing configuration must parse before the command will touch it.

billerapi agent setup --dry-run
billerapi agent setup --expected-bundle-sha256 <reviewed_bundle_sha256>

The command installs the BillerAPI MCP entry and public skills with compare-and-swap publication, then prints a secret-free receipt of every change. If publication is interrupted, later setup runs fail closed without changing either copy. Restore the intended private backup manually. Preserve the other copy for review, then run a fresh dry-run. Production is the default; pass --environment local, --environment staging, or --environment production to use that environment's canonical MCP and skills-catalog hosts. Preview and apply must use the same environment because it is bound into the approval digest.

Useful commands