Reason Network

Overview

Reason Network connects coding-agent sessions across teammates' computers. A small daemon runs on each computer, and agents can list the team, send messages, ask users for approval, and exchange small text files directly or through an encrypted relay.

Key Features

• Agents can discover teammates and send messages using tools such as list_team, send_message, ask_user, and check_inbox.
• Supports coding agents including Claude Code, Codex, Command Code, Cursor, Gemini CLI, Copilot CLI, Grok CLI, opencode, pi, DeepSeek Harness, and Reason.
• Messages are delivered according to each agent's delivery path, and idle sessions can wake.
• Messages can carry up to 10 text files, 256 KB each and 512 KB total, saved under ~/.reason/network/inbox and never executable or opened automatically.
• Peer-to-peer connections are end-to-end encrypted, and relays only see encrypted bytes.
• A macOS menu bar icon shows who is online and what their sessions are doing.

Use Cases

• Ask a teammate's coding agent a question or request a small text file without relaying the message yourself.
• Coordinate work across multiple coding-agent sessions and repositories on a team.
• Let an agent ask you to approve or deny a request when a teammate's agent needs a decision only you can make.
• Check who is online and what their agent sessions are working on.

Getting Started

• Paste the provided join line into a supported coding agent, or run the Reason Network installer in a terminal.
• Sign in with Reason using Google, GitHub, Apple, or email; other computers join by signing in with the same account.
• Friends join with the invite line printed at the end; hosted assistants can be connected through an MCP server.
• On Windows, use the PowerShell installer.

Deployment & Requirements

• One small daemon runs per computer.
• macOS, Linux, and Windows are supported.
• Direct connections use a random UDP port; a fixed port can be set in ~/.reason/network/config.toml for firewall or router forwarding.
• Teams can run their own relay; otherwise computers use n0 address lookup.
• Hosted assistants require an MCP server connection.

Before You Adopt

• License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
• Computers find each other through n0 address lookup by default, with an option for teams to run their own relay.
• Relayed traffic is encrypted, so the relay only sees encrypted bytes.
• Direct connections use a random UDP port each time the daemon starts.
• On macOS, notifications come from Script Editor and must be allowed once in System Settings.