AI 编码 CLI 工作台 — 在一块看板上编排 Claude Code、Codex 等 AI 编码 CLI，
让多个项目的开发任务排队、并行、可插手、可复盘。
Bosun 是一个本地优先的 Web 工作台：扫描并集中管理本机的多个代码项目，把开发任务派发给 Claude Code、Codex、Oh My Pi、Kimi Code 等 AI 编码 CLI 的可交互终端会话，由调度器控制并发与优先级，你只在关键决策时介入。
Warning
Bosun 可以驱动本机终端并访问已导入的代码仓库。服务默认监听 0.0.0.0，首次启动后请立即在「设置 → 访问控制」中设置强口令，或通过 BOSUN_PASSWORD 配置。请勿在未配置访问控制和 HTTPS 反向代理的情况下暴露到公网。
- 多项目看板 — 扫描本机目录批量导入仓库，项目泳道集中管理所有任务
- 多引擎编排 — 在 Claude Code / Codex / Oh My Pi / Kimi Code 间自由选择，创建、排队、接续任务，支持按订阅额度自动选引擎
- 自动调度 — 优先级 + 并发上限驱动的任务队列，拖拽改优先级
- 实时终端 — 浏览器里看 AI 干活的完整终端，随时打字插手、接管会话
- 人在环诊断 — 整体分析生成问题收件箱，一键转修复任务，关键决策保留人工确认
- 数据统计 — 跨项目的任务趋势、引擎用量与复盘数据
- 随处可用 — 手机 PWA + 可选的 macOS 菜单栏常驻应用，二进制发行版开箱即用
交互终端
等待用户介入
手机 PWA
| 任务操作 | 终端详情 |
|---|---|
以上截图使用完全虚构的项目、路径、任务、终端输出和系统指标，不包含真实用户数据。
下列执行引擎 至少安装并登录一个（哪个都行，没有必选项），命令位于 PATH 中；未安装的引擎不会出现在界面里：
| 引擎 | 命令 | 安装方式 | 说明 |
|---|---|---|---|
| Claude Code | claude |
npm i -g @anthropic-ai/claude-code |
支持订阅额度查询，参与自动选引擎 |
| Codex CLI | codex |
npm i -g @openai/codex |
支持订阅额度查询，参与自动选引擎 |
| Oh My Pi | omp |
npm i -g @oh-my-pi/pi-coding-agent |
自带 provider 凭据；依赖 Bun 运行时，安装体积约 1.1 GB；不做订阅额度查询 |
| Kimi Code CLI | kimi |
npm i -g @moonshot-ai/kimi-code 或官方 install.sh |
自带 provider 凭据；不做订阅额度查询。注意 npm 上裸 kimi-cli 是不相干的占名包，旧一代 PyPI 版已淘汰，只适配新版 kimi-code |
从 Releases 下载对应平台的产物：
| 平台 | 产物 | 安装 |
|---|---|---|
| macOS（Apple Silicon / Intel） | Bosun-*-macos-arm64.dmg / …-x86_64.dmg |
按芯片选对应 DMG，拖入「应用程序」，菜单栏出现「>~」图标即可用 |
| Linux（x86_64） | bosun-*-linux-x86_64.tar.gz |
解压后 ./bosun/bosun，浏览器访问 http://127.0.0.1:8770 |
| Windows（x86_64，beta） | bosun-*-windows-x86_64.zip |
解压后运行 bosun\bosun.exe，浏览器访问 http://127.0.0.1:8770 |
macOS 产物未做 Apple 公证，首次打开被 Gatekeeper 拦截时执行：
xattr -cr /Applications/Bosun.app
macOS / Linux 二进制版同样支持「设置 → Bosun 版本」在线更新（整包替换）；Windows 版暂需手动下载新版替换。Windows 属 beta：等待/接管的识别启发式在 ConPTY 下仍在打磨，源码运行方式暂只支持 macOS / Linux（start.sh 依赖 bash）。
需要 Python 3.10+、Node.js 18+ 与 Git：
git clone https://github.com/thsrite/bosun.git
cd bosun
python3 -m venv backend/.venv
backend/.venv/bin/pip install -r backend/requirements.txt
cd frontend && npm install && cd ..
./start.sh # 开发模式：后端 + Vite dev server（前端热更新）
./start.sh --prod # 生产模式：先构建前端产物，只起后端托管 dist开发模式会清理占用 8770 / 5199 的旧进程并启动前后端，前端监听 0.0.0.0:5199，同一局域网设备可通过脚本输出的地址访问，Ctrl+C 同时停止前后端。生产模式只占用 8770，由后端托管 frontend/dist，手机/PWA 直接访问后端端口，不再热重载。
分步手动启动
# 后端
cd backend
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python run.py # 监听 0.0.0.0:8770
# 前端（开发）
cd frontend
npm install
npm run dev # 打开 http://localhost:5199
# 前端（生产，随后端一起服务）
cd frontend && npm run build # 产物在 frontend/dist，之后访问 8770 即完整应用cd frontend && npm run build # 生产模式需要先有 frontend/dist
./macos/build.sh --install # 构建 Bosun.app 并安装到 /Applications菜单栏出现品牌「>~」图标即成功：满色 = 运行中，半透明 = 已停止。菜单提供打开工作台、启动/重启/停止后端、查看日志，以及两个开关。
菜单栏应用细节（自启 / 资源占用 / 卸载）
启动时打开工作台（默认开启）：打开 Bosun.app 后会等后端健康检查通过（最多等 20 秒，避免白屏），再自动拉起已安装的 PWA「Bosun 工作台」，省掉手动点一次。找不到 PWA 时退回默认浏览器打开 http://127.0.0.1:8770。不需要可在菜单里关掉。
菜单顶部实时显示运行中的任务数，以及后端与图标进程各自的内存和 CPU 占用。采样走 proc_pid_rusage 系统调用而非 ps，不派生子进程；任务数由 /api/health 提供，该字段只回给 127.0.0.1，不会经局域网泄露（该端点免鉴权，而后端默认监听 0.0.0.0）。
开机自启默认关闭：装好后打开 Bosun.app 才会拉起后端，重启电脑不会自动运行。需要的话在菜单里勾选「开机自启」，下次登录起生效。
后端由 launchd（com.thsrite.bosun.backend）持有而非图标进程持有，因此退出图标不会中断在途任务；崩溃会被自动拉起，并有 10 秒节流防止重启风暴。若 8770 已被手工运行的 start.sh 占用，图标会识别并跳过接管，不会抢端口。
只依赖 Xcode Command Line Tools，无需完整 Xcode。日志在 ~/Library/Logs/bosun.{out,err}.log。
完全卸载：
launchctl bootout gui/$(id -u)/com.thsrite.bosun.backend 2>/dev/null
rm -f ~/Library/LaunchAgents/com.thsrite.bosun.*.plist
pkill -x Bosun; rm -rf /Applications/Bosun.app- 右上「+ 项目 / 扫描」→ 填一个根目录扫描导入，或手动加单个仓库
- 项目泳道里「+ 任务」→ 选 cc/codex/omp/kimi + 写指令 + 优先级 → 自动进调度
- 点任务卡「终端」→ 右侧实时终端，可打字插手
- 拖拽任务卡改优先级；顶栏调并发上限
- 「整体分析」→ 问题收件箱 → 勾「→ 修复任务」转成修复任务（人在环）
- 「统计」看任务趋势 / 引擎用量 / 问题态势
选用 omp 时，「设置 → Oh My Pi」可以填模型与思考档位；选用 kimi 时，「设置 → Kimi Code」可以选模型别名（列表来自 ~/.kimi-code/config.toml）。设置页按引擎分卡：已安装的引擎卡头显示版本，未安装的显示灰态占位卡（含安装命令），全部支持的 CLI 与本机安装状态一目了然。
| 环境变量 | 默认值 | 用途 |
|---|---|---|
BOSUN_DATA |
~/.bosun |
SQLite 数据库与运行日志目录 |
BOSUN_HOST |
0.0.0.0 |
后端监听地址 |
BOSUN_PORT |
8770 |
后端端口 |
BOSUN_PASSWORD |
未设置 | 访问口令；设置后会覆盖设置页中保存的口令 |
BOSUN_BACKEND_PORT |
8770 |
start.sh 使用的后端端口 |
BOSUN_FRONTEND_PORT |
5199 |
start.sh 开发模式使用的前端端口 |
BOSUN_CLAUDE_BIN |
自动探测 claude |
Claude Code 可执行文件路径 |
BOSUN_CODEX_BIN |
自动探测 codex |
Codex CLI 可执行文件路径 |
BOSUN_OMP_BIN |
自动探测 omp |
Oh My Pi 可执行文件路径 |
BOSUN_KIMI_BIN |
自动探测 kimi |
Kimi Code CLI 可执行文件路径 |
默认数据保存在 ~/.bosun/。升级或迁移前，建议先备份该目录。
「设置 → Bosun 版本」可以对比本地版本与 GitHub 上最新的 release，并一键更新。
二进制部署：下载当前平台的最新产物后整包原子替换安装目录，重启后端即生效（macOS 菜单栏图标程序在下次启动 Bosun.app 时更新）。
源码部署：
git fetch --tags后快进合并到该 release 的 tag（不做 merge，也不会 reset）- 按本次变更的文件决定是否重装后端依赖、前端依赖、重建
frontend/dist - 由 Bosun.app 托管的后端会自动重启；
start.sh启动的后端需要自己重启
以下情况会拒绝更新，交由你自己处理，不会覆盖本地内容：
- 工作区有未提交改动
- 本地存在该 release 之外的提交（无法快进）
- 当前部署不是 git 工作区（例如直接下载的源码包）
发版时需要同步更新 backend/app/version.py 的 VERSION、frontend/package.json 的 version，并打上同名 tag（vX.Y.Z）；三者不一致会导致版本比对失真。
- Bosun 会继承本机 Claude Code / Codex / Oh My Pi / Kimi Code 的登录状态和文件访问能力，请只导入可信仓库。
- Oh My Pi 启动时会自动读取
~/.claude下的配置，包括已配置的 MCP server 和 skills；不希望它接触这些资源时，不要选用该引擎。 - 未设置访问口令时，任何能访问服务的人都可能操作任务和终端；局域网环境也不应视为安全边界。
- 若需跨设备访问，至少启用强口令；若需公网访问，请额外使用 HTTPS、可信反向代理和网络访问控制。
- 不要把 API Key、访问令牌、数据库或
~/.bosun/中的运行数据提交到 Git。
backend/ FastAPI 后端、调度器、终端会话与 SQLite 数据层
frontend/ React + TypeScript + Vite 前端
macos/ macOS 菜单栏应用及构建脚本
packaging/ PyInstaller 打包定义（二进制发行）
bosun_skills/ 随项目提供的 Bosun agent skills
docs/ 设计文档与功能规格
开发与验证：
backend/.venv/bin/python -m compileall -q backend/app # 后端语法检查
cd frontend && npm run build # 前端类型检查与生产构建提交改动前，请至少运行与改动范围对应的检查和前端构建。
欢迎提交 Issue 和 Pull Request。请在 PR 中说明改动目的、验证命令与结果；行为变更和缺陷修复应同时提供对应测试。安全问题请不要公开披露利用细节，先通过仓库维护者的私密联系方式报告。
Bosun 采用 GNU General Public License v3.0（GPL-3.0-only）开源。你可以使用、修改和分发本项目；分发本项目或其衍生作品时，需要遵守 GPL v3 的源代码开放及同许可证分发要求。