boss/README.md

Boss

Boss 是一个面向多设备开发协作的 agent control plane。

它的目标是让用户通过对话入口或独立控制台，持续管理多台 Windows、Mac 上的编码代理，支持任务拆分、实时进度、需求变更、审批和审计。

当前状态

当前仓库已经完成第一轮产品设计文档：

• 文档总览
• 竞品对比
• 系统架构
• MVP 功能清单
• 技术选型
• 消息协议与状态机
• 实施路线图

并且已经补入首版可运行原型：

• Fastify API
• 文件持久化状态存储
• SSE 实时事件流
• Web 控制台
• boss-worker 模拟执行器
• npm run smoke 自动跑端到端验证
• Dockerfile + compose.yaml 支持容器启动

当前推荐方向

• 主控面：Web 为主，聊天入口为辅
• Manager：Codex
• 设备侧 worker：Codex CLI + Claude Code
• 工具层：MCP
• 调度：持久队列或工作流引擎

下一步

建议直接开始：

1. 建立 Web 控制台和后端骨架
2. 实现 boss-worker 注册与心跳
3. 打通会话、任务树和子任务分发
4. 接入审批和中途重规划

本地运行

npm install
npm run demo

浏览器打开：

http://127.0.0.1:43210

如果你只想单独启动服务端：

npm run dev

如果你要手工启动 worker：

npm run worker -- --name win-a --os windows --capability terminal --capability browser
npm run worker -- --name win-b --os windows --capability terminal --capability test
npm run worker -- --name mac-a --os macos --capability terminal --capability test --capability browser

一键本地 demo：

npm install
npm run demo

这会拉起：

• Web/API 服务
• 2 台 Windows 模拟 worker
• 1 台 Mac 模拟 worker

自动 smoke test：

npm run smoke

容器启动：

docker compose up --build

当前 v1 能力

• 创建项目会话并持续对话
• 自动生成任务树并调度到不同 worker
• worker 心跳、掉线回收、任务重排
• 审批、暂停、恢复、取消、重排
• SSE 实时事件流和 Web 控制台
• 一键 demo 启动