CLI Desktop — DR-Terminal

Build Desktop DR-Terminal dilengkapi antarmuka baris perintah. Berguna untuk integrasi IDE, skrip, dan otomatisasi.

Penggunaan

DR-Terminal connect <target> [flags]

target — diselesaikan pertama-tama sebagai nama koneksi tersimpan (tidak peka huruf besar/kecil), lalu dicocokkan dengan koneksi tersimpan berdasarkan host[:port] (dipersempit dengan -u jika diberikan), lalu diurai sebagai host[:port] untuk sesi ad-hoc. Kecocokan dengan koneksi tersimpan menggunakan kembali tema, grup, dan kredensial tersimpan dari koneksi tersebut.

Flag

Flag	Deskripsi
`-u`, `--user`	Nama pengguna (untuk target `host:port`).
`-p`, `--password`	Kata sandi di baris perintah (tidak aman — dapat masuk ke riwayat shell).
`--password-stdin`	Membaca kata sandi dari stdin (aman: `pass show server \| DR-Terminal ...`). Hanya `--exec`.
`-i`, `--identity`	File kunci privat (PEM). Hanya `--exec`.
`-j`, `--jump`	Rantai jump host berdasarkan nama, mis. `bastion1,bastion2`.
`-c`, `--command`	Cuplikan shell: disuntikkan setelah login (default) atau dijalankan secara headless dengan `--exec`.
`--new-tab`	Memaksa membuka tab baru di instance yang sedang berjalan.
`--exec`	Headless: menjalankan perintah, mengalirkan stdout/stderr, keluar dengan kode keluar dari sisi jauh.
`-h`, `--help`	Menampilkan bantuan ini.

-i dan --password-stdin hanya berlaku untuk eksekusi headless --exec. Saat membuka tab di GUI, autentikasi menggunakan kredensial koneksi tersimpan atau prompt biasa di dalam aplikasi.

Contoh

# 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 lokal dari CLI

DR-Terminal local [flag]

Membuka tab terminal lokal baru di GUI (menjalankan aplikasi bila belum berjalan) dan opsional mengetikkan perintah ke shell yang sudah siap. Setelah perintah selesai, shell tetap interaktif — tab tersebut adalah sesi lokal biasa.

Flag	Deskripsi
`-t`, `--type`	Shell yang dibuka: `system`, `cmd`, `powershell`, `pwsh`, `wsl`, atau `wsl:<distribusi>`. Jika dihilangkan: shell lokal yang dikonfigurasi di Pengaturan — sama dengan yang dibuka tombol terminal lokal. Pilihan hanya berlaku untuk tab ini.
`-c`, `--command`	Diketikkan ke shell tab baru begitu siap — tidak pernah ke sesi yang kebetulan sedang aktif.
`--cwd`	Direktori kerja shell. Jika dihilangkan: direktori tempat CLI dipanggil, sehingga path relatif di `--command` menunjuk file yang sama terlepas dari apakah aplikasi sudah berjalan atau belum.

cmd, powershell, pwsh, dan wsl adalah shell Windows; di sistem lain gunakan --type system atau konfigurasikan shell di Pengaturan.

# 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

Symlink ke PATH

Setelah memasang DR-Terminal, buat symlink agar perintahnya berfungsi secara global:

sudo ln -s /path/to/DR-Terminal/bin/DR-Terminal /usr/local/bin/dr-terminal
dr-terminal connect lager --exec -c 'df -h'

Instance tunggal

DR-Terminal mempertahankan satu instance per pengguna (socket domain Unix atau named pipe di Windows). Perintah DR-Terminal connect ... atau DR-Terminal local ... kedua meneruskan argumennya ke instance yang sedang berjalan lalu keluar — instance yang berjalan kemudian membuka tab baru.