rdp-cli

Primeros pasos con RDP por línea de comandos en Windows, Mac y Linux

Conecta una vez, observa, actúa y verifica. El visor local es opcional.
Mira cómo funciona rdp-cli

¿Qué comando RDP necesitas?

Automatizar el escritorio con un agente de IA

rdp-cli funciona en Windows, macOS y Linux. Tu agente se conecta sin abrir un visor, lee capturas, envía clics y pulsaciones y transfiere archivos. Puedes unirte a la misma sesión mediante el visor GUI o web y tomar el control.

Conectar paso a paso →Buscar comandos por tarea →

Abrir una ventana de escritorio remoto

En Windows, mstsc abre la aplicación de Escritorio remoto integrada. Sustituye desktop.example.net por la dirección de tu equipo e inicia sesión en la ventana.

mstsc /v:desktop.example.net

EMPIEZA EN TU EQUIPO

Elige tu plataforma.
Empieza tu próxima tarea.

Elige dónde ejecutar rdp-cli.
Prepara las herramientas de trabajo remoto de tu agente.

01 / INSTALAR Y COMPROBAR

Prepara el EXE y abre PowerShell.

Para Windows 10 u 11 con procesador ARM, elige ARM64. Para procesadores Intel o AMD, elige x64 si Windows es de 64 bits o x86 si es de 32 bits. Descarga el archivo rdp-cli.exe correspondiente y ejecútalo en PowerShell.

Cada arquitectura tiene su propio archivo EXE único.

PowerShell
.\rdp-cli.exe --help
2. Conecta al escritorio

Activa RDP en el destino. Sustituye 192.0.2.20 y USER. La solicitud oculta envía la contraseña por la entrada estándar. Guarda data.session de la respuesta JSON.

PowerShell
$secret = Read-Host 'Contraseña' -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. Observa antes de actuar

Sustituye SESSION por el resultado de conexión. Abre before.png, localiza la aplicación y guarda data.observation de la respuesta de captura.

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. Actúa y verifica

Localiza el campo en la imagen y sustituye X, Y y OBSERVATION. Captura de nuevo tras el clic y usa la nueva observación para escribir. Comprueba el resultado en 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 "Tarea remota completada." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. Invita a una persona a observar

Abre la sesión existente solo cuando alguien quiera verla. Los visores empiezan en modo de solo lectura. Pausa, toma el control y devuélvelo desde el visor; tras un traspaso o reconexión se requiere una observación nueva.

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / INSTALAR Y COMPROBAR

Abre el DMG y activa la CLI.

Arrastra rdp-cli a Aplicaciones y ejecuta estos comandos en Terminal de macOS (zsh).

Elige el DMG para tu Mac: Apple silicon (macOS 13 o posterior) o Intel (macOS 12 o posterior). Consulta la disponibilidad de cada versión en la página de descargas.

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. Conecta al escritorio

Activa RDP en el destino. Sustituye 192.0.2.20 y USER. La solicitud oculta envía la contraseña por la entrada estándar. Guarda data.session de la respuesta JSON.

zsh
read -r -s "rdp_password?Contraseña: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Observa antes de actuar

Sustituye SESSION por el resultado de conexión. Abre before.png, localiza la aplicación y guarda data.observation de la respuesta de captura.

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. Actúa y verifica

Localiza el campo en la imagen y sustituye X, Y y OBSERVATION. Captura de nuevo tras el clic y usa la nueva observación para escribir. Comprueba el resultado en 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 "Tarea remota completada." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. Invita a una persona a observar

Abre la sesión existente solo cuando alguien quiera verla. Los visores empiezan en modo de solo lectura. Pausa, toma el control y devuélvelo desde el visor; tras un traspaso o reconexión se requiere una observación nueva.

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / INSTALAR Y COMPROBAR

Un archivo para empezar

Descarga el archivo Linux x86_64, dale permiso de ejecución y ejecútalo en la terminal. No necesitas permisos de administrador.

La descarga x86_64 funciona en los sistemas Linux indicados abajo. No se ha verificado la compatibilidad con otras versiones.

Sistemas previstos →

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. Conecta al escritorio

Activa RDP en el destino. Sustituye 192.0.2.20 y USER. La solicitud oculta envía la contraseña por la entrada estándar. Guarda data.session de la respuesta JSON.

Bash
IFS= read -r -s -p 'Contraseña: ' 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. Observa antes de actuar

