Project Status
The moai status command shows the current project’s initialization state, SPEC count, and configuration files at a glance. It is a read-only command with no flags.
For the harness to work correctly, both .moai/ and .claude/ must be initialized, and when that condition is broken other moai commands emit obscure errors, so this command is the quick first check to run. It is the default entry point for confirming state before starting a new SPEC or entering a debugging session.
moai statusRun without flags, it prints the project status as a box.
When run in a project where a .moai/ directory exists, the following information is displayed.
| Item | Description |
|---|---|
| Project | Project name (current directory name) |
| ADK | Installed MoAI-ADK version |
| Config | Configuration file path (.moai/config/sections) |
| SPECs | Number of SPEC directories under .moai/specs/ |
| Configs | Number of YAML files in .moai/config/sections/ |
A status indicator showing the initialization state and SPEC count is printed at the bottom.
When no .moai/ directory exists, a “Not initialized” status indicator is shown along with guidance to run moai init.
When the project is a Git repository and the current branch strays from the BODP (Branch-Oriented Development Practice) convention, a notice is printed to stderr. This notice is a reminder of the branch-naming convention within the distributed one-person OSS workflow.
The notice is printed automatically, and is silently skipped when Git is not installed or the current directory is not a Git repository.
| Command | Description |
|---|---|
moai doctor | System diagnostics and environment validation (detailed check) |
moai inventory | Unified view of active sessions, worktrees, and harnesses |
moai init | Project initialization (run when uninitialized) |
- CLI Reference — full CLI commands
- moai inventory — unified view of active resources
- Initial Setup — project initialization wizard