CLI › Comandos
Brain
Crie e edite notas, organize pastas, suba arquivos e busque no Brain pela linha de comando.
O Brain guarda o que os agentes consultam: manuais, políticas, tabelas de preço, atas, contratos. Ele funciona como um cofre do Obsidian: notas em Markdown, em pastas, ligadas por [[Nome da nota]]. Pela CLI você mantém o Brain atualizado a partir de pastas, repositórios e jobs.
doublex brain list | folders | get | search | create | update | upload | deleteCriar e editar notas#
doublex brain create "Reunião com a Acme" --folder Clientes/Reuniões --content "Próximos passos com a [[Acme]]. #reuniao"
cat ata.md | doublex brain create "Ata 29/10" --folder Atas --content -
doublex brain update kno_2c4e6a8b0d1f --content-file politica.md| Opção | Para quê |
|---|---|
--folder <pasta> | Pasta da nota, como Clientes/Reuniões. O padrão é a raiz. |
--content <texto> | Texto da nota. Use - para ler do stdin ou --content-file <arquivo>. |
--scope, --team-id | Quem pode ver a nota (só ao criar). O padrão é personal. |
Se já existir uma nota com o mesmo nome na pasta, a nova ganha um número (Ata 29/10 1).
Renomear e mover#
doublex brain update kno_2c4e6a8b0d1f --title "Política de reembolso e cancelamento"
doublex brain update kno_2c4e6a8b0d1f --folder Comercial/PolíticasOs links das outras notas que você pode editar acompanham a mudança, como no Obsidian. A CLI mostra quantos links mudaram. Use --no-update-links para não mexer nelas.
Subir arquivos#
doublex brain upload politica-de-reembolso.pdf --folder Comercial
doublex brain upload docs/*.md --scope team --team-id team_9c8b7a6d5e4f
doublex brain upload contrato.docx --title "Contrato padrão 2026"
doublex brain upload manual.pdf --replace kno_7e9f1a3b5c2d| Opção | Para quê |
|---|---|
--folder <pasta> | Pasta de destino. |
--scope personal|team|organization | Quem pode ver. O padrão é personal. organization exige ser administrador. |
--team-id <id> | O time, quando o escopo é team. Veja os IDs com doublex teams list. |
--title <título> | Nome da nota (só quando você sobe um arquivo). O padrão é o nome do arquivo. |
--replace <id> | Troca o texto de uma nota existente pelo do arquivo. O ID, o nome e os agentes ligados continuam. |
Formatos aceitos: PDF, Word (.docx), Excel (.xlsx), CSV, JSON, Markdown e texto. Cada arquivo pode ter até 20 MB. PDFs escaneados (só imagem) e arquivos protegidos por senha são recusados, porque não têm texto para extrair.
Buscar#
doublex brain search "prazo de reembolso" --limit 5
doublex brain search "tag:#cliente plano"
doublex brain search "path:Comercial \"30 dias\" -rascunho"A busca não diferencia acentos e maiúsculas e mostra os trechos mais relevantes com a nota de origem. É a mesma busca que os agentes usam. Os operadores tag:, path:, file:, "frase exata" e -palavra filtram as notas, como no Obsidian.
Listar, ler e apagar#
doublex brain list
doublex brain list --folder Clientes
doublex brain folders
doublex brain get kno_2c4e6a8b0d1f > politica.md
doublex brain delete kno_2c4e6a8b0d1f --yeslist mostra o caminho, o tamanho em caracteres, o escopo e quantos agentes usam cada nota. get imprime o texto. delete também tira a nota dos agentes que a usavam.
Ligar uma nota a um agente#
Subir uma nota não basta: o agente só consulta as notas ligadas a ele. Ligue pela tela do agente ou pela CLI:
doublex agents update agt_8f3a2b1c9d0e --args-json '{"knowledgeIds": ["kno_2c4e6a8b0d1f", "kno_7e9f1a3b5c2d"]}'O agente busca trechos e também abre a nota inteira pelo nome, seguindo os [[links]] entre as notas ligadas a ele.
Manter o Brain em dia#
Um exemplo de job que troca o texto de um manual toda vez que ele muda, sem mudar o ID (os agentes continuam ligados):
#!/bin/sh
set -e
ID=$(doublex brain list --json | jq -r '.docs[] | select(.path == "Manuais/manual.pdf") | .id')
if [ -n "$ID" ]; then
doublex brain upload manual.pdf --replace "$ID"
else
doublex brain upload manual.pdf --folder Manuais --scope organization
fi