rdp-cli

Windows・Mac・Linux の RDP コマンドライン入門

一度接続し、観察して操作し、結果を確認。本機の表示ウィンドウは任意です。
rdp-cli の動作を見る

どの RDP コマンドが必要ですか?

AI エージェントにデスクトップ操作を任せる

rdp-cli は Windows、macOS、Linux で動作します。エージェントはビューアーを開かずに接続し、スクリーンショットを読み取り、マウスやキーを操作してファイルを転送できます。人は GUI または Web ビューアーから同じセッションに参加し、操作を引き継げます。

接続手順を見る →目的別にコマンドを探す →

リモートデスクトップのウィンドウを開く

Windows の mstsc は標準のリモートデスクトップアプリを開きます。desktop.example.net を接続先のアドレスに置き換え、ウィンドウ内でサインインしてください。

mstsc /v:desktop.example.net

手元の PC から始める

プラットフォームを選び、
リモート作業を始める。

rdp-cli を動かす PC を選び、
エージェントに遠隔操作の道具を用意します。

01 / インストールと確認

EXE を用意し、PowerShell を開きます。

ARM プロセッサ搭載の Windows 10 または 11 では ARM64 を選びます。Intel または AMD プロセッサでは、64 ビット Windows は x64、32 ビット Windows は x86 を選びます。対応する rdp-cli.exe をダウンロードし、PowerShell で実行してください。

各アーキテクチャ向けに、それぞれ単一の EXE ファイルを提供します。

PowerShell
.\rdp-cli.exe --help
2. デスクトップに接続

接続先で RDP を有効にし、192.0.2.20 と USER を置き換えます。非表示の入力欄からパスワードを標準入力へ渡し、JSON 応答の data.session を保存します。

PowerShell
$secret = Read-Host 'パスワード' -AsSecureString
$savedEncoding = $OutputEncoding
try {
  $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
  [System.Net.NetworkCredential]::new('', $secret).Password |
    .\rdp-cli.exe connect --host 192.0.2.20 --user USER --password-stdin
} finally {
  $OutputEncoding = $savedEncoding
  $secret.Dispose()
}
3. 操作前に観察

SESSION を接続結果の値に置き換えます。before.png で対象と入力位置を確認し、応答の data.observation を保存します。

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. 操作して結果を確認

画像で入力位置を見つけ、X、Y、OBSERVATION を置き換えます。クリック後に再撮影し、新しい observation で入力します。after.png で実際の結果を確認してください。

PowerShell
.\rdp-cli.exe click --session SESSION --desktop --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./focused.png
.\rdp-cli.exe type --session SESSION --text "リモート作業が完了しました。" --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. 人が見たいときに表示

閲覧したいときだけ、既存セッションをウィンドウやブラウザーで開きます。初期状態は読み取り専用。一時停止、引き継ぎ、返却を操作し、交代や再接続後は新しい観察を取得します。

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / インストールと確認

DMG を開き、CLI を有効にします。

rdp-cli を「アプリケーション」にドラッグし、Mac のターミナル(zsh)で以下を実行します。

Mac のチップに合う DMG を選んでください。Apple silicon は macOS 13 以降、Intel は macOS 12 以降が対象です。公開状況はダウンロードページで確認できます。

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. デスクトップに接続

接続先で RDP を有効にし、192.0.2.20 と USER を置き換えます。非表示の入力欄からパスワードを標準入力へ渡し、JSON 応答の data.session を保存します。

zsh
read -r -s "rdp_password?パスワード: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. 操作前に観察

SESSION を接続結果の値に置き換えます。before.png で対象と入力位置を確認し、応答の data.observation を保存します。

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. 操作して結果を確認

画像で入力位置を見つけ、X、Y、OBSERVATION を置き換えます。クリック後に再撮影し、新しい observation で入力します。after.png で実際の結果を確認してください。

zsh
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out ./focused.png
rdp-cli type --session SESSION --text "リモート作業が完了しました。" --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. 人が見たいときに表示

閲覧したいときだけ、既存セッションをウィンドウやブラウザーで開きます。初期状態は読み取り専用。一時停止、引き継ぎ、返却を操作し、交代や再接続後は新しい観察を取得します。

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / インストールと確認

1つのファイルで実行

Linux x86_64 ファイルをダウンロードし、実行権限を付けてターミナルで実行します。管理者権限は不要です。

x86_64 版は以下の Linux システムで利用できます。他の OS バージョンとの互換性は未確認です。

対象システム →

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. デスクトップに接続

