v0.1.0 · CLI Toolkit

Zelta CLI

Multi-rail payments, SMS campaigns, and transaction queries — all from your terminal. Pipe JSON output to scripts, CI/CD pipelines, and AI agents.

JSON Output
Multi-Rail Payments
SMS Campaigns
CI/CD Ready

Command Reference

Every command outputs structured JSON with --json for easy piping.

Payments

zelta pay:send, zelta pay:list, zelta pay:stats — send payments, list history, and view aggregate statistics across all rails.

SMS

zelta sms:send, zelta sms:status, zelta sms:balance — send messages, check delivery status, and monitor provider balance.

Configuration

zelta config:init, zelta config:show — initialize API credentials and display the current environment configuration.

Analytics

zelta analytics:dashboard — real-time payment volume, success rates, and rail distribution rendered in the terminal.

Authentication

zelta auth:login, zelta auth:token — OAuth device flow login and token management for CI environments.

Expanding

More commands shipping in v0.2.0: wallet management, spending limits, agent registration, SDK generation, and plugin management.

Quick Start

Four steps from install to piping payment data into your scripts.

1

Install the CLI

$ npm install -g @zelta/cli

# Verify installation
$ zelta --version
zelta/0.1.0 linux-x64 node-v20.11.0
2

Authenticate

$ zelta auth:login

Opening browser for authentication...
Authenticated as dev@example.com
Token saved to ~/.config/zelta/credentials.json
3

Query payments

$ zelta pay:list --limit 5 --json

[
  { "id": "pay_8f3a...", "amount": 1500, "status": "settled", "rail": "x402" },
  { "id": "pay_2c7b...", "amount": 990, "status": "settled", "rail": "stripe" }
]
4

Pipe to scripts and agents

# AI agent consumes JSON output directly
$ zelta pay:list --json | jq '.[] | select(.status == "settled")'

# CI/CD: fail pipeline if payments are failing
$ zelta pay:stats --json --period day | jq -e '.failed == 0'

# Bulk SMS from a file
$ cat contacts.json | jq -c '.[]' | while read c; do
    zelta sms:send --to $(echo $c | jq -r .phone) --message "Your code: $(openssl rand -hex 3)"
  done

Built for Automation

Every feature is designed for scripting, CI/CD integration, and AI agent consumption.

Structured JSON Output

Every command supports --json for machine-readable output. Pipe to jq, feed into scripts, or let AI agents parse results directly.

Multi-Rail Support

Send payments over x402 (USDC), Stripe, Tempo, Lightning, or Visa CLI rails. The CLI auto-selects the best rail or lets you override with --rail.

Secure by Default

Credentials stored in OS keychain. Tokens auto-refresh. Environment variables for CI/CD. Never stores secrets in plaintext.

Spending Limits

Per-agent daily budgets and per-transaction caps enforced server-side. The CLI surfaces remaining budget in --json responses.

Shell Completions

Tab completion for bash, zsh, and fish. Command, flag, and argument suggestions generated from the CLI schema.

Audit Export

Export full transaction audit trails as JSON or CSV. Filter by date range, rail, status, or agent for compliance reporting.

Start building with Zelta CLI

Install the CLI, authenticate, and send your first payment in under two minutes.

Developer Docs Machine Payments

Related: x402 Protocol · Machine Payments · Visa CLI