CLI Desktop
La build Desktop di DR-Terminal include un'interfaccia a riga di comando. Utile per integrazioni con IDE, scripting e automazione.
Utilizzo
DR-Terminal connect <target> [flags]
- target — risolto prima come nome di una connessione salvata (senza distinzione tra maiuscole e minuscole), poi confrontato con le connessioni salvate per
host[:port](ristretto da-uquando indicato), poi interpretato comehost[:port]per una sessione estemporanea. Una corrispondenza salvata riutilizza il tema, il gruppo e le credenziali memorizzate di quella connessione.
Flag
| Flag | Descrizione |
|---|---|
-u, --user | Nome utente (per target host:port). |
-p, --password | Password sulla riga di comando (insicura — può finire nella cronologia della shell). |
--password-stdin | Legge la password da stdin (sicuro: pass show server | DR-Terminal ...). Solo con --exec. |
-i, --identity | File della chiave privata (PEM). Solo con --exec. |
-j, --jump | Catena di jump host per nome, ad esempio bastion1,bastion2. |
-c, --command | Snippet di shell: iniettato dopo il login (predefinito) o eseguito senza interfaccia con --exec. |
--new-tab | Forza l'apertura di una nuova scheda nell'istanza in esecuzione. |
--exec | Senza interfaccia: esegue il comando, trasmette stdout/stderr, esce con il codice di uscita remoto. |
-h, --help | Mostra questo aiuto. |
-i e --password-stdin valgono solo per le esecuzioni senza interfaccia con --exec. Quando apri una scheda nella GUI, l'autenticazione usa le credenziali della connessione salvata o le normali richieste all'interno dell'app.
Esempi
# 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'
Terminale locale dalla CLI
DR-Terminal local [flag]
Apre una nuova scheda di Terminale locale nella GUI (avviando l'app quando non è in esecuzione) e facoltativamente digita un comando nella shell pronta. La shell resta interattiva al termine del comando — la scheda è una normale sessione locale.
| Flag | Descrizione |
|---|---|
-t, --type | Shell da aprire: system, cmd, powershell, pwsh, wsl o wsl:<distribuzione>. Se omesso: la shell locale configurata nelle Impostazioni — la stessa che apre il pulsante Terminale locale. La scelta vale solo per questa scheda. |
-c, --command | Digitato nella shell della nuova scheda non appena è pronta — mai nella sessione che si trovava a essere attiva. |
--cwd | Directory di lavoro per la shell. Se omesso: la directory da cui è stata invocata la CLI, così i percorsi relativi in --command puntano agli stessi file sia che l'app fosse già in esecuzione sia che no. |
cmd, powershell, pwsh e wsl sono shell di Windows; su altri sistemi usa --type system o configura la shell nelle Impostazioni.
# 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
Collegamento simbolico nel PATH
Dopo aver installato DR-Terminal, crea un collegamento simbolico così il comando funziona globalmente:
sudo ln -s /path/to/DR-Terminal/bin/DR-Terminal /usr/local/bin/dr-terminal
dr-terminal connect lager --exec -c 'df -h'
Istanza singola
DR-Terminal mantiene una sola istanza per utente (socket di dominio Unix o named pipe su Windows). Un secondo DR-Terminal connect ... o DR-Terminal local ... inoltra i propri argomenti all'istanza in esecuzione ed esce — l'istanza in esecuzione apre quindi una nuova scheda.