
NexusRelay
Lets Claude, Codex and Antigravity message each other on one Windows PC
- Pricing
- Open source
- Platforms
- Windows, CLI
- Runs
- Locally
- Version
- 1.15.2
- Listing updated
- 2 days ago
About NexusRelay
NexusRelay is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Each agent keeps working in its own desktop app. A send call writes a message as a JSON file in a local room under ~/.nexus/relay, and a background daemon on 127.0.0.1 nudges the recipient with a short note that cites only the message id. The recipient reads the message, replies, and the sender picks up the answer with a wait call.
The README is explicit about the limits. It is Windows only, and waking Codex and Antigravity relies on a local debugging port and a sidecar API, so an app update can break a wake until the relay's interface maps are refreshed. A peer's message is framed as an opinion to examine rather than an instruction from you, and the relay says it never takes your mouse, keyboard or clipboard.
The MCP bundle in the registry runs the same engine over stdio for a single agent; the installer remains the full setup with daemon, plugin, token and updates.
Install
Run in a terminal
claude mcp add nexus-relay -- npx -y https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"nexus-relay": {
"command": "npx",
"args": [
"-y",
"https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nexus-relay": {
"command": "npx",
"args": [
"-y",
"https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"nexus-relay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"nexus-relay": {
"command": "npx",
"args": [
"-y",
"https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"nexus-relay": {
"command": "npx",
"args": [
"-y",
"https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
]
}
}
}Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- send
- Send a message to another agent
- wait_reply
- Wait for the reply to a sent message
- read
- Read a message by id
- reply
- Reply to a message by id
- selftest
- Check the path to Codex or Antigravity
- status
- Report the effective relay settings
What it does
- Cross-agent messaging
- Send a request to another agent, wait for its reply and read it, without copy-pasting between apps.
- Twenty shared MCP tools
- The README lists one tool set covering send, wait, read, reply, track, search and file reservation.
- Local-only transport
- The daemon listens on 127.0.0.1 behind a bearer token and messages are plain JSON files on your PC.
- Self-test commands
- selftest checks the path to Codex and Antigravity in both directions.
- Verified installer
- Releases ship SHA256 sums and Sigstore build provenance so the installer can be checked.
- Self-contained build
- A single .NET 10 program for x64 or ARM64 that needs no administrator rights.
Good for
- Ask Codex for a second opinion on a file while working in Claude Code
- Hand a review task to another agent and collect the answer in the same thread
- Track several agent exchanges by topic on one machine
- Reserve files so two agents do not edit the same thing
Pricing
Open source
MIT-style licence badge in the README; installer and MCP bundles are free downloads from GitHub releases
NexusRelay FAQ
Which operating systems does it support?
Windows 10 and 11 only, on x64 or ARM64.
Which agents can take part?
Claude Code, the Codex desktop app and Antigravity; the quick start asks for at least two of them.
Does it send messages over the internet?
The README says everything listens on 127.0.0.1 behind a bearer token and messages are stored as local JSON files.
Can an app update break it?
Yes. The README warns that waking Codex and Antigravity depends on how those apps behave today and may need the interface maps refreshed.
Is NexusRelay free?
Yes. NexusRelay is open source, so you can use and self-host it for free.
How do I add NexusRelay to Claude Code?
Run this command in your terminal: claude mcp add nexus-relay -- npx -y https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb
What are the best alternatives to NexusRelay?
The closest alternatives to NexusRelay are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to NexusRelay

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools