CLI
A linha de comando que você e os agentes usam, de dentro dos terminais do Dusky, para criar workspaces, mandar texto para terminais e controlar o navegador.
O Dusky tem uma CLI que conversa com o app aberto. É assim que um agente cria um workspace, lê outro terminal ou controla o navegador embutido.
Onde ela funciona
A CLI já está no PATH de todo terminal aberto pelo Dusky e dos agentes que o Dusky abre. O Dusky não instala a CLI no PATH do sistema, então ela não aparece em terminais de fora do app.
O nome do comando aparece em Settings → General → Dusky CLI. Nos exemplos abaixo, os comandos estão escritos sem o nome do executável: digite esse nome antes de cada um.
A maior parte dos comandos precisa do Dusky aberto; open abre o app.
Opções globais
| Opção | O que faz |
|---|---|
--json | Saída em JSON, para scripts e agentes. |
--help | Ajuda do comando. |
--version ou -v | Versão. |
--environment <seletor> | Escolhe o ambiente que vai receber o comando. |
--pairing-code <código> | Conecta a um app pareado. |
Workspaces
worktree list [--repo <seletor>] [--limit <n>] [--json]
worktree ps [--limit <n>] [--json]
worktree show | current
worktree create --name <nome> [--repo <seletor>] [--agent <id>] [--prompt <texto>]
[--base-branch <ref>] [--setup run|skip|inherit]
[--issue <n>] [--pr <n>] [--linear-issue <id-ou-url>]
[--parent-worktree <seletor>] [--activate] [--json]
worktree set ...
worktree rm --worktree <seletor> [--force] [--json]worktree ps lista os workspaces com o estado dos agentes em cada um.
Seletores:
--repo:id:…,name:…oupath:…;--worktree:id:…,name:…,branch:…,issue:…,path:…,activeoucurrent.
Terminais
terminal list | show | read
terminal create [--worktree <seletor>] [--title <nome>] [--command <texto>] [--shell <shell>] [--focus]
terminal send [--terminal <handle>] [--text <texto>] [--enter] [--interrupt]
terminal wait [--terminal <handle>] --for exit|tui-idle [--timeout-ms <ms>]
terminal rename | split | switch | focus | closeterminal wait --for tui-idle espera um agente ficar ocioso, o que serve para encadear agentes.
Outros grupos
| Grupo | Comandos |
|---|---|
| Início | open, serve, status |
| Busca | search <texto>, nas conversas dos agentes ou em tudo |
| Projetos e repositórios | project …, repo list, repo add, repo show, repo set, repo set-base-ref, repo search-refs |
| Arquivos | file open, file diff, file open-changed |
| Orquestração | orchestration …: execuções, tarefas, despacho para outros agentes, perguntas e respostas entre agentes |
| Automações | automations list, show, create, edit, remove, run, runs |
| Linear | linear issue, search, create, status set, comment add, label … e outros |
| Navegador | tab …, snapshot, goto, click, fill, type, screenshot, wait, cookie …, viewport, console, network e outros |
| Uso do computador | computer …: listar janelas, clicar, digitar, arrastar |
| Emulador | emulator …, para emuladores Android |
| Contas e skills | account …, skills installed, skills list, skills install, skills update |
| Hosts e ambientes | host list, environment … |
| Agentes | agent hooks on, agent hooks off, agent hooks status, agent-context |
| Diagnóstico | diagnostics memory |
Use --help em qualquer grupo para ver as opções completas.
Em hosts SSH
Terminais remotos também têm a CLI. Por padrão, ela só alcança os terminais do próprio host. Para deixar a CLI do host controlar o Dusky, ligue a permissão nas opções avançadas do host em SSH.
O que não existe no Dusky
Publicar artifacts e compartilhar skills dependem de uma conta de nuvem que o Dusky não usa. Esses comandos respondem que o recurso não está disponível.