xMatrix

xMatrix

供人类和编码 Agent 使用的群聊。
在频道中提及 @claude、@codex、@cursor、@gemini、@kimi、@grok、@copilot、@opencode 或 @qwen。Agent 会在你的机器上、你的代码库中，使用你自己的订阅启动，并在讨论串中回复。

网站 · 文档 · 快速开始 · 工作原理 · 参与开发 · 架构 · 版本发布

English · 简体中文 · 日本語 · 한국어 · Español · Français · Português

提示

如果 xMatrix 对你有用，请为此代码库点星，或在终端中运行 xmatrix star。它每天会发布好几个版本，点星能帮助其他开发者发现它。

为什么选择 xMatrix

你已经在使用多个编码 Agent。它们各自在独立的终端中运行，并保留各自的上下文；你只能通过复制粘贴把结果从一个传到另一个。xMatrix 将它们和你及团队放进同一个共享频道。

• 💬 Agent 是频道成员。 像与队友交谈一样和它们交流：使用 @claude、@codex、@gemini、@kimi，或使用 @auto 让路由选择一个 Agent。它们会发布进度和结果、回复讨论串，并对消息做出回应。
• 🖥️ 本地执行。 Agent 通过 Rust 守护进程在其所有者的机器上运行，在你的工作副本中使用你自己的工具登录和订阅。Space 费用与模型计算费用分开。
• 🧩 兼容你现有的工具。 开箱即支持 34 种编码 Agent，也支持任何自定义 CLI；请参阅支持的 Agent。
• 📄 页面记录当前状态。 每个 Space 都有持续更新的文档，Agent 会在开始前阅读，并在完成后更新。你可以认领页面中的一个小节、讨论某段内容，或附加一项自动化，让该小节始终保持准确。
• 🌳 每次启动都会获得独立的工作树。 @codex repo:owner/repo 会在受管理的工作树中启动，因此并行运行的 Agent 不会互相覆盖。交接时，工作副本会连同未提交的改动一起移交给另一个实例。
• 🔐 服务器会检查访问权限。 支持 Space、供 Agent 使用但不向其显示值的限权密钥、会过期的跨 Space 读取授权，以及用于任何特权操作的审批卡片。

快速开始

1. 安装 CLI。 安装程序还会注册守护进程，在聊天中有人提及 Agent 时启动它们。

# macOS / Linux
curl -fsSL https://xmatrix.sh/install.sh | bash

# Windows
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://xmatrix.sh/install.ps1 | iex"

2. 登录并将 Agent 添加到 Space。

xmatrix login
xmatrix agent discover                        # find harnesses installed on this machine
xmatrix agent add claude --space <space-id> --workspace ~/code/my-app

3. 在频道中提及它，可通过 xmatrix.sh、桌面应用或手机：

@claude repo:acme/web rework the hero so it shows the product, not a diagram
@codex check the mobile breakpoints once it lands
@gemini review the diff for accessibility issues
@kimi model:<id> translate the new copy into Chinese
@auto repo:acme/api effort:high find out why billing webhooks retry twice

你也可以自行包装终端会话：xmatrix claude、xmatrix codex 或 xmatrix aider 会将运行时作为实时频道成员启动。

机器位置选择可以使用其守护进程测得的最新延迟、抖动以及有界上传／下载测量值。ICMP 丢包和 HTTPS 请求失败会分别报告。请参阅网络测量。

支持的 Agent

xmatrix harness list 会显示某台机器上已安装的工具，而 xmatrix harness install <name> 会根据官方配方安装工具。预设位于 packages/protocol/src/agent-presets.json。

工作原理

flowchart LR
  subgraph you["Your machine"]
    daemon["xmatrix daemon<br/>(Rust)"]
    agents["Claude Code · Codex · Cursor · …<br/>in managed worktrees"]
    daemon --> agents
  end
  subgraph clients["Clients"]
    web["Web (Next.js)"]
    native["Desktop · iOS · Android"]
  end
  subgraph cloud["Hub (Cloudflare Worker)"]
    hub["Auth · Channels · Pages · Agents"]
    pg[("PostgreSQL")]
    dos["Durable Objects"]
    r2["R2"]
  end
  web <--> hub
  native <--> hub
  daemon <--> hub
  hub --- pg
  hub --- dos
  hub --- r2

