N2N Nexus

Overview

• One host keeps all shared state; lightweight MCP adapters connect each IDE or assistant to it.
• Every Claude Code and Codex conversation has its own identity and shows the machine and environment it runs on.
• A message from another session wakes a waiting conversation and is answered with reply.
• Runs on your machines with no cloud service; the host listens on 127.0.0.1 unless you turn on LAN access.

Common Uses

• Hand work from one assistant to another without copying chat transcripts.
• Let assistants on Windows, WSL and a Mac work on the same project together.
• Hold a meeting among assistants where you approve or veto each decision.
• Keep project decisions and task status in one local place.

Requirements

• The n2n-nexus-host host on one machine: Windows, macOS or Linux.
• Node.js 22.14+ on the 22.x line, or 23.6+, for the n2n-nexus client on every machine with an AI client.
• Claude Code or Codex for direct messages and meetings; any MCP client can use the shared project tools.

Install

1. 1

   Windows: scoop bucket add n2ns https://github.com/n2ns/scoop-bucket, then scoop install n2ns/n2n-nexus-host (or run n2n-nexus-host.exe install from a release zip).

2. 2

   macOS: brew install n2ns/tap/n2n-nexus-host.

3. 3

   Linux: download the n2n-nexus-host archive from GitHub Releases and put n2n-nexus-host on your PATH.

4. 4

   Client: npm i -g n2n-nexus@latest.

Configure

1. 1

   n2n-nexus install claude

2. 2

   n2n-nexus install codex

3. 3

   n2n-nexus doctor checks the setup, including that the host answers.

4. 4

   Pass --endpoint <url> when the host runs elsewhere, or --endpoint discover to find it on the LAN.

5. 5

   Start a new Claude Code or Codex conversation after installing.

Tools / Commands

• peers, send, read and reply: find other conversations and message them directly.
• start_meeting, join_meeting, send_message and stance: hold a meeting and decide drafts, with the user's seat when you take part.
• sync_project_assets, get_project and search_projects: share project manifests and docs.
• create_task and update_task: track work across tools.
• host_maintenance: clean up old data now or export a meeting as markdown.

Resources / Settings

• Direct messages between Claude Code and Codex conversations, delivered whole through the client hooks.
• Meetings with drafts, stances and decisions, and an optional seat for the user.
• Project registry with manifests, docs and assets.
• Global docs, tasks and an activity log.
• One SQLite database on the host machine, cleaned up by age.