Desktop CLI
Desktop verzia DR-Terminal prináša rozhranie príkazového riadka. Užitočné na integrácie s IDE, skriptovanie a automatizáciu.
Použitie
DR-Terminal connect <target> [flags]
- target — najprv sa vyhodnotí ako názov uloženého pripojenia (bez ohľadu na veľkosť písmen), potom sa porovná s uloženými pripojeniami podľa
host[:port](zúžene podľa-u, ak je zadané) a napokon sa spracuje akohost[:port]pre ad-hoc reláciu. Zhoda s uloženým pripojením prevezme jeho tému, skupinu a uložené prihlasovacie údaje.
Príznaky
| Príznak | Popis |
|---|---|
-u, --user | Meno používateľa (pre ciele host:port). |
-p, --password | Heslo na príkazovom riadku (nebezpečné — môže sa dostať do histórie shellu). |
--password-stdin | Čítať heslo zo stdin (bezpečné: pass show server | DR-Terminal ...). Len s --exec. |
-i, --identity | Súbor súkromného kľúča (PEM). Len s --exec. |
-j, --jump | Reťazec skokových hostiteľov podľa názvu, napr. bastion1,bastion2. |
-c, --command | Shell útržok: vložený po prihlásení (predvolene) alebo vykonaný bez hlavy s --exec. |
--new-tab | Vynútiť otvorenie novej karty v bežiacej inštancii. |
--exec | Bez hlavy: spustiť príkaz, prúdiť stdout/stderr, ukončiť s kódom ukončenia vzdialeného procesu. |
-h, --help | Zobraziť túto nápovedu. |
-i a --password-stdin platia len pre behy bez hlavy s --exec. Pri otváraní karty v GUI sa na overenie použijú prihlasovacie údaje uloženého pripojenia alebo bežné výzvy v aplikácii.
Príklady
# Otvoriť novú kartu v bežiacej inštancii a prihlásiť sa do uloženého "lager"
DR-Terminal connect lager --new-tab
# Ad-hoc hostiteľ s používateľom — aplikácia si vyžiada prihlasovacie údaje
DR-Terminal connect 10.0.0.1:22 -u pi --new-tab
# Reťazec skokov: bastion1 → bastion2 → cieľ
DR-Terminal connect production -j bastion1,bastion2 --new-tab
# Spustenie bez hlavy so súborom kľúča — vypíše uptime a skončí
DR-Terminal connect 10.0.0.1:22 -u pi -i ~/.ssh/id_ed25519 --exec -c 'uptime'
# CLI štartovací skript: spustiť príkazy po prihlásení
DR-Terminal connect dev --new-tab -c 'cd /srv/app && tmux attach -t main'
Lokálny terminál z CLI
DR-Terminal local [príznaky]
Otvorí novú kartu lokálneho terminálu v GUI (a spustí aplikáciu, keď nebeží) a voliteľne napíše príkaz do pripraveného shellu. Shell zostáva po skončení príkazu interaktívny — karta je bežnou lokálnou reláciou.
| Príznak | Popis |
|---|---|
-t, --type | Shell, ktorý sa má otvoriť: system, cmd, powershell, pwsh, wsl alebo wsl:<distribúcia>. Ak chýba: lokálny shell nastavený v Nastaveniach — ten istý, ktorý otvára tlačidlo Lokálny terminál. Voľba platí len pre túto kartu. |
-c, --command | Napíše sa do shellu novej karty, hneď ako je pripravený — nikdy do relácie, ktorá bola náhodou aktívna. |
--cwd | Pracovný adresár shellu. Ak chýba: adresár, z ktorého bolo CLI zavolané, takže relatívne cesty v --command ukazujú na tie isté súbory bez ohľadu na to, či aplikácia už bežala. |
cmd, powershell, pwsh a wsl sú shelly Windows; na iných systémoch použite --type system alebo nastavte shell v Nastaveniach.
# Predvolený lokálny shell, spustenie skriptu z aktuálneho adresára
DR-Terminal local --command "python3 aaaa.py"
# Windows: vynútenie CMD a pracovného adresára s medzerami
DR-Terminal.exe local --type cmd --cwd "C:\projekty\demo" --command "python3 aaaa.py"
# Len otvoriť kartu WSL vo vybranej distribúcii
DR-Terminal local --type wsl:Ubuntu-24.04
Symbolický odkaz do PATH
Po inštalácii DR-Terminal vytvorte symbolický odkaz, aby príkaz fungoval globálne:
sudo ln -s /path/to/DR-Terminal/bin/DR-Terminal /usr/local/bin/dr-terminal
dr-terminal connect lager --exec -c 'df -h'
Jedna inštancia
DR-Terminal udržiava jednu inštanciu na používateľa (doménový soket Unix alebo pomenovaný kanál na Windows). Druhý DR-Terminal connect ... alebo DR-Terminal local ... odovzdá svoje argumenty bežiacej inštancii a skončí — bežiaca inštancia potom otvorí novú kartu.