Sustituye SESSION por el resultado de conexión. Abre before.png, localiza la aplicación y guarda data.observation de la respuesta de captura.

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. Actúa y verifica

Localiza el campo en la imagen y sustituye X, Y y OBSERVATION. Captura de nuevo tras el clic y usa la nueva observación para escribir. Comprueba el resultado en 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 "Tarea remota completada." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. Invita a una persona a observar

Abre la sesión existente solo cuando alguien quiera verla. Los visores empiezan en modo de solo lectura. Pausa, toma el control y devuélvelo desde el visor; tras un traspaso o reconexión se requiere una observación nueva.

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / INSTALAR Y COMPROBAR

Un archivo para empezar

Descarga el archivo Linux ARM64 para un sistema Linux ARM de 64 bits, dale permiso de ejecución y ejecútalo con tu usuario habitual.

Un mismo ELF estático ARM64 para los sistemas Linux indicados, Raspberry Pi 4 y DGX Spark. Raspberry Pi OS de 32 bits no es compatible.

Sistemas previstos →

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. Conecta al escritorio

Activa RDP en el destino. Sustituye 192.0.2.20 y USER. La solicitud oculta envía la contraseña por la entrada estándar. Guarda data.session de la respuesta JSON.

Bash
IFS= read -r -s -p 'Contraseña: ' 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. Observa antes de actuar

Sustituye SESSION por el resultado de conexión. Abre before.png, localiza la aplicación y guarda data.observation de la respuesta de captura.

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. Actúa y verifica

Localiza el campo en la imagen y sustituye X, Y y OBSERVATION. Captura de nuevo tras el clic y usa la nueva observación para escribir. Comprueba el resultado en 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 "Tarea remota completada." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. Invita a una persona a observar

Abre la sesión existente solo cuando alguien quiera verla. Los visores empiezan en modo de solo lectura. Pausa, toma el control y devuélvelo desde el visor; tras un traspaso o reconexión se requiere una observación nueva.

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

Sustituye la dirección y los valores de ejemplo. Usa session y observation de las respuestas reales y comprueba el resultado con una nueva captura.

VNC

Escritorio VNC

Usa un servidor VNC accesible y autorizado. Sustituye el host y el puerto. Este ejemplo utiliza autenticación VNC clásica, sin cifrado: úsalo en una LAN de confianza o una VPN. Introduce la contraseña por la entrada estándar y finaliza la entrada. Guarda data.session como SESSION. En PowerShell sustituye rdp-cli por .\rdp-cli.exe; en Linux, usa la ruta del ejecutable si no está en PATH.

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

Abre before.png, elige las coordenadas reales y usa data.observation de la respuesta como OBSERVATION. Captura de nuevo después de cada acción para comprobar el resultado. La guía VNC incluye el ejemplo completo y las condiciones del servidor.

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
Conectar a VNC y comprobar la entrada desde la línea de comandos →

Funciones →

Android · USB / Wi-Fi

Una pantalla Android real para tu agente de IA.

Conecta un teléfono por USB o Wi-Fi. Tu agente observa, toca, escribe y recupera resultados con comandos, mientras tú sigues la misma sesión en una ventana o navegador.

Teléfono Android · USB / Wi-Fi →

Descargas compatibles con Android: macOS · Apple silicon · macOS · Intel · Windows · x64 · Windows · x86 · Windows · ARM64 · Linux · x86_64 · Linux · ARM64

Observar y actuar

Captura la pantalla real, realiza toques, deslizamientos, arrastres y gestos con dos dedos, y comprueba el resultado con otra captura.

Texto, archivos y aplicaciones

Pega texto Unicode de forma explícita, transfiere archivos y carpetas e instala, inicia o detén aplicaciones de un solo APK.

Compartir el control

El agente, la ventana nativa y los navegadores autorizados comparten una sesión persistente. Pausa o toma el control cuando lo necesites.

La base de compatibilidad es Android 12 o posterior. El dispositivo verificado es un Google Pixel 3 con Android 12; no implica haber probado todos los fabricantes o versiones posteriores.

