rdp-cli

Primeiros passos com RDP pela linha de comando no Windows, Mac e Linux

Conecte uma vez, observe, aja e confira. O visualizador local é opcional.
Veja o rdp-cli em ação

De qual comando RDP você precisa?

Automatizar a área de trabalho com um agente de IA

O rdp-cli funciona no Windows, macOS e Linux. Seu agente conecta sem abrir um visualizador, lê capturas, envia cliques e teclas e transfere arquivos. Você pode entrar na mesma sessão pelo visualizador GUI ou web e assumir o controle.

Conectar passo a passo →Buscar comandos por tarefa →

Abrir uma janela de área de trabalho remota

No Windows, mstsc abre o aplicativo de Área de Trabalho Remota integrado. Substitua desktop.example.net pelo endereço do computador e entre pela janela.

mstsc /v:desktop.example.net

COMECE NO SEU COMPUTADOR

Escolha sua plataforma.
Comece sua próxima tarefa.

Escolha onde executar o rdp-cli.
Prepare as ferramentas de trabalho remoto do seu agente.

01 / INSTALAR E CONFERIR

Prepare o EXE e abra o PowerShell.

Para Windows 10 ou 11 com processador ARM, escolha ARM64. Para processadores Intel ou AMD, escolha x64 para Windows de 64 bits ou x86 para Windows de 32 bits. Baixe o arquivo rdp-cli.exe correspondente e execute-o no PowerShell.

Cada arquitetura tem seu próprio arquivo EXE único.

PowerShell
.\rdp-cli.exe --help
2. Conecte ao computador

Ative o RDP no destino. Substitua 192.0.2.20 e USER. O prompt oculto envia a senha pela entrada padrão. Guarde data.session da resposta JSON.

PowerShell
$secret = Read-Host 'Senha' -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. Observe antes de agir

Substitua SESSION pelo resultado da conexão. Abra before.png, encontre o destino e guarde data.observation da resposta da captura.

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. Aja e confira

Encontre o campo na imagem e substitua X, Y e OBSERVATION. Capture novamente após o clique e use a nova observação para digitar. Confira o resultado em 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 "Tarefa remota concluída." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. Convide alguém para observar

Abra a sessão existente quando uma pessoa quiser acompanhar. Visualizadores começam somente para leitura. Pause, assuma e devolva o controle; após troca ou reconexão, o agente precisa de nova observação.

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

Abra o DMG e ative a CLI.

Arraste rdp-cli para Aplicativos e execute estes comandos no Terminal do macOS (zsh).

Escolha o DMG para seu Mac: Apple silicon (macOS 13 ou posterior) ou Intel (macOS 12 ou posterior). Consulte a disponibilidade de cada versão na página de downloads.

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. Conecte ao computador

Ative o RDP no destino. Substitua 192.0.2.20 e USER. O prompt oculto envia a senha pela entrada padrão. Guarde data.session da resposta JSON.

zsh
read -r -s "rdp_password?Senha: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Observe antes de agir

Substitua SESSION pelo resultado da conexão. Abra before.png, encontre o destino e guarde data.observation da resposta da captura.

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. Aja e confira

Encontre o campo na imagem e substitua X, Y e OBSERVATION. Capture novamente após o clique e use a nova observação para digitar. Confira o resultado em 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 "Tarefa remota concluída." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. Convide alguém para observar

Abra a sessão existente quando uma pessoa quiser acompanhar. Visualizadores começam somente para leitura. Pause, assuma e devolva o controle; após troca ou reconexão, o agente precisa de nova observação.

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / INSTALAR E CONFERIR

Um arquivo para executar

Baixe o arquivo Linux x86_64, conceda permissão de execução e execute-o no terminal. Não é necessário acesso de administrador.

O download x86_64 atende aos sistemas Linux listados abaixo. A compatibilidade com outras versões não foi verificada.

Sistemas previstos →

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. Conecte ao computador

Ative o RDP no destino. Substitua 192.0.2.20 e USER. O prompt oculto envia a senha pela entrada padrão. Guarde data.session da resposta JSON.

Bash
IFS= read -r -s -p 'Senha: ' 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. Observe antes de agir

