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

El runtime, desde la terminal.Corre un cobro. Lee el recibo.

Navega el catálogo, corre un cobro, crea un mandato multi-slot, sigue la liquidación, conecta proveedores. Con AgentGate llega la superficie de gobierno y auditoría. Mismos guardrails que el SDK, salida 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 cuatro comandos que mueven el primer dólar: login, mandato, spend, wallet.

codespar — zsh
  ██████╗ ██████╗ ██████╗ ███████╗███████╗██████╗  █████╗ ██████╗ 
 ██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██╔══██╗██╔══██╗
 ██║     ██║   ██║██║  ██║█████╗  ███████╗██████╔╝███████║██████╔╝
 ██║     ██║   ██║██║  ██║██╔══╝  ╚════██║██╔═══╝ ██╔══██║██╔══██╗
 ╚██████╗╚██████╔╝██████╔╝███████╗███████║██║     ██║  ██║██║  ██║
  ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝
@codespar/cli·v0.5.5·The agentic OS for money movement, in your shell.
~ $
Disponible hoyen npm

@codespar/cli@0.5.5Inspeccionar, correr, mover, 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

Explora el catálogo LATAM de MCP servers.

$codespar tools show codespar_charge

Muestra el schema de entrada y los rieles de una meta-tool.

$codespar sessions list

Sesiones recientes con estado, número de servers y última actividad.

Correr
Cobrar, enviar, descubrir — directo desde la terminal
$codespar discover "issue an NF-e for a service"

Búsqueda semántica + léxica en todo el catálogo.

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

Cobro por Pix o tarjeta con la meta-tool codespar_charge.

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

Etiqueta / cotización / rastreo de Melhor Envio vía codespar_ship.

Seguir
Liquidación asíncrona, KYC, logs en vivo
$codespar payment-status tcl_abc123 --stream

Sigue la liquidación del cobro vía SSE. SIGINT cancela limpio.

$codespar verification-status tcl_xyz789 --stream

Estado de la verificación KYC. approved / rejected / review / expired.

$codespar logs tail --status error

Logs de tool-calls en tiempo real. Filtra por server / tool / estado.

Conectar
OAuth, mTLS, HMAC — onboarding de provider
$codespar wizard banco-do-brasil --action initiate

Conecta un proveedor (flujo de certificado / OAuth / API key).

$codespar connect mercadopago

Inicia un Connect Link OAuth para el usuario actual.

$codespar init my-agent

Genera un agente ejecutable (framework + template).

Dinero
Mandatos, slots de billetera, transferencias
$codespar mandate create --slot brl:50000 --slot usdc:100

Emite un mandato multi-slot: una firma, topes por moneda.

$codespar wallet

Saldos entre los slots de moneda de la billetera, por consumidor.

$codespar transfer --from brl --to usdc --amount 150

Planifica y ejecuta un movimiento entre slots al tipo real.

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

Corre un cobro Pix con chequeo de políticas. Devuelve el recibo sellado.

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

Emite un reembolso por el riel original. Nota de crédito automática.

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

Llamada de sesión suelta, como el SDK, pero desde el shell.

Gobernar
Políticas, mandatos, kill switch
$codespar mandates list --agent agent-checkout

Muestra mandatos activos con alcance, vencimiento y presupuesto restante.

$codespar mandates revoke mdt_4a12b --reason "suspicious"

Revoca un mandato en una llamada. Registrado en el ledger de auditoría.

$codespar org pauseAll --reason "drill"

Kill switch. Congela todos los mandatos de la organización.

Observar
Auditoría, export, replay
$codespar audit export --from 2026-01-01 --format json

Exporta un JSON firmado y encadenado por hash de cada evento del rango.

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

Verifica la cadena de hashes desde un checkpoint. Informe de integridad.

$codespar tail --agent agent-checkout

Transmite eventos en vivo de un agente específico en tiempo real.

Construir
Generar, testear, publicar
$codespar generate --from ./src/routes --out mcp-myapi

Escanea tus rutas Express o Next.js y emite un MCP server ejecutable.

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

Corre cada tool contra tu API en dry-run y reporta fallas.

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

Prepara el npm publish con vista previa del manifiesto.

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 ↗
CodeSpar CLI | CodeSpar