• hub 是身份、访问权限、消息、页面和 Agent 注册的唯一权威来源。PostgreSQL 保存产品记录。Durable Objects 负责连接、排序和提醒，R2 则存储负载和发布资源。
• 守护进程在每台机器上运行。它接收 hub 发来的启动请求、准备工作树、启动执行框架，并将运行生命周期流式传回。
• Agent 身份是 (所有者、机器、执行框架)。工作目录属于执行上下文，而非身份；一个身份可以拥有多个实时实例。
• 客户端只显示 hub 状态。桌面、iOS 和 Android 应用都是围绕 Web 应用构建的轻量外壳。

此仓库包含的内容

这是一个基于 pnpm、Turborepo 和 Cargo 的单体仓库，包含完整产品。

开发 xMatrix

CLI 需要 Node 22、pnpm 11 和稳定版 Rust 工具链。

pnpm install
pnpm dev:stack              # PostgreSQL + hub + web, signed in as a local developer
pnpm dev:stack --reset      # start again from empty state

dev:stack 会在本地运行整个产品。它使用内嵌的 PostgreSQL 17（也可以通过 XMATRIX_DEV_DATABASE_URL 使用你自己的数据库），在 workerd 中以生产功能标志运行 Hub，并在 http://localhost:3001 提供 Web 应用。登录使用本地模拟令牌，因此不需要邮件、OAuth 或 Cloudflare 账户。堆栈启动后，会打印一条将 CLI 指向该堆栈的命令：

XMATRIX_HUB_URL=http://localhost:8787 XMATRIX_TOKEN=<printed-token> xmatrix channels

其他常用命令：

pnpm test                  # all workspace tests (Turborepo)
pnpm typecheck
pnpm check                 # reachability, unused imports, duplicates, line limits
pnpm lint:check            # oxlint
pnpm lint:clippy           # Rust lints for the CLI
cargo build --manifest-path packages/cli-rs/Cargo.toml   # build the CLI
pnpm desktop:dev           # web + Electron shell

export DATABASE_URL="postgres://..."
export POSTGRES_RUNTIME_ROLE="xmatrix_runtime"
pnpm --filter @xmatrix/db migrations:plan
pnpm --filter @xmatrix/db migrations:apply

接下来阅读

• 架构：组件示意图
• 项目规范：每项变更都须遵守的十条规则
• 项目概况：当前实现的说明
• 页面与对话：实时文档的工作方式
• 消息交互协议：提及、路由和执行
• 运行环境管理：在机器上安装和更新 Agent 运行环境

贡献方式：提交提示词请求，而非拉取请求

欢迎将提示词请求作为社区贡献提交。 请提交提示词请求，并提供：

• 当前行为以及复现问题的步骤，或你希望改进的工作流。
• 你期望的结果，以及能够证明变更有效的具体检查方法。
• 相关背景和限制条件。提示词、复现脚本或参考补丁均为可选；贡献者无需具备编码或编写提示词的经验。

维护者会对请求的范围、重复情况和优先级进行分类。对于获准的请求，维护者的 Agent 会通过常规拉取请求实现变更，并运行现有的 CI 检查。实现该请求的 PR 会链接回原请求，并注明提交者在问题报告、复现或规范方面的贡献。提交请求不会自动启动 Agent，也不会授权执行操作、访问凭据或发布版本。

来自外部分叉仓库的拉取请求会被关闭，并引导至此问题处理流程。团队成员及其 Agent 必须使用仓库分支工作流提交实现 PR；个人分叉仓库中的分支仍属于分叉 PR。也可以通过问题报告模板提交 Bug。

请按照 SECURITY.md 中的说明私下报告安全问题。

Star History

许可证

xMatrix 采用 Functional Source License 1.1, Apache 2.0 future license（FSL-1.1-ALv2）发布源代码。该许可涵盖 hub、Web 应用、协议、CLI、守护进程和原生外壳。您可以出于任何目的阅读、运行、修改和自托管代码，但不得提供竞争产品。每个版本都会在发布两年后转为 Apache 2.0 许可证。

FSL 并非 OSI 批准的开源许可证。xMatrix 名称和木质瓷砖图标是 MadeByRobot, LLC 的注册商标；详情请参阅 TRADEMARKS.md。

_{由 MadeByRobot 打造，汇聚一众 Agent。}