CLI › Comandos
Brain
Crea y edita notas, organiza carpetas, sube archivos y busca en el Brain desde la línea de comandos.
El Brain guarda lo que consultan los agentes: manuales, políticas, listas de precios, actas, contratos. Funciona como una bóveda de Obsidian: notas en Markdown, en carpetas, conectadas con [[Nombre de la nota]]. Desde la CLI mantienes el Brain al día a partir de carpetas, repositorios y jobs.
doublex brain list | folders | get | search | create | update | upload | deleteCrear y editar notas#
doublex brain create "Reunión con Acme" --folder Clientes/Reuniones --content "Próximos pasos con [[Acme]]. #reunion"
cat acta.md | doublex brain create "Acta 29/10" --folder Actas --content -
doublex brain update kno_2c4e6a8b0d1f --content-file politica.md| Opción | Para qué |
|---|---|
--folder <carpeta> | Carpeta de la nota, como Clientes/Reuniones. Por defecto: la raíz. |
--content <texto> | Texto de la nota. Usa - para leer de stdin o --content-file <archivo>. |
--scope, --team-id | Quién puede ver la nota (solo al crear). Por defecto: personal. |
Si ya existe una nota con el mismo nombre en la carpeta, la nueva recibe un número (Acta 29/10 1).
Renombrar y mover#
doublex brain update kno_2c4e6a8b0d1f --title "Política de reembolso y cancelación"
doublex brain update kno_2c4e6a8b0d1f --folder Ventas/PolíticasLos enlaces en las otras notas que puedes editar acompañan el cambio, como en Obsidian. La CLI muestra cuántos enlaces cambiaron. Usa --no-update-links para no tocarlas.
Subir archivos#
doublex brain upload politica-de-reembolso.pdf --folder Ventas
doublex brain upload docs/*.md --scope team --team-id team_9c8b7a6d5e4f
doublex brain upload contrato.docx --title "Contrato estándar 2026"
doublex brain upload manual.pdf --replace kno_7e9f1a3b5c2d| Opción | Para qué |
|---|---|
--folder <carpeta> | Carpeta de destino. |
--scope personal|team|organization | Quién puede verlo. Por defecto: personal. organization requiere ser administrador. |
--team-id <id> | El equipo, cuando el alcance es team. Consulta los IDs con doublex teams list. |
--title <título> | Nombre de la nota (solo al subir un archivo). Por defecto: el nombre del archivo. |
--replace <id> | Reemplaza el texto de una nota existente por el del archivo. El ID, el nombre y los agentes vinculados se mantienen. |
Formatos aceptados: PDF, Word (.docx), Excel (.xlsx), CSV, JSON, Markdown y texto. Cada archivo puede tener hasta 20 MB. Los PDF escaneados (solo imagen) y los archivos protegidos con contraseña se rechazan, porque no tienen texto para extraer.
Buscar#
doublex brain search "plazo de reembolso" --limit 5
doublex brain search "tag:#cliente plan"
doublex brain search "path:Ventas \"30 días\" -borrador"La búsqueda no distingue acentos ni mayúsculas y muestra los fragmentos más relevantes con su nota. Es la misma búsqueda que usan los agentes. Los operadores tag:, path:, file:, "frase exacta" y -palabra filtran las notas, como en Obsidian.
Listar, leer y eliminar#
doublex brain list
doublex brain list --folder Clientes
doublex brain folders
doublex brain get kno_2c4e6a8b0d1f > politica.md
doublex brain delete kno_2c4e6a8b0d1f --yeslist muestra la ruta, el tamaño en caracteres, el alcance y cuántos agentes usan cada nota. get imprime el texto. delete también quita la nota de los agentes que la usaban.
Vincular una nota a un agente#
Subir una nota no basta: el agente solo consulta las notas vinculadas a él. Vincúlalas en la pantalla del agente o desde la CLI:
doublex agents update agt_8f3a2b1c9d0e --args-json '{"knowledgeIds": ["kno_2c4e6a8b0d1f", "kno_7e9f1a3b5c2d"]}'El agente busca fragmentos y también puede abrir la nota completa por su nombre, siguiendo los [[enlaces]] entre las notas vinculadas.
Mantener el Brain al día#
Un ejemplo de job que reemplaza el texto de un manual cada vez que cambia, sin cambiar su ID (los agentes siguen vinculados):
#!/bin/sh
set -e
ID=$(doublex brain list --json | jq -r '.docs[] | select(.path == "Manuales/manual.pdf") | .id')
if [ -n "$ID" ]; then
doublex brain upload manual.pdf --replace "$ID"
else
doublex brain upload manual.pdf --folder Manuales --scope organization
fi