Command Palette

Search for a command to run...

UnylyUnyly
Browse all

NexusWindows

FreeNot checked

NexusWindows: Windows computer use in the background for Claude, Codex and Antigravity. One common C# engine, three profiles, every action read back.

GitHubEmbed

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

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

▶ Watch the NexusWindows video (subtitled)
▶ Click to watch the video · more on julienpiron.fr

One engine, three profiles

▶ Watch the Claude profile video
Claude
Claude Code and Claude Desktop
Page · Video · README
▶ Watch the Codex profile video
Codex
the OpenAI Codex desktop app
Page · Video · README
▶ Watch the Antigravity profile video
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 package nexus-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

from github.com/pironjulien/NexusWindows

Installing NexusWindows

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/pironjulien/NexusWindows

FAQ

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

Compare NexusWindows with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs