CLI 概览

概览在终端执行的 moai(Go 二进制)的所有命令与标志。它与在 Claude Code 对话窗输入的 /moai(斜杠子命令)是完全不同的工具 —— 本页只讲终端 CLI。

各命令的详细参考(标志、子命令、示例)请见 CLI 参考 部分。

moai --help

moai CLI 分为三组。

用 moai version 确认当前安装的版本。

moai version

╭────────────────────────╮
│                        │
│    moai-adk v3.0.0     │
│                        │
│                        │
╰────────────────────────╯
 v3.0.0   none   built unknown

框式横幅下方一行按 <版本> <提交哈希> built <构建时刻> 顺序显示。若像 go install 那样在无 ldflags 下构建,提交显示为 none,构建时刻显示为 unknown。

初始化项目。交互式向导会设置语言、Git 自动化、模型策略、harness 配置文件等。

moai init [project-name] [OPTIONS]

# 初始化新项目(交互式向导)
moai init my-project

# 安装到既有文件夹
cd my-existing-project
moai init

# 非交互(CI/CD)
moai init --non-interactive --project-mode personal --model-policy medium

详细的向导步骤请参阅初始设置页面。

将 MoAI-ADK 更新到最新版本。不带标志运行时会一并更新二进制与模板,用户自定义资产会自动保留。

moai update [OPTIONS]

# 默认更新(二进制 + 模板)
moai update

# 仅确认是否有新版本
moai update --check

# 重新运行设置向导
moai update -c

# 仅同步模板
moai update --templates-only

详细的更新流程请参阅更新页面。

执行系统诊断。检查 Git、项目结构、配置文件、各语言的开发工具。

moai doctor [OPTIONS]

# 完整诊断
moai doctor

# 详细诊断
moai doctor --verbose

# 导出诊断结果
moai doctor --export diagnostics.json

一目了然地查询项目状态。显示是否已初始化、SPEC 数量、配置文件数。

moai status

这是无标志的只读命令。详细的输出内容请参阅项目状态页面。

综合查询活跃会话、工作树、harness 的只读命令。

moai inventory [OPTIONS]

详细的 JSON schema 与使用示例请参阅moai inventory页面。

管理 Claude Code 设置配置文件。可为每个配置文件维护独立的模型、语言、显示设置。

moai profile [COMMAND]

用 -p 标志指定运行时的配置文件:

moai cc -p work       # 用 work 配置文件运行 Claude
moai glm -p cost-save # 用 cost-save 配置文件运行 GLM
moai cg -p team       # 用 team 配置文件运行 CG 模式

详情请参阅配置文件管理页面。

处理 Claude Code 钩子事件的调度器。由 settings.json 的钩子设置以 moai hook <event> 形式调用。

moai hook <event>

moai hook 调度器把标准 Claude Code 钩子事件与 MoAI 专用内部动作合在一起,共提供 42 个子命令。所有名称均为 kebab-case。下面是有代表性的事件。

钩子事件数与子命令数是两个不同的数字。 moai doctor hook 显示的 30 是 Claude Code 定义的钩子事件种类,这里的 42 是 moai hook 接受的子命令数量。由于 MoAI 专用内部动作没有对应事件也作为子命令存在,两者并不一致。

还包含 MoAI 专用子命令。

钩子不由用户直接执行 —— Claude Code 的 settings.json 会自动调用。

管理 Git worktree 以进行并行 SPEC 开发。

moai worktree <COMMAND> [ARGS]...

进入工作树是启动器的职责。列表查询则直接用 git。

moai cc -w feat-login           # 在工作树中开始工作 (不存在则创建)
moai cc -w feat-login --spawn   # 保留当前会话,在新 tmux 窗口中打开
git worktree list               # 工作树列表

在启动 Claude Code 时选择后端的启动命令。三条命令都能用 -p <profile> 标志指定配置文件。把 -- 之后的参数原样传给 Claude Code,只有 moai cc 与 moai glm 支持(moai cg 不支持)。

moai cc [-p profile] [-- claude-args...]
moai glm [-p profile] [-- claude-args...]
moai cg [-p profile]

moai cg 激活 CG 模式(Claude 领导 + GLM 队友)。必须在 tmux 会话内运行,它会把 GLM 环境变量注入 tmux 会话,而领导窗口使用 Claude API。moai cg 在设置后会直接在当前窗口启动 Claude Code,因此不需要另外的 claude 启动步骤。

# 1. 保存 GLM API 密钥(首次一次)
moai glm setup sk-your-glm-api-key

# 2. 激活 CG 模式(在 tmux 内运行 —— Claude Code 会在当前窗口直接启动)
moai cg

详细的 CG 模式指南请参阅简介 — 用 GLM 节省 token。

三条启动命令共同支持的标志。

moai cc 额外支持以下标志。

auto 权限模式在 GLM(第三方提供者)中不可用 —— 仅在 moai cc 或 moai cg 中支持。

为当前会话注册·查询·解除基于条件的自主 goal 循环。在条件满足之前,每个回合结束时进行评估。

moai goal <COMMAND>

管理用于跨越 /clear 边界续接会话的 auto-resume 交接待处理记录。

moai handoff <COMMAND>

管理用于缓解多会话竞态的活跃会话协调注册表。

moai session <COMMAND>

启动基于浏览器的配置编辑器 MoAI Web Console。

moai web [OPTIONS]

显示版本、commit 哈希、构建日期。

moai version
moai --version    # 相同

MoAI-ADK 提供为智能体分配最优 AI 模型的性能层级系统 —— 这是代币经济学的起点。通过 llm.yaml 的 performance_tier 字段设置,用 --model-policy 标志或初始化向导选择。

# 初始化时设置
moai init my-project --model-policy high

# 在既有项目中重新设置
moai update -c

配置文件(profile: high/medium/low)选择配置矩阵的活动列，确定每个代理的 model+effort。详细的每个代理映射请参阅配置矩阵页面。

• 快速开始
• 安装
• 更新
• 初始设置
• 配置文件管理
• 项目状态