Skip to main content
SECTION · CLI REFERENCE

CLI Reference

Detailed reference for the terminal moai CLI commands.

moai init Initialization
moai init initializes a MoAI project in the current directory or a new folder. …
moai inventory Command
A guide to the moai inventory command, which shows the current project’s …
moai cc / cg / glm Launchers
moai cc, moai cg, and moai glm are three launchers that run Claude Code with …
moai graph
NEW · v3.1.1 A tool that gathers the codebase’s relationships into one …
moai tokens
NEW · v3.1.1 An accounting tool that records a Claude Code session’s token …
moai memory
NEW · v3.1.1 A health-check and archive tool for the Lessons Protocol memory …
Project Status
The moai status command shows the current project’s initialization state, …
moai worktree Worktrees
moai worktree (alias moai wt) manages the Git worktrees used for parallel SPEC …
Update
A guide to keeping MoAI-ADK up to date. A single moai update refreshes both the …
moai spec Document Management
moai spec manages the SPEC documents in the .moai/specs/ directory. It provides …
Profile Management
MoAI-ADK’s profile system lets you manage multiple Claude Code …
moai web Console
The moai web command that starts the local operations console — flags, routes, port-reclaim behavior.
moai doctor Diagnostics
moai doctor runs comprehensive system diagnostics. It checks Claude Code …
moai session Session Registry
moai session manages the multi-session coordination registry in …
moai handoff Handoff Records
moai handoff manages the auto-resume handoff pending record. It saves or clears …
moai goal Goal Loop
moai goal arms/queries/clears a condition-declared agentic goal loop for the …
moai loop Feedback Loop
moai loop manages the SPEC-lifecycle Ralph feedback-loop controller. It drives a …
moai ast-grep / ast-edit Structural Search and Rewrite
moai ast-grep scans code by syntax tree, and moai ast-edit rewrites the code it …
moai harness Harness
moai harness is a unified command tree that manages SPEC-complexity routing and …
moai constitution Constitution
moai constitution queries and validates the zone registry (the codification of …
moai tool-policy Tool Policy
moai tool-policy manages the tool/permission policy SSOT. …
moai github GitHub Integration
moai github provides commands for GitHub issue parsing, SPEC linking, and …
moai pr PR Watch
moai pr is a command that watches and manages pull requests in a CI/CD workflow. …
moai epic Epic Progress
The moai epic status command, which computes milestone progress for a multi-SPEC epic from disk.
Info
Belongs to: Tokenomics · Agentic Loop Engineering · Agentic Harness

A detailed reference for the terminal moai (Go binary) commands. Each entry covers the command’s flags, subcommands, and usage examples.

This is a completely different tool from the slash /moai commands you type in the Claude Code chat (workflow / utility commands) — see Workflow Commands and Utility Commands for those. For a high-level overview of the moai CLI, see CLI Overview.