Desktop CLI
The Desktop build of DR-Terminal ships a command-line interface. Useful for IDE integrations, scripting and automation.
Usage
DR-Terminal connect <target> [flags]- target — resolved first as a saved connection name (case-insensitive), then matched against saved connections by
host[:port](narrowed by-uwhen given), then parsed ashost[:port]for an ad-hoc session. A saved match reuses that connection's theme, group and stored credentials.
Flags
| Flag | Description |
|---|---|
-u, --user | User name (for host:port targets). |
-p, --password | Password on the command line (insecure — may hit shell history). |
--password-stdin | Read password from stdin (safe: pass show server | DR-Terminal ...). --exec only. |
-i, --identity | Private key file (PEM). --exec only. |
-j, --jump | Chain of jump hosts by name, e.g. bastion1,bastion2. |
-c, --command | Shell snippet: injected after login (default) or executed headlessly with --exec. |
--new-tab | Force opening a new tab in the running instance. |
--exec | Headless: run command, stream stdout/stderr, exit with the remote exit code. |
-h, --help | Show this help. |
-i and --password-stdin apply to headless --exec runs only. When opening a tab in the GUI, authentication uses the saved connection's credentials or the regular in-app prompts.
Examples
# 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'Symlink into PATH
After installing DR-Terminal, create a symlink so the command works globally:
sudo ln -s /path/to/DR-Terminal/bin/DR-Terminal /usr/local/bin/dr-terminal
dr-terminal connect lager --exec -c 'df -h'Single-instance
DR-Terminal keeps one instance per user (Unix domain socket or named pipe on Windows). A second DR-Terminal connect ... forwards its args to the running instance and exits — the running instance then opens a new tab.