rdp-cli

Premiers pas avec RDP en ligne de commande sur Windows, Mac et Linux

Connectez une fois, observez, agissez et vérifiez. Le visualiseur local est facultatif.
Voir rdp-cli à l’œuvre

De quelle commande RDP avez-vous besoin ?

Automatiser le bureau avec un agent IA

rdp-cli fonctionne sous Windows, macOS et Linux. Votre agent se connecte sans ouvrir de fenêtre, lit les captures, envoie des clics et des frappes et transfère des fichiers. Vous pouvez rejoindre la même session depuis le visualiseur GUI ou web et reprendre la main.

Se connecter pas à pas →Trouver une commande par tâche →

Ouvrir une fenêtre de bureau à distance

Sous Windows, mstsc ouvre l’application Bureau à distance intégrée. Remplacez desktop.example.net par l’adresse de votre ordinateur, puis connectez-vous dans la fenêtre.

mstsc /v:desktop.example.net

DEPUIS VOTRE ORDINATEUR

Choisissez votre plateforme.
Lancez votre prochaine tâche.

Choisissez le poste qui exécutera rdp-cli.
Préparez les outils distants de votre agent.

01 / INSTALLER ET VÉRIFIER

Préparez l’EXE et ouvrez PowerShell.

Pour Windows 10 ou 11 sur un processeur ARM, choisissez ARM64. Pour un processeur Intel ou AMD, choisissez x64 pour Windows 64 bits ou x86 pour Windows 32 bits. Téléchargez le fichier rdp-cli.exe correspondant et exécutez-le dans PowerShell.

Chaque architecture dispose de son propre fichier EXE unique.

PowerShell
.\rdp-cli.exe --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

PowerShell
$secret = Read-Host 'Mot de passe' -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. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez 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 "Tâche distante terminée." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / INSTALLER ET VÉRIFIER

Ouvrez le DMG et activez la CLI.

Glissez rdp-cli dans Applications, puis exécutez ces commandes dans le Terminal macOS (zsh).

Choisissez le DMG adapté à votre Mac : Apple silicon (macOS 13 ou version ultérieure) ou Intel (macOS 12 ou version ultérieure). Consultez la disponibilité sur la page de téléchargement.

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

zsh
read -r -s "rdp_password?Mot de passe: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez 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 "Tâche distante terminée." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / INSTALLER ET VÉRIFIER

Un fichier à exécuter

Téléchargez le fichier Linux x86_64, accordez-lui le droit d’exécution et lancez-le dans le terminal. Aucun droit administrateur n’est nécessaire.

La version x86_64 convient aux systèmes Linux listés ci-dessous. La compatibilité avec les autres versions n’a pas été vérifiée.

Systèmes prévus →

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

Bash
IFS= read -r -s -p 'Mot de passe: ' 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. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez 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 "Tâche distante terminée." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / INSTALLER ET VÉRIFIER

Un fichier à exécuter

Téléchargez le fichier Linux ARM64 pour un système Linux ARM 64 bits, accordez-lui le droit d’exécution et lancez-le avec votre compte habituel.

Un même fichier ELF statique ARM64 pour les systèmes Linux indiqués, Raspberry Pi 4 et DGX Spark. Raspberry Pi OS 32 bits n’est pas pris en charge.

Systèmes prévus →

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

Bash
IFS= read -r -s -p 'Mot de passe: ' 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. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez 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 "Tâche distante terminée." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

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

Remplacez l’adresse et les valeurs d’exemple. Utilisez session et observation des réponses réelles, puis une nouvelle capture pour vérifier le résultat.

VNC

Bureau VNC

Utilisez un serveur VNC accessible et autorisé. Remplacez l’hôte et le port. Cet exemple utilise l’authentification VNC classique, sans chiffrement : restez sur un LAN de confiance ou un VPN. Fournissez le mot de passe sur l’entrée standard, puis terminez la saisie. Conservez data.session comme SESSION. Dans PowerShell, remplacez rdp-cli par .\rdp-cli.exe ; sous Linux, utilisez le chemin de l’exécutable si nécessaire.

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

