JSPM

npm i -g codemachine

CodeMachine CLI is an autonomous multi-agent platform that works locally on your computer, turning specifications into production-ready code.

✨ CodeMachine Built Itself

90% of this entire codebase was generated by CodeMachine from a single specification file.
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.

What is CodeMachine?

CodeMachine is a CLI-native orchestration platform that transforms specification files and contextual inputs into production-ready code through coordinated multi-agent workflows. Specialized AI agents operate in hierarchical and parallel configurations with the ability for bidirectional communication, enabling runtime-adaptable methodologies that dynamically adjust to project requirements without framework modifications.

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 via npm:

npm install -g codemachine

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

codemachine

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. The table below shows the current status of supported engines and their platform compatibility.

✅ Fully Supported | ⚠️ Not Officially Supported | ❌ Not Available

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.

Real-world comparison: One developer manually prompting AI coding assistants vs CodeMachine's autonomous multi-agent orchestration

Want to see how CodeMachine built this?
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.

📊 View Complete Case Study & Development Track →

📚 Documentation

Getting Started

• Prerequisites & Installation
• Quick Start Guide
  • Writing Your Specification
  • Running the Workflow
• How CodeMachine Works

Core Concepts

• Agents in CodeMachine
  • Main Agents
  • Sub Agents
  • Modules
  • Dynamic Agent Generation
• Communication Patterns
  • Sequential Execution
  • Parent-Child Delegation
• Context Management
  • File-Based Memory
  • Session Memory

CLI Usage

• CLI Overview
  • Global Options
  • Interactive Mode
• Workflow Commands
  • Start Command
  • Template Selection
• Development Commands
  • Run Command
  • Step Execution
• Authentication
  • Login
  • Logout
• Advanced Topics
  • Engine-Specific Commands

Creating Custom Workflows

• Workflow Templates
  • Template Structure
  • Step Resolution Functions
  • Override Options
• Configuring Agents
  • Main Agents
  • Sub Agents
  • Workflow Modules
• Engine & Model Selection
  • Available Engines
  • Model Options
  • Reasoning Levels
• Advanced Patterns
  • Loop Behaviors
  • Fallback Handling
  • Mixed Engine Workflows

Writing Specifications

• Specification Schema
  • Essential Requirements
  • Advanced Specifications

🙏 Contributors

Special thanks to the following contributors who have helped make CodeMachine better:

• Bahy Ali - Architect of the original workflow system and core orchestration concepts. His deep expertise and guidance were instrumental in shaping CodeMachine's foundation.

• Adinda Praditya - Added CCR (Claude Code Router) engine support, removing a major limitation by enabling users to leverage AI capabilities beyond subscription-based services.

• SoyHub - Enhanced the UI system and contributed innovative ideas during brainstorming sessions that helped strengthen CodeMachine's capabilities.