Substitua SESSION pelo resultado da conexão. Abra before.png, encontre o destino e guarde data.observation da resposta da captura.

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. Aja e confira

Encontre o campo na imagem e substitua X, Y e OBSERVATION. Capture novamente após o clique e use a nova observação para digitar. Confira o resultado em 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 "Tarefa remota concluída." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. Convide alguém para observar

Abra a sessão existente quando uma pessoa quiser acompanhar. Visualizadores começam somente para leitura. Pause, assuma e devolva o controle; após troca ou reconexão, o agente precisa de nova observação.

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

Um arquivo para executar

Baixe o arquivo Linux ARM64 para um sistema Linux ARM de 64 bits, conceda permissão de execução e execute-o com seu usuário normal.

Um único ELF estático ARM64 para os sistemas Linux listados, Raspberry Pi 4 e DGX Spark. Raspberry Pi OS de 32 bits não é compatível.

Sistemas previstos →

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. Conecte ao computador

Ative o RDP no destino. Substitua 192.0.2.20 e USER. O prompt oculto envia a senha pela entrada padrão. Guarde data.session da resposta JSON.

Bash
IFS= read -r -s -p 'Senha: ' 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. Observe antes de agir

Substitua SESSION pelo resultado da conexão. Abra before.png, encontre o destino e guarde data.observation da resposta da captura.

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. Aja e confira

Encontre o campo na imagem e substitua X, Y e OBSERVATION. Capture novamente após o clique e use a nova observação para digitar. Confira o resultado em 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 "Tarefa remota concluída." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. Convide alguém para observar

Abra a sessão existente quando uma pessoa quiser acompanhar. Visualizadores começam somente para leitura. Pause, assuma e devolva o controle; após troca ou reconexão, o agente precisa de nova observação.

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

Substitua o endereço e os valores de exemplo. Use session e observation das respostas reais e confira o resultado em uma nova captura.

VNC

Área de trabalho VNC

Use um servidor VNC acessível e autorizado. Substitua o host e a porta. Este exemplo usa autenticação VNC clássica sem criptografia; utilize uma LAN confiável ou VPN. Forneça a senha pela entrada padrão e encerre a entrada. Salve data.session como SESSION. No PowerShell, troque rdp-cli por .\rdp-cli.exe; no Linux, use o caminho do executável se ele não estiver no PATH.

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

Abra before.png, escolha as coordenadas reais e use data.observation da resposta como OBSERVATION. Capture novamente após cada ação para verificar o resultado. O guia VNC traz o exemplo completo e as condições do 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 ao VNC e verificar a entrada pela linha de comando →

Recursos →

Android · USB / Wi-Fi

Uma tela Android real para seu agente de IA.

Conecte um celular por USB ou Wi-Fi. Seu agente observa, toca, digita e coleta resultados por comandos, enquanto você acompanha a mesma sessão em uma janela ou navegador.

Celular Android · USB / Wi-Fi →

Downloads com suporte a Android: macOS · Apple silicon · macOS · Intel · Windows · x64 · Windows · x86 · Windows · ARM64 · Linux · x86_64 · Linux · ARM64

Observar e agir

Capture a tela real, execute toques, deslizes, arrastos e gestos com dois dedos e confira o resultado com outra captura.

Texto, arquivos e aplicativos

Cole texto Unicode explicitamente, transfira arquivos e pastas e instale, inicie ou pare aplicativos de APK único.

Compartilhar o controle

Agente, janela nativa e navegadores autorizados compartilham uma sessão persistente. Pause ou assuma o controle quando precisar.

A base de suporte é Android 12 ou posterior. O aparelho verificado é o Google Pixel 3 com Android 12; isso não significa que todos os fabricantes ou versões posteriores foram testados.

Preparar o celular

  1. Ative as opções do desenvolvedor e a depuração USB, conecte um cabo de dados e confirme a autorização no celular desbloqueado.
  2. Para Wi-Fi, ative a depuração sem fio e use o código e a porta de pareamento mostrados no celular. A porta de conexão é diferente; não é necessário cabo USB.
  3. A conexão USB no Windows precisa de um driver WinUSB adequado ao celular e à arquitetura do computador, incluindo ARM64. O rdp-cli não instala drivers nem encerra outras ferramentas de depuração. No Linux (x86_64 / ARM64), permita que seu usuário comum acesse o dispositivo USB do celular por meio da regra udev ou do grupo de dispositivos adequado e execute os comandos abaixo no Bash. Execute rdp-cli sem sudo. macOS usa a interface USB do sistema.

