rdp-cli
Menu

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.

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.

Escolha x64 (64 bits) ou x86 (32 bits). Coloque rdp-cli.exe em uma pasta e abra o PowerShell nela.

EXEs assinados em arquivo único para x64 e x86. Não exigem runtime adicional.

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 mesmo ELF estático para os sistemas x86_64 listados. Outras versões e arquiteturas de CPU estão fora do escopo desta versão.

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.

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.

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