avr-cli 0.7.0__py3-none-win_amd64.whl

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-firewall-flow-summaries.1

@@ -0,0 +1,47 @@
+.TH AVR\-FIREWALL\-FLOW\-SUMMARIES 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-firewall-flow-summaries \- Show per-VM network activity summaries captured at VM stop.
+.SH SYNOPSIS
+.B avr firewall flow-summaries
+[OPTIONS]
+.SH DESCRIPTION
+Show per-VM network activity summaries captured at VM stop.
+.PP
+Each row is the totals + top-N destinations for one VM run. The Blocked column counts both per-rule packet drops and DNS queries the firewall refused to resolve. Use ``--with-drops`` to triage what the firewall blocked after editing a rule or ``--job`` to include every execution attempt for a job.
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository ID. (required)
+.TP
+\fB\-\-job\fR, \fB\-\-job\-id\fR \fITEXT\fR
+Filter to every VM execution attempt for a job ID.
+.TP
+\fB\-\-with\-drops\fR
+Show only summaries where the firewall blocked at least one flow.
+.TP
+\fB\-L\fR, \fB\-\-limit\fR \fIINTEGER RANGE\fR
+Max summaries to return. (default: 20)
+.TP
+\fB\-\-offset\fR \fIINTEGER RANGE\fR
+Number of summaries to skip. (default: 0)
+.TP
+\fB\-\-from\fR, \fB\-\-start\-after\fR \fITEXT\fR
+Only include summaries that started at or after this ISO-8601 timestamp.
+.TP
+\fB\-\-to\fR, \fB\-\-end\-before\fR \fITEXT\fR
+Only include summaries that ended at or before this ISO-8601 timestamp.
+.TP
+\fB\-\-json\fR
+Emit raw JSON instead of a table.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-firewall (1),
+.BR avr-firewall-add (1),
+.BR avr-firewall-delete (1),
+.BR avr-firewall-list (1),
+.BR avr-firewall-move (1),
+.BR avr-firewall-set-default (1),
+.BR avr-firewall-show (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-firewall-list.1

@@ -0,0 +1,28 @@
+.TH AVR\-FIREWALL\-LIST 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-firewall-list \- List egress firewall rules for the given scope.
+.SH SYNOPSIS
+.B avr firewall list
+[OPTIONS]
+.SH DESCRIPTION
+List egress firewall rules for the given scope.
+.PP
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository ID. If provided, shows the repo-level list.
+.TP
+\fB\-\-json\fR
+Output rules as JSON instead of a table.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-firewall (1),
+.BR avr-firewall-add (1),
+.BR avr-firewall-delete (1),
+.BR avr-firewall-flow-summaries (1),
+.BR avr-firewall-move (1),
+.BR avr-firewall-set-default (1),
+.BR avr-firewall-show (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-firewall-move.1

@@ -0,0 +1,32 @@
+.TH AVR\-FIREWALL\-MOVE 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-firewall-move \- Move a rule to a new position (rewrites the full ordering atomically).
+.SH SYNOPSIS
+.B avr firewall move
+[OPTIONS] RULE_ID
+.SH DESCRIPTION
+Move a rule to a new position (rewrites the full ordering atomically).
+.PP
+.SH ARGUMENTS
+.TP
+\fIRULE_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-to\fR \fIINTEGER\fR
+Target 0-indexed position. (required)
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository ID. If provided, moves a repo-level rule.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-firewall (1),
+.BR avr-firewall-add (1),
+.BR avr-firewall-delete (1),
+.BR avr-firewall-flow-summaries (1),
+.BR avr-firewall-list (1),
+.BR avr-firewall-set-default (1),
+.BR avr-firewall-show (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-firewall-set-default.1

@@ -0,0 +1,28 @@
+.TH AVR\-FIREWALL\-SET\-DEFAULT 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-firewall-set-default \- Set (or replace) the catch-all (default) rule for the scope.
+.SH SYNOPSIS
+.B avr firewall set-default
+[OPTIONS]
+.SH DESCRIPTION
+Set (or replace) the catch-all (default) rule for the scope.
+.PP
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository ID. If provided, sets the repo-level default.
+.TP
+\fB\-\-action\fR \fICHOICE\fR
+(choices: allow, deny; required)
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-firewall (1),
+.BR avr-firewall-add (1),
+.BR avr-firewall-delete (1),
+.BR avr-firewall-flow-summaries (1),
+.BR avr-firewall-list (1),
+.BR avr-firewall-move (1),
+.BR avr-firewall-show (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-firewall-show.1

@@ -0,0 +1,28 @@
+.TH AVR\-FIREWALL\-SHOW 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-firewall-show \- Show the resolved (merged) firewall rule list for a repository.
+.SH SYNOPSIS
+.B avr firewall show
+[OPTIONS]
+.SH DESCRIPTION
+Show the resolved (merged) firewall rule list for a repository.
+.PP
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository ID. (required)
+.TP
+\fB\-\-json\fR
+Output resolved rules as JSON instead of a table.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-firewall (1),
+.BR avr-firewall-add (1),
+.BR avr-firewall-delete (1),
+.BR avr-firewall-flow-summaries (1),
+.BR avr-firewall-list (1),
+.BR avr-firewall-move (1),
+.BR avr-firewall-set-default (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-firewall.1

@@ -0,0 +1,60 @@
+.TH AVR\-FIREWALL 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-firewall \- Manage the egress firewall rule list for orgs and repositories.
+.SH SYNOPSIS
+.B avr firewall
+[OPTIONS] COMMAND [ARGS]...
+.SH DESCRIPTION
+Manage the egress firewall rule list for orgs and repositories.
+.PP
+.SH COMMANDS
+.TP
+add
+Add a rule.
+.TP
+delete
+Delete a rule by ID.
+.TP
+flow-summaries
+Show per-VM network activity summaries captured at VM stop.
+.TP
+list
+List egress firewall rules for the given scope.
+.TP
+move
+Move a rule to a new position (rewrites the full ordering atomically).
+.TP
+set-default
+Set (or replace) the catch-all (default) rule for the scope.
+.TP
+show
+Show the resolved (merged) firewall rule list for a repository.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-artifact (1),
+.BR avr-status (1),
+.BR avr-run (1),
+.BR avr-pr (1),
+.BR avr-job (1),
+.BR avr-vm (1),
+.BR avr-workflow (1),
+.BR avr-cache (1),
+.BR avr-tests (1),
+.BR avr-sbom (1),
+.BR avr-log (1),
+.BR avr-auth (1),
+.BR avr-token (1),
+.BR avr-config (1),
+.BR avr-settings (1),
+.BR avr-billing (1),
+.BR avr-audit-events (1),
+.BR avr-repo (1),
+.BR avr-org (1),
+.BR avr-health (1),
+.BR avr-firewall-add (1),
+.BR avr-firewall-delete (1),
+.BR avr-firewall-flow-summaries (1),
+.BR avr-firewall-list (1),
+.BR avr-firewall-move (1),
+.BR avr-firewall-set-default (1),
+.BR avr-firewall-show (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-health.1

@@ -0,0 +1,46 @@
+.TH AVR\-HEALTH 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-health \- Check Avrea platform status.
+.SH SYNOPSIS
+.B avr health
+[OPTIONS]
+.SH DESCRIPTION
+Check Avrea platform status.
+.PP
+.RS 4
+.nf
+Examples:
+    avr health
+    avr health --json status
+    avr health --json '*' -q '.status'
+.fi
+.RE
+.SH OPTIONS
+.TP
+\fB\-\-json\fR \fITEXT\fR
+Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
+.TP
+\fB\-q\fR, \fB\-\-jq\fR \fITEXT\fR
+Filter --json output through a jq expression.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-artifact (1),
+.BR avr-status (1),
+.BR avr-run (1),
+.BR avr-pr (1),
+.BR avr-job (1),
+.BR avr-vm (1),
+.BR avr-workflow (1),
+.BR avr-cache (1),
+.BR avr-tests (1),
+.BR avr-sbom (1),
+.BR avr-log (1),
+.BR avr-auth (1),
+.BR avr-token (1),
+.BR avr-config (1),
+.BR avr-settings (1),
+.BR avr-firewall (1),
+.BR avr-billing (1),
+.BR avr-audit-events (1),
+.BR avr-repo (1),
+.BR avr-org (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-job-list.1

@@ -0,0 +1,77 @@
+.TH AVR\-JOB\-LIST 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-job-list \- List jobs for an organization.
+.SH SYNOPSIS
+.B avr job list
+[OPTIONS]
+.SH DESCRIPTION
+List jobs for an organization.
+.PP
+.RS 4
+.nf
+Examples:
+    avr job list
+    avr job list --status failure --limit 5
+    avr job list --status in_progress --json job_name,state,conclusion
+    avr job list --since 24h
+    avr job list --json '?'           # list available fields
+    avr job list --json '*'           # all fields
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    ci_provider, run_id, completed_at, conclusion, created_at, duration_seconds, platform_job_id,
+    platform_run_id, platform, job_id, job_name, labels, repository, repository_id,
+    running_on_avrea, started_at, state
+.fi
+.RE
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Filter by repository (org/repo or rep-xxx). Pass --repo more than once to filter multiple repositories. Auto-detected from git remote if omitted. (repeatable)
+.TP
+\fB\-\-name\fR \fITEXT\fR
+Filter by job name (repeatable). (repeatable)
+.TP
+\fB\-\-status\fR \fICHOICE\fR
+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)
+.TP
+\fB\-\-on\-avrea\fR / \fB\-\-shadowing\fR
+Filter by Avrea-run vs shadowing jobs.
+.TP
+\fB\-\-ci\-provider\fR \fICHOICE\fR
+Filter by CI engine. (choices: github_actions, gitlab_ci, avrea_ci)
+.TP
+\fB\-w\fR, \fB\-\-workflow\fR \fITEXT\fR
+Filter by workflow ID (wfl- or awf-, repeatable). (repeatable)
+.TP
+\fB\-\-since\fR \fITEXT\fR
+Relative time window: '7d', '24h', etc.
+.TP
+\fB\-L\fR, \fB\-\-limit\fR \fIINTEGER RANGE\fR
+Max jobs to return. (default: 20)
+.TP
+\fB\-\-cursor\fR \fITEXT\fR
+Pagination cursor from a previous response.
+.TP
+\fB\-\-order\fR \fICHOICE\fR
+Sort order. (choices: created_at.desc, created_at.asc; default: created_at.desc)
+.TP
+\fB\-\-json\fR \fITEXT\fR
+Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
+.TP
+\fB\-q\fR, \fB\-\-jq\fR \fITEXT\fR
+Filter --json output through a jq expression.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-job (1),
+.BR avr-job-logs (1),
+.BR avr-job-metrics (1),
+.BR avr-job-ssh (1),
+.BR avr-job-view (1),
+.BR avr-job-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-job-logs.1

@@ -0,0 +1,52 @@
+.TH AVR\-JOB\-LOGS 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-job-logs \- View logs for a job, grouped by step.
+.SH SYNOPSIS
+.B avr job logs
+[OPTIONS] JOB_ID
+.SH DESCRIPTION
+View logs for a job, grouped by step.
+.PP
+.RS 4
+.nf
+Examples:
+    avr job logs job-abc123
+    avr job logs job-abc123 --failed
+    avr job logs job-abc123 --step "Build" --level error
+    avr job logs job-abc123 --follow
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIJOB_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-failed\fR
+Only show logs from failed steps.
+.TP
+\fB\-\-step\fR \fITEXT\fR
+Filter to a specific step by name.
+.TP
+\fB\-\-level\fR \fICHOICE\fR
+Filter by log level. (choices: debug, info, notice, warning, error)
+.TP
+\fB\-\-follow\fR, \fB\-f\fR
+Follow logs for in-progress jobs.
+.TP
+\fB\-\-all\-levels\fR
+Include diagnostic-level lines (hidden by default).
+.TP
+\fB\-\-no\-pager\fR
+Print directly to stdout instead of paging through `less`. Same as setting AVR_PAGER=''.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-job (1),
+.BR avr-job-list (1),
+.BR avr-job-metrics (1),
+.BR avr-job-ssh (1),
+.BR avr-job-view (1),
+.BR avr-job-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-job-metrics.1

@@ -0,0 +1,48 @@
+.TH AVR\-JOB\-METRICS 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-job-metrics \- Show CPU/memory/IO gauges for a job's VM.
+.SH SYNOPSIS
+.B avr job metrics
+[OPTIONS] JOB_ID
+.SH DESCRIPTION
+Show CPU/memory/IO gauges for a job's VM.
+.PP
+.RS 4
+.nf
+Examples:
+    avr job metrics job-abc123
+    avr job metrics job-abc123 --source cpu --source network
+    avr job metrics job-abc123 --watch
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIJOB_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-source\fR \fICHOICE\fR
+Metric source (repeatable). Defaults to cpu and memory. (choices: cpu, memory, filesystem, load, disk-io, disk-ops, network; repeatable)
+.TP
+\fB\-\-start\fR \fIINTEGER\fR
+Start time (Unix seconds). Single-shot only; defaults to execution start.
+.TP
+\fB\-\-end\fR \fIINTEGER\fR
+End time (Unix seconds). Single-shot only; defaults to execution end or now.
+.TP
+\fB\-w\fR, \fB\-\-watch\fR
+Stream live metrics until completion (Ctrl-C to exit).
+.TP
+\fB\-\-json\fR
+Output raw metrics responses as JSON.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-job (1),
+.BR avr-job-list (1),
+.BR avr-job-logs (1),
+.BR avr-job-ssh (1),
+.BR avr-job-view (1),
+.BR avr-job-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-job-ssh.1

@@ -0,0 +1,28 @@
+.TH AVR\-JOB\-SSH 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-job-ssh \- SSH into a running job's VM.
+.SH SYNOPSIS
+.B avr job ssh
+[OPTIONS] JOB_ID
+.SH DESCRIPTION
+SSH into a running job's VM.
+.PP
+.SH ARGUMENTS
+.TP
+\fIJOB_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-print\-command\fR
+Print the SSH command instead of connecting.
+.TP
+\fB\-\-show\-password\fR
+Display the SSH password (use with caution).
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-job (1),
+.BR avr-job-list (1),
+.BR avr-job-logs (1),
+.BR avr-job-metrics (1),
+.BR avr-job-view (1),
+.BR avr-job-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-job-view.1

@@ -0,0 +1,61 @@
+.TH AVR\-JOB\-VIEW 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-job-view \- View a single job with its steps.
+.SH SYNOPSIS
+.B avr job view
+[OPTIONS] JOB_ID
+.SH DESCRIPTION
+View a single job with its steps.
+.PP
+.RS 4
+.nf
+Examples:
+    avr job view job-abc123
+    avr job view job-abc123 --log-failed
+    avr job view job-abc123 --json conclusion,steps
+    avr job view job-abc123 --json '*' --jq '.steps[] | select(.conclusion=="failure")'
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    ci_provider, run_id, completed_at, conclusion, created_at, duration_seconds, platform_job_id,
+    platform_run_id, platform, job_id, job_name, labels, repository, repository_id,
+    running_on_avrea, started_at, state, steps, workflow_run
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIJOB_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-log\fR
+Print full logs for the job.
+.TP
+\fB\-\-log\-failed\fR
+Print logs only for failed steps.
+.TP
+\fB\-\-json\fR \fITEXT\fR
+Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
+.TP
+\fB\-q\fR, \fB\-\-jq\fR \fITEXT\fR
+Filter --json output through a jq expression.
+.TP
+\fB\-\-web\fR
+Open in browser.
+.TP
+\fB\-\-no\-pager\fR
+Print logs directly to stdout instead of paging through `less`. Same as setting AVR_PAGER=''.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-job (1),
+.BR avr-job-list (1),
+.BR avr-job-logs (1),
+.BR avr-job-metrics (1),
+.BR avr-job-ssh (1),
+.BR avr-job-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-job-watch.1

@@ -0,0 +1,33 @@
+.TH AVR\-JOB\-WATCH 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-job-watch \- Watch active jobs with auto-refresh (Ctrl+C to stop).
+.SH SYNOPSIS
+.B avr job watch
+[OPTIONS]
+.SH DESCRIPTION
+Watch active jobs with auto-refresh (Ctrl+C to stop).
+.PP
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Filter by repository (org/repo or rep-xxx). Pass --repo more than once to filter multiple repositories. Auto-detected from git remote if omitted. (repeatable)
+.TP
+\fB\-\-name\fR \fITEXT\fR
+Filter by job name (repeatable). (repeatable)
+.TP
+\fB\-\-interval\fR \fIINTEGER\fR
+Refresh interval in seconds. (default: 5)
+.TP
+\fB\-\-ndjson\fR
+Emit one JSON object per refresh (default when stdout isn't a TTY).
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-job (1),
+.BR avr-job-list (1),
+.BR avr-job-logs (1),
+.BR avr-job-metrics (1),
+.BR avr-job-ssh (1),
+.BR avr-job-view (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-job.1

@@ -0,0 +1,56 @@
+.TH AVR\-JOB 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-job \- Inspect Avrea job VMs (SSH, metrics, logs).
+.SH SYNOPSIS
+.B avr job
+[OPTIONS] COMMAND [ARGS]...
+.SH DESCRIPTION
+Inspect Avrea job VMs (SSH, metrics, logs).
+.PP
+.SH COMMANDS
+.TP
+list
+List jobs for an organization.
+.TP
+logs
+View logs for a job, grouped by step.
+.TP
+metrics
+Show CPU/memory/IO gauges for a job's VM.
+.TP
+ssh
+SSH into a running job's VM.
+.TP
+view
+View a single job with its steps.
+.TP
+watch
+Watch active jobs with auto-refresh (Ctrl+C to stop).
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-artifact (1),
+.BR avr-status (1),
+.BR avr-run (1),
+.BR avr-pr (1),
+.BR avr-vm (1),
+.BR avr-workflow (1),
+.BR avr-cache (1),
+.BR avr-tests (1),
+.BR avr-sbom (1),
+.BR avr-log (1),
+.BR avr-auth (1),
+.BR avr-token (1),
+.BR avr-config (1),
+.BR avr-settings (1),
+.BR avr-firewall (1),
+.BR avr-billing (1),
+.BR avr-audit-events (1),
+.BR avr-repo (1),
+.BR avr-org (1),
+.BR avr-health (1),
+.BR avr-job-list (1),
+.BR avr-job-logs (1),
+.BR avr-job-metrics (1),
+.BR avr-job-ssh (1),
+.BR avr-job-view (1),
+.BR avr-job-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-log-search.1

@@ -0,0 +1,59 @@
+.TH AVR\-LOG\-SEARCH 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-log-search \- Search logs for a repository.
+.SH SYNOPSIS
+.B avr log search
+[OPTIONS]
+.SH DESCRIPTION
+Search logs for a repository.
+.PP
+Performs full-text search when --query is provided, otherwise returns logs sorted by line number. Results are filtered to logs from repositories you have access to.
+.PP
+.RS 4
+.nf
+Examples:
+    avr log search --repo acme/web --query "error"
+    avr log search --repo rep-abc123 --level error --limit 50
+    avr log search --repo rep-abc123 --vm-id vm-xyz --stream stderr
+    avr log search --repo rep-abc123 --query "OOM" --json content,timestamp,vm_id
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    content, group_name, id, level, line_number, repository_id, score,
+    step_name, step_record_id, stream, timestamp, vm_id
+.fi
+.RE
+.SH OPTIONS
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository (org/repo or rep-xxx). Auto-detected from git remote if omitted.
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified.
+.TP
+\fB\-\-query\fR \fITEXT\fR
+Full-text search query
+.TP
+\fB\-\-stream\fR \fICHOICE\fR
+Filter by output stream (choices: stdout, stderr)
+.TP
+\fB\-\-level\fR \fICHOICE\fR
+Filter by log level (choices: debug, info, warning, error)
+.TP
+\fB\-\-vm\-id\fR \fITEXT\fR
+Filter by execution/VM ID
+.TP
+\fB\-L\fR, \fB\-\-limit\fR \fIINTEGER\fR
+Maximum results to return (default: 100)
+.TP
+\fB\-\-json\fR \fITEXT\fR
+Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
+.TP
+\fB\-q\fR, \fB\-\-jq\fR \fITEXT\fR
+Filter --json output through a jq expression.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-log (1)