SECTION · CLI REFERENCE
CLI 레퍼런스
터미널에서 실행하는 moai CLI 커맨드의 상세 레퍼런스.
moai init 초기화
moai init 은 현재 디렉터리 또는 새 폴더에 MoAI 프로젝트를 초기화합니다. Claude Code 연동에 필요한 .claude/, …
moai inventory 커맨드
현재 프로젝트의 활성 세션, 워크트리, 하네스를 한눈에 조회하는 moai inventory 커맨드를 안내합니다.
여러 SPEC 을 동시에 진행하 …
moai cc / cg / glm 런처
moai cc, moai cg, moai glm 은 Claude Code를 서로 다른 백엔드 구성으로 실행하는 세 가지 런처입니다. 세 명령 모 …
프로젝트 상태
moai status 명령어로 현재 프로젝트의 초기화 상태, SPEC 개수, 설정 파일 현황을 한눈에 확인합니다. 플래그가 없는 읽기 전용 명령 …
moai worktree 워크트리
moai worktree (별칭 moai wt) 는 병렬 SPEC 개발에 쓰는 Git 워크트리를 관리합니다. 동기화, 완료 처리, 제거, 정리, …
업데이트
MoAI-ADK를 최신 버전으로 유지하는 방법을 안내합니다. moai update 하나로 바이너리와 템플릿이 함께 갱신되며, 사용자가 만든 커스 …
moai spec 문서 관리
moai spec 은 .moai/specs/ 디렉터리의 SPEC 문서를 관리합니다. 상태 갱신, 드리프트 감지, 수용 기준 조회, …
프로필 관리
MoAI-ADK의 프로필 시스템은 여러 Claude Code 설정을 격리해 관리합니다. 업무용과 개인용, 고품질 세션과 비용 절감 세션을 프로필 …
moai web 웹 콘솔
로컬 운영 콘솔을 띄우는 moai web 커맨드 — 플래그, 라우트, 포트 회수 동작.
moai doctor 진단
moai doctor 는 시스템 전반을 한 번에 진단합니다. Claude Code 설정, 의존성, 프로젝트 구조, 언어별 개발 도구, 환경을 차 …
moai session 세션 레지스트리
moai session 은 .moai/state/active-sessions.json 의 다중 세션 조율 레지스트리를 관리합니다. 여러 …
moai handoff 핸드오프 레코드
moai handoff 는 auto-resume 핸드오프 pending 레코드를 관리합니다. 세션 경계(/clear)를 넘어 작업을 이어 가려고 …
moai goal 목표 루프
moai goal 은 조건을 선언해 두는 에이전틱 목표 루프를 현재 세션에 arm 하고, 상태를 조회하고, 해제합니다. 선언한 조건이 충족되거나 …
moai loop 피드백 루프
moai loop 은 SPEC 라이프사이클 Ralph 피드백 루프 컨트롤러를 관리합니다. SPEC 하나를 대상으로, 도구 진단이 찾아낸 작업을 …
moai ast-grep / ast-edit 구조 검색·치환
moai ast-grep 은 코드를 구문 트리 단위로 스캔하고, moai ast-edit 은 매칭된 코드를 실제로 치환합니다. 텍스트 기반 …
moai harness 하네스
moai harness 은 SPEC 복잡도 라우팅과 하네스 학습 서브시스템을 관리하는 통합 커맨드 트리입니다. 라우팅, 검증, 라이프사이클, 제 …
moai constitution 헌법
moai constitution 은 zone 레지스트리(FROZEN/EVOLVABLE zone 성문화)를 조회하고 검증합니다. 규칙 가운데 어디 …
moai tool-policy 도구 정책
moai tool-policy 는 도구/권한 정책 SSOT를 관리합니다. .moai/config/sections/tool-policy.yaml …
moai github GitHub 연동
moai github 는 GitHub 이슈 파싱, SPEC 링크, 워크플로우 자동화 커맨드를 제공합니다.
이슈 트래커와 SPEC 문서가 서로 분 …
moai pr PR 감시
moai pr 은 CI/CD 워크플로우에서 pull request를 감시·관리하는 커맨드입니다.
SPEC 단위로 PR 을 열면 관리자 에이전트가 …
moai epic 에픽 진행률
여러 SPEC 으로 나뉜 에픽의 마일스톤 진행률을 디스크에서 계산하는 moai epic status 커맨드.정보소속 가치: 토크노믹스 · 에이전틱 루프 엔지니어링 · 에이전틱 하네스
터미널에서 실행하는 moai(Go 바이너리) 커맨드의 상세 레퍼런스입니다. 각 커맨드의 플래그, 하위 명령어, 사용 예시를 다룹니다.
Claude Code 대화창에서 입력하는 슬래시 /moai 커맨드(워크플로우/유틸리티 명령어)와는 완전히 다른 도구입니다. 터미널 moai 가 프로젝트 초기화와 템플릿 배포, SPEC 라이프사이클 관리, 하네스(harness) 라우팅 같은 파일시스템 작업을 맡고, 슬래시 /moai 는 Claude Code 안에서 에이전트(스스로 일하는 AI)를 지시하는 대화 커맨드이기 때문에, 두 축을 한 색인에서 명확히 나눠 둡니다. 이 분리가 사용자의 가장 흔한 혼란을 줄여 주기 때문에, 각 커맨드가 어느 쪽에 속하는지부터 확인하고 본문으로 내려가는 것을 권합니다.
워크플로우 명령어는 워크플로우 명령어, 유틸리티 명령어는 유틸리티 명령어 섹션을 참조하세요. moai CLI 전체 개요는 CLI 개요에서 확인할 수 있습니다.