Codeflow is the orchestrator for long-haul AI coding tasks. Hand it a spec, walk away, come back to a branch, a diff, and a proof of work.
┌──────────────────────────────────────┐
│ LOCAL-FIRST ████████ 100% │
│ SOURCE-TRACEABLE ████████ 100% │
│ TYPING REQUIRED ░░░░░░░░ 0% │
│ VIBES ████████ ZERO │
│ FILLER│
└──────────────────────────────────────┘
Long-running coding-agent orchestrator. Plan, run, replay, deliver.
What You Get
| Surface | What |
|---|---|
orchestrator apps | Plan it, run it, watch it, replay it. |
packages | Pluggable runners — Codex, Claude, Cline, OpenHands. |
contracts & schemas | Spec, plan, run, artifact. Every step versioned. |
design system | Calm cockpit. No flashing red. No false confidence. |
public skills | Drop into Claude/Codex/OpenClaw. Hand it a spec, get a branch. |
IMPORTANT
Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.
Install
git clone https://github.com/xiaojiou176-open/codeflow.git
cd Codeflow
# follow the per-stack quickstart in INSTALL.md or docs/
Three commands. No curl | sh. No login. Read what you run.
Install break? Open your favorite agent and say "Read AGENTS.md and bootstrap Codeflow for me." Agent fix own brain. Long version: docs/.
How It Work
The repo is seven layers — exactly the seven commits in git log. New work goes in as small named PRs. No 50-file mystery commits.
| Layer | What |
|---|---|
chore: scaffold | License, governance, hygiene gates, CI scaffolding. |
feat(core) | The primary engine. The reason Codeflow exists. |
feat(modules) | Packages, adapters, services, plugins. The second floor. |
feat(contracts) | Schemas, configs, public boundaries. Other code talks here. |
test: | Receipts. Everything in this layer must run. |
feat(ops) | Scripts, infra, CI helpers, build glue. |
docs: | Public docs surface. The pretty face. |
git log reads like a building floor plan. Look once, know the whole shape.
Ecosystem
Codeflow lives in the open family: three open platforms. local-first, source-first, builder-first.
| Repo | What |
|---|---|
| OpenCampus | Canvas + Gradescope + EdStem on one calm desk |
| Codeflow (you here) | AI codes overnight, you ship in the morning |
| OpenUIStudio | brief in, React + shadcn out, proof attached |
Cross-family taste: BeamMe · BrewMe · Codeflow · proofyard.
Star This Repo
If Codeflow saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐
Also by Yifeng[Terry] Yu
- OpenCampus — Canvas + Gradescope + EdStem on one calm desk
- OpenUIStudio — brief in, React + shadcn out, proof attached
- BeamMe — beam your agent config to any planet
- BrewMe — wake up, news already brewed
- proofyard — every claim ships with its receipt
License
MIT — small print, big freedom.