CLI de Desktop
La versión de escritorio de DR-Terminal incluye una interfaz de línea de comandos. Útil para integraciones con IDE, scripting y automatización.
Uso
DR-Terminal connect <target> [flags]
- target — se resuelve primero como nombre de una conexión guardada (sin distinguir mayúsculas), luego se compara con las conexiones guardadas por
host[:port](acotado con-usi se indica) y por último se interpreta comohost[:port]para una sesión puntual. Una coincidencia guardada reutiliza el tema, el grupo y las credenciales almacenadas de esa conexión.
Opciones
| Opción | Descripción |
|---|---|
-u, --user | Nombre de usuario (para destinos host:port). |
-p, --password | Contraseña en la línea de comandos (inseguro — puede acabar en el historial del shell). |
--password-stdin | Lee la contraseña de stdin (seguro: pass show server | DR-Terminal ...). Solo con --exec. |
-i, --identity | Archivo de clave privada (PEM). Solo con --exec. |
-j, --jump | Cadena de jump hosts por nombre, p. ej. bastion1,bastion2. |
-c, --command | Fragmento de shell: inyectado tras el inicio de sesión (por defecto) o ejecutado sin interfaz con --exec. |
--new-tab | Fuerza abrir una nueva pestaña en la instancia en ejecución. |
--exec | Sin interfaz: ejecuta el comando, transmite stdout/stderr y sale con el código de salida remoto. |
-h, --help | Muestra esta ayuda. |
-i y --password-stdin se aplican únicamente a las ejecuciones sin interfaz con --exec. Al abrir una pestaña en la interfaz gráfica, la autenticación usa las credenciales de la conexión guardada o las peticiones habituales dentro de la app.
Ejemplos
# 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 desde la CLI
DR-Terminal local [opciones]
Abre una nueva pestaña de Terminal local en la interfaz gráfica (arrancando la app si no está en ejecución) y, opcionalmente, escribe un comando en el shell ya listo. El shell sigue siendo interactivo cuando el comando termina — la pestaña es una sesión local normal.
| Opción | Descripción |
|---|---|
-t, --type | Shell que se abre: system, cmd, powershell, pwsh, wsl o wsl:<distribución>. Si se omite: el shell local configurado en Ajustes — el mismo que abre el botón Terminal local. La elección se aplica solo a esta pestaña. |
-c, --command | Se escribe en el shell de la nueva pestaña en cuanto está listo — nunca en la sesión que casualmente estuviera activa. |
--cwd | Directorio de trabajo del shell. Si se omite: el directorio desde el que se invocó la CLI, de modo que las rutas relativas de --command apuntan a los mismos archivos tanto si la app ya estaba en ejecución como si no. |
cmd, powershell, pwsh y wsl son shells de Windows; en otros sistemas usa --type system o configura el shell en Ajustes.
# 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
Enlace simbólico en el PATH
Tras instalar DR-Terminal, crea un enlace simbólico para que el 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'
Instancia única
DR-Terminal mantiene una sola instancia por usuario (socket de dominio Unix o named pipe en Windows). Un segundo DR-Terminal connect ... o DR-Terminal local ... reenvía sus argumentos a la instancia en ejecución y sale; la instancia en ejecución abre entonces una nueva pestaña.