接続先で RDP を有効にし、192.0.2.20 と USER を置き換えます。非表示の入力欄からパスワードを標準入力へ渡し、JSON 応答の data.session を保存します。

Bash
IFS= read -r -s -p 'パスワード: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-x86_64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. 操作前に観察

SESSION を接続結果の値に置き換えます。before.png で対象と入力位置を確認し、応答の data.observation を保存します。

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. 操作して結果を確認

画像で入力位置を見つけ、X、Y、OBSERVATION を置き換えます。クリック後に再撮影し、新しい observation で入力します。after.png で実際の結果を確認してください。

Bash
./rdp-cli-linux-x86_64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-x86_64 type --session SESSION --text "リモート作業が完了しました。" --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. 人が見たいときに表示

閲覧したいときだけ、既存セッションをウィンドウやブラウザーで開きます。初期状態は読み取り専用。一時停止、引き継ぎ、返却を操作し、交代や再接続後は新しい観察を取得します。

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / インストールと確認

1つのファイルで実行

64 ビット ARM Linux 用の Linux ARM64 ファイルをダウンロードし、実行権限を付けて一般ユーザーで実行します。

同じ静的 ARM64 ELF が、掲載の Linux システム、Raspberry Pi 4、DGX Spark に対応します。32 ビットの Raspberry Pi OS は対象外です。

対象システム →

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. デスクトップに接続

接続先で RDP を有効にし、192.0.2.20 と USER を置き換えます。非表示の入力欄からパスワードを標準入力へ渡し、JSON 応答の data.session を保存します。

Bash
IFS= read -r -s -p 'パスワード: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-arm64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. 操作前に観察

SESSION を接続結果の値に置き換えます。before.png で対象と入力位置を確認し、応答の data.observation を保存します。

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. 操作して結果を確認

画像で入力位置を見つけ、X、Y、OBSERVATION を置き換えます。クリック後に再撮影し、新しい observation で入力します。after.png で実際の結果を確認してください。

Bash
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-arm64 type --session SESSION --text "リモート作業が完了しました。" --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. 人が見たいときに表示

閲覧したいときだけ、既存セッションをウィンドウやブラウザーで開きます。初期状態は読み取り専用。一時停止、引き継ぎ、返却を操作し、交代や再接続後は新しい観察を取得します。

Bash
./rdp-cli-linux-arm64 watch --session SESSION --viewer window
./rdp-cli-linux-arm64 watch --session SESSION --viewer web

例のアドレスや値は置き換えてください。session と observation は実際の応答を使い、入力後は新しい画像で結果を確認します。

VNC

VNC デスクトップ

アクセス権があり到達可能な VNC サーバーを使い、ホストとポートを置き換えてください。この例は従来の VNC パスワード認証で、通信は暗号化されません。信頼できる LAN または VPN 内で使用してください。パスワードは標準入力から渡し、入力を終了します。応答の data.session を SESSION として保存します。Windows PowerShell では rdp-cli を .\rdp-cli.exe に、PATH 未設定の Linux では実行ファイルのパスに置き換えます。

rdp-cli connect --protocol vnc --host 192.0.2.20 --port 5900 --password-stdin

before.png を開いて実際の座標を選び、応答の data.observation を OBSERVATION として使います。操作のたびに画面を再取得して結果を確認します。接続例とサーバーごとの条件は VNC ガイドを参照してください。

rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png
VNC をコマンドで操作して入力結果を確認する →

機能 →

Android · USB / Wi-Fi

AI エージェントに、実際の Android 画面を。

USB または Wi-Fi でスマートフォンに接続。エージェントがコマンドで画面を確認し、タップ、入力、成果の取得を行う間、同じセッションをウィンドウやブラウザーで確認できます。

Android スマートフォン · USB / Wi-Fi →

Android 対応のダウンロード: macOS · Apple silicon · macOS · Intel · Windows · x64 · Windows · x86 · Windows · ARM64 · Linux · x86_64 · Linux · ARM64

画面を見て操作

実際の画面を撮影し、タップ、スワイプ、ドラッグ、2 本指のジェスチャーを実行。新しいスクリーンショットで結果を確認します。

テキスト、ファイル、アプリ

Unicode テキストを明示的に貼り付け、ファイルやフォルダーを転送し、単一 APK アプリをインストール、起動、停止できます。

人とエージェントが共有

コマンド、ネイティブウィンドウ、承認済みブラウザーが同じ持続セッションを共有。必要に応じて一時停止や操作の引き継ぎができます。