Substitua DEVICE_SERIAL, SESSION, OBSERVATION, PHONE_IP e as duas portas pelos valores reais. Guarde data.session de connect e use data.observation de cada captura. Substitua wifi:PHONE_GUID pelo ID wifi: retornado. Escolha um nome para PHONE_REF para salvar o pareamento neste computador. Digite o código atual de seis dígitos quando solicitado; o comando o envia pela entrada padrão.

macOS / Linux

Encontrar e conectar

Escolha explicitamente o ID detectado. Conectar não abre uma janela nem inicia o áudio.

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

Observar, agir e verificar

Veja before.png e use suas coordenadas e seu valor de observação. Confira em after.png o resultado real no aplicativo.

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 sem fio

Wi-Fi é uma alternativa ao USB. Se o celular já tem uma sessão USB, execute primeiro disconnect --session SESSION. Faça o pareamento e conecte com o ID retornado e a porta de conexão atual. Salve o novo data.session e capture a tela novamente antes de enviar entradas.

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

Encerrar

Desative o áudio e desconecte. Arquivos concluídos e aplicativos do usuário permanecem no celular.

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

Encontrar e conectar

Escolha explicitamente o ID detectado. Conectar não abre uma janela nem inicia o áudio.

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

Observar, agir e verificar

Veja before.png e use suas coordenadas e seu valor de observação. Confira em after.png o resultado real no aplicativo.

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

Wi-Fi é uma alternativa ao USB. Se o celular já tem uma sessão USB, execute primeiro disconnect --session SESSION. Faça o pareamento e conecte com o ID retornado e a porta de conexão atual. Salve o novo data.session e capture a tela novamente antes de enviar entradas.

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

Encerrar

Desative o áudio e desconecte. Arquivos concluídos e aplicativos do usuário permanecem no celular.

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

Como funciona

Seu agente de IA opera dispositivos remotos. Você pode participar a qualquer momento.

Conecte, observe a tela, envie uma sequência curta de ações e verifique o resultado. Guarde o ID da sessão e observe novamente quando uma pessoa devolver o controle.

Um executável para seu sistema e processador. Confira os recursos do arquivo baixado antes de usar os comandos abaixo.

Veja a área que importa

Peça uma região da tela ou uma imagem menor. Compare com uma observação anterior e omita a imagem se nada mudou; as coordenadas mantêm a relação com a tela remota.

Espere mudanças ou o fim de uma transferência

Aguarde uma região mudar ou estabilizar, ou uma conexão, operação ou transferência atingir o estado indicado. Confira também o resultado real antes de continuar.

Uma sequência curta, com parada para conferir

Agrupe ações escolhidas pelo agente, inclua uma nova observação e pare em um ponto de verificação. Erros ou mudanças de controle interrompem as próximas etapas; ações já enviadas não são desfeitas.

Registre o progresso e continue após conferir

Salve o progresso, pontos de verificação e imagens selecionadas. Exporte um relatório local e, após uma interrupção, confira o que terminou antes de enviar novas etapas sem repetir ações incertas.

Agentes e pessoas com passagem de controle

Agentes registrados passam o controle explicitamente. Uma pessoa pode assumir pela GUI ou pela web e devolver ao agente escolhido, que observa novamente antes de agir.

Conecte o agente e investigue a conexão

Use o MCP integrado ao executável ou a CLI. Salve perfis de conexão nomeados com referências às credenciais e examine as camadas da conexão com doctor.

Escolha a tela principal ou uma tela virtual

Em um Android compatível, crie explicitamente uma tela virtual e abra um app nela. Agente, GUI e web usam essa tela; o comportamento do app e as permissões de áudio do sistema continuam valendo.

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

Controle aplicativos Linux com um agente de IA por X11 e SSH

