Skip to main content
@codespar/cli · v0.1.0

Commerce from your terminal.Every tool, one command.

Authenticate, inspect servers, run a session, revoke a mandate, export the audit chain — all without leaving your shell. Same guardrails as the SDK, scripting-friendly output, zero telemetry.

requires Node.js 20+ · changelog →
codespar --help →View source on GitHub ↗
Live demo

A real session, auto-played.

The three commands you will run in your first five minutes.

codespar — zsh
  ██████╗ ██████╗ ██████╗ ███████╗███████╗██████╗  █████╗ ██████╗ 
 ██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██╔══██╗██╔══██╗
 ██║     ██║   ██║██║  ██║█████╗  ███████╗██████╔╝███████║██████╔╝
 ██║     ██║   ██║██║  ██║██╔══╝  ╚════██║██╔═══╝ ██╔══██║██╔══██╗
 ╚██████╗╚██████╔╝██████╔╝███████╗███████║██║     ██║  ██║██║  ██║
  ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝
@codespar/cli·v0.1.0·Every LatAm commerce API in your shell.
~ $
What you will actually type

Four groups of commands.Transact, govern, observe, build.

Every command supports --json and --help. Human messages go to stderr, machine data to stdout.

Transact
Move money from the shell
$codespar pay --amount 150 --rail pix --to diego-br

Run a policy-checked Pix charge. Returns the sealed receipt.

$codespar refund --tx rcp_8f2a91 --reason "duplicate"

Issue a refund on the original rail. Credit note auto-emitted.

$codespar session send "Charge R$150 and issue the NF-e"

One-off session call, like the SDK but from the shell.

Govern
Policies, mandates, kill switch
$codespar mandates list --agent agent-checkout

Show active mandates with scope, expiry, and remaining budget.

$codespar mandates revoke mdt_4a12b --reason "suspicious"

Revoke a mandate in one call. Written to the audit ledger.

$codespar org pauseAll --reason "drill"

Kill switch. Freezes every mandate across the org.

Observe
Audit, export, replay
$codespar audit export --from 2026-01-01 --format json

Exports a signed, hash-chained JSON of every event in the range.

$codespar audit replay --from hash:0x8f2a...

Verifies the hash chain from a checkpoint. Integrity report.

$codespar tail --agent agent-checkout

Streams live events from a specific agent in real time.

Build
Generate, test, publish
$codespar generate --from ./src/routes --out mcp-myapi

Scan your Express or Next.js routes, emit a runnable MCP server.

$codespar test --server mcp-myapi --all-tools

Runs every tool against your API in dry-run, reports failures.

$codespar publish --server mcp-myapi --dry-run

Stages npm publish with manifest preview.

Designed for your shell

Four commitments. Every release keeps them.

Zero config

Install, run codespar login, done. Your API key lives in ~/.codespar/config.json (chmod 600).

Scripting-first

Every command supports --json. Pipe into jq. Human messages go to stderr, machine data to stdout.

Throwaway sessions

codespar session send opens a session, runs your intent, closes. No SDK boilerplate for one-off calls.

Open source · MIT

Source on GitHub, bugs on Issues, zero telemetry. Every flag you see is documented.

One install.The whole stack in your shell.

Free, MIT-licensed, zero telemetry. Same guardrails as the SDK. Run it on your laptop, pipe it through CI, or embed it in your scripts.

Read the CLI docs →Source on GitHub ↗