対応基準は Android 12 以降です。実機確認済みなのは Android 12 の Google Pixel 3 です。すべてのメーカーや後続バージョンでの検証を意味しません。

スマートフォンの準備

  1. 開発者向けオプションと USB デバッグを有効にし、データケーブルで接続して、ロック解除した端末でデバッグを許可します。
  2. Wi-Fi ではワイヤレスデバッグを有効にし、端末に表示されたペア設定コードとポートを使用します。接続ポートは別です。USB 接続は不要です。
  3. Windows の USB 接続には、スマートフォンとホストの CPU アーキテクチャに適した WinUSB ドライバーが必要です。ARM64 も同様です。rdp-cli はドライバーの自動インストールや他のデバッグツールの終了を行いません。 Linux (x86_64 / ARM64) では、適切な udev ルールまたはデバイスグループで通常のユーザーに端末の USB アクセス権を付与し、以下のコマンドを Bash で実行します。rdp-cli の実行に sudo は使わないでください。macOS はシステムの USB インターフェースを使用します。

DEVICE_SERIAL、SESSION、OBSERVATION、PHONE_IP と2つのポートを実際の値に置き換えてください。connect の data.session と各スクリーンショットの data.observation を使用します。wifi:PHONE_GUID は返された wifi: デバイス ID に置き換えます。PHONE_REF には、このコンピューターにペア設定を保存するための名前を指定します。入力を求められたら、その時点の6桁のコードを入力してください。コマンドが標準入力で送信します。

macOS / Linux

検出して接続

検出結果のデバイス ID を明示的に指定します。接続だけではウィンドウや音声は開始しません。

rdp-cli android devices
rdp-cli connect --protocol adb --device usb:DEVICE_SERIAL --transport usb

観察、操作、確認

before.png を確認し、その座標と観察値で操作します。after.png でアプリの実際の結果を確認します。

rdp-cli screenshot --session SESSION --out before.png
rdp-cli android touch --session SESSION --kind tap --x 300 --y 900 --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

ワイヤレス接続

Wi-Fi は USB に代わる接続方法です。同じ端末に USB セッションがある場合は、先に disconnect --session SESSION を実行します。ペア設定後、返された端末 ID と現在の接続ポートで接続します。新しい data.session を保存し、入力前に再びスクリーンショットを取得します。

printf '%s' 'ペア設定コード: '
IFS= read -r -s rdp_pair_code
printf '\n'
printf '%s' "$rdp_pair_code" | rdp-cli android pair --host PHONE_IP --port PAIR_PORT --code-stdin --save-device-auth PHONE_REF
unset rdp_pair_code
rdp-cli connect --protocol adb --device wifi:PHONE_GUID --transport wifi --host PHONE_IP --port CONNECT_PORT --device-auth-ref PHONE_REF

終了

端末音声をオフにして切断します。転送済みファイルや利用者がインストールしたアプリは残ります。

rdp-cli audio android --session SESSION --source off
rdp-cli disconnect --session SESSION
Windows · PowerShell

検出して接続

検出結果のデバイス ID を明示的に指定します。接続だけではウィンドウや音声は開始しません。

.\rdp-cli.exe android devices
.\rdp-cli.exe connect --protocol adb --device usb:DEVICE_SERIAL --transport usb

観察、操作、確認

before.png を確認し、その座標と観察値で操作します。after.png でアプリの実際の結果を確認します。

.\rdp-cli.exe screenshot --session SESSION --out before.png
.\rdp-cli.exe android touch --session SESSION --kind tap --x 300 --y 900 --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

ワイヤレス接続

Wi-Fi は USB に代わる接続方法です。同じ端末に USB セッションがある場合は、先に disconnect --session SESSION を実行します。ペア設定後、返された端末 ID と現在の接続ポートで接続します。新しい data.session を保存し、入力前に再びスクリーンショットを取得します。

$pairingCode = Read-Host 'ペア設定コード' -AsSecureString
try {
  [System.Net.NetworkCredential]::new('', $pairingCode).Password |
    .\rdp-cli.exe android pair --host PHONE_IP --port PAIR_PORT --code-stdin --save-device-auth PHONE_REF
} finally {
  $pairingCode.Dispose()
}
.\rdp-cli.exe connect --protocol adb --device wifi:PHONE_GUID --transport wifi --host PHONE_IP --port CONNECT_PORT --device-auth-ref PHONE_REF

終了

端末音声をオフにして切断します。転送済みファイルや利用者がインストールしたアプリは残ります。

