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.