DoubleX AgentesDocs

CLI › DoubleX no terminal

Visão geral

Use agentes, conversas, modelos, conectores, Brain, skills, criações e gatilhos direto do shell.

doublex é a linha de comando do DoubleX Agentes. Você entra uma vez e, a partir daí, conversa com agentes, chama modelos, usa as ferramentas dos conectores, alimenta o Brain e gerencia skills e gatilhos pelo terminal. Todo comando tem a opção --json, para você encadear o resultado em scripts, cron jobs ou qualquer outra ferramenta.

Instalação#

Terminal
curl -fsSL https://doublex.ai/cli/install.sh | sh

O instalador:

  • confere se o Node.js 18 ou mais novo está instalado (a CLI é um único arquivo JavaScript, sem dependências);
  • coloca o comando em ~/.doublex/bin e cria o atalho ~/.local/bin/doublex, sem sudo;
  • grava o endereço deste app como padrão em ~/.config/doublex/config.json. Instalar de novo a partir de outro endereço troca o padrão, e o doublex login --base-url também.

Confira a instalação e mantenha a CLI atualizada:

Terminal
doublex --version
doublex update        # baixa a versão mais nova deste servidor
Variável do instaladorPadrãoPara quê
DOUBLEX_HOME~/.doublexPasta da instalação
DOUBLEX_BIN_DIR~/.local/binOnde fica o atalho doublex

Sistemas suportados#

A CLI roda no macOS e no Linux. No Windows, use o WSL e instale dentro da distribuição Linux.

A chave fica no chaveiro do sistema: no macOS, as Chaves (Keychain), que já vêm instaladas; no Linux, o Secret Service, pelo comando secret-tool:

Terminal
sudo apt install libsecret-tools gnome-keyring   # Debian e Ubuntu
sudo dnf install libsecret gnome-keyring         # Fedora

Em servidores e contêineres sem chaveiro, não use o doublex login: passe a chave pela variável DOUBLEX_API_KEY (veja Autenticação).

Entrar#

Terminal
doublex login

O navegador abre na tela de autorização do app. Clique em Permitir e volte para o terminal. Os detalhes, inclusive como entrar num servidor remoto, estão em Autenticação.

Primeiro comando#

Terminal
doublex agents list

Escolha um agente e converse:

Terminal
doublex sessions create agt_8f3a2b1c9d0e --input "Quais reuniões eu tenho amanhã?"

Todo comando segue o formato doublex <grupo> <ação>. Use --help em qualquer grupo para ver as opções:

Terminal
doublex triggers --help

Comandos#

ComandoO que faz
doublex login / logout / whoamiEntra, sai e mostra quem está conectado.
doublex agentsLista, mostra, cria, edita e apaga agentes.
doublex sessionsConversa com agentes: cria, continua, mostra, cancela e apaga conversas.
doublex chatChama um modelo direto, sem agente.
doublex models / creditsLista os modelos e mostra o saldo e o consumo de créditos.
doublex mcpLista os conectores e as ferramentas deles, e executa ferramentas.
doublex brainCria, edita, move, busca, sobe e apaga notas do Brain.
doublex skillsBaixa e sobe skills como arquivos SKILL.md.
doublex artifactsLista e baixa os arquivos que os agentes criaram.
doublex triggersCria e gerencia gatilhos agendados, únicos, por webhook e de apps.
doublex teamsLista os times e os IDs deles.
doublex pluginEnsina o Claude Code e o Codex a usar a CLI.
doublex updateAtualiza a CLI para a versão do servidor.

Opções globais#

OpçãoVariávelPara quê
--json—Saída em JSON (ou NDJSON, nos comandos com streaming). Use sempre que outro programa for ler a saída.
--base-url <url>DOUBLEX_BASE_URLEndereço do app. O padrão é o do instalador.
-h, --help—Ajuda do grupo.
-V, --version—Versão da CLI.
—DOUBLEX_API_KEYChave de API. Tem prioridade sobre a chave do chaveiro.
—DOUBLEX_LANGIdioma da CLI: pt, en ou es. Sem ela, a CLI segue LANG.

A ordem para descobrir o endereço é: --base-url, depois DOUBLEX_BASE_URL, depois o arquivo ~/.config/doublex/config.json e, por fim, https://doublex.ai.

Entrada e saída#

  • Tabelas para pessoas, JSON para programas. Sem --json, a CLI mostra tabelas alinhadas e corta textos longos. Com --json, mostra tudo.
  • Mensagens de progresso vão para o stderr. O stdout fica só com o resultado, então doublex ... --json > saida.json grava um JSON limpo.
  • Textos longos pelo stdin. As opções que recebem texto aceitam - para ler do stdin (--input -, --instructions -, --args -).
Terminal
cat relatorio.md | doublex sessions create agt_8f3a2b1c9d0e --input -
doublex agents list --json | jq -r '.agents[] | select(.scope == "team") | .id'

Códigos de saída#

CódigoSignificado
0Deu certo.
1Erro no comando ou na requisição (opção faltando, item não encontrado, sem permissão, JSON inválido).
2Sem credencial: não entrou, chave inválida ou sem chaveiro no sistema.
3Não deu para falar com o servidor, ou o servidor respondeu com erro 5xx.
130Interrompido com Ctrl+C.

Use com agentes de programação#

O Claude Code, o Codex e o Cursor podem usar a CLI por você. Um comando instala as instruções:

Terminal
doublex plugin install

Veja Agentes de programação.