
Agent skill for Claude Code, Codex and Cursor: drive a remote Windows machine over RDP on an
Agent skill for Claude Code, Codex and Cursor: drive a remote Windows machine over RDP on an isolated Xvfb display, with a VNC window the operator can watch and take over, a session that survives between agent turns, and lock-screen recovery over NLA
·
An agent skill that lets an AI coding agent drive a remote Windows machine over
RDP in a session a human can watch and take over at any moment. It is a portable
skill: install it in Claude Code, Cursor, Codex or Coddy, or drop the folder into
any agent that reads SKILL.md.
The problem it solves: agents are good at shells and APIs, and helpless in front of a GUI that only exists on someone else's desktop. Ready-made "computer use" servers either need an agent installed on the target (impossible on a locked-down corporate image) or hijack the operator's own screen. This skill takes the third path, it runs a real RDP client on an isolated virtual display and drives it with synthetic X input.
xfreerdp -> Xvfb :77 (1920x1080) -> x11vnc 127.0.0.1:5977 -> viewer window
^
XTEST: clicks and keys from the agentThe skill is distributed through the
rpa-skills catalog, a plugin
marketplace for Claude Code and Codex, and it also installs as a plain skill folder
for Cursor, Coddy and anything else that reads SKILL.md.
As a plugin. Add the catalog once, then install this skill from it:
/plugin marketplace add EvilFreelancer/rpa-skills
/plugin install rdp-agent@rpa-skillscodex plugin marketplace add EvilFreelancer/rpa-skillsIn Coddy: the rpa-skills catalog is built into Coddy as a system source,
so there is nothing to connect. One sync installs this skill together with the rest of the collection
into ~/.coddy/skills/rdp-agent/ and keeps it up to date (or press Sync all in Settings → Skills):
coddy skills syncAs a skill folder. Clone the repository and symlink it into every agent you use,
the directory name has to match the name field in SKILL.md:
git clone https://github.com/EvilFreelancer/rdp-agent.git ~/Repository/skills/rdp-agentfor d in ~/.claude/skills ~/.cursor/skills ~/.codex/skills ~/.coddy/skills; do
mkdir -p "$d" && ln -sfn ~/Repository/skills/rdp-agent "$d/rdp-agent"
doneThe per-agent plugin manifests live in .claude-plugin/, .codex-plugin/ and
.cursor-plugin/.
Dependencies on the operator's Linux box:
sudo apt install freerdp2-x11 xvfb x11-utils imagemagick python3-xlib x11vnc remminaCreate a profile with mode 600, it never goes into a repository:
install -d -m 700 ~/.config/rdp-agent && umask 177 && cat > ~/.config/rdp-agent/default.env <<'EOF'
RDP_HOST=win-host.example.com
RDP_PORT=3389
RDP_USER=user
RDP_DOMAIN=example.com
RDP_PASSWORD=change-me
RDP_DISPLAY=:77
RDP_VNC_PORT=5977
RDP_GEOMETRY=1920x1080
EOFThen just talk to the agent in plain words, "over RDP on the build machine, open the log viewer and tell me what the last error is". The skill triggers on its own description. By hand it looks like this:
python3 ~/Repository/skills/rdp-agent/scripts/rdpctl.py startpython3 ~/Repository/skills/rdp-agent/scripts/rdpctl.py shot --crop 0 1040 1920 40 --zoom 2python3 ~/Repository/skills/rdp-agent/scripts/rdpctl.py stop| Path | Role |
|---|---|
SKILL.md | The skill itself: architecture, the work loop, the command table, field notes. |
scripts/rdpctl.py | Session lifecycle and every action: start, shot, click, type, unlock, keepalive, stop. |
scripts/xctl.py | XTEST driver for one display (mouse, keyboard, capture), reused from the screenshotting-gui skill. |
scripts/xpaste.py | Serves UTF-8 text on the X clipboard for paste-based input. |
scripts/jiggle.py | One-pixel mouse jiggler against the idle lock. |
references/troubleshooting.md | Symptoms and fixes collected from real runs. |
The password lives in one file with mode 600, is handed to the client over stdin,
never appears in ps, and is redacted from the command line written to the logs.
The virtual display is started without -ac, the VNC server listens on localhost
only, and the generated viewer profile stores no credentials. Screenshots of the
remote desktop accumulate under ~/.local/state/rdp-agent/<profile>/shots/, treat
that directory as sensitive and clean it out when the work is done.
/rdp-agent in agent chat;@ context, attach the skill folder or SKILL.md to the message;description in SKILL.md, for example "look at what is open on the remote
desktop".Part of rpa-skills, Pavel Rykov's agent-skills collection (see the notes on vibe coding and cursor-vibe-prompts).
scripts/xctl.py and scripts/xpaste.py are reused from the
screenshotting-gui skill,
which is under the same license.
MIT, see LICENSE. Author: Pavel Rykov, @evilfreelancer.
This repo does not document an install step we could read. Check the README on GitHub.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/rdp-agent to learn what the "Rdp Agent" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/rdp-agent)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "rdp-agent" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.