Preparar el teléfono

  1. Activa las opciones de desarrollador y la depuración USB, conecta un cable de datos y acepta la autorización con el teléfono desbloqueado.
  2. Para Wi-Fi, activa la depuración inalámbrica y usa el código y el puerto de emparejamiento del teléfono. El puerto de conexión es distinto; no hace falta cable USB.
  3. La conexión USB en Windows necesita un controlador WinUSB adecuado para el teléfono y la arquitectura del equipo, incluida ARM64. rdp-cli no instala controladores ni cierra otras herramientas de depuración. En Linux (x86_64 / ARM64), permite que tu usuario habitual acceda al dispositivo USB del teléfono mediante la regla udev o el grupo de dispositivos adecuado y ejecuta los siguientes comandos en Bash. Ejecuta rdp-cli sin sudo. macOS utiliza la interfaz USB del sistema.

Sustituye DEVICE_SERIAL, SESSION, OBSERVATION, PHONE_IP y ambos puertos por valores reales. Guarda data.session de connect y usa data.observation de cada captura. Sustituye wifi:PHONE_GUID por el ID wifi: devuelto. Elige un nombre para PHONE_REF para guardar el emparejamiento en este ordenador. Introduce el código actual de seis dígitos cuando se solicite; el comando lo envía por la entrada estándar.

macOS / Linux

Detectar y conectar

Selecciona explícitamente el ID del dispositivo detectado. La conexión no abre una ventana ni activa el audio.

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

Observar, actuar y verificar

Mira before.png y utiliza sus coordenadas y valor de observación. Comprueba after.png para verificar el resultado de la aplicación.

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

Conectar por Wi-Fi

Wi-Fi es una alternativa a USB. Si el teléfono ya tiene una sesión USB, ejecuta primero disconnect --session SESSION. Empareja y conecta con el ID devuelto y el puerto de conexión actual. Guarda el nuevo data.session y captura otra imagen antes de enviar entradas.

printf '%s' 'Código de emparejamiento: '
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

Finalizar

Desactiva el audio y desconecta. Los archivos terminados y las aplicaciones del usuario permanecen en el teléfono.

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

Detectar y conectar

Selecciona explícitamente el ID del dispositivo detectado. La conexión no abre una ventana ni activa el audio.

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

Observar, actuar y verificar

Mira before.png y utiliza sus coordenadas y valor de observación. Comprueba after.png para verificar el resultado de la aplicación.

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

Conectar por Wi-Fi

Wi-Fi es una alternativa a USB. Si el teléfono ya tiene una sesión USB, ejecuta primero disconnect --session SESSION. Empareja y conecta con el ID devuelto y el puerto de conexión actual. Guarda el nuevo data.session y captura otra imagen antes de enviar entradas.

$pairingCode = Read-Host 'Código de emparejamiento' -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

Finalizar

Desactiva el audio y desconecta. Los archivos terminados y las aplicaciones del usuario permanecen en el teléfono.

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

Alcance

Tu agente de IA opera dispositivos remotos. Tú puedes unirte cuando quieras.

Conecta, observa la pantalla, envía una secuencia breve y verifica el resultado. Guarda el ID de sesión y vuelve a observar cuando una persona devuelva el control.

Un ejecutable para tu sistema y procesador. Comprueba sus capacidades antes de usar los comandos siguientes.

Mira la zona que importa

Solicita una región o una imagen más pequeña. Compárala con una observación anterior y omite la imagen si nada cambió; las coordenadas conservan su relación con la pantalla remota.

Espera cambios o transferencias completas

Espera a que una región cambie o se estabilice, o a que una conexión, operación o transferencia alcance el estado indicado. Verifica también el resultado real.

Envía una secuencia breve y detente para revisar

Agrupa acciones decididas por tu agente, añade una observación y para en un punto de control. Un error o cambio de control detiene los pasos posteriores; las acciones enviadas no se deshacen.

Conserva el progreso y continúa tras comprobarlo

Guarda progreso, puntos de control e imágenes seleccionadas. Exporta un informe local y, tras una interrupción, comprueba lo terminado antes de enviar nuevos pasos sin repetir acciones inciertas.

Varios agentes, con turnos claros

Los agentes registrados se ceden el control explícitamente. Una persona puede tomarlo desde la GUI o la web y devolverlo al agente elegido, que vuelve a observar antes de actuar.

Conecta tu agente y diagnostica problemas

Usa MCP integrado en el ejecutable o la CLI. Guarda perfiles con referencias a credenciales y utiliza doctor para comprobar las distintas capas de conexión.

Elige la pantalla principal o una virtual

