DoubleX AgentesDocs

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:

FormaComoUse quando
Login pelo navegador (recomendado)doublex loginNo seu computador. A CLI recebe uma chave só deste terminal, que você desconecta pelo Perfil quando quiser.
Chave pessoaldoublex login --api-key - ou a variável DOUBLEX_API_KEYServidores, contêineres, CI e máquinas sem navegador.

Login pelo navegador#

Terminal
doublex login

O que acontece:

  1. A CLI abre um servidor local, só para esta etapa, em http://127.0.0.1:8765.
  2. 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.
  3. Você clica em Permitir. O navegador volta para o servidor local com um código de uso único.
  4. 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çãoPadrãoPara quê
--no-browserdesligadaMostra o endereço de autorização em vez de abrir o navegador.
--callback-port <porta>8765Troca a porta do servidor local, se a 8765 estiver em uso.
--base-url <url>o do instaladorEntra 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:

Terminal
ssh -L 8765:127.0.0.1:8765 voce@servidor
doublex login --no-browser

Abra 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:

Terminal
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#

Terminal
doublex whoami
Ana Souza <[email protected]>
id: usr_1a2b3c4d5e6f
org: Empresa SA (admin)
times: Comercial, Operações
url: https://doublex.ai

Com --json, o whoami devolve o mesmo objeto de GET /api/me.

Sair#

Terminal
doublex logout

O 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ávelPara quê
DOUBLEX_API_KEYChave de API. Quando existe, a CLI não consulta o chaveiro.
DOUBLEX_BASE_URLEndereço do app.
DOUBLEX_LANGIdioma da CLI: pt, en ou es.
XDG_CONFIG_HOMEMuda a pasta do arquivo de configuração (padrão ~/.config).
GitHub Actions
- 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 organization

Onde a CLI guarda a credencial#

SistemaOnde
macOSChaves (Keychain), item doublex-cli, uma entrada por endereço do app
LinuxSecret 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.