CLI リファレンス
MoAI-ADK コマンドラインインターフェースのすべてのコマンドとオプションを参照します。
コマンド一覧
moai --help出力例:
MoAI-ADK - Agentic Development Kit for Claude Code
Usage:
moai [command]
Available Commands:
init Interactive project setup (auto-detects language/framework/methodology)
doctor System health diagnosis and environment verification
status Project status summary including Git branch, quality metrics, etc.
update Update to the latest version (with automatic rollback support)
worktree Manage Git worktrees for parallel SPEC development
hook Claude Code hook dispatcher
glm Switch to GLM backend (cost-effective) or update API key
claude Switch to Claude backend (Anthropic API)
version Display version, commit hash, and build date
Flags:
-h, --help help for moai
-v, --version version for moai| コマンド | 説明 |
|---|---|
moai init | プロジェクトを初期化 (言語/フレームワーク/メソドロジー自動検出) |
moai doctor | システム診断および環境検証 |
moai status | プロジェクトステータス概要 (Git ブランチ、品質メトリクスなど) |
moai update | 最新バージョンに更新 (自動ロールバックサポート) |
moai worktree | Git worktree を管理 (並列 SPEC 開発) |
moai hook | Claude Code フックディスパッチャー |
moai glm | GLM バックエンドに切り替え (--team: GLM Worker モード) |
moai claude, moai cc | Claude バックエンドに切り替え |
moai cg | CG モードを有効化 — Claude リーダー + GLM チームメイト (tmux 必須) |
moai version | バージョン、コミットハッシュ、ビルド日付を表示 |
moai init
プロジェクトを初期化します。
moai init [PATH] [OPTIONS]オプション
| オプション | 説明 |
|---|---|
-y, --non-interactive | 非対話モード (デフォルトを使用) |
--mode [personal|team] | プロジェクトモード |
--locale [ko|en|ja|zh] | 優先言語 (デフォルト: en) |
--language TEXT | プログラミング言語 (指定すると自動検出) |
--force | 確認なしで強制再初期化 |
例
# 新しいプロジェクトを初期化
moai init my-project
# 韓国語、チームモード
moai init my-project --locale ko --mode team
# Python プロジェクト
moai init --language pythonmoai update
MoAI-ADK を最新バージョンに更新します。
moai update [OPTIONS]オプション
| オプション | 説明 |
|---|---|
--path PATH | プロジェクトパス (デフォルト: 現在のディレクトリ) |
--force | バックアップなしで強制更新 |
--check | バージョンのみ確認 (更新なし) |
--project | プロジェクトテンプレートのみ同期 |
--templates-only | テンプレートのみ同期 (パッケージアップグレードをスキップ) |
--yes | 自動確認 (CI/CD モード) |
-c, --config | プロジェクト設定を編集 (初期セットアップウィザードと同じ) |
--merge | 自動マージ (ユーザー変更を保持) |
--manual | 手動マージ (ガイドを作成) |
例
# 更新を確認
moai update --check
# 強制更新
moai update --force
# 自動マージ
moai update --merge重要: --force オプションはバックアップを作成しません。ユーザー変更が失われる可能性があります。
moai doctor
システム診断を実行します。
moai doctor [OPTIONS]オプション
| オプション | 説明 |
|---|---|
-v, --verbose | 詳細なツールバージョンと言語検出を表示 |
--fix | 欠落しているツールの修正を提案 |
--export PATH | JSON ファイルにエクスポート |
--check TEXT | 特定のツールのみ確認 |
--check-commands | スラッシュコマンドの読み込み問題を診断 |
--shell | シェルと PATH 設定を診断 (WSL/Linux) |
例
# 完全な診断
moai doctor
# 詳細な診断
moai doctor --verbose
# 修正を提案
moai doctor --fixmoai glm
GLM バックエンドに切り替えるか、API キーを更新します。
moai glm [OPTIONS] [API_KEY]オプション
| オプション | 説明 |
|---|---|
--team | GLM Worker モードを開始 (Opus リーダー + GLM-5 チームメンバー) |
--help | ヘルプを表示 |
使用方法
# GLM バックエンドに切り替え
moai glm
# API キーを更新
moai glm <api-key>
# GLM Worker モードを開始 (コスト効率の良いチーム開発)
moai glm --team
# z.ai から API キーを取得
# https://z.ai/subscribe?ic=1NDV03BGWUプロファイルベースログイン (v2.7.0+)
moai glm、moai cc、moai cg は永続プロファイルをサポートするログインコマンドになりました。プロファイルは ~/.moai/claude-profiles/ に保存されます。
- 初回実行時にインタラクティブなプロファイル設定ウィザードを提供
- プロファイルはセッション間で永続化
moai glmからmoai cgへの切り替え時に GLM 設定を自動リセット
GLM Worker モード
--team オプションを使用すると、コスト効率の良い GLM Worker モードが開始されます:
- 構成: Opus モデルのリーダーエージェント + GLM-5 モデルのチームメンバーエージェント
- 利点: Claude と比べて 70% のコスト削減、同等のパフォーマンス
- 用途: 大規模なチームベース開発時のトークンコスト最適化
moai claude
Claude バックエンド (Anthropic API) に切り替えます。
$ moai claude
# または省略形
$ moai ccmoai cg
CG モード (Claude + GLM ハイブリッド) を有効にします。リーダーは Claude API を、チームメイトは GLM API を使用し、tmux セッションレベルの環境変数分離で実装されています。
moai cgv2.7.1 の変更: CG モードがデフォルトのチームモードになりました。--team 使用時、設定変更なしで CG モードで実行されます。
動作原理
- GLM 設定を tmux セッション環境に注入
- settings から GLM 環境を削除 — リーダーペインは Claude API を使用
CLAUDE_CODE_TEAMMATE_DISPLAY=tmuxを設定 — チームメイトは新しいペインで GLM 環境を継承
使用方法
# 1. GLM API キーを保存 (初回のみ)
moai glm sk-your-glm-api-key
# 2. CG モードを有効化 (tmux 内で実行)
moai cg
# 3. 同じペインで Claude Code を開始
claude
# 4. チームワークフローを実行
/moai --team "タスクの説明"注意事項
| 項目 | 説明 |
|---|---|
| tmux 必須 | tmux セッション内で実行する必要があります。VS Code ターミナルのデフォルトを tmux に設定すると便利です。 |
| リーダー開始位置 | moai cg を実行した同じペインで Claude Code を開始する必要があります。 |
| セッション終了 | session_end フックが自動的に tmux セッション環境をクリアします。 |
モード比較
| コマンド | リーダー | ワーカー | tmux 必須 | コスト削減 | 用途 |
|---|---|---|---|---|---|
moai cc | Claude | Claude | 不要 | - | 最高品質 |
moai glm | GLM | GLM | 推奨 | ~70% | コスト最適化 |
moai cg | Claude | GLM | 必須 | ~60% | 品質 + コストバランス |
ディスプレイモード
| モード | 説明 | 通信 | リーダー/ワーカー分離 |
|---|---|---|---|
in-process | デフォルトモード | SendMessage | 同じ環境 |
tmux | 分割ペイン表示 | SendMessage | セッション環境分離 |
注意: CG モードは tmux ディスプレイモードでのみリーダー/ワーカー API 分離をサポートします。
moai status
プロジェクトステータスを確認します。
moai status出力例:
╭────── Project Status ──────╮
│ Mode personal │
│ Locale unknown │
│ SPECs 1 │
│ Branch main │
│ Git Status Modified │
╰────────────────────────────╯出力情報:
- Mode: 作業モード (personal、team、manual)
- Locale: 言語設定
- SPECs: アクティブな SPEC の数
- Branch: 現在のブランチ
- Git Status: Git ステータス (Clean、Modified)
moai worktree
並列 SPEC 開発のための Git worktree を管理します。
moai worktree [OPTIONS] COMMAND [ARGS]...サブコマンド
| コマンド | 説明 |
|---|---|
moai worktree new | 新しい worktree を作成 |
moai worktree list | アクティブな worktree を一覧表示 |
moai worktree switch | worktree に切り替え |
moai worktree go | worktree ディレクトリに移動 |
moai worktree sync | アップストリームと同期 |
moai worktree remove | worktree を削除 |
moai worktree clean | 古い worktree をクリーンアップ |
moai worktree recover | 既存のディレクトリから復元 |
moai worktree new
新しい worktree を作成します。
moai worktree new [OPTIONS] SPEC_IDオプション
| オプション | 説明 |
|---|---|
-b, --branch TEXT | ユーザーブランチ名 |
--base TEXT | ベースブランチ (デフォルト: main) |
--repo PATH | リポジトリパス |
--worktree-root PATH | worktree ルートパス |
-f, --force | 存在していても強制作成 |
--glm | GLM LLM 設定を使用 |
--llm-config PATH | ユーザー LLM 設定ファイルパス |
例
# SPEC-001 の worktree を作成
moai worktree new SPEC-001
# ユーザーブランチを指定
moai worktree new SPEC-001 --branch feature-auth
# ベースブランチを変更
moai worktree new SPEC-001 --base developmoai worktree list
アクティブな worktree を一覧表示します。
moai worktree list [OPTIONS]オプション
| オプション | 説明 |
|---|---|
--format [table|json] | 出力形式 |
--repo PATH | リポジトリパス |
--worktree-root PATH | worktree ルートパス |
moai worktree remove
worktree を削除します。
moai worktree remove [OPTIONS] SPEC_IDオプション
| オプション | 説明 |
|---|---|
-f, --force | コミットされていない変更を強制削除 |
--repo PATH | リポジトリパス |
--worktree-root PATH | worktree ルートパス |
worktree ワークフロー
moai hook
MoAI-ADK イベント用の Claude Code フックディスパッチャー。
moai hook <event>サポートされるイベント (16)
| イベント | 説明 |
|---|---|
PreToolUse | ツール実行前 |
PostToolUse | ツール実行後 |
Notification | システム通知 |
Stop | セッション終了 |
SubagentStop | サブエージェント終了 |
UserPromptSubmit | ユーザープロンプト送信 |
PreCompact | コンテキスト圧縮前 |
PostCompact | コンテキスト圧縮後 |
PermissionRequest | 権限リクエスト |
PostToolFailure | ツール実行失敗後 |
SubagentStart | サブエージェント開始 |
TeammateIdle | チームメイトアイドル状態 |
TaskCompleted | タスク完了 |
WorktreeCreate | ワークツリー作成 |
WorktreeRemove | ワークツリー削除 |
model | モデル選択 |
例
# PreToolUse フックを実行
moai hook PreToolUse
# PostToolUse フックを実行
moai hook PostToolUse
# ユーザープロンプト送信フック
moai hook UserPromptSubmitタスクメトリクスロギング
MoAI-ADK は開発セッション中に Task ツールメトリクスを自動的にキャプチャします。
ログファイル
- 場所:
.moai/logs/task-metrics.jsonl - 形式: JSONL (JSON Lines)
キャプチャメトリクス
| メトリクス | 説明 |
|---|---|
| トークン使用量 | 入力/出力トークン数 |
| ツール呼び出し | 使用されたツールのリストと呼び出し回数 |
| 所要時間 | タスク実行時間 |
| エージェントタイプ | 実行されたエージェントの種類 |
活用方法
- セッション分析とパフォーマンス最適化
- エージェント効率の分析
- トークン消費の追跡とコスト管理
Task ツール完了時に PostToolUse フックがメトリクスを自動的にロギングします。
モデルポリシー設定
MoAI-ADK は Claude Code サブスクリプションプランに基づいてエージェントに最適な AI モデルを割り当てます。
ポリシーティア
| ポリシー | プラン | 🟣 Opus | 🔵 Sonnet | 🟡 Haiku |
|---|---|---|---|---|
| High | Max $200/月 | 23 | 1 | 4 |
| Medium | Max $100/月 | 4 | 19 | 5 |
| Low | Plus $20/月 | 0 | 12 | 16 |
設定方法
# プロジェクト初期化時 (対話型ウィザード)
moai init my-project
# 既存プロジェクトの再設定
moai update -c
# 手動設定 (.moai/config/sections/user.yaml)
# model_policy: high | medium | low注意: デフォルトポリシーは
Highです。moai update実行後、moai update -cで設定を構成してください。
環境変数
| 変数 | 説明 |
|---|---|
MOAI_API_KEY | API キー (Claude/GLM) |
MOAI_MODE | 実行モード (development/production) |
MOAI_LOCALE | 言語設定 (ko/en/ja/zh) |
MOAI_WORKTREE_ROOT | worktree ルートパス |
関連項目
Last updated on