rdp-cli
Menú

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.

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.

Elige x64 (64 bits) o x86 (32 bits). Guarda rdp-cli.exe en una carpeta y abre PowerShell allí.

EXE firmados de un solo archivo para x64 y x86. Sin entorno de ejecución adicional.

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.

El mismo ELF estático para los sistemas x86_64 indicados. Otras versiones y arquitecturas de CPU quedan fuera de esta versión.

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.

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.

Ú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