.\rdp-cli.exe audio android --session SESSION --source off
.\rdp-cli.exe disconnect --session SESSION

動作範囲

AI エージェントがリモート端末を操作。人はいつでも参加できます。

接続して画面を確認し、短い操作列を送り、結果を確かめます。セッション ID を保存し、人から操作が戻ったら新しく画面を確認します。

OS と CPU に合う実行ファイルを一つダウンロード。以下のコマンドを使う前に、そのファイルの対応機能を確認してください。

必要な場所を確認

画面の一部や縮小画像を取得し、前の観察と比較。変化がなければ画像を省略でき、座標はリモート画面との対応を保ちます。

画面の変化や転送完了を待つ

指定範囲の変化・安定、接続・操作・ファイル転送の指定状態を待ちます。続ける前に実際の成果も確認します。

短い操作列を送り、確認点で止まる

エージェントが決めた操作をまとめ、新しい観察とチェックポイントを追加。エラーや操作権の変更で後続を停止し、送信済みの操作は取り消しません。

進捗を残し、中断後に確認して続行

タスクの進捗、チェックポイント、選択した画像を保存し、ローカルのレポートに出力。中断後は完了内容を確認し、結果不明の操作を繰り返さず新しい手順へ進みます。

複数のエージェントと人で引き継ぐ

登録済みエージェント間で操作権を明示的に移します。人は GUI や Web から引き継ぎ、指定したエージェントに返せます。返された側は画面を確認して再開します。

エージェント接続と接続診断

実行ファイル内蔵の MCP または CLI を利用。認証情報への参照を持つ接続プロファイルを保存し、doctor で接続の各層を確認できます。

メイン画面か仮想ディスプレイを選択

対応 Android 端末で仮想ディスプレイを明示的に作成し、アプリを起動。エージェント、GUI、Web は同じ表示先を使います。アプリの動作とシステムの音声許可は引き続き適用されます。

Windows · PowerShell
.\rdp-cli.exe --version
.\rdp-cli.exe --help-json
.\rdp-cli.exe screenshot --session SESSION --max-width 640
.\rdp-cli.exe screenshot --session SESSION --region X,Y,WIDTH,HEIGHT --max-width 640
.\rdp-cli.exe wait --session SESSION --condition changed --region X,Y,WIDTH,HEIGHT --timeout-ms 10000
.\rdp-cli.exe doctor --session SESSION
.\rdp-cli.exe mcp stdio
macOS / Linux
rdp-cli --version
rdp-cli --help-json
rdp-cli screenshot --session SESSION --max-width 640
rdp-cli screenshot --session SESSION --region X,Y,WIDTH,HEIGHT --max-width 640
rdp-cli wait --session SESSION --condition changed --region X,Y,WIDTH,HEIGHT --timeout-ms 10000
rdp-cli doctor --session SESSION
rdp-cli mcp stdio

Linux · X11 / SSH · Wayland RDP / VNC

X11 と SSH で AI エージェントから Linux アプリを操作する

既存の Linux デスクトップまたは単独の X11 アプリに接続し、画面取得と入力コマンドで作業し、ファイルを回収して同じセッションを人に引き継ぎます。

ダウンロード: macOS · Apple siliconmacOS · IntelWindows · x64Windows · x86Windows · ARM64Linux · x86_64Linux · ARM64

接続前に、読み書き可能な既存のリモートディレクトリを FILE_ROOT に指定します。デスクトップモードの DISPLAY と XAUTHORITY は、対象ユーザーのログイン済み GUI 内で開いた端末から確認します。SSH 端末の値は異なる場合があります。空ならデスクトップの所有者か管理者に確認してください。

macOS / Linux

エージェントと人が同じセッションを使う

rdp-cli を使うと、AI エージェントがコマンドで Linux アプリの画面を見て操作できます。画面を取得し、その画面をもとに操作して、次の画面で結果を確認します。人はネイティブウィンドウや許可された Web ビューアーを開き、同じセッションの監視、一時停止、操作の引き継ぎができます。

許可済みの接続先を準備する

Linux 側には既存の SSH 接続手段と、インストール済みの X11 対応アプリが必要です。例のアドレス、ユーザー、秘密鍵のパス、別途確認済みの known-hosts ファイルを置き換えてください。Windows PowerShell では rdp-cli を .\rdp-cli.exe に置き換えます。--version の embedded_ssh、x11_desktop、x11_application がすべて true であることを確認します。

アプリを単独で開く