Conecte um desktop Linux existente ou um único aplicativo X11, trabalhe com capturas e comandos, recupere arquivos e permita que uma pessoa assuma a mesma sessão.

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

Antes de conectar, escolha um diretório remoto existente com leitura e escrita para FILE_ROOT. No modo desktop, obtenha DISPLAY e XAUTHORITY em um terminal dentro da sessão gráfica ativa do usuário de destino. Os valores da sessão SSH podem ser diferentes. Se estiverem vazios, consulte o dono da sessão ou o administrador.

macOS / Linux

Uma sessão para o agente e para você

O rdp-cli permite que um agente de IA veja e controle um aplicativo Linux por comandos. Ele captura a tela, age sobre o que observou e verifica a próxima imagem. Você pode abrir uma janela nativa ou um visualizador web autorizado para observar, pausar ou assumir a mesma sessão.

Prepare um destino autorizado

O computador Linux precisa oferecer acesso SSH e ter um aplicativo compatível com X11 já instalado. Substitua o endereço, o usuário, o caminho da chave privada e o arquivo known-hosts verificado de forma independente. No PowerShell do Windows, use .\rdp-cli.exe no lugar de rdp-cli. Confira se --version mostra true para embedded_ssh, x11_desktop e x11_application.

Abra um aplicativo

O exemplo abre o Gedit já instalado em uma tela isolada integrada ao rdp-cli. Nenhum visualizador local é aberto automaticamente. Guarde data.session da resposta e use-o como SESSION. Um host cujo desktop habitual usa Wayland também pode encaminhar um aplicativo compatível com X11 dessa 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"]'

Ou conecte um desktop X11 existente

Informe o display real e o caminho de seu arquivo de autorização existente. A conta SSH precisa ter acesso a esse display; autenticar-se por SSH não concede, por si só, acesso ao desktop. Esse modo usa o desktop existente sem criar outra sessão de login.

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

Observe, aja e verifique

Examine o PNG retornado e guarde data.observation. Troque X e Y pelas coordenadas reais da imagem. Depois de focar o campo, capture novamente e use o novo token. O método explícito de área de transferência substitui a área de transferência remota, sem alterar a local. A resposta confirma o envio da entrada; verifique o resultado na tela em seguida.

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 'Revisão concluída.' --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

Recupere os arquivos

Abra o remote_path retornado pelo envio no aplicativo Linux, edite e salve antes de baixar o resultado. Guarde cada transfer_id e espere completed para usar o arquivo. Salve antes da transferência; nomes existentes não são sobrescritos por padrão. Se houver erro, consulte o estado antes de repetir.

Substitua FILE_ROOT por um diretório remoto existente no qual esta conta SSH tenha acesso de leitura e gravação. As operações de arquivos ficam dentro desse diretório; informar o caminho não cria o diretório nem concede novas permissões.

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

Deixe uma pessoa assumir

Abra o visualizador quando quiser acompanhar. Ele começa somente para leitura. Assumir o controle interrompe a entrada do agente; após corrigir, devolva o controle para continuar a mesma tarefa. O visualizador web autorizado participa da mesma sessão, com apenas um detentor de controle humano por vez. Fechar um visualizador de leitura não encerra a conexão.

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

Entenda o alcance do protocolo

X11 nativo não oferece redirecionamento de reprodução de áudio nem de microfone. O desktop Wayland completo exige um destino RDP ou VNC compatível já configurado e usa as capacidades realmente negociadas. O rdp-cli não instala nem ativa serviços remotos. O aplicativo pode sair quando a conexão de exibição for encerrada ou perdida: salve antes e não suponha reinício automático ou um ambiente de trabalho preservado.

A entrada de texto no Wayland depende do servidor existente. O GNOME 46 e o Krfb 23.08 podem não mapear todas as teclas Unicode; confira o resultado. Use a colagem explícita pela área de transferência apenas quando funcionar nesse destino: o Krfb no Plasma Wayland pode anunciar o recurso sem entregar o conteúdo aos aplicativos. Divida entradas complexas ou rápidas em etapas menores e confira a próxima captura.

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

Continue com o início rápido

Windows · PowerShell

