Beobachten und handeln
Erfassen Sie den echten Bildschirm, führen Sie Tipp-, Wisch-, Zieh- und Zweifingergesten aus und prüfen Sie das Ergebnis mit einem neuen Screenshot.
rdp-cli
Einmal verbinden, beobachten, handeln und prüfen. Das lokale Fenster ist optional.
rdp-cli in Aktion ansehen
rdp-cli läuft auf Windows, macOS und Linux. Dein Agent verbindet sich ohne Viewer, liest Screenshots, sendet Klicks und Tastatureingaben und überträgt Dateien. Du kannst über den GUI- oder Web-Viewer derselben Sitzung beitreten und die Steuerung übernehmen.
Schritt für Schritt verbinden →Befehle nach Aufgabe finden →Unter Windows öffnet mstsc die integrierte Remotedesktop-App. Ersetze desktop.example.net durch die Adresse deines Computers und melde dich im Fenster an.
mstsc /v:desktop.example.netAUF IHREM COMPUTER STARTEN
Wählen Sie den Rechner für rdp-cli.
Geben Sie Ihrem Agenten Werkzeuge für Remoteaufgaben.
Wählen Sie ARM64 für Windows 10 oder 11 auf einem ARM-Prozessor. Bei Intel- oder AMD-Prozessoren wählen Sie x64 für 64-Bit-Windows oder x86 für 32-Bit-Windows. Laden Sie die passende rdp-cli.exe herunter und führen Sie sie in PowerShell aus.
Für jede Architektur gibt es eine eigene einzelne EXE-Datei.
rdp-cli.exe Windows ≥ 7 · 64 Bit rdp-cli.exe Windows ≥ 7 · 32 Bit rdp-cli.exe Windows 10 / 11 · ARM64 .\rdp-cli.exe --helpAktivieren Sie RDP auf dem Ziel. Ersetzen Sie 192.0.2.20 und USER. Die verdeckte Abfrage übergibt das Passwort über die Standardeingabe. Speichern Sie data.session aus der JSON-Antwort.
$secret = Read-Host 'Passwort' -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()
}Ersetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.
.\rdp-cli.exe screenshot --session SESSION --out ./before.pngBestimmen Sie das Eingabefeld im Bild und ersetzen Sie X, Y und OBSERVATION. Nach dem Klick erneut aufnehmen und den neuen Beobachtungswert zur Texteingabe nutzen. Prüfen Sie after.png.
.\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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.pngDie vorhandene Sitzung bei Bedarf im Fenster oder Browser öffnen. Ansichten starten schreibgeschützt. Dort pausieren, übernehmen und zurückgeben. Nach Übergabe oder Wiederverbindung braucht der Agent eine neue Beobachtung.
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer webZiehen Sie rdp-cli nach Programme und führen Sie diese Befehle im macOS-Terminal (zsh) aus.
Wähle das DMG für deinen Mac: Apple silicon (ab macOS 13) oder Intel (ab macOS 12). Die Downloadseite zeigt, welche Versionen verfügbar sind.
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --helpAktivieren Sie RDP auf dem Ziel. Ersetzen Sie 192.0.2.20 und USER. Die verdeckte Abfrage übergibt das Passwort über die Standardeingabe. Speichern Sie data.session aus der JSON-Antwort.
read -r -s "rdp_password?Passwort: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_passwordErsetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.
rdp-cli screenshot --session SESSION --out ./before.pngBestimmen Sie das Eingabefeld im Bild und ersetzen Sie X, Y und OBSERVATION. Nach dem Klick erneut aufnehmen und den neuen Beobachtungswert zur Texteingabe nutzen. Prüfen Sie after.png.
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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.pngDie vorhandene Sitzung bei Bedarf im Fenster oder Browser öffnen. Ansichten starten schreibgeschützt. Dort pausieren, übernehmen und zurückgeben. Nach Übergabe oder Wiederverbindung braucht der Agent eine neue Beobachtung.
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer webLade die Linux-x86_64-Datei herunter, erteile die Ausführungsberechtigung und starte sie im Terminal. Administratorrechte sind nicht erforderlich.
Der x86_64-Download ist für die unten aufgeführten Linux-Systeme geeignet. Andere Systemversionen wurden nicht auf Kompatibilität geprüft.
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --helpAktivieren Sie RDP auf dem Ziel. Ersetzen Sie 192.0.2.20 und USER. Die verdeckte Abfrage übergibt das Passwort über die Standardeingabe. Speichern Sie data.session aus der JSON-Antwort.
IFS= read -r -s -p 'Passwort: ' 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_passwordErsetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.pngBestimmen Sie das Eingabefeld im Bild und ersetzen Sie X, Y und OBSERVATION. Nach dem Klick erneut aufnehmen und den neuen Beobachtungswert zur Texteingabe nutzen. Prüfen Sie after.png.
./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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.pngDie vorhandene Sitzung bei Bedarf im Fenster oder Browser öffnen. Ansichten starten schreibgeschützt. Dort pausieren, übernehmen und zurückgeben. Nach Übergabe oder Wiederverbindung braucht der Agent eine neue Beobachtung.
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer webLade die Linux-ARM64-Datei für ein 64-Bit-ARM-Linux-System herunter, erteile die Ausführungsberechtigung und starte sie als normaler Benutzer.
Dieselbe statische ARM64-ELF-Datei für die aufgeführten Linux-Systeme, Raspberry Pi 4 und DGX Spark. Raspberry Pi OS mit 32 Bit wird nicht unterstützt.
rdp-cli-linux-arm64 aarch64 · 64 Bit chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --helpAktivieren Sie RDP auf dem Ziel. Ersetzen Sie 192.0.2.20 und USER. Die verdeckte Abfrage übergibt das Passwort über die Standardeingabe. Speichern Sie data.session aus der JSON-Antwort.
IFS= read -r -s -p 'Passwort: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-arm64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_passwordErsetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.pngBestimmen Sie das Eingabefeld im Bild und ersetzen Sie X, Y und OBSERVATION. Nach dem Klick erneut aufnehmen und den neuen Beobachtungswert zur Texteingabe nutzen. Prüfen Sie after.png.
./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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.pngDie vorhandene Sitzung bei Bedarf im Fenster oder Browser öffnen. Ansichten starten schreibgeschützt. Dort pausieren, übernehmen und zurückgeben. Nach Übergabe oder Wiederverbindung braucht der Agent eine neue Beobachtung.
./rdp-cli-linux-arm64 watch --session SESSION --viewer window
./rdp-cli-linux-arm64 watch --session SESSION --viewer webErsetzen Sie Beispieladresse und Platzhalter. Verwenden Sie session und observation aus den tatsächlichen Antworten und prüfen Sie Eingaben mit einem neuen Screenshot.
VNC
Nutze einen erreichbaren VNC-Server, für den du berechtigt bist. Ersetze Host und Port. Das Beispiel nutzt klassische VNC-Passwortauthentifizierung ohne Verschlüsselung; verwende ein vertrauenswürdiges LAN oder VPN. Übergib das Passwort über die Standardeingabe und beende die Eingabe. Speichere data.session als SESSION. In PowerShell ersetzt du rdp-cli durch .\rdp-cli.exe; unter Linux nutzt du bei Bedarf den vollständigen Programmpfad.
rdp-cli connect --protocol vnc --host 192.0.2.20 --port 5900 --password-stdin Öffne before.png, wähle die tatsächlichen Koordinaten und nutze data.observation aus der Antwort als OBSERVATION. Prüfe das Ergebnis nach jeder Aktion mit einem neuen Screenshot. Die VNC-Anleitung enthält das vollständige Verbindungsbeispiel und die Serverbedingungen.
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 Per Kommandozeile mit VNC verbinden und Eingaben prüfen → Android · USB / Wi-Fi
Verbinden Sie ein Smartphone über USB oder WLAN. Ihr Agent beobachtet, tippt, gibt Text ein und ruft Ergebnisse per Befehl ab. Sie verfolgen dieselbe Sitzung im Fenster oder Browser.
Android-Smartphone · USB / Wi-Fi →
Downloads mit Android-Unterstützung: macOS · Apple silicon · macOS · Intel · Windows · x64 · Windows · x86 · Windows · ARM64 · Linux · x86_64 · Linux · ARM64
Erfassen Sie den echten Bildschirm, führen Sie Tipp-, Wisch-, Zieh- und Zweifingergesten aus und prüfen Sie das Ergebnis mit einem neuen Screenshot.
Fügen Sie Unicode-Text ausdrücklich ein, übertragen Sie Dateien und Ordner und installieren, starten oder stoppen Sie Apps aus einer einzelnen APK.
Agent, natives Fenster und autorisierte Browser teilen eine dauerhafte Sitzung. Bei Bedarf pausieren Sie oder übernehmen die Steuerung.
Die unterstützte Basis ist Android 12 oder neuer. Geprüft wurde Google Pixel 3 mit Android 12. Das bedeutet nicht, dass alle Hersteller oder späteren Android-Versionen getestet wurden.
Ersetzen Sie DEVICE_SERIAL, SESSION, OBSERVATION, PHONE_IP und beide Ports durch echte Werte. Verwenden Sie data.session aus connect und data.observation aus dem jeweiligen Screenshot. Ersetzen Sie wifi:PHONE_GUID durch die zurückgegebene wifi:-Geräte-ID. Wählen Sie für PHONE_REF einen Namen, unter dem die Kopplung auf diesem Computer gespeichert wird. Geben Sie den aktuellen sechsstelligen Code bei der Aufforderung ein; der Befehl übergibt ihn über die Standardeingabe.
Wählen Sie die ermittelte Geräte-ID ausdrücklich aus. Die Verbindung öffnet kein Fenster und aktiviert kein Audio.
rdp-cli android devices
rdp-cli connect --protocol adb --device usb:DEVICE_SERIAL --transport usbPrüfen Sie before.png und verwenden Sie dessen Koordinaten und Beobachtungswert. Kontrollieren Sie das App-Ergebnis in 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.pngWLAN ist eine Alternative zu USB. Besteht bereits eine USB-Sitzung für dieses Smartphone, zuerst disconnect --session SESSION ausführen. Danach koppeln und mit zurückgegebener Geräte-ID und aktuellem Verbindungsport verbinden. Neue data.session speichern und vor Eingaben erneut ein Bildschirmbild aufnehmen.
printf '%s' 'Kopplungscode: '
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_REFSchalten Sie das Smartphone-Audio aus und trennen Sie die Verbindung. Fertige Dateien und Benutzer-Apps bleiben erhalten.
rdp-cli audio android --session SESSION --source off
rdp-cli disconnect --session SESSIONWählen Sie die ermittelte Geräte-ID ausdrücklich aus. Die Verbindung öffnet kein Fenster und aktiviert kein Audio.
.\rdp-cli.exe android devices
.\rdp-cli.exe connect --protocol adb --device usb:DEVICE_SERIAL --transport usbPrüfen Sie before.png und verwenden Sie dessen Koordinaten und Beobachtungswert. Kontrollieren Sie das App-Ergebnis in 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.pngWLAN ist eine Alternative zu USB. Besteht bereits eine USB-Sitzung für dieses Smartphone, zuerst disconnect --session SESSION ausführen. Danach koppeln und mit zurückgegebener Geräte-ID und aktuellem Verbindungsport verbinden. Neue data.session speichern und vor Eingaben erneut ein Bildschirmbild aufnehmen.
$pairingCode = Read-Host 'Kopplungscode' -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_REFSchalten Sie das Smartphone-Audio aus und trennen Sie die Verbindung. Fertige Dateien und Benutzer-Apps bleiben erhalten.
.\rdp-cli.exe audio android --session SESSION --source off
.\rdp-cli.exe disconnect --session SESSIONVerbinden, Bildschirm ansehen, eine kurze Aktionsfolge senden und das Ergebnis prüfen. Bewahre die Sitzungs-ID auf und beobachte nach einer menschlichen Übernahme erneut.
Eine ausführbare Datei für dein Betriebssystem und deinen Prozessor. Prüfe ihre Fähigkeiten, bevor du die folgenden Befehle verwendest.
Fordere einen Bildausschnitt oder ein kleineres Bild an. Vergleiche es mit einer früheren Beobachtung und lasse das Bild bei unverändertem Inhalt weg. Koordinaten bleiben dem entfernten Bildschirm zugeordnet.
Warte auf einen veränderten oder stabilen Bereich oder einen bestimmten Zustand einer Verbindung, Aktion oder Dateiübertragung. Prüfe vor dem Fortfahren das tatsächliche Ergebnis.
Fasse vom Agenten festgelegte Aktionen zusammen, beobachte erneut und halte an einem Prüfpunkt an. Fehler oder ein Steuerungswechsel stoppen Folgeschritte; gesendete Aktionen werden nicht zurückgerollt.
Speichere Fortschritt, Prüfpunkte und ausgewählte Bilder und exportiere einen lokalen Bericht. Prüfe nach einer Unterbrechung erledigte Arbeit und beginne neue Schritte, ohne unklare Aktionen zu wiederholen.
Registrierte Agenten übergeben die Steuerung ausdrücklich. Menschen können per GUI oder Web übernehmen und an einen ausgewählten Agenten zurückgeben, der vor weiteren Aktionen erneut beobachtet.
Nutze die integrierte MCP-Schnittstelle oder die CLI. Speichere benannte Verbindungsprofile mit Verweisen auf Zugangsdaten und prüfe Verbindungsschichten mit doctor.
Erstelle auf einem unterstützten Android-Gerät ausdrücklich ein virtuelles Display und starte dort eine App. Agent, GUI und Web nutzen dasselbe Display; App-Verhalten und Systemberechtigungen für Audio gelten weiterhin.
.\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 rdp-cli --version
rdp-cli --help-jsonrdp-cli screenshot --session SESSION --max-width 640
rdp-cli screenshot --session SESSION --region X,Y,WIDTH,HEIGHT --max-width 640rdp-cli wait --session SESSION --condition changed --region X,Y,WIDTH,HEIGHT --timeout-ms 10000rdp-cli doctor --session SESSIONrdp-cli mcp stdio Linux · X11 / SSH · Wayland RDP / VNC
Verbinde einen vorhandenen Linux-Desktop oder eine einzelne X11-Anwendung, arbeite mit Bildschirmaufnahmen und Eingabebefehlen, hole Dateien ab und übergib dieselbe Sitzung an einen Menschen.
Download: macOS · Apple siliconmacOS · IntelWindows · x64Windows · x86Windows · ARM64Linux · x86_64Linux · ARM64
Wähle vor dem Verbinden für FILE_ROOT ein vorhandenes, les- und beschreibbares Verzeichnis auf dem Zielgerät. DISPLAY und XAUTHORITY für den Desktopmodus stammen aus einem Terminal in der aktiven grafischen Sitzung des Zielbenutzers. Eine SSH-Sitzung kann andere Werte haben. Bei leeren Werten frage den Desktopbesitzer oder Administrator.
Mit rdp-cli kann ein KI-Agent eine Linux-Anwendung über Befehle sehen und bedienen. Er erstellt eine Bildschirmaufnahme, handelt anhand des Bildes und prüft das nächste Bild. Du kannst ein natives Fenster oder einen autorisierten Web-Betrachter öffnen, um dieselbe Sitzung zu beobachten, anzuhalten oder zu übernehmen.
Der Linux-Rechner benötigt einen vorhandenen SSH-Zugang und eine installierte X11-kompatible Anwendung. Ersetze Adresse, Benutzer, privaten Schlüsselpfad und die unabhängig geprüfte known-hosts-Datei. Unter Windows PowerShell verwendest du .\rdp-cli.exe statt rdp-cli. Prüfe, dass --version für embedded_ssh, x11_desktop und x11_application jeweils true meldet.
Das Beispiel öffnet das bereits installierte Gedit in einer isolierten, in rdp-cli integrierten Anzeige. Ein lokales Betrachterfenster wird nicht automatisch geöffnet. Speichere data.session aus der Antwort als SESSION. Auch ein Rechner mit einem gewöhnlichen Wayland-Desktop kann eine X11-kompatible Anwendung so weiterleiten.
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"]'
Gib das tatsächliche display und den Pfad seiner vorhandenen Autorisierungsdatei an. Das SSH-Konto braucht Zugriff auf dieses display; eine SSH-Anmeldung allein erteilt keine Desktop-Berechtigung. Dieser Modus verbindet den vorhandenen Desktop und erzeugt keine weitere Anmeldung.
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
Öffne das zurückgegebene PNG und speichere data.observation. Ersetze X und Y durch tatsächliche Bildkoordinaten. Nach dem Fokussieren des Feldes erstellst du ein neues Bild und nutzt den neuen Token. Die ausdrücklich gewählte Zwischenablage-Methode ersetzt die entfernte Zwischenablage, nicht die lokale. Eine Eingabeantwort bestätigt den Versand; prüfe danach das sichtbare Ergebnis.
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 'Prüfung abgeschlossen.' --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png
Öffne den remote_path des Upload-Ergebnisses in der Linux-Anwendung, bearbeite und speichere die Datei und lade das Ergebnis herunter. Behalte jede transfer_id und warte auf completed. Speichere vor der Übertragung; vorhandene Namen werden standardmäßig nicht überschrieben. Prüfe bei Fehlern den Aufgabenstatus, bevor du erneut überträgst.
Ersetze FILE_ROOT durch ein vorhandenes entferntes Verzeichnis, in dem dieses SSH-Konto lesen und schreiben darf. Dateioperationen bleiben in diesem Verzeichnis. Die Angabe erstellt kein Verzeichnis und erteilt keine zusätzlichen Rechte.
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
Öffne den Betrachter, wenn du zusehen möchtest. Er beginnt schreibgeschützt. Die Übernahme stoppt Agent-Eingaben; nach der Korrektur gibst du die Kontrolle für dieselbe Aufgabe zurück. Ein autorisierter Web-Betrachter teilt diese Sitzung. Nur ein Betrachter kann menschliche Kontrolle besitzen. Ein geschlossenes schreibgeschütztes Fenster trennt die Verbindung nicht.
rdp-cli watch --session SESSION --viewer window
Natives X11 bietet keine Wiedergabe- oder Mikrofonumleitung. Für einen ganzen Wayland-Desktop ist ein bereits konfigurierter kompatibler RDP- oder VNC-Endpunkt nötig; es gelten die tatsächlich ausgehandelten Fähigkeiten. rdp-cli installiert oder aktiviert keinen entfernten Dienst. Beim Trennen oder Verlust der Anzeige kann die Anwendung enden. Speichere vorher und erwarte weder automatischen Neustart noch einen erhaltenen Arbeitsbereich.
Die Texteingabe unter Wayland hängt vom vorhandenen Server ab. GNOME 46 und Krfb 23.08 können manche Unicode-Tasten nicht zuordnen; prüfe daher das Ergebnis. Verwende explizites Einfügen aus der Zwischenablage nur, wenn es am Ziel funktioniert: Krfb unter Plasma Wayland kann die Funktion melden, ohne Inhalte an Anwendungen weiterzugeben. Sende komplexe Eingaben oder schnelle Abläufe in kleinen Schritten und prüfe den nächsten Screenshot.
Getestete Desktop-Endpunkte: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.
Mit rdp-cli kann ein KI-Agent eine Linux-Anwendung über Befehle sehen und bedienen. Er erstellt eine Bildschirmaufnahme, handelt anhand des Bildes und prüft das nächste Bild. Du kannst ein natives Fenster oder einen autorisierten Web-Betrachter öffnen, um dieselbe Sitzung zu beobachten, anzuhalten oder zu übernehmen.
Der Linux-Rechner benötigt einen vorhandenen SSH-Zugang und eine installierte X11-kompatible Anwendung. Ersetze Adresse, Benutzer, privaten Schlüsselpfad und die unabhängig geprüfte known-hosts-Datei. Unter Windows PowerShell verwendest du .\rdp-cli.exe statt rdp-cli. Prüfe, dass --version für embedded_ssh, x11_desktop und x11_application jeweils true meldet.
Das Beispiel öffnet das bereits installierte Gedit in einer isolierten, in rdp-cli integrierten Anzeige. Ein lokales Betrachterfenster wird nicht automatisch geöffnet. Speichere data.session aus der Antwort als SESSION. Auch ein Rechner mit einem gewöhnlichen Wayland-Desktop kann eine X11-kompatible Anwendung so weiterleiten.
.\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"]'
Gib das tatsächliche display und den Pfad seiner vorhandenen Autorisierungsdatei an. Das SSH-Konto braucht Zugriff auf dieses display; eine SSH-Anmeldung allein erteilt keine Desktop-Berechtigung. Dieser Modus verbindet den vorhandenen Desktop und erzeugt keine weitere Anmeldung.
.\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
Öffne das zurückgegebene PNG und speichere data.observation. Ersetze X und Y durch tatsächliche Bildkoordinaten. Nach dem Fokussieren des Feldes erstellst du ein neues Bild und nutzt den neuen Token. Die ausdrücklich gewählte Zwischenablage-Methode ersetzt die entfernte Zwischenablage, nicht die lokale. Eine Eingabeantwort bestätigt den Versand; prüfe danach das sichtbare Ergebnis.
.\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 'Prüfung abgeschlossen.' --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png
Öffne den remote_path des Upload-Ergebnisses in der Linux-Anwendung, bearbeite und speichere die Datei und lade das Ergebnis herunter. Behalte jede transfer_id und warte auf completed. Speichere vor der Übertragung; vorhandene Namen werden standardmäßig nicht überschrieben. Prüfe bei Fehlern den Aufgabenstatus, bevor du erneut überträgst.
Ersetze FILE_ROOT durch ein vorhandenes entferntes Verzeichnis, in dem dieses SSH-Konto lesen und schreiben darf. Dateioperationen bleiben in diesem Verzeichnis. Die Angabe erstellt kein Verzeichnis und erteilt keine zusätzlichen Rechte.
.\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
Öffne den Betrachter, wenn du zusehen möchtest. Er beginnt schreibgeschützt. Die Übernahme stoppt Agent-Eingaben; nach der Korrektur gibst du die Kontrolle für dieselbe Aufgabe zurück. Ein autorisierter Web-Betrachter teilt diese Sitzung. Nur ein Betrachter kann menschliche Kontrolle besitzen. Ein geschlossenes schreibgeschütztes Fenster trennt die Verbindung nicht.
.\rdp-cli.exe watch --session SESSION --viewer window
Natives X11 bietet keine Wiedergabe- oder Mikrofonumleitung. Für einen ganzen Wayland-Desktop ist ein bereits konfigurierter kompatibler RDP- oder VNC-Endpunkt nötig; es gelten die tatsächlich ausgehandelten Fähigkeiten. rdp-cli installiert oder aktiviert keinen entfernten Dienst. Beim Trennen oder Verlust der Anzeige kann die Anwendung enden. Speichere vorher und erwarte weder automatischen Neustart noch einen erhaltenen Arbeitsbereich.
Die Texteingabe unter Wayland hängt vom vorhandenen Server ab. GNOME 46 und Krfb 23.08 können manche Unicode-Tasten nicht zuordnen; prüfe daher das Ergebnis. Verwende explizites Einfügen aus der Zwischenablage nur, wenn es am Ziel funktioniert: Krfb unter Plasma Wayland kann die Funktion melden, ohne Inhalte an Anwendungen weiterzugeben. Sende komplexe Eingaben oder schnelle Abläufe in kleinen Schritten und prüfe den nächsten Screenshot.
Getestete Desktop-Endpunkte: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.
Programmdatei, autorisiertes Ziel oder Sitzung und gewünschtes Ergebnis nennen. Der optionale Skill rdp-cli-agent erklärt den Ablauf; SKILL.md kann direkt gelesen werden. Für eine Verbindung ist der Skill nicht erforderlich.
rdp-cli-agent / SKILL.md ↓RDP verwendet aus Kompatibilitätsgründen zunächst die Zertifikatrichtlinie ignore. connect --help lesen und die Prüfung passend konfigurieren. Die Website vermittelt keine Sitzungen und sammelt keine Zugangsdaten. Browseransichten sind für LAN/VPN; VNC braucht ein vertrauenswürdiges Netz.