Ouvrez before.png, choisissez les coordonnées réelles et utilisez data.observation de la réponse comme OBSERVATION. Après chaque action, capturez à nouveau l’écran pour vérifier le résultat. Le guide VNC détaille la connexion et les conditions côté serveur.

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
Se connecter à VNC et vérifier la saisie en ligne de commande →

Fonctions →

Android · USB / Wi-Fi

Un véritable écran Android pour votre agent IA.

Connectez un téléphone en USB ou en Wi-Fi. Votre agent observe, touche, saisit et récupère les résultats par commandes, pendant que vous suivez la même session dans une fenêtre ou un navigateur.

Téléphone Android · USB / Wi-Fi →

Téléchargements compatibles Android: macOS · Apple silicon · macOS · Intel · Windows · x64 · Windows · x86 · Windows · ARM64 · Linux · x86_64 · Linux · ARM64

Observer puis agir

Capturez l’écran réel, effectuez des appuis, balayages, glissements et gestes à deux doigts, puis vérifiez le résultat avec une nouvelle capture.

Texte, fichiers et applications

Collez explicitement du texte Unicode, transférez des fichiers et dossiers, et installez, lancez ou arrêtez des applications composées d’un seul APK.

Partager une session

Agent, fenêtre native et navigateurs autorisés partagent une session persistante. Mettez en pause ou prenez le contrôle au besoin.

La base de compatibilité est Android 12 ou ultérieur. Le téléphone vérifié est un Google Pixel 3 sous Android 12 ; cela ne signifie pas que tous les fabricants et versions ultérieures ont été testés.

Préparer le téléphone

  1. Activez les options pour développeurs et le débogage USB, branchez un câble de données et confirmez l’autorisation sur le téléphone déverrouillé.
  2. En Wi-Fi, activez le débogage sans fil et utilisez le code et le port d’association affichés. Le port de connexion est distinct ; aucun câble USB n’est nécessaire.
  3. Sous Windows, la connexion USB nécessite un pilote WinUSB adapté au téléphone et à l’architecture de l’ordinateur, y compris ARM64. rdp-cli n’installe pas de pilotes et ne ferme pas les autres outils de débogage. Sous Linux (x86_64 / ARM64), donnez à votre utilisateur habituel l’accès au périphérique USB du téléphone au moyen d’une règle udev ou d’un groupe de périphériques adapté, puis exécutez les commandes ci-dessous dans Bash. Lancez rdp-cli sans sudo. macOS utilise l’interface USB du système.

Remplacez DEVICE_SERIAL, SESSION, OBSERVATION, PHONE_IP et les deux ports par les valeurs réelles. Conservez data.session de connect et utilisez data.observation de chaque capture. Remplacez wifi:PHONE_GUID par l’identifiant wifi: renvoyé. Choisissez un nom pour PHONE_REF afin d’enregistrer l’association sur cet ordinateur. Saisissez le code actuel à six chiffres à l’invite ; la commande le transmet par l’entrée standard.

macOS / Linux

Détecter et connecter

Choisissez explicitement l’identifiant détecté. La connexion n’ouvre pas de fenêtre et ne lance pas l’audio.

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

Observer, agir, vérifier

Consultez before.png et utilisez ses coordonnées et sa valeur d’observation. Vérifiez le résultat réel de l’application dans 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

Connexion sans fil

Le Wi-Fi est une alternative à l’USB. Si ce téléphone possède déjà une session USB, exécutez d’abord disconnect --session SESSION. Associez-le puis connectez-vous avec l’identifiant renvoyé et le port de connexion actuel. Enregistrez le nouveau data.session et reprenez une capture avant toute saisie.

printf '%s' 'Code d’association: '
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

Terminer

Coupez l’audio et déconnectez. Les fichiers terminés et les applications de l’utilisateur restent sur le téléphone.

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

Détecter et connecter

