@codespar/cli · v0.4.0

Comercio desde tu terminal.Cada herramienta, un comando.

Autenticá, inspeccioná servers, corré una sesión, revocá un mandato, exportá la cadena de auditoría — todo sin salir de tu shell. Los mismos guardrails que el SDK, output amigable para scripts, cero telemetría.

requires Node.js 20+ ·  changelog →

codespar --help →Ver código en GitHub ↗

Demo en vivo

Una sesión real, auto-reproducida.

Los tres comandos que vas a correr en tus primeros cinco minutos.

codespar — zsh
  ██████╗ ██████╗ ██████╗ ███████╗███████╗██████╗  █████╗ ██████╗ 
 ██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██╔══██╗██╔══██╗
 ██║     ██║   ██║██║  ██║█████╗  ███████╗██████╔╝███████║██████╔╝
 ██║     ██║   ██║██║  ██║██╔══╝  ╚════██║██╔═══╝ ██╔══██║██╔══██╗
 ╚██████╗╚██████╔╝██████╔╝███████╗███████║██║     ██║  ██║██║  ██║
  ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝@codespar/cli·v0.4.0·Every LatAm commerce API in your shell.
~ $ 

Disponible hoyv0.4.0 en npm

`@codespar/cli@0.4.0`Inspeccionar, correr, seguir, conectar.

Every command supports --json and --help. Human messages go to stderr, machine data to stdout. Run codespar --help for the full surface — or see the CLI reference.

Inspeccionar

Navegá el catálogo y tus sesiones

$codespar servers list

Browse the LATAM commerce catalog (109+ servers, 9 verticals).

$codespar tools show codespar_charge

Show a meta-tool's input schema and rails.

$codespar sessions list

Recent sessions with status, server count, and last activity.

Correr

Cobrar, enviar, descubrir — directo desde la terminal

$codespar discover "issue an NF-e for a service"

Semantic + lexical search across the whole catalog.

$codespar charge --input '{ "amount": 5000, ... }'

Pix or card charge via codespar_charge meta-tool.

$codespar ship --input-file ./shipment.json

Melhor Envio label / quote / track via codespar_ship.

Seguir

Liquidación asíncrona, KYC, logs en vivo

$codespar payment-status tcl_abc123 --stream

Stream charge settlement via SSE. SIGINT cancels cleanly.

$codespar verification-status tcl_xyz789 --stream

KYC inquiry status. approved / rejected / review / expired.

$codespar logs tail --status error

Real-time tool-call logs. Filter by server / tool / status.

Conectar

OAuth, mTLS, HMAC — onboarding de provider

$codespar wizard banco-do-brasil --action initiate

Connect a provider (cert / OAuth / API-key flow).

$codespar connect mercadopago

Start an OAuth Connect Link for the current user.

$codespar init my-agent

Scaffold a runnable commerce agent (framework + template).

Llegando con AgentGateEnterprise tier — preview

Cuatro grupos de comandos.Transaccionar, gobernar, observar, construir.

Cómo se ve el CLI una vez que lleguen las primitivas del tier gestionado AgentGate (mandatos, policy engine, kill switch, replay de auditoría). Las formas pueden cambiar antes del GA.

Transaccionar

Mové dinero desde el 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.

Gobernar

Políticas, mandatos, 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.

Observar

Auditoría, 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.

Construir

Generar, testear, publicar

$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.

Diseñado para tu shell

Cuatro compromisos. Cada release los mantiene.

Zero config

Instalá, corré codespar login, listo. Tu API key vive en ~/.codespar/config.json (chmod 600).

Scripting-first

Todo comando soporta --json. Hacé pipe a jq. Los mensajes para humanos van a stderr, los datos de máquina a stdout.

Sesiones descartables

codespar session send abre una sesión, corre tu intención, cierra. Sin boilerplate de SDK para llamadas sueltas.

Open source · MIT

Código en GitHub, bugs en Issues, cero telemetría. Cada flag que ves está documentada.

Una instalación.Todo el stack en tu shell.

Gratis, con licencia MIT, cero telemetría. Los mismos guardrails que el SDK. Corrélo en tu laptop, hacé pipe por el CI o embebelo en tus scripts.

Leer la documentación del CLI →Código en GitHub ↗