almirant login

Autentica uma conta do Almirant abrindo um fluxo OAuth no navegador. Ao concluí-lo, a CLI salva a conta em ~/.almirant/config.json para uso em comandos posteriores.

Uso

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

O que faz

1. Resolve a URL da API: --api-url, ALMIRANT_API_URL ou prompt interativo (padrão https://api.almirant.ai).
2. Abre o navegador para concluir o OAuth.
3. Valida a API key obtida com o servidor.
4. Obtém as informações do usuário.
5. Salva ou atualiza a conta em ~/.almirant/config.json com permissões 600.
6. Atribui um ID estável e um rótulo local.

Exemplos

# SaaS
almirant login

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

Arquivo de configuração

O formato atual suporta várias contas:

{
  "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 contém API keys. A CLI o grava com permissões 600; nunca o copie para o repositório.

Várias contas

Você pode executar login uma vez para cada instância ou conta. Depois, atribua rótulos úteis e selecione a ativa:

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

As configurações geradas por init e link usam o ID estável da conta, não o e-mail, porque o mesmo e-mail pode existir em várias instâncias.