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

O runtime, a partir do terminal.Rode uma cobrança. Leia o recibo.

Navegue o catálogo, rode uma cobrança, crie um mandato multi-slot, acompanhe a liquidação, conecte provedores. Com o AgentGate, chega a superfície de governo e auditoria. Mesmos guardrails do SDK, saída amigável a 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 quatro comandos que movem o primeiro dólar: login, mandato, spend, wallet.

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

@codespar/cli@0.5.5Inspecionar, rodar, mover, 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

Navegue pelo catálogo LATAM de MCP servers.

$codespar tools show codespar_charge

Mostra o schema de entrada e os trilhos de uma meta-tool.

$codespar sessions list

Sessões recentes com status, número de servers e última atividade.

Rodar
Cobrar, enviar, descobrir — direto do terminal
$codespar discover "issue an NF-e for a service"

Busca semântica + lexical em todo o catálogo.

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

Cobrança via Pix ou cartão pela meta-tool codespar_charge.

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

Etiqueta / cotação / rastreio do Melhor Envio via codespar_ship.

Acompanhar
Liquidação assíncrona, KYC, logs ao vivo
$codespar payment-status tcl_abc123 --stream

Acompanhe a liquidação da cobrança via SSE. SIGINT cancela limpo.

$codespar verification-status tcl_xyz789 --stream

Status da verificação de KYC. approved / rejected / review / expired.

$codespar logs tail --status error

Logs de tool-calls em tempo real. Filtre por server / tool / status.

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

Conecte um provedor (fluxo de certificado / OAuth / API key).

$codespar connect mercadopago

Inicia um Connect Link OAuth para o usuário atual.

$codespar init my-agent

Gera um agente executável (framework + template).

Dinheiro
Mandatos, slots de carteira, transferências
$codespar mandate create --slot brl:50000 --slot usdc:100

Emita um mandato multi-slot: uma assinatura, tetos por moeda.

$codespar wallet

Saldos entre os slots de moeda da carteira, por consumidor.

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

Planeje e execute uma troca entre slots à taxa real.

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

Roda uma cobrança Pix com checagem de política. Retorna o recibo selado.

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

Emite um estorno no trilho original. Nota de crédito automática.

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

Chamada de sessão avulsa, como o SDK, mas do shell.

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

Mostra mandatos ativos com escopo, validade e orçamento restante.

$codespar mandates revoke mdt_4a12b --reason "suspicious"

Revoga um mandato em uma chamada. Registrado no ledger de auditoria.

$codespar org pauseAll --reason "drill"

Kill switch. Congela todos os mandatos da organização.

Observar
Auditoria, export, replay
$codespar audit export --from 2026-01-01 --format json

Exporta um JSON assinado e em hash-chain de cada evento do período.

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

Verifica a hash chain a partir de um checkpoint. Relatório de integridade.

$codespar tail --agent agent-checkout

Transmite eventos ao vivo de um agente específico em tempo real.

Construir
Gerar, testar, publicar
$codespar generate --from ./src/routes --out mcp-myapi

Escaneia suas rotas Express ou Next.js e gera um MCP server executável.

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

Roda cada tool contra a sua API em dry-run e reporta falhas.

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

Prepara o npm publish com prévia do manifesto.

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