この例では、rdp-cli 内蔵の独立した表示環境で既存の Gedit を開きます。ローカルのビューアーは自動で開きません。応答の data.session を保存し、以下の SESSION に使います。通常のデスクトップが Wayland のホストでも、X11 対応アプリはこの方法で転送できます。

rdp-cli connect --protocol x11 --mode application --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --application /usr/bin/gedit --app-args '["--standalone","--new-window"]'

既存の X11 デスクトップに接続する場合

実際の display と既存の認証ファイルのパスを指定します。SSH ユーザーにはその display へのアクセス権が必要です。SSH 認証の成功だけでは、デスクトップへのアクセスは許可されません。このモードは既存のデスクトップに接続し、別のログインセッションは作りません。

rdp-cli connect --protocol x11 --mode desktop --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --display DISPLAY --xauthority XAUTHORITY_PATH

画面を確認してから操作する

返された PNG を確認し、data.observation を保存します。X、Y を画像内の実際の座標に置き換えます。入力欄を選択した後にもう一度画面を取得し、新しいトークンを使います。明示的なクリップボード入力はリモート側のクリップボードを置き換え、手元のクリップボードは変えません。入力応答は送信の確認なので、その後の画面も確認してください。

rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out focused.png
rdp-cli linux text --session SESSION --method clipboard --text '確認が完了しました。' --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

成果のファイルを回収する

アップロード結果の remote_path を Linux アプリで開き、編集、保存してから結果をダウンロードします。各 transfer_id を保存し、completed になるまで待ってください。転送前にファイルを保存します。同名ファイルは標準では上書きしません。失敗時には、繰り返す前にタスクの状態を確認します。

FILE_ROOT を、この SSH アカウントで読み書きできる既存のリモートディレクトリに置き換えてください。ファイル操作の範囲はそのディレクトリ内です。指定してもディレクトリは作成されず、権限も追加されません。

rdp-cli files list --session SESSION
rdp-cli files upload --session SESSION --local ./report.txt --path report.txt
rdp-cli files status --session SESSION --transfer-id UPLOAD_TRANSFER
rdp-cli files download --session SESSION --path report.txt --local ./result.txt
rdp-cli files status --session SESSION --transfer-id DOWNLOAD_TRANSFER

人が作業を引き継ぐ

画面を見たいときにビューアーを開きます。最初は読み取り専用です。操作を引き継ぐとエージェントの入力が止まり、修正後に操作を返すと同じ作業を続行できます。許可された Web ビューアーも同じセッションに参加し、人による操作権を持てるのは一つのビューアーだけです。読み取り専用のビューアーを閉じても接続は維持されます。

rdp-cli watch --session SESSION --viewer window

プロトコルの範囲を確認する

ネイティブ X11 は音声再生やマイクのリダイレクトを提供しません。Wayland デスクトップ全体への接続には、設定済みの互換 RDP または VNC エンドポイントが必要で、実際にネゴシエートされた機能を使います。rdp-cli はリモートサービスをインストール、有効化しません。表示接続の切断や喪失でアプリが終了する場合があるため、先に保存してください。自動再起動やワークスペースの保持は想定しないでください。

Wayland の文字入力は既存のサーバーに依存します。GNOME 46 と Krfb 23.08 では一部の Unicode キーを変換できない場合があるため、入力結果を確認してください。クリップボードからの明示的な貼り付けは、その接続先で実際に動作する場合に使います。Plasma Wayland の Krfb はクリップボード対応を通知してもアプリに内容を渡さない場合があります。複雑な入力や連続操作は小さな手順に分け、次のスクリーンショットで確認してください。

実測済みデスクトップ接続先: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

クイックスタートを読む

Windows · PowerShell

エージェントと人が同じセッションを使う

rdp-cli を使うと、AI エージェントがコマンドで Linux アプリの画面を見て操作できます。画面を取得し、その画面をもとに操作して、次の画面で結果を確認します。人はネイティブウィンドウや許可された Web ビューアーを開き、同じセッションの監視、一時停止、操作の引き継ぎができます。

許可済みの接続先を準備する

Linux 側には既存の SSH 接続手段と、インストール済みの X11 対応アプリが必要です。例のアドレス、ユーザー、秘密鍵のパス、別途確認済みの known-hosts ファイルを置き換えてください。Windows PowerShell では rdp-cli を .\rdp-cli.exe に置き換えます。--version の embedded_ssh、x11_desktop、x11_application がすべて true であることを確認します。

アプリを単独で開く

