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