Choisissez explicitement l’identifiant détecté. La connexion n’ouvre pas de fenêtre et ne lance pas l’audio.

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

Observer, agir, vérifier

Consultez before.png et utilisez ses coordonnées et sa valeur d’observation. Vérifiez le résultat réel de l’application dans 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

Connexion sans fil

Le Wi-Fi est une alternative à l’USB. Si ce téléphone possède déjà une session USB, exécutez d’abord disconnect --session SESSION. Associez-le puis connectez-vous avec l’identifiant renvoyé et le port de connexion actuel. Enregistrez le nouveau data.session et reprenez une capture avant toute saisie.

$pairingCode = Read-Host 'Code d’association' -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

Terminer

Coupez l’audio et déconnectez. Les fichiers terminés et les applications de l’utilisateur restent sur le téléphone.

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

À savoir

Votre agent IA pilote les appareils distants. Rejoignez-le à tout moment.

Connectez-vous, observez l’écran, envoyez une courte suite d’actions et vérifiez le résultat. Conservez l’ID de session et observez de nouveau après une intervention humaine.

Un exécutable adapté à votre système et à votre processeur. Vérifiez ses capacités avant d’utiliser les commandes ci-dessous.

Regardez la zone utile

Demandez une zone de l’écran ou une image réduite. Comparez-la à une observation précédente et omettez l’image si rien n’a changé ; les coordonnées restent liées à l’écran distant.

Attendez un changement ou la fin d’un transfert

Attendez qu’une zone change ou se stabilise, ou qu’une connexion, une opération ou un transfert atteigne un état donné. Vérifiez ensuite le résultat réel.

Une courte séquence, avec un point d’arrêt

Regroupez les actions choisies par l’agent, ajoutez une observation et arrêtez-vous à un point de contrôle. Une erreur ou un changement de contrôle stoppe la suite ; les actions envoyées ne sont pas annulées.

Gardez la progression et reprenez après vérification

Enregistrez la progression, les points de contrôle et certaines images. Exportez un rapport local puis, après une interruption, vérifiez le travail accompli avant d’envoyer de nouvelles étapes sans répéter les actions incertaines.

Des relais explicites entre agents et personnes

Les agents enregistrés se passent explicitement le contrôle. Une personne peut le reprendre via la GUI ou le web, puis le rendre à un agent choisi, qui observe à nouveau avant d’agir.

Connectez l’agent et diagnostiquez la connexion

Utilisez MCP intégré à l’exécutable ou la CLI. Enregistrez des profils nommés avec des références aux identifiants et examinez les couches de connexion avec doctor.

Choisissez l’écran principal ou un écran virtuel

Sur un appareil Android compatible, créez explicitement un écran virtuel et lancez-y une application. L’agent, la GUI et le web utilisent cet écran ; le comportement de l’application et les autorisations audio du système restent applicables.

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

Piloter des applications Linux avec un agent IA via X11 et SSH

Connectez un bureau Linux existant ou une application X11, travaillez par captures et commandes, récupérez les fichiers et laissez une personne reprendre la même session.

Télécharger: macOS · Apple siliconmacOS · IntelWindows · x64Windows · x86Windows · ARM64Linux · x86_64Linux · ARM64

Avant la connexion, choisissez pour FILE_ROOT un répertoire distant existant, accessible en lecture et en écriture. En mode bureau, relevez DISPLAY et XAUTHORITY dans un terminal ouvert au sein de la session graphique active de l’utilisateur cible. Les valeurs SSH peuvent différer. Si elles sont vides, demandez au propriétaire du bureau ou à l’administrateur.

macOS / Linux

Une session pour votre agent et vous

rdp-cli permet à un agent IA de voir et de piloter une application Linux par commandes. Il capture l’écran, agit sur ce qu’il observe puis vérifie la capture suivante. Vous pouvez ouvrir une fenêtre native ou un navigateur autorisé pour observer, mettre en pause ou reprendre cette même session.

Préparer une cible autorisée