この例では、rdp-cli 内蔵の独立した表示環境で既存の Gedit を開きます。ローカルのビューアーは自動で開きません。応答の data.session を保存し、以下の SESSION に使います。通常のデスクトップが Wayland のホストでも、X11 対応アプリはこの方法で転送できます。

.\rdp-cli.exe connect --protocol x11 --mode application --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --application /usr/bin/gedit --app-args '["--standalone","--new-window"]'

既存の X11 デスクトップに接続する場合

実際の display と既存の認証ファイルのパスを指定します。SSH ユーザーにはその display へのアクセス権が必要です。SSH 認証の成功だけでは、デスクトップへのアクセスは許可されません。このモードは既存のデスクトップに接続し、別のログインセッションは作りません。

.\rdp-cli.exe connect --protocol x11 --mode desktop --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --display DISPLAY --xauthority XAUTHORITY_PATH

画面を確認してから操作する

返された PNG を確認し、data.observation を保存します。X、Y を画像内の実際の座標に置き換えます。入力欄を選択した後にもう一度画面を取得し、新しいトークンを使います。明示的なクリップボード入力はリモート側のクリップボードを置き換え、手元のクリップボードは変えません。入力応答は送信の確認なので、その後の画面も確認してください。

.\rdp-cli.exe screenshot --session SESSION --out before.png
.\rdp-cli.exe click --session SESSION --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out focused.png
.\rdp-cli.exe linux text --session SESSION --method clipboard --text '確認が完了しました。' --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

成果のファイルを回収する

アップロード結果の remote_path を Linux アプリで開き、編集、保存してから結果をダウンロードします。各 transfer_id を保存し、completed になるまで待ってください。転送前にファイルを保存します。同名ファイルは標準では上書きしません。失敗時には、繰り返す前にタスクの状態を確認します。

FILE_ROOT を、この SSH アカウントで読み書きできる既存のリモートディレクトリに置き換えてください。ファイル操作の範囲はそのディレクトリ内です。指定してもディレクトリは作成されず、権限も追加されません。

.\rdp-cli.exe files list --session SESSION
.\rdp-cli.exe files upload --session SESSION --local ./report.txt --path report.txt
.\rdp-cli.exe files status --session SESSION --transfer-id UPLOAD_TRANSFER
.\rdp-cli.exe files download --session SESSION --path report.txt --local ./result.txt
.\rdp-cli.exe files status --session SESSION --transfer-id DOWNLOAD_TRANSFER

人が作業を引き継ぐ

画面を見たいときにビューアーを開きます。最初は読み取り専用です。操作を引き継ぐとエージェントの入力が止まり、修正後に操作を返すと同じ作業を続行できます。許可された Web ビューアーも同じセッションに参加し、人による操作権を持てるのは一つのビューアーだけです。読み取り専用のビューアーを閉じても接続は維持されます。

.\rdp-cli.exe watch --session SESSION --viewer window

プロトコルの範囲を確認する

ネイティブ X11 は音声再生やマイクのリダイレクトを提供しません。Wayland デスクトップ全体への接続には、設定済みの互換 RDP または VNC エンドポイントが必要で、実際にネゴシエートされた機能を使います。rdp-cli はリモートサービスをインストール、有効化しません。表示接続の切断や喪失でアプリが終了する場合があるため、先に保存してください。自動再起動やワークスペースの保持は想定しないでください。

Wayland の文字入力は既存のサーバーに依存します。GNOME 46 と Krfb 23.08 では一部の Unicode キーを変換できない場合があるため、入力結果を確認してください。クリップボードからの明示的な貼り付けは、その接続先で実際に動作する場合に使います。Plasma Wayland の Krfb はクリップボード対応を通知してもアプリに内容を渡さない場合があります。複雑な入力や連続操作は小さな手順に分け、次のスクリーンショットで確認してください。

実測済みデスクトップ接続先: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

クイックスタートを読む

Agent と使う

実行ファイルの場所、許可された接続先またはセッション、望む結果を伝えます。任意の rdp-cli-agent スキルに手順があり、SKILL.md を直接読めます。接続にスキルの導入は必須ではありません。

rdp-cli-agent / SKILL.md ↓

接続とアクセスの設定

RDP 証明書ポリシーは互換性のため初期値が ignore です。connect --help を読み、環境に合わせて検証を設定してください。公式サイトは接続を中継せず認証情報を収集しません。ブラウザーは LAN/VPN 用、VNC は信頼できるネットワークで利用します。

rdp-cli@weerocks.com