CLI 概要
ターミナルで実行する moai (Go バイナリ) のすべてのコマンドとフラグを俯瞰します。Claude Code の対話画面で入力する /moai (スラッシュサブコマンド) とは完全に別のツールです — このページはターミナル CLI のみを扱います。
コマンドごとの詳細リファレンス (フラグ・サブコマンド・例) は CLIリファレンス セクションを参照してください。
moai --helpmoai CLI は 3 つのグループに分かれます。
| グループ | コマンド | 説明 |
|---|---|---|
| Launch | moai cc · moai glm | Claude Code セッションの開始 (バックエンド選択) |
| Project | moai init · moai update · moai doctor · moai status | プロジェクトの初期化、アップデート、診断、状態照会 |
| Tools | moai profile · moai inventory · moai hook · moai worktree · moai spec · moai harness · … | 設定、インベントリ、フック、ワークツリーなどのツール |
moai version で現在インストールされているバージョンを確認します。
moai version╭────────────────────────╮
│ │
│ moai-adk v3.0.0 │
│ │
│ │
╰────────────────────────╯
v3.0.0 none built unknownボックスバナーの下の行は <バージョン> <コミットハッシュ> built <ビルド時刻> の順で表示されます。go install など ldflags なしでビルドした場合、コミットは none、ビルド時刻は unknown と表示されます。
プロジェクトを初期化します。対話型ウィザードが言語、Git 自動化、モデルポリシー、ハーネスプロファイルなどを設定します。
moai init [project-name] [OPTIONS]| フラグ | 説明 |
|---|---|
--non-interactive | 対話型ウィザードをスキップ (フラグとデフォルト値を使用) |
--force | 既存プロジェクトの強制再初期化 (現在の .moai/ をバックアップ) |
--no-hooks | Git フックのインストールをスキップ |
--all | カタログの全項目を配布 (core + optional packs + harness-generated) |
--mode <ddd|tdd> | 開発方法論 (デフォルト値: tdd) |
--language <lang> | 主要プログラミング言語 |
--framework <name> | フレームワーク名 (デフォルト値: 自動検出または “none”) |
--name <name> | プロジェクト名 (デフォルト値: ディレクトリ名) |
--root <path> | プロジェクトルートディレクトリ (デフォルト値: 現在のディレクトリ) |
--git-mode <manual|personal|team> | Git ワークフローモード (デフォルト値: manual) |
--git-provider <github|gitlab> | Git プロバイダー |
--enable-lsp | LSP 連携の有効化 (デフォルト値: true) |
--enforce-quality | 品質ゲートの強制 (デフォルト値: true) |
--enable-design | デザインワークフローの有効化 (デフォルト値: true) |
--profile <high|medium|low> | 廃止済みスタブ — スクリプト互換のため値だけ受け付け、効果はなく、moai profile setup を案内する廃止警告を出します |
--model-policy <high|medium|low> | 廃止済みスタブ — スクリプト互換のため値だけ受け付け、効果はなく、moai profile setup を案内する廃止警告を出します |
--high | 廃止済みスタブ — 退いた --model-policy high の別名。同じ廃止警告を出します |
# 新規プロジェクトの初期化 (対話型ウィザード)
moai init my-project
# 既存フォルダへのインストール
cd my-existing-project
moai init
# 非対話型 (CI/CD)
moai init --non-interactive詳しいウィザードステップは 初期設定 ページを参照してください。
MoAI-ADK を最新バージョンにアップデートします。フラグなしで実行するとバイナリとテンプレートを一緒に更新し、ユーザーのカスタム資産は自動保存されます。
moai update [OPTIONS]| フラグ | 説明 |
|---|---|
--check | 新バージョンがあるかのみ確認 (アップデートしない) |
-c, --config | 設定ウィザードの再実行 (テンプレート同期はしない) |
--force | 強制アップデート (バージョン一致をスキップ、バックアップ+マージを強制、アーカイブドリフトを上書き) |
--yes | すべての確認を自動承認 (CI/CD モード) |
--templates-only | バイナリアップデートをスキップしテンプレートのみ同期 |
--binary | テンプレート同期をスキップしバイナリのみアップデート |
--dry-run | ファイルシステム変更なしで計画された作業のみ表示 |
--no-hooks | Git フックのインストールをスキップ |
--verbose | すべての警告を表示 (診断モード) |
--shell-env | Claude Code 用のシェル環境変数を構成 |
--profile <high|medium|low> | 廃止済みスタブ — スクリプト互換のため値だけ受け付け、効果はなく、moai profile setup を案内する廃止警告を出します |
# 基本アップデート (バイナリ + テンプレート)
moai update
# 新バージョンがあるか確認のみ
moai update --check
# 設定ウィザードの再実行
moai update -c
# テンプレートのみ同期
moai update --templates-only詳しいアップデート手順は アップデート ページを参照してください。
システム診断を実行します。Git、プロジェクト構造、設定ファイル、言語別の開発ツールを検査します。
moai doctor [OPTIONS]| フラグ | 説明 |
|---|---|
-v, --verbose | 詳細なツールバージョンおよび言語検出結果を表示 |
--fix | 欠落ツールの修正提案 |
--export <path> | 診断結果を JSON ファイルにエクスポート |
--check <tool> | 特定のツールのみ確認 (例: git, go, config) |
| コマンド | 説明 |
|---|---|
moai doctor sandbox | サンドボックスバックエンドの可用性診断 |
moai doctor permission | 権限解決の診断 |
moai doctor hook | 30 個のフックイベントカバレッジ表を表示 |
moai doctor config dump | マージ済み設定を provenance とともにダンプ |
moai doctor config diff <tier-a> <tier-b> | 2 つの設定ティアを比較 |
# 全体診断
moai doctor
# 詳細診断
moai doctor --verbose
# 診断結果のエクスポート
moai doctor --export diagnostics.jsonプロジェクトの状態を一目で照会します。初期化の有無、SPEC 個数、設定ファイル数を表示します。
moai statusフラグを持たない読み取り専用コマンドです。詳しい出力内容は プロジェクト状態 ページを参照してください。
アクティブセッション、ワークツリー、ハーネスを統合照会する読み取り専用コマンドです。
moai inventory [OPTIONS]| フラグ | 説明 |
|---|---|
--json | 構造化された JSON 出力 |
--project-root <path> | プロジェクトルートパス (デフォルト値: 現在のディレクトリ) |
詳しい JSON スキーマと活用例は moai inventory ページを参照してください。
Claude Code の設定プロファイルを管理します。プロファイルごとに独立したモデル、言語、表示設定を維持できます。
moai profile [COMMAND]| コマンド | 説明 |
|---|---|
moai profile list | 利用可能なすべてのプロファイルを表示 |
moai profile setup | 対話型設定ウィザードの実行 |
moai profile current | 現在アクティブなプロファイルを表示 |
moai profile delete <name> | 指定されたプロファイルの削除 |
プロファイルの実行は -p フラグで指定します:
moai cc -p work # work プロファイルで Claude 実行
moai glm -p cost-save # cost-save プロファイルで GLM 実行詳しい内容は プロファイル管理 ページを参照してください。
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 専用の内部アクションが対応するイベントなしでサブコマンドとして存在するため、両者は一致しません。
| イベント | 説明 |
|---|---|
session-start | セッション開始 |
session-end | セッション終了 |
pre-tool | ツール実行前 (PreToolUse) |
post-tool | ツール実行後 (PostToolUse) |
post-tool-failure | ツール実行失敗後 |
stop | セッション停止 |
stop-failure | 停止失敗 |
compact | コンテキスト圧縮前 (PreCompact) |
post-compact | コンテキスト圧縮後 |
notification | システム通知 |
subagent-start | サブエージェント開始 |
subagent-stop | サブエージェント終了 |
user-prompt-submit | ユーザープロンプト送信 |
permission-request | 権限リクエスト |
permission-denied | 権限拒否 |
teammate-idle | チームメイトのアイドル状態 |
task-completed | タスク完了 |
task-created | タスク生成 |
worktree-create | ワークツリー生成 |
worktree-remove | ワークツリー削除 |
instructions-loaded | インストラクションロード完了 |
config-change | 設定変更 |
cwd-changed | 作業ディレクトリ変更 |
file-changed | ファイル変更 |
elicitation | MCP elicitation リクエスト |
elicitation-result | MCP elicitation 結果 |
MoAI 専用のサブコマンドも含まれます。
| サブコマンド | 説明 |
|---|---|
stop-goal | ターン終了時にアクティブセッションの goal を評価 |
pre-push | コミットメッセージを規約に沿って検証 |
spec-status | git コミット時に SPEC status を自動更新 |
harness-classify | ハーネス分類器の実行とティア昇格の記録 |
harness-observe · harness-observe-stop · harness-observe-subagent-stop · harness-observe-user-prompt-submit | ハーネス使用ログの記録 |
フックはユーザーが直接実行しません — Claude Code の settings.json が自動的に呼び出します。
Git worktree を管理して並列 SPEC 開発を行います。
moai worktree <COMMAND> [ARGS]...| コマンド | 説明 |
|---|---|
moai worktree sync [branch-name] | base ブランチと worktree を同期 |
moai worktree done <branch-name> | ブランチの worktree を削除、任意でブランチも削除 |
moai worktree remove <path> | 指定パスの worktree を削除 |
moai worktree clean | stale な参照の整理、マージ済み・放置された worktree の整理 |
moai worktree recover | worktree レジストリの復旧 |
moai worktree snapshot | 作業ツリー状態のスナップショットを取得 |
moai worktree verify | 作業ツリー状態をスナップショットと照合検証 |
moai worktree restore | スナップショット HEAD 状態へ作業ツリーを復元 |
ワークツリーの中へ入るのはランチャーの役目です。一覧表示は git をそのまま使います。
moai cc -w feat-login # ワークツリーで作業を開始 (なければ生成)
moai cc -w feat-login --spawn # 現在のセッションは残して新しい tmux ウィンドウで開く
git worktree list # ワークツリーの一覧moai cc と moai glm は選択したバックエンドで Claude Code を起動します。旧 CG 設定は起動前に移行が必要です。
moai cc [-p profile] [-- claude-args...]
moai glm [-p profile] [-- claude-args...]moai cg は廃止されました。Claude や GLM を起動せず、移行案内を表示して終了します。moai cc の別名ではありません。llm.team_mode: cg が残るプロジェクトでは、セッションを起動する前に移行先を明示的に選ぶ必要があります。 CG の廃止と設定の移行
3 つのランチコマンドが共通で対応するフラグです。
| フラグ | 説明 |
|---|---|
-p, --profile <name> | 名前付き Claude プロファイルを使用 |
--permission-mode <mode> | 権限モード (default, acceptEdits, plan, auto, bypassPermissions, dontAsk) |
-b, --bypass | --permission-mode bypassPermissions の短縮形 |
moai cc はさらに次のフラグに対応します。
| フラグ | 説明 |
|---|---|
-c, --continue | 以前のセッションを継続 |
-m, --model <model> | モデル選択の上書き |
--chrome / --no-chrome | Claude Code にそのまま渡します。ランチャーはどちらも自動では付けないため、--no-chrome を指定しない限り /chrome で接続できます |
auto権限モードは GLM (サードパーティプロバイダー) では使えません —moai ccでのみ対応します。
moai cc は次の順にセッションモデルを探し、最初に見つかった値を --model として Claude Code に渡します。
- 明示した
--model引数 - プロファイルのモデル (
moai profile setupで選んだ値) - 環境変数
ANTHROPIC_MODEL(今回の起動のみ) - プロジェクトの
.claude/settings.local.jsonのmodel(このプロジェクトのみ) - そのプロファイルのユーザースコープ
settings.jsonに/modelで保存した値 — 起動時にmodel: opus (user /model)のような 1 行で知らせます - 上記がすべて空なら何も渡しません。このときはプロジェクトの
.claude/settings.jsonのmodelピンがセッションモデルになり、ランチャーがその値と変更方法を表示します
より具体的で、より新しく直接指定したものが優先されます。3 番と 4 番は Claude Code 自身が適用するため、ランチャーは --model を渡さずに任せます。プロジェクト設定はユーザースコープ設定より優先されるため、5 番がないと /model で選んだモデルがプロジェクトのピンに隠れてしまいます。moai glm はこの規則に従いません。GLM ではモデルをスロットエイリアスで渡す必要があり、Anthropic アカウントで /model により選んだ値は別のモデル系列で、誤ったスロットにつながるためです。
| コマンド | 説明 |
|---|---|
moai glm setup <api-key> | GLM API キーの保存 |
moai glm status | 現在の GLM 資格情報状態を表示 |
moai glm tools | Z.AI MCP サーバーのツール管理 (有効/無効) |
現在のセッションに条件ベースの自律 goal ループを登録・照会・解除します。条件が満たされるまで毎ターン終了時に評価されます。
moai goal <COMMAND>| コマンド | 説明 |
|---|---|
moai goal arm <condition> | アクティブセッションに goal を登録・有効化 |
moai goal status | アクティブセッションの goal 状態を出力 |
moai goal clear | アクティブセッションの goal を解除 |
/clear 境界を越えてセッションを継続するための auto-resume ハンドオフ待機レコードを管理します。
moai handoff <COMMAND>| コマンド | 説明 |
|---|---|
moai handoff save | 貼り付け用 resume 本文を待機レコードとして保存 |
moai handoff clear | 待機ハンドオフレコードを削除 |
マルチセッションレース緩和のためのアクティブセッション調整レジストリを管理します。
moai session <COMMAND>| コマンド | 説明 |
|---|---|
moai session current | 現在のオーケストレーターセッション UUID を出力 |
moai session list | アクティブセッション一覧 (--filter-spec でフィルタリング可) |
moai session register <session_id> <spec_id> <phase> | レジストリにセッションを登録 |
moai session deregister <session_id> | レジストリからセッションを削除 (idempotent) |
moai session heartbeat <session_id> | セッションの last_heartbeat を更新 |
moai session purge | 古い項目を削除 (デフォルト: 最後の heartbeat から 30 分超過) |
moai session doctor | セッションレジストリが空である原因を診断 |
ブラウザベースの設定エディタ MoAI Web Console を起動します。
moai web [OPTIONS]| フラグ | 説明 |
|---|---|
--port <N> | 127.0.0.1 にバインドする TCP ポート (デフォルト: 3041) |
--no-open | ブラウザを自動で開かない |
--no-reuse | 古い moai インスタンスからポートを回収しない |
バージョン、コミットハッシュ、ビルド日付を表示します。
moai version
moai --version # 同じエージェントごとにモデルを割り当てていたかつてのパフォーマンスティアシステムは退きました。v3.2 からはサブエージェントがメインセッションのモデルと推論深度をそのまま引き継ぎます — spawn するとき model も effort も渡さず、MoAI のエージェント定義はどちらも宣言しません。モデルポリシーの席に残ったのはセッションレベルの選択 1 つです。moai profile setup のセッションモデルポリシーの質問は、このプロファイルで起動する Claude セッションの既定の推論強度(推論強度を別に選ばなかったときのフォールバック)を決めます。
| 旧値 | 現在の意味 |
|---|---|
| high | セッション effort フォールバック high |
| medium | セッション effort フォールバック medium |
| low | セッション effort フォールバック low |
# セッションモデルポリシーを含むプロファイル全体の設定
moai profile setup
# 退いたエージェント別フラグは廃止警告を出すだけで効果はありません
moai init my-project --model-policy highかつての --model-policy、--profile、--high、--medium-alias、--low フラグは廃止済みスタブです。値はスクリプト互換のために受け付けますが効果はなく、moai profile setup を案内する警告を出します。セッションレベルのモデル·effort 調節はモデルポリシーページ、マトリクスの退場はプロファイルマトリクスページを参照してください。