argos-cli

Argos CLI

任意のコマンドで正確なフラグを確認するには、argos <command> --help を実行してください。このスキルでは、--help では分からないトークンモデル、出力仕様、コマンド一覧のみを説明します。

出力仕様（エージェント）

• 標準出力を解析する場合は、必ず --json を指定してください。指定しない場合、コマンドは人間が読みやすいテキストを出力します。
• エラーは 標準エラー出力 に Error: <message> の形式で出力されます。終了コード 0 は成功、1 は失敗です。
• トークン値は絶対に出力しないでください。

認証

<buildReference> はビルド番号（例：72652）または完全なビルド URL です。番号を指定する場合は、--project owner/project を追加してください。URL にはすでにプロジェクトが含まれています。<changeId> はビルド参照ではありません。差分の change.id から取得し、アカウント情報を含まないため、すべての change コマンドで --project owner/project（または ARGOS_PROJECT）が必要です。<testId> は差分の test.id から取得し、プロジェクト名は含みますがアカウント情報は含まないため、プロジェクトトークンを使用する場合を除き、test コマンドでは同じ --project／ARGOS_PROJECT が必要です。プロジェクトトークンは、そのプロジェクトをすでに特定しています。project と automation コマンドには同じ --project owner/project が必要です。account コマンドには --account <slug>（または ARGOS_ACCOUNT）が必要です。

トークンは2種類あります。コマンドに応じて選択してください。

コマンド	トークン	解決順序
build get, build snapshots, test list, test get, test changes, change list, project get, project deployments, project domain get, media get, media list, media versions, media update, media delete	プロジェクトトークン	--token › ARGOS_TOKEN
review *, comment *, test comment *, media comment *, test subscribe / unsubscribe, build subscribe / unsubscribe, change ignore / unignore, account *, project update, project transfer, project contributor *, project domain set, automation *, analytics, create-project	個人用アクセストークン（PAT）	--token › ARGOS_TOKEN › argos login
upload, finalize, skip, deploy, media upload	CI／プロジェクトトークン	--token › ARGOS_TOKEN（またはトークンなしの CI）

プロジェクトトークンではビルドデータを読み取れますが、レビュー、コメント、変更の無視、プロジェクトやチームの管理はできません。これらには PAT が必要です。適切なトークンがない場合は、ユーザーに確認してください。これらの操作で PAT が存在しない場合は、操作を行わず、結論と根拠を報告してください。argos login は対話形式で利用する人間向けであり、CI 向けではありません。

コマンド

• 確認 — build get <ref> · build snapshots <ref> [--needs-review] [--metrics-period 24h|3d|7d|30d|90d] · build subscribe|unsubscribe <ref>
• レビュー — review list <ref> · review create <ref> --event <approve|reject|comment> [--body <md>] · review dismiss <ref> <reviewId> · review reviewer list <ref> · review reviewer add|remove <ref> <userId...>
• コメント — comment list <ref> · comment create <ref> --body <md> [--reply-to <id>] [--diff <id>] [--draft] · comment get|edit|delete|resolve|unresolve|subscribe|unsubscribe <ref> <id> · comment react|unreact <ref> <id> <emoji>
• 不安定さ — test list [--build-name <name>] [--search <q>] · test get <testId> · test changes <testId> [--ignored true|false] [--metrics-period …] · test subscribe|unsubscribe <testId> · change list · change ignore|unignore <changeId> --project owner/project
• テストコメント — test comment list|create <testId> · test comment get|edit|delete|resolve|unresolve|subscribe|unsubscribe <testId> <id> · test comment react|unreact <testId> <id> <emoji>
• プロジェクト — project get · project update [--name …] [--summary-check …] [--default-user-level …] [--ignore-changes true|false] [--deployments true|false] … · project transfer --to <slug> · project contributor list|set|remove · project deployments [--environment preview|production] · project domain get|set <domain>
• 自動化 — automation list [--active true|false] · automation get <ruleId> · automation create|update [<ruleId>] --definition-file <path> · automation deactivate <ruleId>
• チーム — account get · account update --default-user-level <member|contributor> · account member list|set-level|remove · account invite list|create|cancel|reset-link · account domain list|add|remove
• アカウント — analytics --account <slug> · create-project <name> --account <slug> · whoami
• メディア — media upload <files...> [--branch <b> | --pr <n>] [--state before|after] [--description <text>] [--visibility team|public] [--no-compress] · media list [--branch <b>] [--pr <n>] [--stage staged|published] [--search <q>] [--type image|video] · media get|delete|versions <mediaId> · media update <mediaId> [--name <n>] [--description <text>] [--branch <b>]
• メディアコメント — media comment list <mediaId> [--all]（デフォルトでは未解決のスレッド） · media comment create <mediaId> · media comment get|edit|delete|resolve|unresolve|subscribe|unsubscribe <mediaId> <id> · media comment react|unreact <mediaId> <id> <emoji>
• CI — upload <dir> · finalize · skip · deploy <dir>
• 認証 — login · logout

