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#
curl -fsSL https://doublex.ai/cli/install.sh | shO 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/bine cria o atalho~/.local/bin/doublex, semsudo; - 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 odoublex login --base-urltambém.
Confira a instalação e mantenha a CLI atualizada:
doublex --version
doublex update # baixa a versão mais nova deste servidor| Variável do instalador | Padrão | Para quê |
|---|---|---|
DOUBLEX_HOME | ~/.doublex | Pasta da instalação |
DOUBLEX_BIN_DIR | ~/.local/bin | Onde 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:
sudo apt install libsecret-tools gnome-keyring # Debian e Ubuntu
sudo dnf install libsecret gnome-keyring # FedoraEm 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#
doublex loginO 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#
doublex agents listEscolha um agente e converse:
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:
doublex triggers --helpComandos#
| Comando | O que faz |
|---|---|
doublex login / logout / whoami | Entra, sai e mostra quem está conectado. |
doublex agents | Lista, mostra, cria, edita e apaga agentes. |
doublex sessions | Conversa com agentes: cria, continua, mostra, cancela e apaga conversas. |
doublex chat | Chama um modelo direto, sem agente. |
doublex models / credits | Lista os modelos e mostra o saldo e o consumo de créditos. |
doublex mcp | Lista os conectores e as ferramentas deles, e executa ferramentas. |
doublex brain | Cria, edita, move, busca, sobe e apaga notas do Brain. |
doublex skills | Baixa e sobe skills como arquivos SKILL.md. |
doublex artifacts | Lista e baixa os arquivos que os agentes criaram. |
doublex triggers | Cria e gerencia gatilhos agendados, únicos, por webhook e de apps. |
doublex teams | Lista os times e os IDs deles. |
doublex plugin | Ensina o Claude Code e o Codex a usar a CLI. |
doublex update | Atualiza a CLI para a versão do servidor. |
Opções globais#
| Opção | Variável | Para 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_URL | Endereço do app. O padrão é o do instalador. |
-h, --help | — | Ajuda do grupo. |
-V, --version | — | Versão da CLI. |
| — | DOUBLEX_API_KEY | Chave de API. Tem prioridade sobre a chave do chaveiro. |
| — | DOUBLEX_LANG | Idioma 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.jsongrava um JSON limpo. - Textos longos pelo stdin. As opções que recebem texto aceitam
-para ler do stdin (--input -,--instructions -,--args -).
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ódigo | Significado |
|---|---|
0 | Deu certo. |
1 | Erro no comando ou na requisição (opção faltando, item não encontrado, sem permissão, JSON inválido). |
2 | Sem credencial: não entrou, chave inválida ou sem chaveiro no sistema. |
3 | Não deu para falar com o servidor, ou o servidor respondeu com erro 5xx. |
130 | Interrompido 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:
doublex plugin installVeja Agentes de programação.