Kibble CLI: Accept Payments from Your Terminal

Run npx create-kibble to create payment links and send invoices interactively, via env vars, or by piping JSON — no installation required.

The Kibble CLI lets you accept USDC payments and send invoices without leaving your terminal. You can run it interactively to walk through a guided prompt flow, use --yes with environment variables for scripted one-liners, or pipe a JSON payload with --stdin to automate invoice creation in CI pipelines and agent workflows. No global installation is required — just run npx create-kibble.

Installation

You do not need to install anything globally. Run the CLI directly with npx:

npx create-kibble

For local development or to pin a specific version, install it as a dev dependency:

npm install --save-dev create-kibble

Then invoke it via your package.json scripts or npx:

npx create-kibble

Commands

The CLI exposes two main commands after you complete the initial prompts:

Command	What it does
kibble charge	Creates a USDC payment link and opens it in your browser
kibble invoice	Creates and emails a USDC invoice to your vendor

Three ways to run the CLI

Interactive

Run npx create-kibble with no flags. The CLI prompts you for your business name, email, and action. Best for one-off payments and invoices.

Non-interactive (--yes)

Pass --yes and set environment variables to skip all prompts. Prints the result as JSON to stdout. Best for shell scripts and CI jobs.

Piped JSON (--stdin)

Pipe a JSON invoice payload to stdin with --stdin. Prints the API response as JSON. Best for automation, agent workflows, and programmatic use.

Flags and environment variables

CLI flags

Flag	Description
--yes	Non-interactive mode. Reads all inputs from environment variables and prints JSON to stdout.
--stdin	Reads a JSON invoice payload from stdin and prints the API response as JSON to stdout.
--stdin --dry-run	Validates the invoice JSON payload and echoes it back without calling the API.

Environment variables

Variable	Used with	Description
KIBBLE_EMAIL	--yes	Your merchant email address.
KIBBLE_AMOUNT	--yes	Payment amount in USDC (e.g. "150.00").
KIBBLE_WALLET_TYPE	--yes	privy for a managed wallet or byo for your own.
KIBBLE_WALLET	--yes	Your wallet address (required when KIBBLE_WALLET_TYPE=byo).
KIBBLE_BUSINESS_NAME	--yes	Your business name for the payment link.
KIBBLE_BASE_URL	Any mode	Override the API base URL (e.g. http://localhost:3000 for local dev).
DO_NOT_TRACK=1	Any mode	Disable anonymous analytics.

Pointing the CLI at a different API

Set KIBBLE_BASE_URL to redirect all CLI requests to a different host. This is useful for local development or staging environments:

KIBBLE_BASE_URL=http://localhost:3000 npx create-kibble --yes

Use --stdin when you need to create invoices from an automated system, a scheduled job, or an AI agent. Pipe any JSON that conforms to the invoice schema and capture the structured JSON response for downstream processing:

cat invoice.json | npx create-kibble --stdin

Combine with --dry-run to validate payloads in CI before they hit the API.

Next steps

Create a payment link

Walk through the kibble charge flow and learn the --yes non-interactive mode.

Send an invoice

Walk through the kibble invoice flow and learn how to pipe JSON with --stdin.