⚠️ Early Development Notice: This project is in early development and is not yet ready for production use. Features may change, break, or be incomplete.

Why CodeMachine?

• Customizable, End-to-End Workflows: Architect sophisticated orchestration pipelines for any scale, from executing simple scripts to managing multi-day, complex development cycles.
• 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.
• Massively Parallel Execution: Achieve significantly accelerated output by deploying sub-agents that operate simultaneously on different components of a task.
• Persistent, Long-Running Orchestration: Execute workflows for extended durations—hours or even days—to autonomously accomplish complex, long-term development goals.

🚀 Quick Start

Installing and running CodeMachine CLI

First, install the command-line tool globally:

npm install -g codemachine   # or bun/pnpm/yarn

Then, simply run codemachine in your project directory to get started:

codemachine   # or cm

Initializing a Project

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:

• Architect a complete system blueprint from your requirements.
• Formulate detailed, step-by-step execution plans.
• Engineer clean, production-grade code for every component.
• Generate essential automation for testing and deployment.
• Integrate rigorous validation checks across every phase of execution.

Supported AI Engines

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.

Production Validation:

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.

CodeMachine vs Regular AI Agents

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.

⭐ Contributors

📖 References