npm i -g codemachine

CodeMachine 是一款开源工具，可将 AI 编码代理编排成可重复、长期运行的工作流。⚡️

---

每次你使用 AI 编码代理时，其实都在执行一个工作流。修复 bug？你需要提问、复现、分析、规划、实现、测试。构建新功能？则需要调研、设计、编码、评审。

这个工作流就存在于你的脑海中。 你一步步、一次又一次地引导代理完成它。但每次开始时，你都得从头再来：重新解释流程，记住该问哪些问题，还要把握何时清除上下文、何时推进、何时回溯。

CodeMachine 让你可以捕获并再次运行这个工作流。

工作原理

CodeMachine 是一个编排层，通过结构化的工作流来运行 AI 编码 CLI。你只需定义一次工作流，CodeMachine 就会负责执行、上下文传递以及代理间的协调。

它利用 AI 编码引擎为自动化提供的无头脚本模式（如 Claude Code、Codex、Cursor 等）。通过 CLI 启动这些引擎，传递正确的参数和标志，并借助自身的基础设施控制各个代理。

你可以构建从完全交互式到完全自主的任何类型的工作流——以及介于两者之间的各种模式。了解编排模式 →

为什么选择 CodeMachine？

CM 引入了前所未有的创新代理通信方式，使你能构建任何复杂的、想象得到的工作流。从 Ali Workflow Builder 的默认工作流开始，即可交互式地创建你的第一个工作流。

• 一次构建，永久运行： 只需定义一次复杂的工作流，便可在每个项目上可靠地执行——无需再手动重复搭建相同的模式。
• 多代理编排： 为不同任务分配不同的代理，让它们相互通信，共同做出复杂决策。
• 并行执行： 在工作流的不同部分同时运行多个代理，以加快结果产出。
• 长周期工作流： 可以持续数小时甚至数天执行工作流——CodeMachine 会处理持久化问题，你无需时刻盯着。
• 上下文工程： 集中管理提示词、动态上下文，并精确控制每个代理在每一步看到的内容。

准备好构建你的第一个工作流了吗？立即开始 →

---

开发者们已经在使用 CodeMachine 来减少复杂且重复性工作流所需的时间和精力。
想看看他们在构建什么吗？加入我们吧。

  

CodeMachine-CLI 快速上手指南

CodeMachine 是一个开源工具，用于将 AI 编程智能体（Agents）编排成可重复、长期运行的工作流。它通过结构化流程自动化执行任务，支持多智能体协作、并行执行及上下文管理，让你只需定义一次工作流，即可在任何项目中可靠地重复运行。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• Node.js 环境：你需要安装 Node.js 和 npm（Node Package Manager）。建议使用 LTS（长期支持）版本以确保兼容性。
• AI 编程引擎：CodeMachine 本身不生成代码，而是 orchestrate（编排）现有的 AI 编程 CLI 工具。你需要至少安装并配置好以下任一工具：
  • Claude Code
  • Codex
  • Cursor CLI
  • 其他支持无头脚本模式（headless scripting mode）的 AI 编程引擎。
• API 密钥/认证：确保你使用的 AI 引擎已正确配置 API 密钥或登录状态，以便 CodeMachine 能够调用它们。

安装步骤

CodeMachine 以全局 CLI 工具的形式发布。打开终端，运行以下命令进行安装：

npm i -g codemachine

提示：如果你在中国大陆地区遇到 npm 下载速度慢的问题，建议临时切换至国内镜像源（如淘宝镜像）：

npm config set registry https://registry.npmmirror.com
npm i -g codemachine

安装完成后，你可以在终端输入 codemachine 或 cm（如果支持别名）来验证安装是否成功。

基本使用

CodeMachine 的核心在于“工作流（Workflow）”。对于初学者，最简单的方式是使用内置的 Ali Workflow Builder 交互式构建你的第一个工作流。

1. 启动交互式构建器

在终端中运行以下命令启动默认的工作流构建器：

codemachine run ali

2. 遵循引导定义工作流

系统将进入交互模式，引导你完成以下步骤：

• 定义目标：描述你想要自动化的任务（例如：“修复 bug”、“构建新功能”）。
• 选择智能体：为不同的步骤分配不同的 AI 引擎或角色。
• 配置步骤：设置具体的执行逻辑，如研究、编码、测试等阶段。

3. 执行工作流

一旦工作流定义完成并保存，你可以随时在项目根目录下重新运行它，CodeMachine 将自动处理上下文传递、智能体协调和错误恢复：

codemachine run <your-workflow-name>

核心优势一览

• 一次构建，永久运行：无需每次手动重复相同的提示词和步骤。
• 多智能体协作：让不同的 AI 模型各司其职（例如一个负责架构设计，一个负责具体编码）。
• 长期运行支持：适合耗时数小时甚至数天的复杂任务，CodeMachine 会自动持久化状态，无需人工值守。

更多高级编排模式和详细文档，请访问 CodeMachine 官方文档。