Brains Copilot CLI

Converse com o Brains Copilot CLI pelo terminal. Fala direto com o gateway (API compatível com OpenAI), com streaming, escolha de modelo e skills.

Cada pessoa usa com a própria conta: gere uma API key na sua Conta no site e configure abaixo. As chamadas consomem a cota do seu plano.

Requisitos

• Node.js 18+ (usa fetch nativo). Sem dependências externas.

Instalação

Depois de publicado no npm:

npm install -g brains-copilot-cli

Ou local, na pasta cli/:

npm install -g .

Isso cria o comando brains no PATH (no Windows, o npm gera o brains.cmd). Para desinstalar: npm uninstall -g brains-copilot-cli.

Alternativa sem instalar: node brains.mjs "sua pergunta".

Configuração

1. No site do Brains, abra Conta → API keys → Gerar nova key e copie a chave (brains_sk_…).
2. Configure o CLI só com a sua key (a URL já vem embutida):

brains config --token brains_sk_SUA_KEY

Confira sua conta e plano a qualquer momento:

brains whoami

Fica salvo em ~/.brains/config.json. As chamadas consomem a cota do seu plano. Também dá para usar variáveis de ambiente (precedência: flags > ambiente > arquivo):

BRAINS_URL · BRAINS_TOKEN · BRAINS_MODEL · BRAINS_SKILL

Avançado (admin): dá para apontar direto ao gateway (Railway) com o GATEWAY_TOKEN — acesso sem cota, só para uso próprio. Não distribua esse token.

Uso

# pergunta única (resposta em streaming)
brains "resuma a LGPD em 3 linhas"

# escolher o modelo
brains -m openrouter:anthropic/claude-opus-4 "revise este parágrafo"

# forçar uma skill (ou "auto" para o gateway escolher)
brains -s minutar-documento "contrato de prestação de serviço"

# ler da entrada padrão (pipe)
git diff | brains -s git-commit "escreva a mensagem de commit"

# modo interativo (chat com histórico na sessão)
brains

# modo agente: a IA pode LER e EDITAR arquivos do projeto (confirma antes de gravar)
brains -a "crie testes para src/cpf.js e conserte o bug do dígito verificador"

# anexar o conteúdo de arquivos à pergunta
brains -f app.js -f utils.js "ache o bug que quebra o login"

# continuar a última conversa desta pasta
brains -c "agora adicione tratamento de erro"

# memória local (a IA lembra quem você é em toda conversa)
brains memory set "sou advogada e dev full-stack; quero respostas diretas, em PT"
brains memory            # vê a memória atual

# listar modelos e skills
brains models            # ou: brains models cerebras
brains skills

Modo agente — editar arquivos do projeto

Com -a (ou /agente no chat), a IA pode ler e modificar arquivos da pasta atual:

cd meu-projeto
brains -a "renomeie a função antiga e atualize todos os usos"

Como funciona:

• A IA recebe a lista de arquivos do projeto e pode pedir para ler os que precisar.
• Quando vai criar/editar, o CLI mostra o que será gravado e pede confirmação ([s/N]).
• Tudo fica travado na pasta atual — ele não escreve fora do projeto.

Memória, retomar conversa e web

• Memória (~/.brains/memory.md): injetada em toda conversa. brains memory set/add/clear ou edite o arquivo.
• Retomar (-c): cada pasta tem seu próprio histórico; -c continua de onde parou.
• Busca na web: automática quando a pergunta pede algo atual (preços, notícias, datas…). Desligue com --no-web.

Comandos do modo interativo

Ao digitar /, as sugestões aparecem acima do prompt e vão filtrando conforme você escreve. Use ↑/↓ para escolher, Tab para completar, Enter para enviar. Em /model as sugestões viram a lista de modelos; digitando / também aparecem as skills (puxadas do gateway ao abrir o chat) — é só usar /nome.

Em terminais que não suportam modo interativo avançado, cai automaticamente no modo simples (completação por Tab).

/model <id>             troca o modelo   (Tab lista os modelos)
/<skill> [pergunta]     usa uma skill    (ex.: /advogado — Tab lista as skills)
/skill <nome|auto|none> idem, forma longa (auto = o gateway escolhe)
/agente                 liga/desliga o modo agente (ler/editar arquivos)
/memoria                mostra a memória local
/whoami                 sua conta, plano e cota
/clear                  limpa o histórico da conversa
/models  /skills        listas completas (modelos agrupados por provedor)
/ajuda                  mostra os comandos
/sair                   encerra (ou Ctrl+C / Ctrl+D)

Os ids de modelo precisam do prefixo do provedor: gemini:gemini-2.5-flash, openrouter:openai/gpt-4o, cerebras:gpt-oss-120b. Sem prefixo, o gateway recusa (erro 401). Use o Tab para não errar.

Opções

| flag | descrição | |------|-----------| | -m, --model <id> | modelo (ex.: gemini:gemini-2.5-flash, openrouter:anthropic/claude-opus-4) | | -s, --skill <nome> | injeta uma skill do Brains (auto deixa o gateway escolher) | | -a, --agente | modo agente: a IA pode ler e editar arquivos do projeto (confirma antes) | | -c, --continue | continua a última conversa desta pasta | | -f, --file <arq> | anexa o conteúdo de um arquivo à pergunta (pode repetir) | | --no-web | desliga a busca na web automática | | --no-stream | espera a resposta completa antes de imprimir | | --url, --token | sobrepõem a config para a execução atual | | -h, --help | ajuda |

Publicar no npm (mantenedor)

npm login
cd cli
npm publish          # nome do pacote: brains-copilot-cli

A cada nova versão, suba o version no package.json antes do npm publish.