rdp-cli

RDP per Befehlszeile unter Windows, Mac und Linux

Einmal verbinden, beobachten, handeln und prüfen. Das lokale Fenster ist optional.
rdp-cli in Aktion ansehen

Welchen RDP-Befehl brauchst du?

Den Desktop mit einem KI-Agenten automatisieren

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 →

Ein Remotedesktopfenster öffnen

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.net

AUF IHREM COMPUTER STARTEN

Plattform wählen.
Die nächste Aufgabe starten.

Wählen Sie den Rechner für rdp-cli.
Geben Sie Ihrem Agenten Werkzeuge für Remoteaufgaben.

01 / INSTALLIEREN UND PRÜFEN

EXE bereitstellen, PowerShell öffnen.

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.

PowerShell
.\rdp-cli.exe --help
2. Desktop verbinden

Aktivieren 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.

PowerShell
$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()
}
3. Vor dem Handeln beobachten

Ersetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. Handeln und prüfen

Bestimmen 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.

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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. Menschen zusehen lassen

Die 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.

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / INSTALLIEREN UND PRÜFEN

DMG öffnen, CLI aktivieren.

Ziehen 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.

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. Desktop verbinden

Aktivieren 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.

zsh
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_password
3. Vor dem Handeln beobachten

Ersetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. Handeln und prüfen

Bestimmen 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.

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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. Menschen zusehen lassen

Die 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.

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / INSTALLIEREN UND PRÜFEN

Eine Datei ausführen

Lade 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.

Vorgesehene Systeme →

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. Desktop verbinden

Aktivieren 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.

Bash
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_password
3. Vor dem Handeln beobachten

Ersetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. Handeln und prüfen

Bestimmen 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.

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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. Menschen zusehen lassen

Die 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.

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / INSTALLIEREN UND PRÜFEN

Eine Datei ausführen

Lade 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.

Vorgesehene Systeme →

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. Desktop verbinden

Aktivieren 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.

Bash
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_password
3. Vor dem Handeln beobachten

Ersetzen Sie SESSION durch den Verbindungswert. Öffnen Sie before.png, suchen Sie die Zielposition und speichern Sie data.observation aus der Screenshot-Antwort.

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. Handeln und prüfen

Bestimmen 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.

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 "Remote-Aufgabe abgeschlossen." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. Menschen zusehen lassen

Die 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.

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

Ersetzen Sie Beispieladresse und Platzhalter. Verwenden Sie session und observation aus den tatsächlichen Antworten und prüfen Sie Eingaben mit einem neuen Screenshot.

VNC

VNC-Desktop

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 →

Funktionen →

Android · USB / Wi-Fi

Ein echter Android-Bildschirm für Ihren KI-Agenten.

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

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.

Text, Dateien und Apps

Fügen Sie Unicode-Text ausdrücklich ein, übertragen Sie Dateien und Ordner und installieren, starten oder stoppen Sie Apps aus einer einzelnen APK.

Gemeinsame Sitzung

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.

Smartphone vorbereiten

  1. Aktivieren Sie Entwickleroptionen und USB-Debugging, schließen Sie ein Datenkabel an und bestätigen Sie die Debugging-Anfrage auf dem entsperrten Smartphone.
  2. Für WLAN aktivieren Sie drahtloses Debugging und verwenden den angezeigten Kopplungscode und Kopplungsport. Der Verbindungsport ist ein anderer; USB ist nicht erforderlich.
  3. Windows benötigt für USB einen zum Smartphone und zur Hostarchitektur passenden WinUSB-Treiber, auch bei ARM64. rdp-cli installiert keine Treiber und beendet keine anderen Debugging-Werkzeuge. Unter Linux (x86_64 / ARM64) benötigt Ihr normaler Benutzer über eine passende udev-Regel oder Gerätegruppe Zugriff auf das USB-Gerät des Smartphones. Führen Sie die folgenden Befehle in Bash und rdp-cli ohne sudo aus. macOS verwendet die USB-Schnittstelle des Systems.

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.

macOS / Linux

Suchen und verbinden

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 usb

Beobachten, handeln, prüfen

Prü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.png

Drahtlos verbinden

WLAN 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_REF

Beenden

Schalten 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 SESSION
Windows · PowerShell

Suchen und verbinden

Wä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 usb

Beobachten, handeln, prüfen

Prü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.png

Drahtlos verbinden

WLAN 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_REF

Beenden

Schalten 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 SESSION

Funktionsumfang

Dein KI-Agent bedient entfernte Geräte. Du kannst jederzeit dazukommen.

Verbinden, 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.

Den relevanten Bereich ansehen

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.

Auf Änderungen oder Übertragungen warten

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.

Kurze Aktionsfolgen mit Prüfpunkten

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.

Fortschritt festhalten und geprüft fortsetzen

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.

Klare Übergaben zwischen Agenten und Menschen

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.

Agenten anbinden und Verbindungen prüfen

Nutze die integrierte MCP-Schnittstelle oder die CLI. Speichere benannte Verbindungsprofile mit Verweisen auf Zugangsdaten und prüfe Verbindungsschichten mit doctor.

Hauptbildschirm oder virtuelles Display wählen

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.

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

Linux-Anwendungen mit einem KI-Agenten über X11 und SSH steuern

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.

macOS / Linux

Eine Sitzung für den Agenten und dich

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.

Ein autorisiertes Ziel vorbereiten

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.

Eine einzelne Anwendung öffnen

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"]'

Oder einen vorhandenen X11-Desktop verbinden

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

Beobachten, handeln und prüfen

Ö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

Ergebnisdateien zurückholen

Ö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

Einen Menschen übernehmen lassen

Ö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

Die Protokollgrenzen kennen

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.

Weiter zum Schnellstart

Windows · PowerShell

Eine Sitzung für den Agenten und dich

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.

Ein autorisiertes Ziel vorbereiten

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.

Eine einzelne Anwendung öffnen

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"]'

Oder einen vorhandenen X11-Desktop verbinden

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

Beobachten, handeln und prüfen

Ö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

Ergebnisdateien zurückholen

Ö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

Einen Menschen übernehmen lassen

Ö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

Die Protokollgrenzen kennen

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.

Weiter zum Schnellstart

Mit Ihrem Agenten verwenden

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 ↓

Verbindung und Berechtigungen

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.

rdp-cli@weerocks.com