DoubleX AgentesDocs

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.

Terminal
doublex brain list | folders | get | search | create | update | upload | delete

Criar e editar notas#

Terminal
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çãoPara 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-idQuem 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#

Terminal
doublex brain update kno_2c4e6a8b0d1f --title "Política de reembolso e cancelamento"
doublex brain update kno_2c4e6a8b0d1f --folder Comercial/Políticas

Os 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#

Terminal
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çãoPara quê
--folder <pasta>Pasta de destino.
--scope personal|team|organizationQuem 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#

Terminal
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#

Terminal
doublex brain list
doublex brain list --folder Clientes
doublex brain folders
doublex brain get kno_2c4e6a8b0d1f > politica.md
doublex brain delete kno_2c4e6a8b0d1f --yes

list 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:

Terminal
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):

Terminal
#!/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