CLI

@valorbrain/cli: memória agent-native direto do shell. Zero dependências, Node 18+.

Pacote: @valorbrain/cli 0.1.0. Alias do proxy stdio de MCP: @valorbrain/connect.

npx @valorbrain/cli help --json

Aquele JSON é o contrato. Se um blog post ou README citar um subcomando que não está nesse objeto, o comando não existe.

Flags globais

Flag	Alias	Significado
`--json`	`--agent`	Um único objeto JSON no stdout, sem cor, sem spinner
`--key`		Sobrescreve a chave de API (senão `~/.valorbrain/config.json`)
`--url`		Sobrescreve a URL base REST

Padrões:

Cria um shadow tenant e uma chave vb_agent_. Veja o Começo rápido.

Vincula a chave existente a um email via OTP. A chave não muda.

Backfill idempotente de agent_caller. Autodeclarado, nunca inferido do ambiente.

Armazena um documento.

Flag	Mapeia para
`--collection <name>`	`collection` (o padrão depende do servidor; passe um se fizer diferença)
`--title <t>`	`title`
`--type <t>`	tipo de conteúdo (`decision`, `observation`, `problem`, `lesson`, `milestone`, `handoff`, `note`)

Chama POST /documents. O body é armazenado verbatim — sem tradução.

Flag	Significado
`--collection <name>`	Restringe a uma coleção
`--mode auto\|keyword\|semantic\|hybrid`	Modo de recuperação

Chama POST /search com compact: true.

GET /collections.

Config local mais GET /health no host REST.

Proxy MCP stdio ↔ HTTP. @valorbrain/connect é este comando empacotado à parte, para que clientes stdio possam rodar:

{
  "mcpServers": {
    "valorbrain": {
      "command": "npx",
      "args": ["-y", "@valorbrain/connect", "--token", "vbm_…"]
    }
  }
}

O prefixo do token MCP é vbm_, não vb_agent_. Misture os dois e o host MCP vai te rejeitar.

Texto para humanos, ou a superfície de máquina.

npx @valorbrain/cli --url https://your-engine.example.com init --agent

Não existe instalador público de uma linha para o engine. On-prem é um plano Enterprise — implantação acompanhada pela nossa equipe na sua rede.