Just tell the PM what you need, go grab a coffee, and come back to review the results.
你只需要跟 PM 说清楚要做什么，然后去喝杯咖啡，回来验收成果。
We published the methodology — How to Build an Automated AI Development Team in Cursor — and then built the tool to make it real.
我们先发布了方法论 — 如何在 Cursor 中搭建 AI 自动化开发团队 — 然后把它做成了产品。
CodeFlow (码流) is the production-ready tool born from that methodology. It turns the "filename as protocol" concept into a complete human-AI collaboration system: mobile command center + PC execution engine + multi-agent coordination.
码流（CodeFlow） 就是这套方法论的产品化落地。它把"文件名即协议"的理念变成了完整的人机协作系统：手机主控台 + PC 执行机 + 多角色自动调度。
| OCR (legacy) | CDP — CodeFlow | |
|---|---|---|
| Latency 延迟 | 300–800ms | 10–15ms |
| Accuracy 精度 | ~90% | 100% |
| Agent Detection 角色识别 | Screenshot guess | DOM exact match |
| Setup 配置 | Manual shortcut edits | Zero — auto-injected |
| Fallback 降级 | None | Auto-falls back to OCR |
Zero-config CDP injection: CodeFlow detects on startup whether Cursor has the debug port open. If not, it silently restarts Cursor with
--remote-debugging-port=5253— no manual shortcut edits, no config files, nothing.零配置 CDP 注入：Desktop 启动时自动检测 Cursor 是否开启调试端口，若未开启则静默重启并自动注入参数，用户无需手动改快捷方式或任何配置文件。
| Methodology 方法论 | Product 产品 | |
|---|---|---|
| Repo | joinwell52 | codeflow-pwa |
| What | How to name agents, define roles, route tasks via filenames | Desktop EXE + PWA + Relay + MCP Plugin |
| Core idea | TASK-date-seq-Sender-to-Recipient.md |
Same protocol, automated end-to-end |
| Roles | PM / DEV / QA / OPS | 3 team templates (dev / media / mvp) |
| Human role | Tell PM what to do | Phone sends task, PC executes |
Desktop Panel / 桌面端控制面板
Cursor IDE — AI Agents at Work / AI Agent 工作中
PWA Mobile / 手机端
Desktop — download EXE (~35MB) and double-click:
- China: https://gitee.com/joinwell52/cursor-ai/releases
- GitHub: https://github.com/joinwell52-AI/codeflow-pwa/releases
PWA — open on phone and add to home screen:
For full documentation, see English | 中文.
Want to build from source or contribute? See CONTRIBUTING.md.
# Desktop (Python 3.12, Windows)
cd codeflow-desktop
pip install pyautogui pyperclip pywin32 websockets winocr Pillow watchdog psutil
python main.py
# PWA (no build step)
python -m http.server 8080 -d web/pwaProject structure:
codeflow-desktop/ # Desktop app (Python → EXE)
codeflow-plugin/ # Cursor MCP plugin
web/pwa/ # PWA (HTML/JS, no framework)
docs/ # Bilingual documentation
server/relay/ # WebSocket relay
- FCoP — File-based Coordination Protocol — the distilled protocol spec and essays behind CodeFlow's
.cursor/rules/design / CodeFlow.cursor/rules/背后的协议规范与随笔集 - When AI organizes its own work — a 4-AI-role team delivering 87 person-days in 17 days / 4 个 AI 角色在 17 天交付 87 人日
- An unexplainable thing I saw: the agent didn't just comply with rules — it endorsed them — an agent spontaneously wrote itself 4 FCoP memos on an unrelated task. 中文 · CSDN · Dev.to · Cursor Forum
MIT License. © 2026 joinwell52-AI
- Methodology: joinwell52-ai.github.io/joinwell52
- Product: github.com/joinwell52-AI/codeflow-pwa
- Changelog: CHANGELOG.md