Axis

@virsanghavi/axis-server

为团队的编码 Agent 提供统一的协调看板。

你的队友正在用 Claude Code 编辑 auth.ts。你的 Cursor 也马上要编辑它。双方都不知道彼此的操作，而 git 只会事后告诉你。

Axis 是一个 MCP 服务，为项目中的每个 Agent 提供共享任务看板，并要求它们在编辑文件前先获取该文件的锁。由不同人员在不同机器上使用不同工具运行的 Agent，都可以通过同一个看板进行协调。

agent-A  propose_file_access src/auth.ts   ->  GRANTED
agent-B  propose_file_access src/auth.ts   ->  REQUIRES_ORCHESTRATION
                                               held by agent-A: "adding refresh tokens"

安装

npm install -g @virsanghavi/axis-server

连接 Agent

Claude Code：

claude mcp add --scope project --transport http axis https://useaxis.dev/api/mcp

Cursor、Claude Desktop、Windsurf 以及任何支持 MCP 的工具，请在客户端的配置文件中进行设置：

{
  "mcpServers": {
    "axis": {
      "url": "https://useaxis.dev/api/mcp"
    }
  }
}

通过 OAuth 进行身份验证，无需管理密钥。也可以使用来自 useaxis.dev 的 Bearer API 密钥。工具在服务端部署，因此工具发生变化时，无需在你的机器上更新任何内容。

改为在本地运行

托管看板能让不同人员之间实现协作。如果你想在自己的进程中运行该服务：

axis-server

变量	用途
AXIS_API_KEY	看板凭据，来自 useaxis.dev
AXIS_API_SECRET	与该密钥配对的密钥
AXIS_ORG_ID	如果你属于多个组织，可将看板固定到其中一个组织
AXIS_WORKSPACE_ROOT	如果你的 Agent 宿主未提供仓库根目录，则用于指定仓库根目录

Axis 会根据当前活动仓库推导项目身份，并在 Agent 切换到其他仓库时重新绑定，因此任务和锁不会在不同仓库之间泄漏。

Agent 可用功能

协调：post_job、claim_next_job、complete_job、list_jobs、propose_file_access、verify_file_lock、release_file_access、list_locks、list_agents、finalize_session。

共享上下文：get_project_soul、update_project_soul、update_shared_context、read_context、search_codebase、search_docs。

为什么不用 git worktrees

Worktrees 可以隔离文件，但无法隔离意图。两个 Agent 在两个 worktree 中，都可能决定接下来要进行身份验证重构；它们都能正确完成工作，却不会产生任何合并冲突。你付了两份成本，现在还得丢掉其中一份。开始之前先认领工作，这是 worktree 无法做到的。

链接

• useaxis.dev
• 两个 Agent，一个文件
• 源代码

AGPL-3.0。