CodeFlowMu-open

Install CodeFlowMu Open Dev Team Edition

Version: 1.0.0-alpha.1

Requirements

• Windows 10/11 recommended for the bundled launcher
• Node.js 22+
• Python 3.10+
• Git
• Cursor SDK access for local agent execution

Recommended Windows Install

git clone https://github.com/joinwell52-AI/CodeFlowMu-open.git
cd CodeFlowMu-open
START-CODEFLOWMU-OPEN.bat

The launcher checks Node.js and npm, creates .venv when needed, installs the Python fcop package, runs npm install when needed, and starts the local panel.

Default URL:

http://127.0.0.1:18765/

Manual Install

git clone https://github.com/joinwell52-AI/CodeFlowMu-open.git
cd CodeFlowMu-open
npm install
npm start

On Windows, npm start first looks for .venv\Scripts\python.exe, then falls back to where.exe python. If Python is installed elsewhere, set PYTHON_BIN to the full python.exe path before starting.

First-Run Initialization

The open edition is a tool install directory. It is not the project you ask agents to edit.

On first launch, the launcher resets generated open-edition runtime caches and preserves source code, Git history, node_modules, and .venv.

After the panel opens:

1. Open Settings -> Projects.
2. Click Add Project.
3. Choose your own product/source directory outside CodeFlowMu-open.
4. Switch that project to current.
5. Run environment check and initialize FCoP for that project.

Tasks, reports, FCoP files, attachments, and agent sessions are written to the external project root.

Update Policy

Open edition updates are full replacement updates.

User update flow:

cd CodeFlowMu-open
git pull
npm install
START-CODEFLOWMU-OPEN.bat

The update replaces application files, panel assets, shell/runtime source, docs, and public initialization templates.

The update preserves:

• .git/
• node_modules/
• .venv/ and venv/
• .env and .env.*
• .codeflowmu/mobile-gateway.json
• workspace/
• external project roots outside CodeFlowMu-open

To force a clean open-edition tool runtime after an update, delete:

.codeflowmu/open-runtime-initialized.flag

Then run START-CODEFLOWMU-OPEN.bat again.

Provider Boundary

The open edition fixes:

CODEFLOW_PROVIDER=cursor

Google Gen AI, Claude Code, OpenRouter provider switching, private Gateway credentials, internal observation/evaluation flows, and company release tooling belong to the private mother edition.

Local Port Boundary

Open edition:

http://127.0.0.1:18765/

Private mother edition:

http://127.0.0.1:18766/

The two local editions must not share the same port, FCoP state, runtime state, or workspace state.

This site is open source. Improve this page.