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