Uma sessão para o agente e para você

O rdp-cli permite que um agente de IA veja e controle um aplicativo Linux por comandos. Ele captura a tela, age sobre o que observou e verifica a próxima imagem. Você pode abrir uma janela nativa ou um visualizador web autorizado para observar, pausar ou assumir a mesma sessão.

Prepare um destino autorizado

O computador Linux precisa oferecer acesso SSH e ter um aplicativo compatível com X11 já instalado. Substitua o endereço, o usuário, o caminho da chave privada e o arquivo known-hosts verificado de forma independente. No PowerShell do Windows, use .\rdp-cli.exe no lugar de rdp-cli. Confira se --version mostra true para embedded_ssh, x11_desktop e x11_application.

Abra um aplicativo

O exemplo abre o Gedit já instalado em uma tela isolada integrada ao rdp-cli. Nenhum visualizador local é aberto automaticamente. Guarde data.session da resposta e use-o como SESSION. Um host cujo desktop habitual usa Wayland também pode encaminhar um aplicativo compatível com X11 dessa 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"]'

Ou conecte um desktop X11 existente

Informe o display real e o caminho de seu arquivo de autorização existente. A conta SSH precisa ter acesso a esse display; autenticar-se por SSH não concede, por si só, acesso ao desktop. Esse modo usa o desktop existente sem criar outra sessão de login.

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

Observe, aja e verifique

Examine o PNG retornado e guarde data.observation. Troque X e Y pelas coordenadas reais da imagem. Depois de focar o campo, capture novamente e use o novo token. O método explícito de área de transferência substitui a área de transferência remota, sem alterar a local. A resposta confirma o envio da entrada; verifique o resultado na tela em seguida.

.\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 'Revisão concluída.' --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

Recupere os arquivos

Abra o remote_path retornado pelo envio no aplicativo Linux, edite e salve antes de baixar o resultado. Guarde cada transfer_id e espere completed para usar o arquivo. Salve antes da transferência; nomes existentes não são sobrescritos por padrão. Se houver erro, consulte o estado antes de repetir.

Substitua FILE_ROOT por um diretório remoto existente no qual esta conta SSH tenha acesso de leitura e gravação. As operações de arquivos ficam dentro desse diretório; informar o caminho não cria o diretório nem concede novas permissões.

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

Deixe uma pessoa assumir

Abra o visualizador quando quiser acompanhar. Ele começa somente para leitura. Assumir o controle interrompe a entrada do agente; após corrigir, devolva o controle para continuar a mesma tarefa. O visualizador web autorizado participa da mesma sessão, com apenas um detentor de controle humano por vez. Fechar um visualizador de leitura não encerra a conexão.

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

Entenda o alcance do protocolo

X11 nativo não oferece redirecionamento de reprodução de áudio nem de microfone. O desktop Wayland completo exige um destino RDP ou VNC compatível já configurado e usa as capacidades realmente negociadas. O rdp-cli não instala nem ativa serviços remotos. O aplicativo pode sair quando a conexão de exibição for encerrada ou perdida: salve antes e não suponha reinício automático ou um ambiente de trabalho preservado.

A entrada de texto no Wayland depende do servidor existente. O GNOME 46 e o Krfb 23.08 podem não mapear todas as teclas Unicode; confira o resultado. Use a colagem explícita pela área de transferência apenas quando funcionar nesse destino: o Krfb no Plasma Wayland pode anunciar o recurso sem entregar o conteúdo aos aplicativos. Divida entradas complexas ou rápidas em etapas menores e confira a próxima captura.

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

Continue com o início rápido

Use com seu agente

Informe caminho do executável, destino autorizado ou sessão e resultado desejado. A habilidade opcional rdp-cli-agent documenta o fluxo; SKILL.md pode ser lido diretamente. Não é obrigatória para conectar.

rdp-cli-agent / SKILL.md ↓

Conexão e acesso

A política de certificado RDP começa em ignore por compatibilidade. Consulte connect --help e configure a validação para seu ambiente. O site não retransmite sessões nem coleta credenciais. O navegador é para LAN/VPN; VNC exige uma rede confiável.

rdp-cli@weerocks.com