一覧表示コマンド（test list、change list、account member list、project contributor list、project deployments、automation list、account invite list）は、--limit（デフォルトは100）までページネーションをたどります。

build snapshots --json は各差分に test.metrics（不安定さの指標： stability、consistency、flakiness。いずれも0～1）を追加し、変更がある場合は change（id、ignored、occurrences）も含めます。occurrences や flakiness の値が高い変更は無視する価値があることを示します。その変更の change.id を change ignore に渡してください。

よく使う操作

ビルドをレビューします（プロジェクトトークンで確認し、PAT で判断します）。

ARGOS_TOKEN=<project-token> argos build snapshots <ref> --needs-review --json
argos review create <ref> --token <pat> --event approve --json
# regression: argos review create <ref> --token <pat> --event reject --body "..."

不安定な変更を無視します（プロジェクトトークンで確認し、PAT で無視します）。 無視した変更はレビューが不要になり、今後のビルドで自動承認されます。

ARGOS_TOKEN=<project-token> argos build snapshots <ref> --json   # read each diff's change.id + occurrences
argos change ignore <changeId> --token <pat> --project owner/project
# revert: argos change unignore <changeId> --token <pat> --project owner/project

プロジェクトの不安定性のバックログに取り組みます。test list はプロジェクトで現在実行中のテストを不安定な順に返すため、最初のページにあるテストから安定化します。change list では、すでに無視された変更を確認できます。

ARGOS_TOKEN=<project-token> argos test list --project owner/project --json --limit 20
ARGOS_TOKEN=<project-token> argos change list --project owner/project --json   # already ignored

不安定なテストを診断してから、修正するか無視するかを判断します。test get は不安定さの度合いを報告します。test changes は、頻度の高い順に個別の変更を一覧表示し、それぞれの差分、ベースライン、確認用のヘッド画像 URL を示します。

ARGOS_TOKEN=<project-token> argos test get <testId> --json          # flakiness, stability, consistency, series
ARGOS_TOKEN=<project-token> argos test changes <testId> --json      # occurrences + diff/base/head URLs per change
# a change with occurrences > 1 that nothing in the UI explains is flaky:
argos change ignore <changeId> --token <pat> --project owner/project

CI でスクリーンショットをアップロードします。

argos upload ./screenshots --token $ARGOS_TOKEN

並列ビルド：

argos upload ./screenshots --parallel-nonce $ID --parallel-index $i --parallel-total $n
argos finalize --parallel-nonce $ID

チームとプロジェクトにメンバーを追加します。チームのロールは account から、プロジェクトごとのアクセス権は project contributor から設定します。オーナーとメンバーはすでにすべてのプロジェクトにアクセスできるため、アクセス権の付与が必要なのはコントリビューターだけです。

argos account invite create [email protected] --account acme --level contributor --json
argos account member list --account acme --search dev --json          # read back user.id once they accept
argos project contributor set <userId> --level reviewer --project acme/web --json

プロジェクトを設定します。project update は指定した設定のみを変更し、変更後のプロジェクトを表示するため、設定結果を確認できます。

argos project get --project acme/web --json
argos project update --project acme/web --summary-check auto --ignore-changes true --auto-ignore-after 3 --json

ビルドのレビューを依頼してから、対応が必要な人が誰かを確認します。

argos review reviewer add <ref> <userId> --token <pat> --project acme/web
argos review reviewer list <ref> --token <pat> --project acme/web --json