码流 CodeFlowMu：把 AI Agent 组织成一个本地开发团队。
CodeFlowMu turns local AI agents into a coordinated development team.
中文 · 完整中文介绍 · English · Install · Getting Started
CodeFlowMu Open Dev Team Edition 是公开开源版本，面向本地安装、体验、二次开发和贡献。
当前开源版本：V1.0.0-open
它不是母体私有仓库的完整镜像，也不是用来开发 CodeFlowMu 自身的目录。它是一个确定的 FCoP 团队开发应用工具：安装在本地，用 PM / DEV / OPS / QA / EVAL 五个 Agent 协同开发你的项目。
- 固定团队：
PM / DEV / OPS / QA / EVAL - 固定接入：
Cursor SDK only - 默认本地运行：
http://127.0.0.1:18765/ - 单实例安装：每台电脑当前只支持一个标准安装，Windows 默认
D:\CodeFlowMu-open - 默认关闭私有 Gateway 自动连接
- 受保护工具根：
CodeFlowMu-open自身不能作为任务开发目标 - 保留 Git 状态、任务、报告、审批、聊天、项目配置、数据导出和任务模板
- 不包含母体真实运行记录、私有日志、私有 Gateway 凭据、内部评估/观察流和公司私有发布能力
如果你见过旧的 joinwell52-AI/codehouse / CodeFlow 仓库，可以把它理解成上一代产品叙事与实验现场。CodeFlowMu Open 是新的公开入口：保留“指令成流、文件协作、多 Agent 团队”的核心思想，但以干净的公开发行包、固定开发团队、可重复初始化和可贡献的源码结构重新组织。
把需求、任务、代码、报告和验收放进同一个本地协作面板里，让 PM、DEV、OPS、QA 四个 Agent 以文件协议协同工作。
flowchart LR
Human["Human / 你"] --> PM["PM<br/>拆解需求 / 验收调度"]
PM --> DEV["DEV<br/>代码实现"]
PM --> OPS["OPS<br/>运行环境 / 打包发布"]
PM --> QA["QA<br/>测试验证"]
DEV --> Report["REPORT<br/>交付证据"]
OPS --> Report
QA --> Report
Report --> PM
PM --> Git["Git 状态 / 公开贡献"]
Windows 推荐：
START-CODEFLOWMU-OPEN.bat手动方式：
git clone https://github.com/joinwell52-AI/CodeFlowMu-open.git
cd CodeFlowMu-open
npm install
npm start打开：
http://127.0.0.1:18765/
首次启动会进入干净初始化状态：清理公开版运行缓存，保留源码、Git 历史、node_modules 和 .venv。
启动后请先在「设置 → 项目」添加你的产品/代码目录，并切换为当前项目。任务、报告、FCoP 初始化、附件和 Agent 会话都会写入这个外部项目根；公开版不会更新自己的 CodeFlowMu-open 源码目录。
公开仓库面向下载、安装、介绍和贡献。一个全新发版会由母版构建为完整开源版本包，包含源码、面板、Shell、公开文档、公开初始化源、启动器、VERSION.json、RELEASES.md 和 UPDATE.md。
更新策略采用全量更新：应用文件整体替换，保留 .git/、node_modules/、.venv/、本机 .env、.codeflowmu/mobile-gateway.json、workspace/ 和外部项目根。
用户侧更新：
cd CodeFlowMu-open
git pull
npm install
START-CODEFLOWMU-OPEN.bat
| 模块 | 开源版状态 |
|---|---|
| PC Panel | 可用 |
| Mobile PWA | 本地局域网体验 |
| PM / DEV / OPS / QA / EVAL | 固定开发团队 |
| 外部项目根 | 必须添加后再开发 |
| CodeFlowMu-open 自身 | 工具根，受保护，不作为任务目标 |
| Git 状态 | 可用 |
| 技能库 | 公开 manifest 与 playbook |
| Gateway | 默认关闭，仅官方演示 / 受限使用 |
| Provider | Cursor SDK only |
| EVAL / 内部观察流 | 母体能力，公开版默认隐藏 |
公开包带有可公开初始化源：
adoptedSource/fcop/
adoptedSource/pending/
docs/skills/
docs/open/
不会带入：
adoptedSource/gateway/
private/
.env
真实任务、报告、日志、聊天历史
私有母体仓库：
joinwell52-AI/codeflowmu
公开开源仓库：
joinwell52-AI/CodeFlowMu-open
母体负责版本选择、构建、同步、清理运行态和发布；公开仓库负责下载、安装、介绍、体验和贡献入口。
GitHub 仓库 About / topics 建议见 docs/open/github-repo-about.md。
CodeFlowMu Open Dev Team Edition is the public open-source edition for local installation, hands-on evaluation, development, and contribution.
Current open edition version: V1.0.0-open
It is not a full mirror of the private mother repository, and it is not meant to develop CodeFlowMu itself. It is a fixed FCoP team-development application: install it locally, then use PM / DEV / OPS / QA / EVAL agents to collaborate on your own project.
- Fixed team:
PM / DEV / OPS / QA / EVAL - Fixed provider:
Cursor SDK only - Local default:
http://127.0.0.1:18765/ - Single install: one standard CodeFlowMu Open install per computer; Windows default is
D:\CodeFlowMu-open - Private Gateway auto-connect is disabled by default
- Protected tool root:
CodeFlowMu-openitself is not a development target - Git status, tasks, reports, approvals, chat, project settings, data export, and task templates are available
- Private runtime history, private logs, Gateway credentials, internal observation/evaluation flows, and company release tooling are excluded
If you have seen the old joinwell52-AI/codehouse / CodeFlow repository, treat it as the previous product narrative and experiment ground. CodeFlowMu Open is the new public entry point: the same core idea of command flow, file-based collaboration, and multi-agent teams, reorganized as a clean public distribution with a fixed dev team, repeatable first-run initialization, and a contribution-ready source layout.
CodeFlowMu gives local AI agents a shared collaboration surface: requirements become tasks, tasks produce reports, reports carry evidence, and PM/DEV/OPS/QA/EVAL can move work through a visible workflow.
Recommended on Windows:
START-CODEFLOWMU-OPEN.batManual:
git clone https://github.com/joinwell52-AI/CodeFlowMu-open.git
cd CodeFlowMu-open
npm install
npm startOpen:
http://127.0.0.1:18765/
The first launch initializes a clean open-edition runtime state. It removes generated public runtime caches while keeping source files, Git history, node_modules, and .venv.
After startup, open Settings -> Projects, add your product/source directory, and switch to it. Tasks, reports, FCoP initialization, attachments, and agent sessions are written to that external project root. The open edition does not update its own CodeFlowMu-open source directory.
The public repository is for download, installation, introduction, and contribution. Each fresh release is built by the mother repository as a complete open-edition package with source, panel assets, Shell, public docs, public initialization sources, launcher, VERSION.json, RELEASES.md, and UPDATE.md.
Updates use a full replacement strategy: application files are replaced as a whole, while .git/, node_modules/, .venv/, local .env, .codeflowmu/mobile-gateway.json, workspace/, and external project roots are preserved.
User update flow:
cd CodeFlowMu-open
git pull
npm install
START-CODEFLOWMU-OPEN.bat| Area | Open Edition |
|---|---|
| PC Panel | Available |
| Mobile PWA | Local LAN experience |
| PM / DEV / OPS / QA / EVAL | Fixed team |
| External project root | Required before project development |
| CodeFlowMu-open itself | Protected tool root, not a task target |
| Git Status | Available |
| Skills | Public manifest and playbooks |
| Gateway | Disabled by default, official demo / limited use only |
| Provider | Cursor SDK only |
| EVAL / internal observation | Private mother-edition capability, hidden by default |
Included:
adoptedSource/fcop/
adoptedSource/pending/
docs/skills/
docs/open/
Excluded:
adoptedSource/gateway/
private/
.env
real tasks, reports, logs, and chat history
Good first contribution areas:
- Windows/macOS/Linux install flow
- Local four-agent workflow
- Git status and project configuration UX
- Public docs, templates, and examples
- Panel usability and local runtime stability
See also: