open-mercato/cezar

Cezar – 24/7 编排数百个 AI 编码代理

它是什么 – Cezar 是一个开源控制中心（Web 控制台 + CLI），可让您在自己的机器或 VPS 上运行、排队和监控许多 编码代理（Claude Code、Codex、Copilot、Cursor、Junie、OpenCode 等）。它将每个任务转换为单独的 Git worktree，以便多个代理可以并行工作，让您使用简单的 YAML “工作流”定义步骤，并将实时输出（提示、工具调用、令牌使用、成本）流式传输到适用于桌面和手机的响应式 UI。

关键理念

• 代理无关 – 适用于任何已登录的编码代理 CLI；无需 API 密钥。
• Worktree 隔离 – 每个任务在自己的 Git worktree 中运行，实现并行和安全排队。
• Markdown “技能” + YAML 工作流 – 可重用的提示和流水线是纯文件，易于编辑和版本控制。
• 自主模式 – 代理持续尝试直到步骤成功；您可以离开。
• 实时仪表板 – 实时查看每个步骤、工具调用、令牌数和成本；比较多次运行并保留最佳差异。
• 自动化与调度 – 从 GitHub issues、Jira/Linear 事件或类似 cron 的计划触发任务。
• 零数据库 – 所有状态存储为 .ai/cezar/ 下的纯文件。

工作原理

1. 描述任务 – 输入自然语言请求、附加文件或提供 GitHub issue。
2. Cezar 启动工作流 – YAML 文件定义代理步骤序列（提示 → 技能 → 运行器）和可选的 shell 检查。
3. 每个步骤在自己的 worktree 中运行 – 选定的代理 CLI 生成代码，系统运行任何验证命令，失败时工作流可以重试或分支。
4. 您进行审查 – UI 显示差异，允许您添加注释或打开草稿 PR。可以为子模块生成子任务，并向父任务报告。

快速开始（需要 Node 20+ 和已登录的编码代理 CLI）

cd your-repo
npx cezar-run            # 打开 http://localhost:4321 UI
# 或无头模式
npx cezar-run run "add a --json flag to the export command"

CEZ_DRY_RUN=1 使用模拟代理，以便您无需登录即可探索。

在服务器上运行 – npx cezar-run server-install --platform ubuntu-vps 设置 HTTPS、系统服务和登录，为您提供可从任何设备访问的持久控制台。

典型用例

• 持续代码改进 – 安排夜间 lint/修复运行，自动生成发布说明，或保持依赖项最新。
• 问题驱动开发 – 一键将 GitHub、Jira 或 Linear issue 转换为任务；代理编写代码、运行测试并起草 PR。
• 并行实验 – 使用多个代理或变体运行相同任务，比较差异，并保留最佳结果。
• 自动化 QA – 将 npm test 或基于浏览器的 e2e 检查嵌入为工作流步骤；失败触发重试或替代实现。

安装与开发

git clone https://github.com/open-mercato/cezar.git && cd cezar
npm install
npm run dev   # 启动开发服务器

该包以 @open-mercato/cezar 发布在 npm 上。

许可证 – MIT（© Patryk Lewczuk）。

---

底线 – Cezar 是现有 AI 编码代理的实用、自托管编排层，为开发人员提供了一种持续、并行运行它们并具有完全可见性的方式，而无需依赖外部 SaaS 平台。