En un Android compatible, crea explícitamente una pantalla virtual e inicia una app allí. El agente, la GUI y la web usan esa pantalla; siguen aplicándose el comportamiento de la app y los permisos de audio del sistema.

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

Controla aplicaciones Linux con un agente de IA mediante X11 y SSH

Conecta un escritorio Linux existente o una sola aplicación X11, trabaja con capturas y comandos de entrada, recupera archivos y permite que una persona tome el control de la misma sesión.

Descargar: macOS · Apple siliconmacOS · IntelWindows · x64Windows · x86Windows · ARM64Linux · x86_64Linux · ARM64

Antes de conectar, selecciona un directorio remoto existente con permiso de lectura y escritura para FILE_ROOT. En modo escritorio, consulta DISPLAY y XAUTHORITY desde un terminal de la sesión gráfica activa del usuario. Pueden ser distintos en SSH. Si están vacíos, consulta al propietario del escritorio o al administrador.

macOS / Linux

Una sesión para el agente y para ti

rdp-cli permite que un agente de IA vea y maneje una aplicación Linux mediante comandos. El agente captura la pantalla, actúa sobre lo observado y comprueba la siguiente imagen. Puedes abrir una ventana nativa o un visor web autorizado para observar, pausar o controlar esa misma sesión.

Prepara un destino autorizado

El equipo Linux debe ofrecer acceso SSH y tener instalada una aplicación compatible con X11. Sustituye la dirección, el usuario, la ruta de la clave privada y el archivo known-hosts verificado por separado. En PowerShell de Windows, usa .\rdp-cli.exe en lugar de rdp-cli. Comprueba que --version indique true para embedded_ssh, x11_desktop y x11_application.

Abre una sola aplicación

El ejemplo abre el Gedit ya instalado en una pantalla aislada integrada en rdp-cli. No abre un visor local automáticamente. Guarda data.session de la respuesta y úsalo como SESSION. Un equipo cuyo escritorio habitual sea Wayland también puede reenviar una aplicación compatible con X11 de esta forma.

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

O conecta un escritorio X11 existente

Indica el display real y la ruta de su archivo de autorización existente. La cuenta SSH necesita permiso para acceder a ese display: autenticarse por SSH no concede por sí solo acceso al escritorio. Este modo conecta el escritorio existente y no crea otra sesión de inicio de sesión.

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

Observa, actúa y verifica

Revisa el PNG devuelto y guarda data.observation. Sustituye X e Y por las coordenadas reales de la imagen. Tras enfocar el campo, captura de nuevo y usa el nuevo token. El método explícito de portapapeles sustituye el portapapeles remoto, sin cambiar el local. La respuesta confirma el envío de la entrada; comprueba después el resultado 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 'Revisión completada.' --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

Recupera los archivos

Abre el remote_path devuelto por la subida en la aplicación Linux, edita y guarda, y descarga el resultado. Conserva cada transfer_id y espera a completed antes de usar el archivo. Guarda antes de transferir; los nombres existentes no se sobrescriben por defecto. Si falla, consulta el estado antes de repetir la transferencia.

Sustituye FILE_ROOT por un directorio remoto existente en el que esta cuenta SSH pueda leer y escribir. Las operaciones de archivos quedan dentro de ese directorio; indicar la ruta no crea el directorio ni concede permisos adicionales.

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

Permite que una persona intervenga

Abre el visor cuando quieras observar: al principio es de solo lectura. Tomar el control detiene la entrada del agente; tras corregir, devuelve el control para continuar la misma tarea. El visor web autorizado comparte la sesión y solo un visor puede tener el control humano. Cerrar un visor de solo lectura conserva la conexión.

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

Conoce el alcance del protocolo

X11 nativo no ofrece redirección de reproducción ni de micrófono. Un escritorio Wayland completo necesita un destino RDP o VNC compatible ya configurado y utiliza las funciones realmente negociadas. rdp-cli no instala ni activa servicios remotos. La aplicación puede cerrarse al desconectar o perder la pantalla: guarda primero y no presupongas reinicio automático ni un espacio de trabajo conservado.

La entrada de texto en Wayland depende del servidor existente. GNOME 46 y Krfb 23.08 pueden no convertir todas las teclas Unicode; comprueba el resultado. Usa el pegado explícito del portapapeles solo cuando funcione en ese destino: Krfb sobre Plasma Wayland puede anunciar esta función sin entregar el contenido a las aplicaciones. Divide las entradas complejas o rápidas en pasos pequeños y revisa la siguiente captura.

