CodeMachine-CLI is an open-source command-line AI coding agent and orchestrator developed by Moaz Builds. Built on top of the Bun/JavaScript runtime ecosystem, it provides a terminal-driven framework designed to execute structured, multi-step agent workflows across local repositories. The tool operates around guided execution flows, featuring Quick Mode for fast single-pass tasks and Expert Mode for complex multi-step development pipelines. Workflows utilize explicit step boundaries, system guardrails ("stay-in-lane" rules), and interactive confirmation checkpoints ("Press Enter to continue") that prevent the agent from jumping ahead or acting outside its assigned scope. CodeMachine-CLI differentiates itself by prioritizing deterministic workflow execution and prompt modularity over unrestrained autonomy. It also provides observability integration with dedicated Docker metrics configurations and structured logging for monitoring agent execution and boot cycles. The project is open-source under a public repository on GitHub, distributed as precompiled binaries via release assets or run locally via Bun.
Dual Workflow Modes — Offers Quick Mode for lightweight updates and Expert Mode for multi-stage software design and execution. - Strict Step Gating — Enforces sequential agent execution with explicit stop conditions and interactive user checkpoints between steps. - Bun Runtime Architecture — Implemented with Bun for high-performance execution and fast command-line startup. - Modular Prompt System — Employs shared system rules and template directories that dictate agent scope and forbidden behaviors. - Containerized Observability — Includes built-in Docker observability configurations and telemetry logger tracking boot and execution metrics.
Use cases
Use Case: Multi-Step Refactoring Developers can initiate Expert Mode to break complex codebase restructuring into sequential phases, verifying changes at each milestone before proceeding to subsequent edits.
Use Case: Fast Scaffolding and Targeted Edits Engineers can execute Quick Mode workflows to rapidly generate isolated modules, tests, or bug fixes without loading extended planning pipelines.
Use Case: Guarded Workflow Execution Teams working in sensitive codebases can enforce strict DO NOT system rules within custom prompt templates to prevent the agent from modifying forbidden files or executing unauthorized shell commands.
Who it is for
CodeMachine-CLI is suited for developers and technical leads who prefer tightly controlled, step-by-step terminal agent execution over unconstrained autonomous loops. It is not intended for users seeking deep GUI IDE integrations or fully hands-off, unsupervised agent workflows.
Install guide
Installation Install and run from source using the Bun runtime, or obtain binary builds from GitHub Releases: bash git clone https://github.com/moazbuilds/CodeMachine-CLI.git cd CodeMachine-CLI bun install
First Run Set your upstream provider API credentials in your environment before invoking the CLI: bash export OPENAI_API_KEY="your-api-key-here" export ANTHROPIC_API_KEY="your-api-key-here"
Example Session Start the agent interface to select workflow modes and provide task context: bash bun run bin/index.js # Select 'Quick Mode' or 'Expert Mode' from the prompt menu # Provide your task instruction when prompted
SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…
Hivelore — Hivelore is an open-source agent harness and contextual memory orchestrator created by Doucs91. It provides persistent project memory, decision tracking,…
Context Bridge — Context Bridge is an open-source CLI agent harness and context orchestration utility developed by serdardb. It is built to facilitate…
Vibe Kanban — Vibe Kanban, originally developed by Bloop AI, is an open-source orchestration harness and visual task board designed to manage and…
Parallel Harness Pets — Parallel Harness Pets (parallel-harness-pets) is an open-source companion tool and harness plugin created by TevvvB. It is designed for developers…