Agor

正如 Figma 之于设计，Agor 致力于成为 AI 编程助手的协同平台。 在多玩家共享的画布上编排 Claude Code、Codex 和 Gemini 会话。管理 Git worktrees（工作树），追踪 AI 对话，并实时可视化团队的智能体工作流。

简而言之： Agor 是一个多玩家空间画布，你可以在其中协调多个 AI 编程助手并行处理任务，支持 GitHub 链接的 worktrees、自动化工作流区域以及隔离的测试环境——所有这一切均可同时运行。

📖 阅读完整文档请访问 agor.live →

功能展示

(此处为原 README 图片占位)

→ 在 YouTube 上观看无脚本演示 (13 分钟)

✨ 承诺 ✨ ⭐️ 我承诺 Agor 每获得一个 Star，我就修复一个 GitHub Issue :)

安装指南

系统要求

Node.js 20.x
Zellij ≥ 0.40 (必须安装，否则守护进程将无法启动)

安装 Zellij:

# Ubuntu/Debian
curl -L https://github.com/zellij-org/zellij/releases/latest/download/zellij-x86_64-unknown-linux-musl.tar.gz | sudo tar -xz -C /usr/local/bin

# macOS
brew install zellij

# RHEL/CentOS
curl -L https://github.com/zellij-org/zellij/releases/latest/download/zellij-x86_64-unknown-linux-musl.tar.gz | sudo tar -xz -C /usr/local/bin

安装 Agor

npm install -g agor-live

注意： Agor 需要 Zellij 来实现持久化的终端会话。如果未安装 Zellij，守护进程启动时会报错并给出提示。

快速开始

# 1. 初始化 (创建 ~/.agor/ 目录和数据库)
agor init

# 2. 启动守护进程
agor daemon start

# 3. 打开 UI 界面
agor open

在 Codespaces 中尝试：

核心功能

🧩 智能体集群控制 (Agent Swarm Control)

同时运行尽可能多的 Claude Code、Codex 和 Gemini 会话。
Agor 中的智能体可以通过内部的 Agor MCP 服务进行协调和监督。
内置 调度器 (scheduler)，可按你的节奏触发模板化提示词。

🌐 多玩家空间画布

类 Figma 的布局，将你的 AI 编程会话组织在看板（完整的 2D 画布）中。
范围/空间评论 + 钉在看板、区域或 worktrees 上的反馈（Figma 风格）。
基于 WebSocket 的光标广播和头像展示，实时显示团队成员动态。

🌲 会话树 — 分叉、衍生、协同

分叉会话：在不丢失原始路径的情况下探索替代方案。
衍生子会话：针对特定子任务进行深入处理，并向父任务反馈。
在“会话树”中可视化会话谱系。

⚙️ 区域触发器 — 空间化的工作流

在画布上定义 区域 (zones)，当 worktrees 拖入时触发模板化提示词。
构建 看板式流程 或自定义管道：分析 → 开发 → 代码审查 → 部署。
GitHub 原生工作流：将 worktrees 链接到 Issues/PRs，自动将上下文注入到提示词中。
- 模板语法："深入分析此 GitHub issue: {{ worktree.issue_url }}"
- 每个 worktree 对应特定 Issue/PR 的隔离分支。
- AI 智能体会自动读取关联的 Issue/PR 上下文。

🌳 隔离的开发环境

痛点： 同时处理 3 个 PR？每个 PR 都需要不同的端口、依赖项和数据库状态。

Agor 的解决方案：

每个 worktree 都拥有自己 隔离的环境，并自动管理唯一端口。
使用模板配置启动/停止命令：PORT={{ add 9000 worktree.unique_id }} docker compose up -d
团队中的任何人都可以 一键启动/停止 任何 worktree 的环境。
多个 AI 智能体并行工作，互不干扰。
健康监控系统会实时跟踪服务是否运行正常。

从此告别： “关掉你的本地服务器，我要测试我的分支了”。

🕹️ AI 团队实时战略 (RTS)

像玩多人即时战略游戏一样协调智能体工作。
实时观看队友或智能体在任务间的移动。
聚合会话、委派任务、调整方向并共同迭代。

📱 移动端友好的提示词交互

随时随地推进会话 — 移动端优化的 UI，用于发送提示词和监控进度。
在手机上访问对话、发送后续指令并查看智能体状态。
完整的对话视图，支持通过汉堡菜单在不同会话间切换。

使用场景：并行 PR 工作流

你的团队目前有 3 个 Bug 修复任务和 2 个新功能开发。使用 Agor：

创建 5 个 worktrees，每个都链接到其 GitHub Issue/PR。
为每个 worktree 衍生 AI 会话 (Claude, Codex, Gemini)。
拖入区域 (zones) → 处理工作。

preset-io/agor