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#
curl -fsSL https://doublex.ai/cli/install.sh | shEl 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/biny crea el acceso directo~/.local/bin/doublex, sinsudo; - guarda la dirección de esta app como predeterminada en
~/.config/doublex/config.json. Instalar de nuevo desde otra dirección cambia la predeterminada, ydoublex login --base-urltambién.
Comprueba la instalación y mantén la CLI actualizada:
doublex --version
doublex update # descarga la versión más reciente de este servidor| Variable del instalador | Predeterminado | Para qué |
|---|---|---|
DOUBLEX_HOME | ~/.doublex | Carpeta de la instalación |
DOUBLEX_BIN_DIR | ~/.local/bin | Dó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:
sudo apt install libsecret-tools gnome-keyring # Debian y Ubuntu
sudo dnf install libsecret gnome-keyring # FedoraEn servidores y contenedores sin llavero, no uses doublex login: pasa la clave con la variable DOUBLEX_API_KEY (consulta Autenticación).
Iniciar sesión#
doublex loginEl 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#
doublex agents listElige un agente y conversa:
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:
doublex triggers --helpComandos#
| Comando | Qué hace |
|---|---|
doublex login / logout / whoami | Inicia sesión, la cierra y muestra quién está conectado. |
doublex agents | Lista, muestra, crea, edita y borra agentes. |
doublex sessions | Conversa con agentes: crea, continúa, muestra, cancela y borra conversaciones. |
doublex chat | Llama a un modelo directamente, sin agente. |
doublex models / credits | Lista los modelos y muestra el saldo y el consumo de créditos. |
doublex mcp | Lista los conectores y sus herramientas, y ejecuta herramientas. |
doublex brain | Crea, edita, mueve, busca, sube y borra notas del Brain. |
doublex skills | Descarga y sube skills como archivos SKILL.md. |
doublex artifacts | Lista y descarga los archivos que crearon los agentes. |
doublex triggers | Crea y gestiona disparadores programados, únicos, por webhook y de apps. |
doublex teams | Lista los equipos y sus IDs. |
doublex plugin | Enseña a Claude Code y a Codex a usar la CLI. |
doublex update | Actualiza la CLI a la versión del servidor. |
Opciones globales#
| Opción | Variable | Para 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_URL | Dirección de la app. La predeterminada es la del instalador. |
-h, --help | — | Ayuda del grupo. |
-V, --version | — | Versión de la CLI. |
| — | DOUBLEX_API_KEY | Clave de API. Tiene prioridad sobre la clave del llavero. |
| — | DOUBLEX_LANG | Idioma 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.jsonguarda un JSON limpio. - Textos largos por stdin. Las opciones que reciben texto aceptan
-para leer de stdin (--input -,--instructions -,--args -).
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ódigo | Significado |
|---|---|
0 | Funcionó. |
1 | Error en el comando o en la solicitud (falta una opción, elemento no encontrado, sin permiso, JSON no válido). |
2 | Sin credencial: no iniciaste sesión, clave no válida o no hay llavero en el sistema. |
3 | No se pudo conectar con el servidor, o el servidor respondió con un error 5xx. |
130 | Interrumpido 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:
doublex plugin installConsulta Agentes de programación.