CLI do Desktop — DR-Terminal

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

Uso

DR-Terminal connect <target> [flags]

target — resolvido primeiro como o nome de uma ligação guardada (sem distinção entre maiúsculas e minúsculas), depois comparado com as ligações guardadas por host[:port] (restringido por -u quando indicado) e, por fim, interpretado como host[:port] para uma sessão ad-hoc. Uma correspondência guardada reutiliza o tema, o grupo e as credenciais armazenadas dessa ligação.

Flags

Flag	Descrição
`-u`, `--user`	Nome de utilizador (para destinos `host:port`).
`-p`, `--password`	Palavra-passe na linha de comandos (inseguro — pode acabar no histórico do shell).
`--password-stdin`	Lê a palavra-passe da stdin (seguro: `pass show server \| DR-Terminal ...`). Apenas com `--exec`.
`-i`, `--identity`	Ficheiro 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 (predefinição) ou executado sem interface com `--exec`.
`--new-tab`	Força a abertura de um novo separador 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 aplicam-se apenas a execuções sem interface com --exec. Ao abrir um separador na interface gráfica, a autenticação utiliza as credenciais da ligação guardada ou as caixas de diálogo normais dentro da aplicação.

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'

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 utilizador (socket de domínio Unix ou named pipe no Windows). Um segundo DR-Terminal connect ... encaminha os respetivos argumentos para a instância em execução e termina — a instância em execução abre então um novo separador.