프로젝트 상태
moai status 명령어로 현재 프로젝트의 초기화 상태, SPEC 개수, 설정 파일 현황을 한눈에 확인합니다. 플래그가 없는 읽기 전용 명령어입니다.
하네스(harness) 가 정상 동작하려면 .moai/ 와 .claude/ 디렉터리가 모두 초기화돼 있어야 하는데, 이 조건이 깨져 있으면 다른 moai 커맨드가 애매한 오류를 내기 때문에, 이 커맨드는 가장 먼저 실행해 볼 한눈짚기 용도로 쓰입니다. 따라서 SPEC 을 새로 시작하거나 디버깅 세션에 들어가기 전 상태를 확인하는 기본 진입점입니다.
bash
moai status플래그 없이 실행하면 프로젝트 상태를 박스 형태로 출력합니다.
.moai/ 디렉터리가 있는 프로젝트에서 실행하면 다음 정보를 보여 줍니다.
| 항목 | 설명 |
|---|---|
| Project | 프로젝트 이름 (현재 디렉터리명) |
| ADK | 설치된 MoAI-ADK 버전 |
| Config | 설정 파일 경로 (.moai/config/sections) |
| SPECs | .moai/specs/ 하위의 SPEC 디렉터리 개수 |
| Configs | .moai/config/sections/ 의 YAML 파일 개수 |
하단에 초기화 상태와 SPEC 개수를 나타내는 상태 표시가 함께 출력됩니다.
.moai/ 디렉터리가 없는 경우, “Not initialized” 상태 표시와 함께 moai init 실행을 안내합니다.
Git 저장소에서 실행할 때 현재 브랜치가 BODP (Branch-Oriented Development Practice) 규약을 벗어나면 stderr로 알림을 내보냅니다. 분산된 1인 OSS 워크플로우에서 브랜치 네이밍 규칙을 잊지 않도록 붙여 둔 장치입니다.
알림은 따로 켜지 않아도 나오며, Git이 설치돼 있지 않거나 현재 디렉터리가 Git 저장소가 아니면 조용히 넘어갑니다.
| 명령어 | 설명 |
|---|---|
moai doctor | 시스템 진단 및 환경 검증 (상세 확인) |
moai inventory | 활성 세션, 워크트리, 하네스 통합 조회 |
moai init | 프로젝트 초기화 (미초기화 시 실행) |
- CLI 레퍼런스 — 전체 CLI 명령어
- moai inventory — 활성 자원 통합 조회
- 초기 설정 — 프로젝트 초기화 마법사