CLI do Desktop
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-uquando indicado) e, por fim, interpretado comohost[: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'
Terminal local a partir da CLI
DR-Terminal local [flags]
Abre um novo separador de terminal local na interface gráfica (iniciando a aplicação quando não está em execução) e, opcionalmente, escreve um comando no shell pronto. O shell permanece interativo depois de o comando terminar — o separador é uma sessão local normal.
| Flag | Descrição |
|---|---|
-t, --type | Shell a abrir: system, cmd, powershell, pwsh, wsl ou wsl:<distribuição>. Omitida: o shell local configurado nas Definições — o mesmo que o botão Terminal local abre. A escolha aplica-se apenas a este separador. |
-c, --command | Escrito no shell do novo separador assim que estiver pronto — nunca na sessão que estivesse ativa no momento. |
--cwd | Diretório de trabalho do shell. Omitida: o diretório a partir do qual a CLI foi invocada, para que os caminhos relativos em --command apontem para os mesmos ficheiros, quer a aplicação já estivesse em execução quer não. |
cmd, powershell, pwsh e wsl são shells do Windows; noutros sistemas use --type system ou configure o shell nas Definiçõ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 utilizador (socket de domínio Unix ou named pipe no Windows). Um segundo DR-Terminal connect ... ou DR-Terminal local ... 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.