Começo rápido

Quatro comandos de um shell limpo até uma memória pesquisável. Medido, não estimado.

O onboarding que importa é o caminho do agente. Um humano pode se cadastrar depois no app e assumir a mesma chave. A chave não muda.

Quatro comandos

npx @valorbrain/cli init --agent --agent-caller claude-code
npx @valorbrain/cli add "the deploy key lives in the ops vault"
npx @valorbrain/cli search "deploy key"
npx @valorbrain/cli status

Esse é o cadastro inteiro: sem email, sem dashboard, sem cartão. A chave é escrita em ~/.valorbrain/config.json com modo 0600.

Tempo medido

Medido em 2026-08-30 contra o pacote publicado @valorbrain/[email protected], não contra um checkout local:

Passo	Tempo
`init --agent` (frio, inclui o download do npx)	2.5s
`add` → `search`	1.45s
Shell → memória pesquisável	~4s

Alvo: menos de 15 segundos. Referência (mem0, no mesmo dia): ~13s, dos quais 4.66s são pip install. O npx pula essa instalação.

--json (alias --agent) em qualquer comando imprime um único objeto JSON. help --json despeja a superfície inteira.

Cadastre-se como agente

init --agent chama POST https://valorbrain-api.valor.digital/api/v1/agents/signup.

Devolve uma chave vb_agent_… amarrada a um shadow tenant. O padrão é expirar em 30 dias até um humano assumi-la.

A identidade é autodeclarada. --agent-caller nunca é inferido do ambiente. A CLI pode sugerir um caller a partir do env (CLAUDECODE, CURSOR, …) e imprimir uma dica; ela não registra nada a menos que você passe a flag. Se esqueceu:

npx @valorbrain/cli identify claude-code

Caller ids que a CLI entende como dicas: claude-code, cursor, codex, cline, continue, aider, goose, windsurf, kiro, opencode, hermes, zcode, grok. Qualquer outro é armazenado como você digitou.

A resposta do signup inclui uma message escrita como uma instrução para você. Mostre-a ao humano no seu próximo turno voltado para o usuário. Não pule.

Assuma como humano

npx @valorbrain/cli init --email [email protected]

O OTP chega por email. Depois de verificar, a mesma chave vb_agent_ continua funcionando. As memórias são preservadas. Esse é o critério de aceite, e foi verificado ponta a ponta em 2026-08-30.

O que a chave pode fazer

A chave da CLI fala REST com valorbrain-api.valor.digital. O tenant é resolvido a partir do token — você não envia X-Tenant-ID.

Comando	Endpoint
`add`	`POST /documents`
`search`	`POST /search`
`list`	`GET /collections`
`status`	`GET /health` + config local
`identify`	`POST /api/v1/agents/identify`
`init --email`	`POST /api/v1/agents/claim` e depois `/claim/verify`

MCP é uma credencial diferente: vbm_…, criada no app em Settings → MCP tokens, ou obtida via OAuth. Veja MCP.

Caminho humano (app)

Se você não é um agente:

Abra valorbrain.valor.digital.
Ative o email.
Crie um token MCP (vbm_…) ou uma chave de ingest (fk_….sk_…).
Siga MCP ou REST.

Comandos fantasma

Estes aparecem em READMEs antigos e não existem no @valorbrain/[email protected]. help --json é a fonte da verdade.

valorbrain setup harness …
valorbrain setup status
valorbrain setup openclaw
valorbrain setup harness --detect