# avr run View and manage GitHub workflow runs. ```sh avr run [OPTIONS] COMMAND [ARGS]... ``` ## Subcommands ### `avr run cancel` Cancel an in-progress or queued workflow run. ```sh avr run cancel [OPTIONS] RUN_ID ``` ```sh Examples: avr run cancel run-abc123 avr run cancel run-abc123 --yes ``` **Arguments** - RUN_ID **Options** - --org <TEXT> — Organization ID. - -y, --yes — Skip the confirmation prompt. ### `avr run list` List workflow runs for an organization. ```sh avr run list [OPTIONS] ``` ```sh Examples: avr run list avr run list --status failure --limit 5 avr run list --status in_progress --json status,conclusion,head_branch avr run list --branch main --status completed avr run list --since 24h avr run list --json '?' # list available fields avr run list --json '*' # all fields avr run list --json status,conclusion -q '[.[] | select(.status == "completed")]' ``` ```sh JSON FIELDS conclusion, created_at, display_title, duration_seconds, event, head_branch, head_sha, platform_run_id, repository, run_attempt, run_id, run_number, status, triggering_actor, updated_at, workflow, workflow_id ``` **Options** - --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org). - --repo <TEXT> — Filter by repository (org/repo or rep-xxx, repeatable). Auto-detected from git remote if omitted. _(repeatable)_ - --status <CHOICE> — Filter by state (queued, in_progress, completed) or conclusion (success, failure, ...). Repeatable. _(choices: `action_required`, `cancelled`, `completed`, `failure`, `in_progress`, `neutral`, `queued`, `skipped`, `stale`, `startup_failure`, `success`, `timed_out` · repeatable)_ - --branch <TEXT> — Filter by head branch (repeatable). _(repeatable)_ - -w, --workflow <TEXT> — Filter by workflow ID (wfl-xxx, repeatable). _(repeatable)_ - --since <TEXT> — Relative time window: '7d', '24h', etc. Sugar for --created-after. - --from, --created-after <TEXT> — Only runs created after this ISO timestamp. - --to, --created-before <TEXT> — Only runs created before this ISO timestamp. - -L, --limit <INTEGER RANGE> — Max runs to return. _(default: `20`)_ - --cursor <TEXT> — Pagination cursor from a previous response. - --order <CHOICE> — Sort order. _(choices: `created_at.desc`, `created_at.asc` · default: `created_at.desc`)_ - --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields. - -q, --jq <TEXT> — Filter --json output through a jq expression. - --web — Open in browser. ### `avr run logs` Fetch logs for a workflow run's GitHub jobs. ```sh avr run logs [OPTIONS] RUN_ID ``` Long-form alternative to `avr run view --log[-failed]`. Use --follow to tail logs in real time for an in-progress job; pass --job to scope to a specific job when a run has many. ```sh Examples: avr run logs run-abc123 avr run logs run-abc123 --failed avr run logs run-abc123 --job test avr run logs run-abc123 --follow ``` **Arguments** - RUN_ID **Options** - --org <TEXT> — Organization ID. - --job <TEXT> — Restrict to GitHub jobs whose name contains this string. - -f, --follow — Tail logs as they appear (running jobs only). - --failed — Show only logs from failed jobs. - --all-levels — Include diagnostic-level lines (off by default). - --no-pager — Print directly to stdout instead of paging through `less`. Same as setting AVR_PAGER=''. ### `avr run rerun` Re-run a completed workflow run. ```sh avr run rerun [OPTIONS] RUN_ID ``` ```sh Examples: avr run rerun run-abc123 avr run rerun run-abc123 --failed avr run rerun run-abc123 --yes ``` **Arguments** - RUN_ID **Options** - --org <TEXT> — Organization ID. - --failed — Re-run only the failed jobs. - -y, --yes — Skip the confirmation prompt. ### `avr run view` View a workflow run with its jobs. ```sh avr run view [OPTIONS] [RUN_ID] ``` ```sh Without RUN_ID, shows 10 most recent runs. ``` ```sh Examples: avr run view avr run view run-abc123 avr run view run-abc123 --steps avr run view run-abc123 --log-failed avr run view run-abc123 --job Build avr run view run-abc123 --json conclusion,jobs avr run view run-abc123 --json '*' --jq '.jobs[].job_name' ``` ```sh JSON FIELDS conclusion, created_at, display_title, duration_seconds, event, head_branch, head_sha, jobs, platform_run_id, repository, run_attempt, run_id, run_number, status, triggering_actor, updated_at, workflow, workflow_id ``` **Arguments** - [RUN_ID] **Options** - --org <TEXT> — Organization ID. - --steps — Expand each job to show its individual steps. - --log — Print full logs for all jobs. - --log-failed — Print logs only for failed steps. - --job <TEXT> — Restrict view and logs to jobs whose name contains this string. - --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields. - -q, --jq <TEXT> — Filter --json output through a jq expression. - --web — Open in browser. - --no-pager — Print logs directly to stdout instead of paging through `less`. Same as setting AVR_PAGER=''. ### `avr run watch` Watch a workflow run until it completes. ```sh avr run watch [OPTIONS] [RUN_ID] ``` ```sh Without RUN_ID, auto-selects the latest in-progress run. Pass --repo (repeatable) to scope the auto-select to specific repositories. ``` ```sh Examples: avr run watch avr run watch --repo avrea-com/avrea-core avr run watch --repo a/x --repo b/y avr run watch run-abc123 --exit-status avr run watch run-abc123 --ndjson | jq -c . ``` **Arguments** - [RUN_ID] **Options** - --org <TEXT> — Organization ID. - --repo <TEXT> — Scope the auto-select to a repo (org/name or rep-xxx, repeatable). Auto-detected from git remote if omitted. _(repeatable)_ - --exit-status — Exit non-zero if run failed. - --interval <INTEGER> — Refresh interval in seconds. _(default: `3`)_ - --ndjson — Force NDJSON event stream (default when stdout isn't a TTY).