argos-cli

Operates the Argos CLI to inspect builds, review visual diffs, and manage flakiness.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Nadav011/nadavai-claude --skill argos-cli-nadav011
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argos-cli
Source: https://github.com/Nadav011/nadavai-claude/tree/main/plugins/nadavai/skills/argos-cli
Command: npx skills add https://github.com/Nadav011/nadavai-claude --skill argos-cli-nadav011

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running Argos visual-testing commands from a shell or CI pipeline fails silently when the wrong token type is used or when build references, change IDs, and project flags are mixed up. This Skill encodes the Argos CLI's token model, output contract, and full command map so agents and developers run commands correctly the first time. ## Core Features & Use Cases - Token model guidance: Distinguishes project tokens, personal access tokens (PAT), and CI tokens, with the exact resolution order (--token, ARGOS_TOKEN, argos login) per command group. - Full command map: Covers build inspection, snapshot diffs, reviews and reviewers, comments, test flakiness analysis, change ignore/unignore, project and team administration, automation rules, analytics, media management, and CI upload/finalize flows. - Output contract for agents: Mandates --json for parsing, documents the stderr error format and exit codes, and prohibits printing token values. - Use Case: A CI build shows unexpected visual diffs. Use this Skill to fetch build snapshots --needs-review --json with a project token, inspect each diff's change.id and flakiness metrics, then approve the build or ignore a recurring flaky change with a PAT. ## Quick Start Use the argos-cli skill to list the snapshots needing review on the latest Argos build and approve it if the diffs look intentional.

Frequently Asked Questions about argos-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an Argos build from the command line?

Inspect the build with a project token using `argos build snapshots <ref> --needs-review --json`, then submit a decision with a personal access token: `argos review create <ref> --token <pat> --event approve --json`. Use `--event reject --body "..."` for regressions.

How do I ignore a flaky visual test change in Argos?

Read each diff's `change.id` and `occurrences` from `argos build snapshots <ref> --json`, then run `argos change ignore <changeId> --token <pat> --project owner/project`. Ignored changes stop requiring review and are auto-approved on future builds; revert with `change unignore`.

What is the difference between an Argos project token and a personal access token?

Project tokens read build data (build get, snapshots, test list, change list) but cannot review, comment, ignore changes, or administer projects and teams. Those write and admin actions require a personal access token obtained via `argos login`.

Why does my Argos change or test command fail without --project?

A `changeId` carries no account context and a `testId` carries the project name but not the account, so every `change` and `test` command needs `--project owner/project` or `ARGOS_PROJECT`. The exception is test commands with a project token, which already identifies its project.

How do I upload screenshots to Argos in a CI pipeline?

Run `argos upload ./screenshots --token $ARGOS_TOKEN` with a CI or project token. For parallel builds, pass `--parallel-nonce`, `--parallel-index`, and `--parallel-total` on each upload, then call `argos finalize --parallel-nonce $ID`.

How do I get machine-readable output from Argos CLI commands?

Pass `--json` to any command; without it the CLI prints human-readable text. Errors go to stderr as `Error: <message>`, exit code 0 means success and 1 means failure, and list commands paginate up to `--limit` (default 100).