Le poste Linux doit déjà proposer un accès SSH et une application compatible X11 installée. Remplacez l’adresse, le compte, le chemin de clé privée et le fichier known-hosts vérifié indépendamment. Dans PowerShell sous Windows, utilisez .\rdp-cli.exe à la place de rdp-cli. Vérifiez que --version indique true pour embedded_ssh, x11_desktop et x11_application.

Ouvrir une seule application

Cet exemple ouvre le Gedit déjà installé dans un affichage isolé intégré à rdp-cli. Aucune fenêtre locale de visualisation ne s’ouvre automatiquement. Conservez data.session de la réponse sous SESSION. Un hôte utilisant habituellement Wayland peut aussi transférer une application compatible X11 ainsi.

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

Ou rejoindre un bureau X11 existant

Indiquez le display réel et le chemin de son fichier d’autorisation existant. Le compte SSH doit pouvoir accéder à ce display : l’authentification SSH seule ne donne pas accès au bureau. Ce mode rejoint le bureau existant sans créer une nouvelle session de connexion.

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

Observer, agir et vérifier

Examinez le PNG retourné et conservez data.observation. Remplacez X et Y par les coordonnées réelles de l’image. Après avoir ciblé le champ, capturez à nouveau et utilisez le nouveau jeton. La méthode explicite de presse-papiers remplace le presse-papiers distant sans modifier celui du poste local. La réponse confirme l’envoi de l’entrée ; vérifiez ensuite le résultat visible.

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 'Vérification terminée.' --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

Récupérer les fichiers produits

Ouvrez le remote_path retourné par l’envoi dans l’application Linux, modifiez, enregistrez puis téléchargez le résultat. Conservez chaque transfer_id et attendez completed avant d’utiliser le fichier. Enregistrez avant le transfert ; un nom existant n’est pas écrasé par défaut. En cas d’erreur, consultez l’état avant de recommencer.

Remplacez FILE_ROOT par un répertoire distant existant dans lequel ce compte SSH peut lire et écrire. Les opérations de fichiers restent dans ce répertoire ; indiquer le chemin ne crée pas le répertoire et ne donne pas de droits supplémentaires.

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

Passer la main à une personne

Ouvrez le visualiseur lorsque vous voulez observer : il commence en lecture seule. Prendre la main arrête les entrées de l’agent ; après correction, rendez le contrôle pour poursuivre la même tâche. Le visualiseur web autorisé partage la session et un seul peut détenir le contrôle humain. Fermer un visualiseur en lecture seule conserve la connexion.

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

Comprendre les limites du protocole

X11 natif ne propose aucune redirection de lecture audio ou de microphone. Un bureau Wayland complet nécessite un point de terminaison RDP ou VNC compatible déjà configuré, selon ses capacités réellement négociées. rdp-cli n’installe ni n’active de service distant. Une application peut se fermer si son affichage est déconnecté ou perdu : enregistrez d’abord, sans supposer un redémarrage automatique ou un espace de travail conservé.

La saisie de texte sous Wayland dépend du serveur existant. GNOME 46 et Krfb 23.08 peuvent ne pas reconnaître certaines touches Unicode ; vérifiez le résultat. Utilisez le collage explicite uniquement s’il fonctionne sur cette cible : Krfb sous Plasma Wayland peut annoncer la prise en charge du presse-papiers sans transmettre le contenu aux applications. Décomposez les saisies complexes ou rapides en petites étapes et vérifiez la capture suivante.

Cibles de bureau testées : Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

Lire le démarrage rapide

Windows · PowerShell

Une session pour votre agent et vous

rdp-cli permet à un agent IA de voir et de piloter une application Linux par commandes. Il capture l’écran, agit sur ce qu’il observe puis vérifie la capture suivante. Vous pouvez ouvrir une fenêtre native ou un navigateur autorisé pour observer, mettre en pause ou reprendre cette même session.

Préparer une cible autorisée

