Codex ──┐
Cursor ─┤─ MCP (record_task / update_progress / log_node)
Claude ─┼──────────────────────────►  mcp_server.py  ─►  SQLite
OpenCode┘                                                  │
                                                      ┌─────▼─────┐
                                                   FastAPI + SSE │
                                                      ┌──────────┴────────┐
                                                      │  网页看板          │
                                                      │  localhost:8777   │
                                                      └───────────────────┘

从现在起，请在每个会话中自动通过 ai-progress-monitor MCP 上报你的任务进度，
无需我每次提醒。规则如下：
1. 会话开始、或接手一个长任务时：调用 record_task
   （task_id=你所属工作台名-短序号，agent=你所属工作台名，name=任务名，stage=starting）
2. 推进到新阶段或进度变化时：调用 update_progress（progress=0-100，stage=coding/testing/deploying 等）
3. 到达重要节点时：调用 log_node（node_type=step 或 milestone，message=简短中文描述）
4. 任务完成：调用 log_node（node_type=success）；失败：调用 log_node（node_type=failed）
   注：milestone / success / fail 会自动触发系统通知并更新任务状态。
判断标准：不要等我要求才上报，做了实质工作就自动上报。
若 MCP 工具暂时不可用，静默跳过，不要阻塞主任务。

uv venv .venv
uv pip install "mcp[cli]" fastmcp fastapi uvicorn

python -m venv .venv
source .venv/bin/activate
pip install "mcp[cli]" fastmcp fastapi uvicorn

cd ai-progress-monitor
.venv/bin/python server/dashboard.py

.venv/bin/python scripts/setup_agents.py     # 探测并配置所有已安装工作台
.venv/bin/python scripts/setup_agents.py --report   # 只查看安装/配置状态
.venv/bin/python scripts/setup_agents.py --codex --cursor --claude  # 只配指定的工作台

cp scripts/com.mxppxm.ai-progress-monitor.plist ~/Library/LaunchAgents/
launchctl load -w ~/Library/LaunchAgents/com.mxppxm.ai-progress-monitor.plist

server/
  db.py            SQLite 数据层
  mcp_server.py    MCP stdio 上报服务
  dashboard.py     FastAPI 看板后端 + SSE
  notify.py        macOS 系统通知
dashboard/
  index.html      看板页面
  styles.css
  app.js          实时逻辑（SSE + 兜底轮询）
client-configs/   Codex/Cursor/Claude/OpenCode 接入说明
scripts/
  setup_agents.py           一键自动配置各工作台 MCP
  run_dashboard.sh          看板启动辅助脚本
  com.mxppxm...plist        macOS launchd 自启配置模板
  sse_live_test.py          SSE 实时推送端到端验证脚本
data/             SQLite 数据库（自动生成）