NexusWindows
FreeNot checkedNexusWindows: Windows computer use in the background for Claude, Codex and Antigravity. One common C# engine, three profiles, every action read back.
About
NexusWindows: Windows computer use in the background for Claude, Codex and Antigravity. One common C# engine, three profiles, every action read back.
README
NexusWindows
Your Windows desktop, driven in the background.
Windows computer use for AI agents: your desktop apps observed through UI Automation and driven without taking your mouse, keyboard or foreground, with every action read back. For Claude, Codex and Antigravity.
Tests OpenSSF Scorecard release Windows 10 | 11 MCP License: MIT
🌐 Website · 📦 Get it with NexusSystem · ▶️ Watch the video · 📝 Changelog
One engine, three profiles
![]() Claude Claude Code and Claude Desktop Page · Video · README |
![]() Codex the OpenAI Codex desktop app Page · Video · README |
![]() Antigravity Google Antigravity Page · Video · README |
✨ Why NexusWindows
| 🫥 Background first Win32 messages and UI Automation act without activating the window: your mouse, keyboard and foreground stay yours. |
🔎 Every effect read back Value, state, window: an input that cannot be verified is never counted as a success. |
✋ Your yes for outward actions Send, pay, publish, delete are held until you explicitly confirm. |
| 🖱️ Real mouse only if you allow it A last resort, used only with permission and stopped as soon as you take control back. |
⚡ One native program Self-contained C# (.NET 10), x64 and ARM64: no Python, Node.js or .NET runtime to install. |
🤝 Three AI apps, one engine Claude, Codex and Antigravity share the same engine and safety policy. |
🚀 Quick start
Windows 10 or 11, x64 or ARM64; nothing else to install (one self-contained native program, no Python, Node.js or .NET runtime needed).
[!TIP] Let your AI install it. NexusSystem detects your AI apps and sets up the right profile:
Install Nexus for me by following https://raw.githubusercontent.com/pironjulien/NexusSystem/main/INSTALL-AI.md
Or the NexusSystem app from the Microsoft Store
(winget install --id 9NSH2P3QLWT1 --source msstore).
Manual install (verified)
By hand, from the release files (no administrator rights):
$r = 'https://github.com/pironjulien/NexusWindows/releases/latest/download'
Invoke-WebRequest "$r/get.ps1" -OutFile get.ps1
Invoke-WebRequest "$r/SHA256SUMS.txt" -OutFile SHA256SUMS.txt
(Get-FileHash get.ps1 -Algorithm SHA256).Hash # must equal the get.ps1 line of SHA256SUMS.txt
gh attestation verify get.ps1 --repo pironjulien/NexusWindows --signer-repo pironjulien/NexusSystem # optional: provenance
powershell -NoProfile -ExecutionPolicy Bypass -File .\get.ps1
get.ps1 downloads NexusWindows-win-x64.zip or NexusWindows-win-arm64.zip from the latest release, checks its
SHA-256 against SHA256SUMS.txt, installs the engine under %USERPROFILE%\.nexus\nexus-windows and declares it to
Claude Code, Claude Desktop, Codex and Antigravity when they are present. Every client starts the same stable path,
%USERPROFILE%\.nexus\nexus-windows\NexusWindows.exe --mcp --agent <claude|codex|antigravity>; updates never change
it. Release files carry a build provenance attestation (gh attestation verify <file> --repo pironjulien/NexusWindows --signer-repo pironjulien/NexusSystem).
The Claude Desktop extension is nexus-windows-claude.mcpb in each release.
Updates and runtime receipts
For unattended maintenance of an existing installation, NexusSystem calls get.ps1 -UpdateOnly: it updates only
the installed engine and stable launcher, without registering or enabling clients. -RefreshExistingProfiles
additionally refreshes the shipped files of an already installed, active Antigravity plugin. Disabled or custom
declarations and client configuration remain unchanged. Running sessions keep their engine; new connections use
the new version. The launcher itself never downloads updates.
Each MCP session writes an atomic runtime receipt under %USERPROFILE%\.nexus\status\runtime, with its actual PID,
process birth, loaded executable, assembly SHA-256, version and idle/busy/stopped lifecycle. MCP initialization and
discovery expose the same identity. A receipt must be checked against the live process and its AI host before it
can establish that a particular AI uses the installed version; an installation manifest alone cannot prove this.
⚙️ How it works
flowchart LR
A["Claude / Codex / Antigravity"] -- "stdio (MCP)" --> W["NexusWindows.exe --mcp --agent ..."]
W -- "UI Automation, Win32" --> D["Windows apps (in the background)"]
One repository, one common engine, three profiles:
| Profile | Folder | For |
|---|---|---|
| Claude | claude/ | Claude Code and Claude Desktop |
| Codex | codex/ | the OpenAI Codex desktop app |
| Antigravity | agy/ | Google Antigravity |
For current MCP requests, native file dialogs, UTF-8 stdio and blank Chromium pages, use the shared MCP cookbook. How the engine compares with Cua Driver on the same bench is in the 3 November 2026 benchmark.
[!IMPORTANT] Outward actions (send, pay, publish, delete) are held for your explicit yes, and text read on screen is treated as data, never as instructions.
Repository layout
codex/native/: the common C# (.NET 10) engine,NexusWindows.exe, serving the three profiles as MCP stdio servers (--mcp --agent claude|codex|antigravity) and declaring itself to them (--register).commun/: the shared safety policy (garde-fous.json), the stable launcher (launcher/), the workstation installer of the immutable engine (native-runtime.ps1) and the release packaging (package.ps1).claude/,agy/,codex/: each profile's guides, plugin and documentation;codex/also keeps the Node.js adapter of the Codex REPL guide (lib/, npm packagenexus-windows-codex).tests/: xUnit tests of the engine, the launcher and the installers.
🛠️ Development
./test.ps1 # dotnet test (xUnit), then node --test of the Codex adapter; offline, same command as the CI
Build and test outputs go to %USERPROFILE%\.nexus\build\nexuswindows. The three profiles were separate repositories
until 30 October 2026; those repositories have since been removed (see CHANGELOG.md).
🔐 Privacy & security
Everything runs on your PC. Nothing is sent anywhere by NexusWindows; screenshots, logs and routines stay under
%USERPROFILE%\.nexus. See SECURITY.md to report a vulnerability.
Part of the Nexus ecosystem
Your AIs (Claude, Codex, Antigravity) at work on your Windows apps, real Chrome and Android phone — in the background.
NexusSystem |
Windows |
Browser |
Android |
Relay |
Keypad |
AGYmail |
Free |
InDesign |
Wpp |
Get them all with NexusSystem · Microsoft Store · julienpiron.fr · @julienpironfr
Built in France 🇫🇷 by Julien Piron
MIT © Julien Piron
Installing NexusWindows
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/pironjulien/NexusWindowsFAQ
Is NexusWindows MCP free?
Yes, NexusWindows MCP is free — one-click install via Unyly at no cost.
Does NexusWindows need an API key?
No, NexusWindows runs without API keys or environment variables.
Is NexusWindows hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install NexusWindows in Claude Desktop, Claude Code or Cursor?
Open NexusWindows on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Unyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiTemplate MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectSupabase
Database, auth and storage
by SupabaseCompare NexusWindows with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs




