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]

Flags

FlagDescrição
-u, --userNome de utilizador (para destinos host:port).
-p, --passwordPalavra-passe na linha de comandos (inseguro — pode acabar no histórico do shell).
--password-stdinLê a palavra-passe da stdin (seguro: pass show server | DR-Terminal ...). Apenas com --exec.
-i, --identityFicheiro de chave privada (PEM). Apenas com --exec.
-j, --jumpCadeia de jump hosts por nome, por exemplo, bastion1,bastion2.
-c, --commandTrecho de shell: injetado após o login (predefinição) ou executado sem interface com --exec.
--new-tabForça a abertura de um novo separador na instância em execução.
--execSem interface: executa o comando, transmite stdout/stderr e sai com o código de saída remoto.
-h, --helpMostra 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.

FlagDescrição
-t, --typeShell 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, --commandEscrito no shell do novo separador assim que estiver pronto — nunca na sessão que estivesse ativa no momento.
--cwdDiretó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.

Anterior
Local & série
Seguinte
Segurança e dados