DoubleX AgentesDocs

CLI › DoubleX en la terminal

Autenticación

Inicia sesión en el navegador o con una clave de API. La CLI guarda la credencial en el llavero del sistema, nunca en un archivo de texto.

La CLI usa una clave de API para hablar con la app. Tienes dos formas de entregarle esa clave:

FormaCómoÚsala cuando
Inicio de sesión en el navegador (recomendado)doublex loginEn tu computadora. La CLI recibe una clave solo para esta terminal, que desconectas desde el Perfil cuando quieras.
Clave personaldoublex login --api-key - o la variable DOUBLEX_API_KEYServidores, contenedores, CI y máquinas sin navegador.

Inicio de sesión en el navegador#

Terminal
doublex login

Qué pasa:

  1. La CLI abre un servidor local, solo para este paso, en http://127.0.0.1:8765.
  2. El navegador abre la página ¿Permitir acceso desde la terminal? de la app, con el nombre de esta computadora y lo que podrá hacer la CLI. Si no iniciaste sesión, la app te lo pide antes.
  3. Haces clic en Permitir. El navegador vuelve al servidor local con un código de un solo uso.
  4. La CLI cambia el código por una clave de terminal (con verificación PKCE: el código no le sirve a nadie más), comprueba la clave y la guarda en el llavero.
Abriendo el navegador para que permitas el acceso…
Esperando la confirmación en el navegador (hasta 5 minutos)…
Conectado como Ana Souza ([email protected]) · Empresa SA.

La clave de terminal aparece en Configuración › Perfil › Terminal (CLI) › Terminales conectadas, con el nombre de la computadora y el último uso.

OpciónPredeterminadoPara qué
--no-browserdesactivadaMuestra la dirección de autorización en lugar de abrir el navegador.
--callback-port <puerto>8765Cambia el puerto del servidor local, si el 8765 está en uso.
--base-url <url>la del instaladorInicia sesión en otra dirección de la app.

En una computadora remota (SSH)#

El navegador tiene que poder volver al puerto local de la máquina donde se ejecuta la CLI. Reenvía el puerto por SSH y usa --no-browser:

Terminal
ssh -L 8765:127.0.0.1:8765 tu@servidor
doublex login --no-browser

Abre en el navegador de tu computadora la dirección que muestra la CLI y haz clic en Permitir.

Iniciar sesión con una clave#

Genera la clave personal en Configuración › Perfil › Acceso por API y pásala por stdin, para que no quede en el historial del shell ni en la lista de procesos:

Terminal
echo "$DOUBLEX_API_KEY" | doublex login --api-key -

La CLI comprueba la clave en el servidor antes de guardarla. Si no es válida, no se guarda nada.

Verificar#

Terminal
doublex whoami
Ana Souza <[email protected]>
id: usr_1a2b3c4d5e6f
org: Empresa SA (admin)
equipos: Comercial, Operaciones
url: https://doublex.ai

Con --json, whoami devuelve el mismo objeto que GET /api/me.

Cerrar sesión#

Terminal
doublex logout

logout revoca la clave de la terminal en el servidor y la borra del llavero. Si iniciaste sesión con la clave personal, solo sale del llavero y sigue siendo válida: revócala en el Perfil si lo necesitas. También puedes desconectar cualquier terminal desde la pantalla Perfil, sin acceso a la computadora.

Variables de entorno#

Las variables valen solo para el comando en el que aparecen y tienen prioridad sobre lo que está guardado. Son el camino para CI, contenedores y servidores sin llavero.

VariablePara qué
DOUBLEX_API_KEYClave de API. Cuando existe, la CLI no consulta el llavero.
DOUBLEX_BASE_URLDirección de la app.
DOUBLEX_LANGIdioma de la CLI: pt, en o es.
XDG_CONFIG_HOMECambia la carpeta del archivo de configuración (predeterminada: ~/.config).
GitHub Actions
- name: Actualizar el Brain con la documentación del producto
  env:
    DOUBLEX_API_KEY: ${{ secrets.DOUBLEX_API_KEY }}
    DOUBLEX_BASE_URL: https://doublex.ai
  run: |
    curl -fsSL https://doublex.ai/cli/install.sh | sh
    ~/.local/bin/doublex brain upload docs/*.md --scope organization

Dónde guarda la CLI la credencial#

SistemaDónde
macOSLlavero (Keychain), elemento doublex-cli, una entrada por dirección de la app
LinuxSecret Service (GNOME Keyring o KWallet), mediante secret-tool, servicio doublex-cli

El archivo ~/.config/doublex/config.json guarda solo la dirección de la app, nunca la clave. Con la clave en el llavero, puedes tener sesiones iniciadas en más de una dirección (por ejemplo, producción y un entorno de pruebas) y elegir con --base-url.