Content
<p align="center">
<img src="https://em-content.zobj.net/source/apple/391/headphone_1f3a7.png" width="120" alt="headphone" />
</p>
<h1 align="center">Codeflow</h1>
<p align="center">
<strong>AI codes overnight, you ship in the morning</strong>
</p>
<p align="center">
<a href="https://github.com/xiaojiou176-open/codeflow/stargazers"><img src="https://img.shields.io/github/stars/xiaojiou176-open/codeflow?style=flat&color=yellow" alt="Stars"></a>
<a href="https://github.com/xiaojiou176-open/codeflow/commits/main"><img src="https://img.shields.io/github/last-commit/xiaojiou176-open/codeflow?style=flat" alt="Last Commit"></a>
<a href="LICENSE"><img src="https://img.shields.io/github/license/xiaojiou176-open/codeflow?style=flat" alt="License"></a>
</p>
<p align="center">
<a href="#what-you-get">What You Get</a> •
<a href="#install">Install</a> •
<a href="#how-it-work">How It Work</a> •
<a href="#ecosystem">Ecosystem</a>
</p>
---
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
```bash
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/`](./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**](https://github.com/xiaojiou176-open/OpenCampus) | Canvas + Gradescope + EdStem on one calm desk |
| [**Codeflow**](https://github.com/xiaojiou176-open/codeflow) *(you here)* | AI codes overnight, you ship in the morning |
| [**OpenUIStudio**](https://github.com/xiaojiou176-open/OpenUIStudio) | brief in, React + shadcn out, proof attached |
Cross-family taste:
[**BeamMe**](https://github.com/xiaojiou176-open/BeamMe) ·
[**BrewMe**](https://github.com/xiaojiou176-open/BrewMe) ·
[**Codeflow**](https://github.com/xiaojiou176-open/codeflow) ·
[**proofyard**](https://github.com/xiaojiou176-open/proofyard).
## Star This Repo
If Codeflow saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐
[](https://star-history.com/#xiaojiou176-open/codeflow&Date)
## Also by Yifeng[Terry] Yu
- **[OpenCampus](https://github.com/xiaojiou176-open/OpenCampus)** — Canvas + Gradescope + EdStem on one calm desk
- **[OpenUIStudio](https://github.com/xiaojiou176-open/OpenUIStudio)** — brief in, React + shadcn out, proof attached
- **[BeamMe](https://github.com/xiaojiou176-open/BeamMe)** — beam your agent config to any planet
- **[BrewMe](https://github.com/xiaojiou176-open/BrewMe)** — wake up, news already brewed
- **[proofyard](https://github.com/xiaojiou176-open/proofyard)** — every claim ships with its receipt
## License
MIT — small print, big freedom.
Connection Info
You Might Also Like
everything-claude-code
Complete Claude Code configuration collection - agents, skills, hooks,...
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
firecrawl
Firecrawl MCP Server enables web scraping, crawling, and content extraction.
cc-switch
All-in-One Assistant for Claude Code, Codex & Gemini CLI across platforms.
servers
Model Context Protocol Servers
servers
Model Context Protocol Servers