CLI コマンドリファレンス
すべてのトップレベル Multiflow CLI コマンドを 1 ページにまとめた概要です。完全な使い方は `multiflow <command> --help` を実行してください。
Multiflow CLI は、Web UI でできるほぼすべての操作をそのまま提供します（イシューの作成、エージェントの割り当て、デーモンの起動など）。このページでは、すべてのトップレベルコマンドを 1 行の説明とともに一覧します。フラグや例の完全な一覧は multiflow <command> --help を実行してください。
認証する
CLI を初めて使うときにこのコマンドを実行して、**パーソナルアクセストークン（PAT）**を取得します。
multiflow loginブラウザが自動的に開きます。Web アプリで承認すると、CLI が PAT（mul_ プレフィックス付き）を ~/.multica/config.json に保存します。これ以降のすべてのコマンドはこの PAT で認証されます。
CI やヘッドレス環境では、ブラウザフローをスキップできます。Web アプリの Settings → Personal Access Tokens で PAT を作成し、multiflow login --token <mul_...> で直接渡してください。
トークンの種類による違いについては、認証とトークンを参照してください。
認証とセットアップ
| コマンド | 用途 |
|---|---|
multiflow login | ログインして PAT を保存 |
multiflow auth status | 現在のログイン状態、ユーザー、ワークスペースを表示 |
multiflow auth logout | ローカルの PAT を削除 |
multiflow setup cloud | Multiflow Cloud のワンショットセットアップ（ログイン + デーモンのインストール） |
multiflow setup self-host | セルフホストバックエンドのワンショットセットアップ |
ワークスペースとメンバー
| コマンド | 用途 |
|---|---|
multiflow workspace list | アクセスできるすべてのワークスペースを一覧 |
multiflow workspace create --name "..." --slug "..." [--issue-prefix "..."] [--description "..."] [--context "..."] | ワークスペースを作成（作成者が owner になります）。--name と --slug は必須で、slug は作成後に変更できません。現在のワークスペースは切り替わりません。 |
multiflow workspace get <slug> | 1 つのワークスペースの詳細を表示 |
multiflow workspace member list | 現在のワークスペースのメンバーを一覧 |
multiflow workspace update <id> --name "..." [--description "..."] [--context "..."] [--issue-prefix "..."] | ワークスペースのメタデータを更新（admin/owner）。長いフィールドは --description-stdin / --context-stdin を使用できます。 |
イシューとプロジェクト
list 系のコマンド（multiflow issue list、autopilot list、project list など）は、デフォルトで短くそのままコピー＆ペーストできる ID を出力します。イシューは MUL-123 のようなイシューキー、それ以外のリソースは短い UUID プレフィックスです。以下の後続コマンドの <id> 引数は短い ID と完全な UUID のどちらも受け取るため、一般的な流れは multiflow issue list → キーをコピー → multiflow issue get MUL-123 となります。正式な UUID が必要なときは list コマンドに --full-id を渡してください。
| コマンド | 用途 |
|---|---|
multiflow issue list | イシューを一覧（コピー＆ペーストできるイシューキーを出力） |
multiflow issue get <id> | 単一のイシューを表示（イシューキーまたは UUID を受け取る） |
multiflow issue create --title "..." | 新しいイシューを作成 |
multiflow issue update <id> ... | イシューを更新（ステータス、優先度、担当者など） |
multiflow issue assign <id> --to <name> | メンバー、エージェント、またはスクワッドに割り当て（エージェントへの割り当ては実行をトリガー） |
multiflow issue status <id> <status> | ステータス変更のショートカット |
multiflow issue search <query> | キーワード検索 |
multiflow issue children <id> | サブイシューを stage ごとに一覧 |
multiflow issue pull-requests <id> | 紐付いた pull request と状態を一覧 |
multiflow issue runs <id> | イシュー上のエージェント実行を表示 |
multiflow issue run-messages <task-id> | 1 回の実行メッセージを表示 |
multiflow issue usage <id> | イシュー単位の集計 token 使用量を表示 |
multiflow issue rerun <id> | イシューの現在のエージェント担当者向けに新しいタスクを再キューイング |
multiflow issue cancel-task <task-id> | キュー中または実行中のタスクをキャンセル |
multiflow issue comment <id> ... | ネスト: コメントの表示 / 投稿 |
multiflow issue comment resolve/unresolve <comment-id> | コメントスレッドを解決済み / 未解決にする |
multiflow issue subscriber <id> ... | ネスト: 購読 / 購読解除 |
multiflow issue metadata <id> ... | ネスト: イシューメタデータの読み書き |
multiflow issue label <id> ... | ネスト: イシューのラベルを管理 |
multiflow project list/get/create/update/delete/status | プロジェクトの CRUD |
multiflow label list/create/update/delete | ワークスペースラベルの CRUD |
エージェントとスキル
| コマンド | 用途 |
|---|---|
multiflow agent list | ワークスペースのエージェントを一覧 |
multiflow agent get <slug> | エージェントの構成を表示 |
multiflow agent create ... | エージェントを作成 |
multiflow agent update <slug> ... | エージェントを更新 |
multiflow agent archive <slug> | アーカイブ |
multiflow agent restore <slug> | アーカイブ済みのエージェントを復元 |
multiflow agent tasks <slug> | エージェントのタスク履歴を表示 |
multiflow agent avatar <slug> | エージェントのアバターをアップロード |
multiflow agent env <slug> ... | エージェントの custom environment variables を読み取り / 置換 |
multiflow agent skills ... | ネスト: スキルのアタッチ / デタッチ |
multiflow skill list/get/create/update/delete | スキルの CRUD |
multiflow skill import ... | GitHub、ClawHub、またはローカルマシンからスキルをインポート |
multiflow skill files ... | ネスト: スキルのファイルを管理 |
スキルインポートの競合
multiflow skill import --url <url> の既定値は --on-conflict fail です。同じ名前のスキルがすでに存在する場合、コマンドは構造化された conflict 結果で終了し、ワークスペースは変更されません。
既存スキルの作成者で、スキル ID とエージェントの紐付けを維持したまま内容を置き換える場合は --on-conflict overwrite を使います。既存スキルを残してコピーを取り込む場合は --on-conflict rename を使うと、-2 のような接尾辞が自動で付きます。同名の項目を単に飛ばす場合は --on-conflict skip を使います。
multiflow skill import --url https://skills.sh/acme/repo/review-helper
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict overwrite
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict rename
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict skipスクワッド
| コマンド | 用途 |
|---|---|
multiflow squad list | ワークスペースのスクワッドを一覧 |
multiflow squad get <id> | 単一のスクワッドを表示 |
multiflow squad create --name "..." --leader <agent> | スクワッドを作成（owner / admin） |
multiflow squad update <id> ... | 名前、説明、指示、リーダー、またはアバターを更新 |
multiflow squad delete <id> | アーカイブ（ソフト削除） — 割り当て済みのイシューをリーダーに移管 |
multiflow squad member list/add/remove <squad-id> | スクワッドメンバーを管理 |
multiflow squad activity <issue-id> <action|no_action|failed> --reason "..." | スクワッドリーダーエージェントがターンごとに評価を記録するために使用 |
完全なモデルについてはスクワッドを参照してください。
オートパイロット
| コマンド | 用途 |
|---|---|
multiflow autopilot list | ワークスペースのすべてのオートパイロットを一覧 |
multiflow autopilot get <id> | 単一のオートパイロットを表示 |
multiflow autopilot create ... | オートパイロットを作成 |
multiflow autopilot update <id> ... | 更新 |
multiflow autopilot delete <id> | 削除 |
multiflow autopilot runs <id> | 実行履歴を表示 |
multiflow autopilot trigger <id> | 手動で実行をトリガー |
multiflow autopilot trigger-add/update/delete <id> | schedule または webhook trigger を管理 |
multiflow autopilot trigger-rotate-url <id> <trigger-id> | webhook trigger URL をローテート |
multiflow autopilot create/update は、create_issue モードの autopilot が作成するイシューの既定購読者を設定する --subscriber も受け取ります。update では --clear-subscribers で削除できます。
デーモンとランタイム
| コマンド | 用途 |
|---|---|
multiflow daemon start | デーモンを起動（デフォルトはバックグラウンド。--foreground を追加するとフォアグラウンドで実行） |
multiflow daemon stop | デーモンを停止 |
multiflow daemon restart | デーモンを再起動 |
multiflow daemon status | デーモンがオンラインかどうかと同時実行数を確認 |
multiflow daemon logs | デーモンのログを表示 |
multiflow runtime list | 現在のワークスペースのランタイムを一覧 |
multiflow runtime usage | リソース使用量を表示 |
multiflow runtime activity | 最近のアクティビティログ |
multiflow runtime update <id> ... | ランタイム上で CLI 更新を開始 |
multiflow runtime delete <id> [--cascade] | ランタイムを削除し、必要なら紐付くエージェントもアーカイブ |
multiflow runtime profile ... | カスタム runtime profile とローカルパス上書きを管理 |
その他
| コマンド | 用途 |
|---|---|
multiflow repo checkout <url> | エージェントが使用できるようにリポジトリをローカルにクローン |
multiflow config | ローカルの CLI 構成を表示または編集 |
multiflow version | CLI のバージョンを出力 |
multiflow update | CLI を最新のリリースにアップグレード |
multiflow attachment download <id> | イシューまたはコメントから添付ファイルをダウンロード |
完全なフラグを確認する
すべてのコマンドが --help をサポートしています。
multiflow issue create --help
multiflow agent update --helpv2 では、各コマンドごとに専用の詳細なリファレンスページを提供する予定です。
次のステップ
- 認証とトークン — PAT vs. JWT vs. デーモントークン
- デーモンとランタイム —
daemonコマンドが内部でどう動作するか - エージェントの作成と構成 —
multiflow agent createのすべてのオプション