almirant login

Authentifie un compte Almirant en ouvrant un flux OAuth dans le navigateur. Une fois terminé, le CLI enregistre le compte dans ~/.almirant/config.json pour les commandes suivantes.

Utilisation

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

Ce qu'il fait

1. Résout l'URL de l'API : --api-url, ALMIRANT_API_URL ou invite interactive (par défaut https://api.almirant.ai).
2. Ouvre le navigateur pour terminer OAuth.
3. Valide la clé API générée auprès du serveur.
4. Récupère les informations de l'utilisateur.
5. Enregistre ou met à jour le compte dans ~/.almirant/config.json avec les permissions 600.
6. Attribue un ID stable et un libellé local.

Exemples

# SaaS
almirant login

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

Fichier de configuration

Le format actuel prend en charge plusieurs comptes :

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

attention

~/.almirant/config.json contient des clés API. Le CLI l'écrit avec les permissions 600 ; ne le commitez jamais.

Plusieurs comptes

Exécutez login une fois par instance ou par compte. Attribuez ensuite des libellés utiles et sélectionnez le compte actif :

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

Les configurations générées par init et link utilisent l'ID stable du compte, et non l'e-mail, car le même e-mail peut exister dans plusieurs instances.