Saltar al contenido principal

almirant login

Autentica una cuenta de Almirant abriendo un flujo OAuth en el navegador. Al completarse, el CLI guarda la cuenta en ~/.almirant/config.json para uso en comandos posteriores.

Uso

almirant login [--api-url <url>] [--app-url <url>] [--name <nombre>]

Que hace

  1. Resuelve la URL del API: --api-url, ALMIRANT_API_URL o prompt interactivo (default https://api.almirant.ai).
  2. Abre el navegador para completar OAuth.
  3. Valida la API key obtenida contra el servidor.
  4. Obtiene informacion del usuario.
  5. Guarda o actualiza la cuenta en ~/.almirant/config.json con permisos 600.
  6. Asigna un ID estable y una etiqueta local.

Ejemplos

# SaaS
almirant login

# Self-hosted
almirant login --api-url https://almirant.miempresa.com/api

Archivo de configuracion

El formato actual soporta varias cuentas:

{
"defaultAccountId": "acc_abc123",
"accounts": [
{
"id": "acc_abc123",
"label": "local-m1pro",
"apiKey": "alm_...",
"apiBaseUrl": "https://almirant.miempresa.com/api",
"appBaseUrl": "https://almirant.miempresa.com",
"userName": "Juan Perez",
"userEmail": "[email protected]"
}
]
}
aviso

~/.almirant/config.json contiene API keys. El CLI lo escribe con permisos 600; nunca lo copies al repositorio.

Cuentas multiples

Puedes ejecutar login una vez por cada instancia o cuenta. Despues, asigna etiquetas utiles y selecciona la activa:

almirant accounts list
almirant accounts rename 1 prod-saas
almirant accounts rename 2 local-m1pro
almirant use local-m1pro
almirant current

Las configuraciones generadas por init y link usan el ID estable de la cuenta, no el email, porque el mismo email puede existir en varias instancias.