Destinos de escritorio probados: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

Continúa con el inicio rápido

Windows · PowerShell

Una sesión para el agente y para ti

rdp-cli permite que un agente de IA vea y maneje una aplicación Linux mediante comandos. El agente captura la pantalla, actúa sobre lo observado y comprueba la siguiente imagen. Puedes abrir una ventana nativa o un visor web autorizado para observar, pausar o controlar esa misma sesión.

Prepara un destino autorizado

El equipo Linux debe ofrecer acceso SSH y tener instalada una aplicación compatible con X11. Sustituye la dirección, el usuario, la ruta de la clave privada y el archivo known-hosts verificado por separado. En PowerShell de Windows, usa .\rdp-cli.exe en lugar de rdp-cli. Comprueba que --version indique true para embedded_ssh, x11_desktop y x11_application.

Abre una sola aplicación

El ejemplo abre el Gedit ya instalado en una pantalla aislada integrada en rdp-cli. No abre un visor local automáticamente. Guarda data.session de la respuesta y úsalo como SESSION. Un equipo cuyo escritorio habitual sea Wayland también puede reenviar una aplicación compatible con X11 de esta forma.

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

O conecta un escritorio X11 existente

Indica el display real y la ruta de su archivo de autorización existente. La cuenta SSH necesita permiso para acceder a ese display: autenticarse por SSH no concede por sí solo acceso al escritorio. Este modo conecta el escritorio existente y no crea otra sesión de inicio de sesión.

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

Observa, actúa y verifica

Revisa el PNG devuelto y guarda data.observation. Sustituye X e Y por las coordenadas reales de la imagen. Tras enfocar el campo, captura de nuevo y usa el nuevo token. El método explícito de portapapeles sustituye el portapapeles remoto, sin cambiar el local. La respuesta confirma el envío de la entrada; comprueba después el resultado 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 'Revisión completada.' --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

Recupera los archivos

Abre el remote_path devuelto por la subida en la aplicación Linux, edita y guarda, y descarga el resultado. Conserva cada transfer_id y espera a completed antes de usar el archivo. Guarda antes de transferir; los nombres existentes no se sobrescriben por defecto. Si falla, consulta el estado antes de repetir la transferencia.

Sustituye FILE_ROOT por un directorio remoto existente en el que esta cuenta SSH pueda leer y escribir. Las operaciones de archivos quedan dentro de ese directorio; indicar la ruta no crea el directorio ni concede permisos adicionales.

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

Permite que una persona intervenga

Abre el visor cuando quieras observar: al principio es de solo lectura. Tomar el control detiene la entrada del agente; tras corregir, devuelve el control para continuar la misma tarea. El visor web autorizado comparte la sesión y solo un visor puede tener el control humano. Cerrar un visor de solo lectura conserva la conexión.

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

Conoce el alcance del protocolo

X11 nativo no ofrece redirección de reproducción ni de micrófono. Un escritorio Wayland completo necesita un destino RDP o VNC compatible ya configurado y utiliza las funciones realmente negociadas. rdp-cli no instala ni activa servicios remotos. La aplicación puede cerrarse al desconectar o perder la pantalla: guarda primero y no presupongas reinicio automático ni un espacio de trabajo conservado.

La entrada de texto en Wayland depende del servidor existente. GNOME 46 y Krfb 23.08 pueden no convertir todas las teclas Unicode; comprueba el resultado. Usa el pegado explícito del portapapeles solo cuando funcione en ese destino: Krfb sobre Plasma Wayland puede anunciar esta función sin entregar el contenido a las aplicaciones. Divide las entradas complejas o rápidas en pasos pequeños y revisa la siguiente captura.

Destinos de escritorio probados: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

Continúa con el inicio rápido

Úsalo con tu agente

Proporciona la ruta del ejecutable, el destino autorizado o la sesión y el resultado deseado. La habilidad opcional rdp-cli-agent documenta el flujo; el agente puede leer SKILL.md directamente. No es necesaria para conectar.

rdp-cli-agent / SKILL.md ↓

Conexión y acceso

La política de certificado RDP es ignore por compatibilidad. Consulta connect --help y configura la validación para tu entorno. La web no retransmite sesiones ni recoge credenciales. El visor web es para LAN/VPN; VNC requiere una red de confianza.

rdp-cli@weerocks.com