DoubleX AgentesDocs

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.

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

Crear y editar notas#

Terminal
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ónPara 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-idQuié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#

Terminal
doublex brain update kno_2c4e6a8b0d1f --title "Política de reembolso y cancelación"
doublex brain update kno_2c4e6a8b0d1f --folder Ventas/Políticas

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

Terminal
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ónPara qué
--folder <carpeta>Carpeta de destino.
--scope personal|team|organizationQuié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#

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

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

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

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