Skip to main content
A CLI guarda as credenciais em ~/.jelou/credentials.json com suporte multi-perfil: várias contas (e empresas) coexistem como perfis nomeados.

​
jelou login

Autentique-se com sua API key da Jelou. O jelou login a salva como um perfil nomeado e o deixa como ativo. Obtenha sua API key em apps.jelou.ai/settings/api-keys.
No primeiro login bem-sucedido, o jelou instala automaticamente as skills de agente de forma global nos editores de IA detectados (Claude Code, Cursor, Codex…), para que as sessões novas conheçam o jelou. Veja Skills.

​
jelou whoami

Verifica a identidade atual e a URL da API.

​
jelou logout

Remove as credenciais armazenadas.
As credenciais não são recuperáveis: após o logout, você terá que executar jelou login novamente, e as skills que foram auto-instaladas no login não se reinstalam sozinhas. logout --all (ou logout quando resta apenas um perfil) é uma operação destrutiva — confirme antes de executá-la.

​
Perfis

Cada perfil normalmente mapeia 1:1 com uma empresa. Trocar de perfil muda a empresa ativa: jelou project list retorna os projetos da nova empresa, jelou databases list seus bancos de dados, etc.
Para uma consulta pontual contra outra empresa, prefira --profile <name> nesse comando em vez de auth switch. O perfil ativo é persistente: se você trocar para “staging” para ler um valor e esquecer de voltar, o próximo deploy, exclusão ou rotação de secret apontará para a empresa errada.

​
Ordem de resolução de credenciais

A CLI resolve qual credencial usar nesta ordem (da maior para a menor prioridade):
  1. Variável de ambiente JELOU_TOKEN
  2. Flag --profile <name>
  3. Variável de ambiente JELOU_PROFILE
  4. .jelou/state.json:profile — vínculo por diretório que o jelou link grava ao vincular o projeto, usando o perfil ativo naquele momento (ou o que você indicar com a flag global --profile <name> nesse mesmo comando)
  5. activeProfile no arquivo de credenciais
Quando você vir “empresa errada”, revise esta ordem antes de presumir que o arquivo está incorreto.

​
Saúde e diagnóstico

Quando algo parecer estranho (auth, rede, “empresa errada”, drift de perfil), execute primeiro jelou doctor:
Verifica: validade do token, alcance do gateway, sanidade do perfil, integridade do lockfile (se houver jelou.lock no diretório) e atualidade da versão da CLI. Códigos de saída: 0 saudável, 4 falha de auth, 6 gateway inacessível, 1 outra falha.

​
Segurança de credenciais

  • As API keys em ~/.jelou/credentials.json são credenciais sensíveis — nunca as publique em um repositório nem as cole em um chat.
  • As credenciais v1 (formato antigo) são migradas automaticamente para v2 deixando um backup .bak. Não apague esse .bak: é o único fallback se o arquivo v2 se corromper.