デスクトップ CLI
DR-Terminal のデスクトップ版にはコマンドラインインターフェースが付属しています。IDE 連携、スクリプト、自動化に便利です。
使い方
DR-Terminal connect <target> [flags]
- target — まず保存済み接続名(大文字小文字を区別しない)として解決され、次に保存済み接続の
host[:port]と照合され(-uを指定した場合はそれで絞り込まれます)、最後にアドホックなセッション用のhost[:port]として解析されます。保存済み接続に一致した場合は、その接続のテーマ、グループ、保存済みの認証情報が再利用されます。
フラグ
| フラグ | 説明 |
|---|---|
-u, --user | ユーザー名(host:port ターゲット用)。 |
-p, --password | コマンドラインでのパスワード(安全でない — シェル履歴に残る可能性があります)。 |
--password-stdin | 標準入力からパスワードを読みます(安全:pass show server | DR-Terminal ...)。--exec 専用です。 |
-i, --identity | 秘密鍵ファイル(PEM)。--exec 専用です。 |
-j, --jump | 名前で指定するジャンプホストのチェーン、例:bastion1,bastion2。 |
-c, --command | シェルスニペット:ログイン後に注入(既定)するか、--exec でヘッドレス実行します。 |
--new-tab | 実行中のインスタンスで強制的に新しいタブを開きます。 |
--exec | ヘッドレス:コマンドを実行し、stdout/stderr をストリーミングし、リモートの終了コードで終了します。 |
-h, --help | このヘルプを表示します。 |
-i と --password-stdin はヘッドレスな --exec の実行にのみ適用されます。GUI でタブを開く場合、認証には保存済み接続の認証情報か、通常のアプリ内プロンプトが使われます。
例
# 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'
CLI からのローカルターミナル
DR-Terminal local [flags]
GUI に新しいローカルターミナルのタブを開き(アプリが起動していない場合は起動します)、必要に応じて準備のできたシェルへコマンドを入力します。コマンドが終了した後もシェルは対話的なままです — タブは通常のローカルセッションです。
| フラグ | 説明 |
|---|---|
-t, --type | 開くシェル:system、cmd、powershell、pwsh、wsl、または wsl:<distribution>。省略時:設定で構成されているローカルシェル — ローカルターミナルボタンが開くものと同じです。この選択はこのタブにのみ適用されます。 |
-c, --command | 新しいタブのシェルが準備でき次第、そのシェルに入力されます — たまたまアクティブだったセッションに入力されることはありません。 |
--cwd | シェルの作業ディレクトリ。省略時:CLI を呼び出したディレクトリになるため、アプリがすでに起動していたかどうかに関わらず、--command 内の相対パスは同じファイルを指します。 |
cmd、powershell、pwsh、wsl は Windows のシェルです。他のシステムでは --type system を使うか、設定でシェルを構成してください。
# 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
PATH へのシンボリックリンク
DR-Terminal をインストールした後、コマンドをグローバルに使えるようシンボリックリンクを作成します。
sudo ln -s /path/to/DR-Terminal/bin/DR-Terminal /usr/local/bin/dr-terminal
dr-terminal connect lager --exec -c 'df -h'
シングルインスタンス
DR-Terminal はユーザーごとに 1 つのインスタンスを保持します(Unix ドメインソケット、Windows では名前付きパイプ)。2 つ目の DR-Terminal connect ... または DR-Terminal local ... は引数を実行中のインスタンスへ転送して終了し、実行中のインスタンスが新しいタブを開きます。