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:
| Forma | Cómo | Úsala cuando |
|---|---|---|
| Inicio de sesión en el navegador (recomendado) | doublex login | En tu computadora. La CLI recibe una clave solo para esta terminal, que desconectas desde el Perfil cuando quieras. |
| Clave personal | doublex login --api-key - o la variable DOUBLEX_API_KEY | Servidores, contenedores, CI y máquinas sin navegador. |
Inicio de sesión en el navegador#
doublex loginQué pasa:
- La CLI abre un servidor local, solo para este paso, en
http://127.0.0.1:8765. - 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.
- Haces clic en Permitir. El navegador vuelve al servidor local con un código de un solo uso.
- 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ón | Predeterminado | Para qué |
|---|---|---|
--no-browser | desactivada | Muestra la dirección de autorización en lugar de abrir el navegador. |
--callback-port <puerto> | 8765 | Cambia el puerto del servidor local, si el 8765 está en uso. |
--base-url <url> | la del instalador | Inicia 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:
ssh -L 8765:127.0.0.1:8765 tu@servidor
doublex login --no-browserAbre 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:
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#
doublex whoamiAna Souza <[email protected]>
id: usr_1a2b3c4d5e6f
org: Empresa SA (admin)
equipos: Comercial, Operaciones
url: https://doublex.aiCon --json, whoami devuelve el mismo objeto que GET /api/me.
Cerrar sesión#
doublex logoutlogout 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.
| Variable | Para qué |
|---|---|
DOUBLEX_API_KEY | Clave de API. Cuando existe, la CLI no consulta el llavero. |
DOUBLEX_BASE_URL | Dirección de la app. |
DOUBLEX_LANG | Idioma de la CLI: pt, en o es. |
XDG_CONFIG_HOME | Cambia la carpeta del archivo de configuración (predeterminada: ~/.config). |
- 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 organizationDónde guarda la CLI la credencial#
| Sistema | Dónde |
|---|---|
| macOS | Llavero (Keychain), elemento doublex-cli, una entrada por dirección de la app |
| Linux | Secret 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.