CLI › DoubleX no terminal
Autenticação
Entre pelo navegador ou com uma chave de API. A CLI guarda a credencial no chaveiro do sistema, nunca num arquivo de texto.
A CLI usa uma chave de API para falar com o app. Você tem duas formas de entregar essa chave:
| Forma | Como | Use quando |
|---|---|---|
| Login pelo navegador (recomendado) | doublex login | No seu computador. A CLI recebe uma chave só deste terminal, que você desconecta pelo Perfil quando quiser. |
| Chave pessoal | doublex login --api-key - ou a variável DOUBLEX_API_KEY | Servidores, contêineres, CI e máquinas sem navegador. |
Login pelo navegador#
doublex loginO que acontece:
- A CLI abre um servidor local, só para esta etapa, em
http://127.0.0.1:8765. - O navegador abre a página Permitir acesso pelo terminal? do app, com o nome deste computador e o que a CLI vai poder fazer. Se você não estiver logado, o app pede o login antes.
- Você clica em Permitir. O navegador volta para o servidor local com um código de uso único.
- A CLI troca o código por uma chave de terminal (com verificação PKCE: o código não serve para mais ninguém), confere a chave e a grava no chaveiro.
Abrindo o navegador para você permitir o acesso…
Esperando a confirmação no navegador (até 5 minutos)…
Conectado como Ana Souza ([email protected]) · Empresa SA.A chave de terminal aparece em Configurações › Perfil › Terminal (CLI) › Terminais conectados, com o nome do computador e o último uso.
| Opção | Padrão | Para quê |
|---|---|---|
--no-browser | desligada | Mostra o endereço de autorização em vez de abrir o navegador. |
--callback-port <porta> | 8765 | Troca a porta do servidor local, se a 8765 estiver em uso. |
--base-url <url> | o do instalador | Entra em outro endereço do app. |
Num computador remoto (SSH)#
O navegador precisa conseguir voltar para a porta local da máquina onde a CLI está rodando. Encaminhe a porta pelo SSH e use --no-browser:
ssh -L 8765:127.0.0.1:8765 voce@servidor
doublex login --no-browserAbra o endereço que a CLI mostrar no navegador do seu computador e clique em Permitir.
Entrar com uma chave#
Gere a chave pessoal em Configurações › Perfil › Acesso pela API e passe-a pelo stdin, para ela não ficar no histórico do shell nem na lista de processos:
echo "$DOUBLEX_API_KEY" | doublex login --api-key -A CLI confere a chave no servidor antes de gravar. Se ela for inválida, nada é gravado.
Verificar#
doublex whoamiAna Souza <[email protected]>
id: usr_1a2b3c4d5e6f
org: Empresa SA (admin)
times: Comercial, Operações
url: https://doublex.aiCom --json, o whoami devolve o mesmo objeto de GET /api/me.
Sair#
doublex logoutO logout revoga a chave do terminal no servidor e a apaga do chaveiro. Se você entrou com a chave pessoal, ela só sai do chaveiro e continua valendo: revogue-a no Perfil se precisar. Você também pode desconectar qualquer terminal pela tela Perfil, sem acesso ao computador.
Variáveis de ambiente#
As variáveis valem só para o comando em que aparecem e têm prioridade sobre o que está gravado. São o caminho para CI, contêineres e servidores sem chaveiro.
| Variável | Para quê |
|---|---|
DOUBLEX_API_KEY | Chave de API. Quando existe, a CLI não consulta o chaveiro. |
DOUBLEX_BASE_URL | Endereço do app. |
DOUBLEX_LANG | Idioma da CLI: pt, en ou es. |
XDG_CONFIG_HOME | Muda a pasta do arquivo de configuração (padrão ~/.config). |
- name: Atualizar o Brain com a documentação do produto
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 organizationOnde a CLI guarda a credencial#
| Sistema | Onde |
|---|---|
| macOS | Chaves (Keychain), item doublex-cli, uma entrada por endereço do app |
| Linux | Secret Service (GNOME Keyring ou KWallet), pelo secret-tool, serviço doublex-cli |
O arquivo ~/.config/doublex/config.json guarda só o endereço do app, nunca a chave. Com a chave no chaveiro, você pode ter logins em mais de um endereço (por exemplo, produção e um ambiente de testes) e escolher com --base-url.