Skip to main content
The Kibble CLI lets you create USDC payment links and professional PDF invoices directly from your terminal. It runs via npx - no global installation needed - and works in three modes: an interactive wizard for ad-hoc use, a non-interactive --yes flag for scripting and CI, and a --stdin flag for piping structured JSON payloads from automated pipelines or agents.
The CLI is Kibble’s supported integration surface today. Treat command flags, environment variables, stdin payloads, and stdout JSON as the public contract.

​
Installation

You don’t need to install anything globally. Run the CLI with npx: 
npx create-kibble
Node 18 or later is required. The CLI fetches the latest version from npm on each run.

​
Interactive mode

When you run npx create-kibble without any flags, the CLI starts an interactive session. It walks you through a short sequence of prompts before presenting the action menu.
1

Analytics consent (EU only)

If your system timezone is in the EU, you’ll be asked whether to enable anonymous analytics. You can opt out at any time by setting DO_NOT_TRACK=1.
2

Business name

Enter the name that will appear on payment links and invoices.
3

Email

Your merchant email. Used for payment confirmation notifications.
4

Choose an action

Select from the action menu:
ActionStatusDescription
kibble chargeAvailableGenerate a payment link
kibble invoiceAvailableCreate and send a PDF invoice
kibble yieldComing soonEarn yield on your USDC treasury
kibble cardsComing soonProgrammable spend cards
kibble formComing soonEntity formation from your terminal

​
Two primary commands

kibble charge

Generate a payment link with a USDC amount. Share it with a customer and get paid on Base. Outputs a URL, QR code, merchant portal link, and iframe embed snippet.

kibble invoice

Create a professional PDF invoice with line items, send it to your vendor by email, and collect USDC payment via a dedicated deposit address.

​
Three operating modes

Interactive

Run npx create-kibble with no flags. Guided prompts walk you through each step. Best for one-off payments and invoices.

--yes (non-interactive)

Pass --yes and supply env vars. Outputs JSON to stdout. Best for scripts, CI pipelines, and agent-driven workflows.

--stdin (programmatic)

Pipe a JSON invoice payload to stdin. Returns a JSON response. Best for server-side automation and batch invoice generation.
For scripting and automation details — including all env vars, the --stdin JSON schema, and pipeline examples — see Automation.

​
Environment variables

VariableDescription
DO_NOT_TRACK=1Disable anonymous usage analytics
KIBBLE_BASE_URLPoint the CLI at a non-production Kibble backend when developing or testing

​
What happens next

After the CLI creates a payment link or invoice, it prints the relevant URLs and opens your browser automatically. Payments are detected on-chain in real time — you’ll receive an email when the USDC arrives.