You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<imgsrc="./docs/assets/nova-banner.png"alt="v0.8 Nova Edition"width="400">
11
-
</p>
10
+
<strong>CodeMachine</strong> is a CLI-native Orchestration Engine that runs coordinated multi-agent workflows directly on your local machine. It provides the runtime infrastructure to execute complex multi-agent topologies within your own environment. Designed to drive any high-level autonomous objective, it features a battle-tested Spec-to-Code blueprint—transforming your terminal into a factory for production-ready software. ⚡️<br></p>
12
11
13
12
<palign="center">
14
-
<strong>🌟 v0.8 NOVA EDITION is here - a massive update.</strong><br>
15
-
New architecture, breaking changes, and a completely refreshed experience.<br>
<imgsrc="https://raw.githubusercontent.com/moazbuilds/CodeMachine-CLI/main/docs/assets/demo.gif"alt="CodeMachine in Action"width="800">
17
14
</p>
18
15
19
-
---
20
16
21
17
<palign="center">
22
-
<strong>CodeMachine</strong> is a reliable, CLI-native orchestration platform built on coding agents that lets you turn complex coding objectives into repeatable, automated pipelines - with context engineering tools and agent observability - so you can build a workflow once and run it confidently on demand. ⚡️<br></p>
18
+
<strong>✨ CodeMachine Built Itself</strong>
19
+
</p>
23
20
24
21
<palign="center">
25
-
<imgsrc="https://raw.githubusercontent.com/moazbuilds/CodeMachine-CLI/main/docs/assets/demo.gif"alt="CodeMachine in Action"width="800">
22
+
<strong>90% of this entire codebase was generated by CodeMachine from a single specification file.</strong><br>
23
+
This isn't a demo—it's proof. CodeMachine engine orchestrated its own architecture, planning, implementation, and testing—creating a massively scalable codebase ready for continuous updates and improvements.
26
24
</p>
27
25
28
-
29
26
---
30
27
31
-
**Coding agents are powerful - until the objectives get repetitive.**
32
-
33
-
When you're doing the same complex workflow for the 10th time - manually chaining sessions, managing context, rebuilding patterns - you become the bottleneck.
34
-
35
-
CodeMachine doesn't replace your agents. It orchestrates them.
28
+
> **⚠️ Early Development Notice:** This project is in early development and is not yet ready for production use. Features may change, break, or be incomplete.
36
29
37
-
## Is CodeMachine For You?
38
-
39
-
**When CodeMachine makes sense:**
40
-
- You're doing similar complex workflows repeatedly
41
-
- Context management across long objectives is painful
42
-
- You want to define once, run many times
43
-
- Your team needs consistent, reproducible processes
<sub>Join our growing Discord and Reddit communities of developers building with CodeMachine!</sub>
39
+
</p>
44
40
45
-
**When it doesn't:**
46
-
- One-off tasks - your coding agent handles those perfectly
47
-
- One-time fixes with no repeating pattern
48
-
- You prefer manual control of session-by-session work
41
+
## Why CodeMachine?
49
42
43
+
***Customizable, End-to-End Workflows:** Architect sophisticated orchestration pipelines for any scale, from executing simple scripts to managing multi-day, complex development cycles.
44
+
***Strategic Multi-Agent Collaboration:** Leverage a heterogeneous multi-agent system by assigning specialized models to specific tasks—for instance, using Gemini for planning, Claude for implementation, and another model for code review.
45
+
***Massively Parallel Execution:** Achieve significantly accelerated output by deploying sub-agents that operate simultaneously on different components of a task.
46
+
***Persistent, Long-Running Orchestration:** Execute workflows for extended durations—hours or even days—to autonomously accomplish complex, long-term development goals.
50
47
---
51
48
52
49
## 🚀 Quick Start
53
50
54
-
### **Install**
51
+
### **Installing and running CodeMachine CLI**
55
52
53
+
First, install the command-line tool globally:
56
54
```bash
57
55
npm install -g codemachine # or bun/pnpm/yarn
58
56
```
59
57
60
-
### **Run**
61
-
58
+
Then, simply run `codemachine` in your project directory to get started:
62
59
```bash
63
60
codemachine # or cm
64
61
```
65
62
66
-
### **Start**
67
-
68
-
Hit `/start` and follow the workflow.
69
-
70
-
That's it.
71
-
72
-
---
73
-
74
-
## Why CodeMachine?
75
-
76
-
***Build Once, Run Forever:** Define complex workflows once and execute them reliably on every project - stop rebuilding the same patterns manually.
77
-
***Multi-Agent Orchestration:** Assign different coding agents to different tasks - use one for planning, another for implementation, another for review.
78
-
***Parallel Execution:** Run multiple agents simultaneously on different parts of your workflow for faster results.
79
-
***Long-Running Workflows:** Execute workflows for hours or days - CodeMachine handles persistence so you don't have to babysit.
80
-
***Context Engineering:** Centralize prompts, manage dynamic context, and control what each agent sees at each step.
81
-
***Agent Observability:** Trace agent behavior, monitor execution, and refine your workflows with visibility into what's happening.
82
-
83
-
---
84
-
85
-
## 🛠️ How It Works
86
-
87
-
CodeMachine resources live at `~/.codemachine/resources/{version}/` with three core folders:
88
-
89
-
| Folder | Purpose |
90
-
|--------|---------|
91
-
|`config/`| Define your agents - who does what |
92
-
|`prompts/`| Write instructions - what agents should know |
93
-
|`templates/`| Build workflows - how agents work together |
94
-
95
-
**That's it.** Configure agents, write prompts, connect them in a workflow - then run it whenever you need.
96
-
97
-
<palign="center">
98
-
<ahref="./docs/building-workflows.md"><strong>Learn to build workflows →</strong></a>
99
-
</p>
100
-
101
-
---
102
-
103
-
## 📦 Workflows
104
-
105
-
CodeMachine ships with ready-to-use workflows. Pick one, customize it, or build your own.
<td>Spec-to-code pipeline - generate code from your specifications</td>
123
-
</tr>
124
-
</tbody>
125
-
</table>
126
-
</p>
127
-
128
-
<palign="center">
129
-
<ahref="./docs/workflows.md"><strong>Explore all workflows →</strong></a>
130
-
</p>
63
+
### **Initializing a Project**
131
64
132
-
---
65
+
CodeMachine initializes a `.codemachine/` workspace. To start **add your specs** to the `inputs/specifications.md` file, then **run `/start`** and watch the magic happen, CodeMachine will:
66
+
***Architect a complete system blueprint from your requirements.**
***Engineer clean, production-grade code for every component.**
69
+
***Generate essential automation for testing and deployment.**
70
+
***Integrate rigorous validation checks across every phase of execution.**
133
71
134
-
##⚙️ Supported AI Engines
72
+
###Supported AI Engines
135
73
136
-
CodeMachine orchestrates CLI-based coding agents. You need at least one installed, and you can use multiple agents in a single workflow.
137
-
138
-
**Zero config?** If you have OpenCode installed, CodeMachine runs with `glm-4.7-free` by default. For other engines, use `/login` to authenticate.
74
+
CodeMachine requires at least one CLI-based AI engine to handle the primary roles of planning and writing code, and is designed to orchestrate multiple engines to collaborate within a single workflow.
139
75
140
76
<palign="center">
141
77
<tablealign="center">
@@ -152,45 +88,117 @@ CodeMachine orchestrates CLI-based coding agents. You need at least one installe
Can't find your engine listed? <ahref="./docs/engines.md"><strong>Check supported engines →</strong></a>
162
-
</p>
97
+
## **Production Validation:**
163
98
164
-
---
99
+
CodeMachine has been battle-tested on the Sustaina Platform a full-stack ESG compliance system spanning **7 microservices**, **500+ files**, and **60,000+ lines of code** across Python, TypeScript, React, FastAPI, and NestJS.
We conducted a real-world comparison by monitoring development work on a project of identical scope and complexity using the most powerful AI agent tools (Claude Code, Cursor, Copilot) with manual orchestration and human review, versus CodeMachine's autonomous multi-agent orchestration.
123
+
124
+
<tablealign="center">
125
+
<tr>
126
+
<th><strong>Aspect</strong></th>
127
+
<th><strong>Regular AI Agents</strong><br/>(Manual Orchestration + Human Review)</th>
<palign="center"><em>Real-world comparison: One developer manually prompting AI coding assistants vs CodeMachine's autonomous multi-agent orchestration</em></p>
178
+
179
+
---
167
180
168
181
<palign="center">
169
-
Developers are already building with CodeMachine - reducing time and effort on complex, repetitive workflows.<br/>
170
-
<strong>Want to see what they're creating? Join us.</strong>
182
+
<strong>Want to see how CodeMachine built this?</strong><br/>
183
+
Explore the complete case study showing the detailed path CodeMachine took to create this project—every step, decision, and workflow tracked from specification to production.
0 commit comments