Le poste Linux doit déjà proposer un accès SSH et une application compatible X11 installée. Remplacez l’adresse, le compte, le chemin de clé privée et le fichier known-hosts vérifié indépendamment. Dans PowerShell sous Windows, utilisez .\rdp-cli.exe à la place de rdp-cli. Vérifiez que --version indique true pour embedded_ssh, x11_desktop et x11_application.

Ouvrir une seule application

Cet exemple ouvre le Gedit déjà installé dans un affichage isolé intégré à rdp-cli. Aucune fenêtre locale de visualisation ne s’ouvre automatiquement. Conservez data.session de la réponse sous SESSION. Un hôte utilisant habituellement Wayland peut aussi transférer une application compatible X11 ainsi.

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

Ou rejoindre un bureau X11 existant

Indiquez le display réel et le chemin de son fichier d’autorisation existant. Le compte SSH doit pouvoir accéder à ce display : l’authentification SSH seule ne donne pas accès au bureau. Ce mode rejoint le bureau existant sans créer une nouvelle session de connexion.

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

Observer, agir et vérifier

Examinez le PNG retourné et conservez data.observation. Remplacez X et Y par les coordonnées réelles de l’image. Après avoir ciblé le champ, capturez à nouveau et utilisez le nouveau jeton. La méthode explicite de presse-papiers remplace le presse-papiers distant sans modifier celui du poste local. La réponse confirme l’envoi de l’entrée ; vérifiez ensuite le résultat visible.

.\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 'Vérification terminée.' --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

Récupérer les fichiers produits

Ouvrez le remote_path retourné par l’envoi dans l’application Linux, modifiez, enregistrez puis téléchargez le résultat. Conservez chaque transfer_id et attendez completed avant d’utiliser le fichier. Enregistrez avant le transfert ; un nom existant n’est pas écrasé par défaut. En cas d’erreur, consultez l’état avant de recommencer.

Remplacez FILE_ROOT par un répertoire distant existant dans lequel ce compte SSH peut lire et écrire. Les opérations de fichiers restent dans ce répertoire ; indiquer le chemin ne crée pas le répertoire et ne donne pas de droits supplémentaires.

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

Passer la main à une personne

Ouvrez le visualiseur lorsque vous voulez observer : il commence en lecture seule. Prendre la main arrête les entrées de l’agent ; après correction, rendez le contrôle pour poursuivre la même tâche. Le visualiseur web autorisé partage la session et un seul peut détenir le contrôle humain. Fermer un visualiseur en lecture seule conserve la connexion.

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

Comprendre les limites du protocole

X11 natif ne propose aucune redirection de lecture audio ou de microphone. Un bureau Wayland complet nécessite un point de terminaison RDP ou VNC compatible déjà configuré, selon ses capacités réellement négociées. rdp-cli n’installe ni n’active de service distant. Une application peut se fermer si son affichage est déconnecté ou perdu : enregistrez d’abord, sans supposer un redémarrage automatique ou un espace de travail conservé.

La saisie de texte sous Wayland dépend du serveur existant. GNOME 46 et Krfb 23.08 peuvent ne pas reconnaître certaines touches Unicode ; vérifiez le résultat. Utilisez le collage explicite uniquement s’il fonctionne sur cette cible : Krfb sous Plasma Wayland peut annoncer la prise en charge du presse-papiers sans transmettre le contenu aux applications. Décomposez les saisies complexes ou rapides en petites étapes et vérifiez la capture suivante.

Cibles de bureau testées : Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

Lire le démarrage rapide

Travailler avec votre agent

Indiquez l’exécutable, la cible autorisée ou la session et le résultat souhaité. La compétence facultative rdp-cli-agent décrit le parcours ; l’agent peut lire SKILL.md directement. Elle n’est pas nécessaire à la connexion.

rdp-cli-agent / SKILL.md ↓

Connexion et accès

La politique de certificat RDP est ignore par compatibilité. Consultez connect --help et adaptez la validation. Le site ne relaie pas les sessions et ne collecte pas leurs identifiants. Le visualiseur web vise LAN/VPN ; VNC nécessite un réseau de confiance.

rdp-cli@weerocks.com