Advanced Setup

System Requirements

For Users (Binary Installation)

The CodeMachine binary bundles the Bun runtime, so no additional tooling is required.

Requirement	Details
OS	Linux (x64, arm64), macOS (x64, arm64), Windows (x64)
RAM	4GB minimum, 8GB+ recommended for parallel agents
Disk	100MB for binary + space for logs
AI Engine	At least one supported engine installed (Claude Code, Codex, etc.)

For Developers (Building from Source)

Requirement	Version
Bun	>= 1.3.3
Node.js	>= 20.10.0 (for tooling)
Git	Latest

Resource Scaling Guide

Running multiple parallel agents requires additional system resources. Use this table to plan your infrastructure:

Workload	RAM	CPU	Notes
Single agent	2 GB	1 core	Light tasks
5 parallel agents	4 GB	2 cores	Small workflows
10-20 parallel agents	8-16 GB	4+ cores	Production workflows
20+ parallel agents	32 GB+	8+ cores	Heavy swarms

These requirements are for running multiple AI engine processes simultaneously, not for build tooling.

Building from Source

Clone the Repository

git clone https://github.com/moazbuilds/CodeMachine-CLI.git
cd CodeMachine-CLI

Install Dependencies

bun install

Run in Development Mode

bun dev

Build for Production

bun run build

Optional: Link bun globally

To use cm as a global command while developing, link the package:

bun link

Now you can run cm from anywhere on your system. To unlink:

bun unlink codemachine

Manual Installation

If you prefer not to use a package manager, you can download the binary directly from the GitHub Releases page.

Linux/macOS
Windows

# Download the binary for your platform
curl -fsSL https://github.com/moazbuilds/CodeMachine-CLI/releases/latest/download/codemachine-linux-x64 -o codemachine

# Make it executable
chmod +x codemachine

# Move to your PATH
sudo mv codemachine /usr/local/bin/

# Create cm alias
sudo ln -s /usr/local/bin/codemachine /usr/local/bin/cm

Download codemachine-win-x64.exe from the releases page and add it to your system PATH.

Manual Update

npm i -g codemachine@latest

bun add -g codemachine@latest

Uninstallation

npm
bun
Manual

npm uninstall -g codemachine

bun remove -g codemachine

sudo rm /usr/local/bin/codemachine /usr/local/bin/cm

Configuration files are stored in ~/.codemachine/. Remove this directory to completely clean up. Also remove ./.codemachine in your project to delete runtime data and reset CodeMachine.

Resources

Docs

Legal

System Requirements

For Users (Binary Installation)

For Developers (Building from Source)

Resource Scaling Guide

Building from Source

Manual Installation

Manual Update

Uninstallation

​System Requirements

​For Users (Binary Installation)

​For Developers (Building from Source)

​Resource Scaling Guide

​Building from Source

​Manual Installation

​Manual Update

​Uninstallation

System Requirements

For Users (Binary Installation)

For Developers (Building from Source)

Resource Scaling Guide

Building from Source

Manual Installation

Manual Update

Uninstallation