DoubleX AgentesDocs

CLI › DoubleX en la terminal

Visión general

Usa agentes, conversaciones, modelos, conectores, Brain, skills, creaciones y disparadores directamente desde el shell.

doublex es la línea de comandos de DoubleX Agentes. Inicias sesión una vez y, a partir de ahí, conversas con agentes, llamas a modelos, usas las herramientas de los conectores, alimentas el Brain y gestionas skills y disparadores desde la terminal. Todos los comandos tienen la opción --json, para que encadenes el resultado en scripts, cron jobs o cualquier otra herramienta.

Instalación#

Terminal
curl -fsSL https://doublex.ai/cli/install.sh | sh

El instalador:

  • comprueba que Node.js 18 o más reciente esté instalado (la CLI es un único archivo JavaScript, sin dependencias);
  • pone el comando en ~/.doublex/bin y crea el acceso directo ~/.local/bin/doublex, sin sudo;
  • guarda la dirección de esta app como predeterminada en ~/.config/doublex/config.json. Instalar de nuevo desde otra dirección cambia la predeterminada, y doublex login --base-url también.

Comprueba la instalación y mantén la CLI actualizada:

Terminal
doublex --version
doublex update        # descarga la versión más reciente de este servidor
Variable del instaladorPredeterminadoPara qué
DOUBLEX_HOME~/.doublexCarpeta de la instalación
DOUBLEX_BIN_DIR~/.local/binDónde queda el acceso directo doublex

Sistemas compatibles#

La CLI funciona en macOS y Linux. En Windows, usa WSL e instálala dentro de la distribución Linux.

La clave queda en el llavero del sistema: en macOS, el Llavero (Keychain), que ya viene instalado; en Linux, el Secret Service, mediante el comando secret-tool:

Terminal
sudo apt install libsecret-tools gnome-keyring   # Debian y Ubuntu
sudo dnf install libsecret gnome-keyring         # Fedora

En servidores y contenedores sin llavero, no uses doublex login: pasa la clave con la variable DOUBLEX_API_KEY (consulta Autenticación).

Iniciar sesión#

Terminal
doublex login

El navegador se abre en la pantalla de autorización de la app. Haz clic en Permitir y vuelve a la terminal. Los detalles, incluido cómo iniciar sesión en un servidor remoto, están en Autenticación.

Primer comando#

Terminal
doublex agents list

Elige un agente y conversa:

Terminal
doublex sessions create agt_8f3a2b1c9d0e --input "¿Qué reuniones tengo mañana?"

Todos los comandos siguen el formato doublex <grupo> <acción>. Usa --help en cualquier grupo para ver las opciones:

Terminal
doublex triggers --help

Comandos#

ComandoQué hace
doublex login / logout / whoamiInicia sesión, la cierra y muestra quién está conectado.
doublex agentsLista, muestra, crea, edita y borra agentes.
doublex sessionsConversa con agentes: crea, continúa, muestra, cancela y borra conversaciones.
doublex chatLlama a un modelo directamente, sin agente.
doublex models / creditsLista los modelos y muestra el saldo y el consumo de créditos.
doublex mcpLista los conectores y sus herramientas, y ejecuta herramientas.
doublex brainCrea, edita, mueve, busca, sube y borra notas del Brain.
doublex skillsDescarga y sube skills como archivos SKILL.md.
doublex artifactsLista y descarga los archivos que crearon los agentes.
doublex triggersCrea y gestiona disparadores programados, únicos, por webhook y de apps.
doublex teamsLista los equipos y sus IDs.
doublex pluginEnseña a Claude Code y a Codex a usar la CLI.
doublex updateActualiza la CLI a la versión del servidor.

Opciones globales#

OpciónVariablePara qué
--json—Salida en JSON (o NDJSON, en los comandos con streaming). Úsala siempre que otro programa vaya a leer la salida.
--base-url <url>DOUBLEX_BASE_URLDirección de la app. La predeterminada es la del instalador.
-h, --help—Ayuda del grupo.
-V, --version—Versión de la CLI.
—DOUBLEX_API_KEYClave de API. Tiene prioridad sobre la clave del llavero.
—DOUBLEX_LANGIdioma de la CLI: pt, en o es. Sin ella, la CLI sigue LANG.

El orden para encontrar la dirección es: --base-url, después DOUBLEX_BASE_URL , después el archivo ~/.config/doublex/config.json y, por último, https://doublex.ai.

Entrada y salida#

  • Tablas para personas, JSON para programas. Sin --json, la CLI muestra tablas alineadas y corta los textos largos. Con --json, muestra todo.
  • Los mensajes de progreso van a stderr. El stdout queda solo con el resultado, así que doublex ... --json > saida.json guarda un JSON limpio.
  • Textos largos por stdin. Las opciones que reciben texto aceptan - para leer de stdin (--input -, --instructions -, --args -).
Terminal
cat relatorio.md | doublex sessions create agt_8f3a2b1c9d0e --input -
doublex agents list --json | jq -r '.agents[] | select(.scope == "team") | .id'

Códigos de salida#

CódigoSignificado
0Funcionó.
1Error en el comando o en la solicitud (falta una opción, elemento no encontrado, sin permiso, JSON no válido).
2Sin credencial: no iniciaste sesión, clave no válida o no hay llavero en el sistema.
3No se pudo conectar con el servidor, o el servidor respondió con un error 5xx.
130Interrumpido con Ctrl+C.

Usar con agentes de programación#

Claude Code, Codex y Cursor pueden usar la CLI por ti. Un comando instala las instrucciones:

Terminal
doublex plugin install

Consulta Agentes de programación.