reason-machines/reason-network

Reason Network – 快速概览

它是什么

• 一个轻量级的点对点守护进程，让不同开发者机器上的 AI 编码助手（Claude Code、Codex、Cursor、Gemini CLI、Copilot CLI、Grok CLI、DeepSeek Harness 等）直接相互通信。
• 无需中央服务器；机器通过 iroh 网状网络在本地网络或互联网上连接，并可回退到可选的中继。

主要功能

功能	作用
团队视图	每个参与者的姓名、计算机、当前仓库/分支以及忙碌-空闲状态对整个团队可见。
即时消息	代理可以向特定队友的代理发送消息（reason-network send alice/api-claude "…"）或向所有人广播。
询问用户流程	当代理需要人工批准时，它会在所有者的机器上弹出对话框（ask_user）。响应作为所有者的答案返回，而不是作为通用消息。
通知	可选弹出窗口（--notify）在接收者的屏幕上显示提示。
菜单栏状态	macOS 显示一个图标，指示谁在线以及他们在做什么。
零维护	作为后台服务运行，通过 Reason CLI 或其自己的发布安装程序自动更新。
跨平台	提供 macOS、Linux 和 Windows 的二进制文件；通过单个 curl/PowerShell 命令安装。

工作原理

• 每台计算机运行一个小型守护进程（reason-network）。
• 对等方直接相互发现（同一 Wi-Fi）或通过 iroh（加密网状网络）。如果直接路由失败，流量可以通过 iroh 公司运行的服务器（或自托管中继）进行中继。
• 状态（团队名册、会话标题、收件箱）存储在本地 ~/.reason/network 下。
• 代理向守护进程暴露四个工具：list_team、send_message、ask_user 和 check_inbox。守护进程不推送消息；代理在运行时从收件箱拉取。

开始使用

# 安装守护进程（macOS/Linux）
curl -fsSL https://github.com/reason-machines/reason-network/releases/latest/download/install.sh | sh
# Windows（PowerShell）
irm https://github.com/reason-machines/reason-network/releases/latest/download/install.ps1 | iex

• 您可以通过一次性链接加入现有团队，或创建新团队（reason-network init "my-team" --as <name>）。
• 基本命令：
  • reason-network who – 列出队友及其当前会话。
  • reason-network send alice/api-claude "question?" – 向特定代理发送消息。
  • reason-network listen --as terminal – 作为简单的基于终端的代理进行回复。

为什么重要

• 实现协作式 AI 编码：开发者可以要求队友的 Claude Code 实例运行查询、获取结果或获得人工批准，而无需离开自己的 IDE。
• 保持所有通信加密且点对点，减少对纯云编排的依赖。
• 通过通用的“MCP 服务器”接口，与各种现有的 AI 驱动编码工具兼容。

开发状态

• 用 Rust 编写（守护进程），使用 Python 进行端到端测试。
• 在 MIT/Apache-2.0 下开源；欢迎贡献。
• 源自早期的 tincan 项目；CLI 现在使用 reason network，同时保持向后兼容。

---

所有细节均直接取自仓库的 README。