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

Comércio direto do seu terminal.Toda ferramenta, um comando.

Autentique, inspecione servers, rode uma sessão, revogue um mandato, exporte a cadeia de auditoria — tudo sem sair do seu shell. Os mesmos guardrails do SDK, output amigável pra scripts, zero telemetria.

requires Node.js 20+ · changelog →
codespar --help →Ver código no GitHub ↗
Demo ao vivo

Uma sessão real, auto-reproduzida.

Os três comandos que você vai rodar nos seus primeiros cinco minutos.

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

@codespar/cli@0.4.0Inspecionar, rodar, acompanhar, 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.

Inspecionar
Navegue pelo catálogo e suas sessões
$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.

Rodar
Cobrar, enviar, descobrir — direto do 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.

Acompanhar
Liquidação assíncrona, KYC, logs ao 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).

Chegando com o AgentGateEnterprise tier — preview

Quatro grupos de comandos.Transacionar, governar, observar, construir.

Como o CLI fica quando as primitivas do tier gerenciado AgentGate (mandatos, policy engine, kill switch, replay de auditoria) chegarem. Os formatos podem mudar antes do GA.

Transacionar
Mova dinheiro a partir do 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.

Governar
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
Auditoria, 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
Gerar, testar, 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.

Feito pro seu shell

Quatro compromissos. Toda release mantém eles.

Zero config

Instale, rode codespar login, pronto. Sua API key fica em ~/.codespar/config.json (chmod 600).

Scripting-first

Todo comando suporta --json. Faça pipe pro jq. Mensagens pra humanos vão pro stderr, dados de máquina pro stdout.

Sessões descartáveis

codespar session send abre uma sessão, roda sua intenção, fecha. Sem boilerplate de SDK pra chamadas avulsas.

Open source · MIT

Código no GitHub, bugs nas Issues, zero telemetria. Cada flag que você vê está documentada.

Uma instalação.A stack inteira no seu shell.

Grátis, com licença MIT, zero telemetria. Os mesmos guardrails do SDK. Rode no seu laptop, faça pipe pelo CI ou embuta nos seus scripts.

Ler a documentação do CLI →Código no GitHub ↗
CodeSpar CLI | CodeSpar