CLI do Desktop — DR-Terminal

A versão Desktop do DR-Terminal traz uma interface de linha de comando. Útil para integrações com IDE, scripts e automação.

Uso

DR-Terminal connect <target> [flags]

target — resolvido primeiro como o nome de uma conexão salva (sem distinção de maiúsculas), depois comparado com as conexões salvas por host[:port] (restringido por -u quando informado) e, por fim, analisado como host[:port] para uma sessão ad-hoc. Uma correspondência salva reutiliza o tema, o grupo e as credenciais armazenadas daquela conexão.

Flags

Flag	Descrição
`-u`, `--user`	Nome de usuário (para destinos `host:port`).
`-p`, `--password`	Senha na linha de comando (inseguro — pode ir parar no histórico do shell).
`--password-stdin`	Lê a senha da stdin (seguro: `pass show server \| DR-Terminal ...`). Apenas com `--exec`.
`-i`, `--identity`	Arquivo de chave privada (PEM). Apenas com `--exec`.
`-j`, `--jump`	Cadeia de jump hosts por nome, por exemplo, `bastion1,bastion2`.
`-c`, `--command`	Trecho de shell: injetado após o login (padrão) ou executado sem interface com `--exec`.
`--new-tab`	Força a abertura de uma nova aba na instância em execução.
`--exec`	Sem interface: executa o comando, transmite stdout/stderr e sai com o código de saída remoto.
`-h`, `--help`	Mostra esta ajuda.

-i e --password-stdin se aplicam apenas a execuções sem interface com --exec. Ao abrir uma aba na interface gráfica, a autenticação usa as credenciais da conexão salva ou os avisos normais dentro do aplicativo.

Exemplos

# Open a new tab in the running instance and log into saved "lager"
DR-Terminal connect lager --new-tab

# Ad-hoc host with user — the app prompts for credentials
DR-Terminal connect 10.0.0.1:22 -u pi --new-tab

# Jump chain: bastion1 → bastion2 → target
DR-Terminal connect production -j bastion1,bastion2 --new-tab

# Headless exec with a key file — prints uptime and exits
DR-Terminal connect 10.0.0.1:22 -u pi -i ~/.ssh/id_ed25519 --exec -c 'uptime'

# CLI start script: run commands after login
DR-Terminal connect dev --new-tab -c 'cd /srv/app && tmux attach -t main'

Terminal local a partir da CLI

DR-Terminal local [flags]

Abre uma nova aba de terminal local na interface gráfica (iniciando o aplicativo quando ele não está em execução) e, opcionalmente, digita um comando no shell pronto. O shell continua interativo depois que o comando termina — a aba é uma sessão local comum.

Flag	Descrição
`-t`, `--type`	Shell a abrir: `system`, `cmd`, `powershell`, `pwsh`, `wsl` ou `wsl:<distribuição>`. Omitida: o shell local configurado nas Configurações — o mesmo que o botão Terminal local abre. A escolha vale apenas para esta aba.
`-c`, `--command`	Digitado no shell da nova aba assim que ele estiver pronto — nunca na sessão que por acaso estava ativa.
`--cwd`	Diretório de trabalho do shell. Omitida: o diretório de onde a CLI foi invocada, para que os caminhos relativos em `--command` apontem para os mesmos arquivos, independentemente de o aplicativo já estar em execução ou não.

cmd, powershell, pwsh e wsl são shells do Windows; em outros sistemas use --type system ou configure o shell nas Configurações.

# Default local shell, run a script from the current directory
DR-Terminal local --command "python3 aaaa.py"

# Windows: force CMD and a working directory with spaces
DR-Terminal.exe local --type cmd --cwd "C:\projekty\demo" --command "python3 aaaa.py"

# Just open a WSL tab in a picked distribution
DR-Terminal local --type wsl:Ubuntu-24.04

Link simbólico no PATH

Após instalar o DR-Terminal, crie um link simbólico para que o comando funcione globalmente:

sudo ln -s /path/to/DR-Terminal/bin/DR-Terminal /usr/local/bin/dr-terminal
dr-terminal connect lager --exec -c 'df -h'

Instância única

O DR-Terminal mantém uma instância por usuário (socket de domínio Unix ou named pipe no Windows). Um segundo DR-Terminal connect ... ou DR-Terminal local ... encaminha seus argumentos para a instância em execução e sai — a instância em execução então abre uma nova aba.