avr-cli 0.7.0__py3-none-win_amd64.whl

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-vm-resume.1

@@ -0,0 +1,50 @@
+.TH AVR\-VM\-RESUME 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-resume \- Resume a PAUSED VM from its preserved snapshot.
+.SH SYNOPSIS
+.B avr vm resume
+[OPTIONS] VM_ID_OR_NAME
+.SH DESCRIPTION
+Resume a PAUSED VM from its preserved snapshot.
+.PP
+The existing password remains unless resume withdraws credentials supplied to a scoped token. Use update --rotate-password to obtain a fresh one. If a memory restore cannot complete, retry with --discard-memory to boot the preserved disk without restoring running processes.
+.SH ARGUMENTS
+.TP
+\fIVM_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-discard\-memory\fR
+Ignore saved memory state and fresh-boot the preserved disk (recovery for a stuck memory restore).
+.TP
+\fB\-\-wait\fR
+Wait until the VM is RUNNING and connectable.
+.TP
+\fB\-\-wait\-timeout\fR \fIINTEGER\fR
+Seconds to wait when --wait is set. (default: 300)
+.TP
+\fB\-\-json\fR
+Emit the raw API response as JSON.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-update (1),
+.BR avr-vm-usage (1),
+.BR avr-vm-vnc (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-vm-rotate-https-label.1

@@ -0,0 +1,41 @@
+.TH AVR\-VM\-ROTATE\-HTTPS\-LABEL 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-rotate-https-label \- Replace public HTTPS URLs to invalidate leaked URLs.
+.SH SYNOPSIS
+.B avr vm rotate-https-label
+[OPTIONS] VM_ID_OR_NAME
+.SH DESCRIPTION
+Replace public HTTPS URLs to invalidate leaked URLs.
+.PP
+Routes change once ingress applies the rotation. On a running VM, AVREA_SANDBOX_URL (in new login shells) and /vm/info follow within seconds; a paused VM picks up the new URLs at resume.
+.SH ARGUMENTS
+.TP
+\fIVM_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-json\fR
+Emit the updated VM as JSON.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-update (1),
+.BR avr-vm-usage (1),
+.BR avr-vm-vnc (1)

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

@@ -0,0 +1,40 @@
+.TH AVR\-VM\-SHOW 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-show \- Show a VM's details, including connection endpoints and egress rules.
+.SH SYNOPSIS
+.B avr vm show
+[OPTIONS] VM_ID_OR_NAME
+.SH DESCRIPTION
+Show a VM's details, including connection endpoints and egress rules.
+.PP
+.SH ARGUMENTS
+.TP
+\fIVM_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-json\fR
+Emit the full VM record (with egress rules) as JSON.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-update (1),
+.BR avr-vm-usage (1),
+.BR avr-vm-vnc (1)

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

@@ -0,0 +1,61 @@
+.TH AVR\-VM\-SSH\-CONFIG 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-ssh-config \- Print (or --append) an ssh_config Host block for a RUNNING VM.
+.SH SYNOPSIS
+.B avr vm ssh-config
+[OPTIONS] VM_ID_OR_NAME
+.SH DESCRIPTION
+Print (or --append) an ssh_config Host block for a RUNNING VM.
+.PP
+Reach the VM with plain `ssh`, scp/rsync, and VS Code / Cursor Remote-SSH, host key pinned, without wrapping each tool. Redirect it yourself:
+.PP
+avr vm ssh-config cvm-abc123 >> ~/.ssh/config
+.PP
+or let --append manage the block for you (idempotent — re-run after a resume to refresh the endpoint in place):
+.PP
+avr vm ssh-config cvm-abc123 --append
+.PP
+The block references a dedicated known_hosts file that this command writes the pinned host key into (one entry per VM). If the endpoint publishes no host key, the block falls back to accept-new (trust-on-first-use) and a warning is printed.
+.SH ARGUMENTS
+.TP
+\fIVM_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-i\fR, \fB\-\-identity\fR \fIPATH\fR
+IdentityFile to write into the block.
+.TP
+\fB\-\-host\-alias\fR \fITEXT\fR
+Host alias for the block (default: avr-<vm-id>).
+.TP
+\fB\-\-known\-hosts\-file\fR \fIPATH\fR
+Where to pin the host key (default: ~/.ssh/avr_known_hosts).
+.TP
+\fB\-\-append\fR
+Write the block into your SSH config (default: ~/.ssh/config) instead of printing it, replacing any prior block for the same alias in place.
+.TP
+\fB\-\-config\-file\fR \fIPATH\fR
+SSH config file for --append (default: ~/.ssh/config).
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-update (1),
+.BR avr-vm-usage (1),
+.BR avr-vm-vnc (1)

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

@@ -0,0 +1,63 @@
+.TH AVR\-VM\-SSH 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-ssh \- Open an SSH session to a RUNNING VM, or run a command on it.
+.SH SYNOPSIS
+.B avr vm ssh
+[OPTIONS] VM_ID_OR_NAME [SSH_ARGS]...
+.SH DESCRIPTION
+Open an SSH session to a RUNNING VM, or run a command on it.
+.PP
+With no extra arguments this opens an interactive session. Anything after `--` is run as a remote command instead, e.g.:
+.PP
+avr vm ssh cvm-abc123 -- uname -a
+.PP
+A one-off `-- <cmd>` runs in a non-login shell that sources no startup files, so it won't see env forwarded by `avr vm bootstrap`. Pass `--login` to run it in a login shell instead (e.g. so `claude` finds its subscription token):
+.PP
+avr vm ssh cvm-abc123 --login -- claude -p 'summarize the repo'
+.PP
+Pass `--session <name>` to attach to (or create) a persistent tmux session, so the shell and any long-running process in it survive a dropped connection; reconnect with the same name to resume where you left off. A `-- <cmd>` given with --session runs only when the session is first created; reattaching to an existing session resumes it and does not rerun the command.
+.PP
+When the VM's endpoint publishes a host key it is pinned, so the first connect neither prompts nor is spoofable. If the endpoint has no host key, `avr` prints a warning and falls back to trust-on-first-use, so this spoofing protection is conditional rather than guaranteed. For port-forwarding use `avr vm port-forward`.
+.SH ARGUMENTS
+.TP
+\fIVM_ID\fR
+\&
+.TP
+[\fISSH_ARGS...\fR]
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-i\fR, \fB\-\-identity\fR \fIPATH\fR
+Private key file to pass to ssh as -i.
+.TP
+\fB\-\-session\fR \fITEXT\fR
+Attach to (or create) a persistent tmux session by this name, so the shell and any long-running process in it survive a dropped connection. Reconnect with the same --session. A `-- <cmd>` runs only when the session is created, not on reattach.
+.TP
+\fB\-\-login\fR
+Run the `-- <cmd>` in a login shell (bash -lc) so it sees bootstrap-forwarded env like CLAUDE_CODE_OAUTH_TOKEN. Needed for a non-interactive command; a plain `ssh host cmd` shell sources nothing.
+.TP
+\fB\-\-print\fR
+Print the ssh command instead of running it.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-update (1),
+.BR avr-vm-usage (1),
+.BR avr-vm-vnc (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-vm-update.1

@@ -0,0 +1,62 @@
+.TH AVR\-VM\-UPDATE 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-update \- Update a VM's name, TTL, or SSH keys, or rotate its password.
+.SH SYNOPSIS
+.B avr vm update
+[OPTIONS] VM_ID_OR_NAME
+.SH DESCRIPTION
+Update a VM's name, TTL, or SSH keys, or rotate its password.
+.PP
+Use avr vm pause, avr vm resume, or avr vm delete for lifecycle changes.
+.SH ARGUMENTS
+.TP
+\fIVM_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-name\fR \fITEXT\fR
+New display name.
+.TP
+\fB\-\-ttl\fR \fITEXT\fR
+Extend the TTL window from now (e.g. 8h, 7d). Max 7d.
+.TP
+\fB\-\-ssh\-key\fR \fITEXT\fR
+Replace stored SSH public keys (literal or @path). Repeatable. Applies live on a RUNNING VM, otherwise at next resume. (repeatable)
+.TP
+\fB\-\-rotate\-password\fR
+Provision a fresh one-time password (returned in the response).
+.TP
+\fB\-\-egress\-rules\fR \fITEXT\fR
+Replace the per-VM egress rules with this JSON array (or @path to a file).
+.TP
+\fB\-\-json\fR
+Emit the raw API response as JSON.
+.TP
+\fB\-\-https\-port\fR \fIINTEGER RANGE\fR
+Replace public HTTPS ports. Repeatable; applies live on a RUNNING VM, otherwise at next start or resume. (repeatable)
+.TP
+\fB\-\-clear\-https\-ports\fR
+Publish no HTTPS ports. Applies live on a RUNNING VM, otherwise at next start or resume.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-usage (1),
+.BR avr-vm-vnc (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-vm-usage.1

@@ -0,0 +1,43 @@
+.TH AVR\-VM\-USAGE 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-usage \- Show usage metering (runtime / vCPU / memory seconds) per VM.
+.SH SYNOPSIS
+.B avr vm usage
+[OPTIONS]
+.SH DESCRIPTION
+Show usage metering (runtime / vCPU / memory seconds) per VM.
+.PP
+Each power-on cycle's window is clipped to the requested period and summed. Deleted VMs are included: usage survives deletion.
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-start\fR \fIDATETIME\fR
+Inclusive period start (default: 30 days ago).
+.TP
+\fB\-\-end\fR \fIDATETIME\fR
+Exclusive period end (default: now).
+.TP
+\fB\-\-json\fR
+Emit the usage report as JSON.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-update (1),
+.BR avr-vm-vnc (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-vm-vnc.1

@@ -0,0 +1,50 @@
+.TH AVR\-VM\-VNC 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm-vnc \- Open a VNC desktop on a macOS VM (Screen Sharing) over an SSH tunnel.
+.SH SYNOPSIS
+.B avr vm vnc
+[OPTIONS] VM_ID_OR_NAME
+.SH DESCRIPTION
+Open a VNC desktop on a macOS VM (Screen Sharing) over an SSH tunnel.
+.PP
+Forwards a local port to the guest's Screen Sharing service (:5900) through the VM's SSH endpoint, so the desktop is never exposed publicly. Holds the tunnel open until Ctrl-C; pass --launch to also open Screen Sharing.
+.SH ARGUMENTS
+.TP
+\fIVM_ID\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-local\-port\fR \fIINTEGER RANGE\fR
+Local port to bind (default: an unused port).
+.TP
+\fB\-i\fR, \fB\-\-identity\fR \fIPATH\fR
+Private key file to pass to ssh as -i.
+.TP
+\fB\-\-launch\fR / \fB\-\-no\-launch\fR
+Also start a local VNC client (macOS Screen Sharing), instead of just printing the connect command.
+.TP
+\fB\-\-print\fR
+Print the tunnel and client commands and exit, without opening the tunnel.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-vm (1),
+.BR avr-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-update (1),
+.BR avr-vm-usage (1)

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

@@ -0,0 +1,104 @@
+.TH AVR\-VM 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-vm \- Manage long-running VMs (SSH/RDP/VNC).
+.SH SYNOPSIS
+.B avr vm
+[OPTIONS] COMMAND [ARGS]...
+.SH DESCRIPTION
+Manage long-running VMs (SSH/RDP/VNC).
+.PP
+.SH COMMANDS
+.TP
+bootstrap
+Set up a RUNNING VM with your dev essentials over SSH.
+.TP
+capabilities
+List available operating systems, architectures, sizes, and quotas.
+.TP
+create
+Create a long-running VM.
+.TP
+delete
+Delete a VM.
+.TP
+fork
+Boot a copy of a PAUSED VM's disk; the source remains paused.
+.TP
+list
+List the organization's VMs, newest first (deleted ones excluded).
+.TP
+metrics
+Show CPU/memory/IO metrics for a VM's current or last run.
+.TP
+pause
+Pause a RUNNING Linux x86_64 VM while preserving its disk.
+.TP
+port-forward
+Forward one or more local ports to TCP ports on the VM over SSH.
+.TP
+rdp
+Open an RDP desktop on a Windows or Linux VM over an SSH tunnel.
+.TP
+resume
+Resume a PAUSED VM from its preserved snapshot.
+.TP
+rotate-https-label
+Replace public HTTPS URLs to invalidate leaked URLs.
+.TP
+show
+Show a VM's details, including connection endpoints and egress rules.
+.TP
+ssh
+Open an SSH session to a RUNNING VM, or run a command on it.
+.TP
+ssh-config
+Print (or --append) an ssh_config Host block for a RUNNING VM.
+.TP
+update
+Update a VM's name, TTL, or SSH keys, or rotate its password.
+.TP
+usage
+Show usage metering (runtime / vCPU / memory seconds) per VM.
+.TP
+vnc
+Open a VNC desktop on a macOS VM (Screen Sharing) over an SSH tunnel.
+.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-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-vm-bootstrap (1),
+.BR avr-vm-capabilities (1),
+.BR avr-vm-create (1),
+.BR avr-vm-delete (1),
+.BR avr-vm-fork (1),
+.BR avr-vm-list (1),
+.BR avr-vm-metrics (1),
+.BR avr-vm-pause (1),
+.BR avr-vm-port-forward (1),
+.BR avr-vm-rdp (1),
+.BR avr-vm-resume (1),
+.BR avr-vm-rotate-https-label (1),
+.BR avr-vm-show (1),
+.BR avr-vm-ssh (1),
+.BR avr-vm-ssh-config (1),
+.BR avr-vm-update (1),
+.BR avr-vm-usage (1),
+.BR avr-vm-vnc (1)

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

@@ -0,0 +1,52 @@
+.TH AVR\-WORKFLOW\-LIST 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-workflow-list \- List workflows with aggregate run stats.
+.SH SYNOPSIS
+.B avr workflow list
+[OPTIONS]
+.SH DESCRIPTION
+List workflows with aggregate run stats.
+.PP
+.RS 4
+.nf
+Examples:
+    avr workflow list
+    avr workflow list --repo acme/web
+    avr workflow list --since 7d
+    avr workflow list --limit 5
+    avr workflow list --since all
+    avr workflow list --json name,runs,median_duration_seconds
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    completed_runs, failure_count, flaked_count, median_duration_seconds, name,
+    path, platform_workflow_id, repository, runs, workflow_id
+.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 ID, repeatable). (repeatable)
+.TP
+\fB\-\-since\fR \fITEXT\fR
+Time window: '30d', '7d', '24h', or 'all'. (default: 30d)
+.TP
+\fB\-L\fR, \fB\-\-limit\fR \fIINTEGER RANGE\fR
+Max workflows to show. (default: 20)
+.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-workflow (1),
+.BR avr-workflow-run (1),
+.BR avr-workflow-view (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-workflow-run.1

@@ -0,0 +1,60 @@
+.TH AVR\-WORKFLOW\-RUN 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-workflow-run \- Trigger a workflow_dispatch event.
+.SH SYNOPSIS
+.B avr workflow run
+[OPTIONS] WORKFLOW
+.SH DESCRIPTION
+Trigger a workflow_dispatch event.
+.PP
+WORKFLOW can be an Avrea workflow ID (wfl-... or awf-...), a GitHub numeric workflow ID, a workflow path, or the workflow's display name. Bare filenames (build.yml) select GitHub Actions; use the full .avrea/workflows/build.yml path for Avrea CI.
+.PP
+Native -f inputs use the workflow's declared types. JSON preserves booleans and numbers. A receipt identifies the exact native run. If a response is lost, use the printed retry command to recover the same invocation with its resolved ref, inputs and --idempotency-key. --no-watch prints the accepted ref and commit plus a command to resume following a pending native dispatch.
+.PP
+.RS 4
+.nf
+Examples:
+    avr workflow run build.yml
+    avr workflow run "Build and Deploy" --ref feat/x
+    avr workflow run wfl-abc123 -f env=prod -f region=eu
+    echo '{"env":"prod"}' | avr workflow run build.yml --json
+    avr workflow run build.yml --watch --exit-status
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIWORKFLOW_IDENTIFIER\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository (org/repo or rep-xxx). Auto-detected from git remote if omitted.
+.TP
+\fB\-r\fR, \fB\-\-ref\fR \fITEXT\fR
+Branch or tag to run at. Defaults to the repository's default branch.
+.TP
+\fB\-f\fR, \fB\-\-raw\-field\fR \fITEXT\fR
+Workflow input: key=value (repeatable). (repeatable)
+.TP
+\fB\-\-json\fR
+Read a JSON object of inputs from stdin.
+.TP
+\fB\-\-idempotency\-key\fR \fIUUID\fR
+For Avrea CI, reuse this key to retry the same invocation.
+.TP
+\fB\-w\fR, \fB\-\-watch\fR / \fB\-W\fR, \fB\-\-no\-watch\fR
+Poll for the new run and watch it until completion. Pass --no-watch / -W to return immediately. (default: True)
+.TP
+\fB\-\-exit\-status\fR
+With --watch, exit non-zero if the run failed.
+.TP
+\fB\-\-interval\fR \fIINTEGER\fR
+With --watch, refresh interval in seconds. (default: 3)
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-workflow (1),
+.BR avr-workflow-list (1),
+.BR avr-workflow-view (1)

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

@@ -0,0 +1,59 @@
+.TH AVR\-WORKFLOW\-VIEW 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-workflow-view \- View a workflow with aggregate stats and per-job breakdown.
+.SH SYNOPSIS
+.B avr workflow view
+[OPTIONS] WORKFLOW
+.SH DESCRIPTION
+View a workflow with aggregate stats and per-job breakdown.
+.PP
+WORKFLOW can be an Avrea workflow ID (wfl-...), a GitHub numeric workflow ID (the integer in the GH URL), a workflow filename (build.yml), or the workflow's display name. All forms except wfl-... need a repository — pass --repo or run from inside the repo's git checkout.
+.PP
+.RS 4
+.nf
+Examples:
+    avr workflow view wfl-abc123
+    avr workflow view 200589168
+    avr workflow view ci.yml
+    avr workflow view "Build and Deploy" --since 7d
+    avr workflow view ci --json runs,median_duration_seconds
+    avr workflow view wfl-abc123 --json '*' --jq '.jobs[].job.name'
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    completed_runs, failure_count, flaked_count, jobs, median_duration_seconds,
+    name, p95_duration_seconds, path, platform_workflow_id, repository, runs,
+    workflow_id
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIWORKFLOW_IDENTIFIER\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository (org/repo or rep-xxx). Auto-detected from git remote when WORKFLOW is a filename or display name.
+.TP
+\fB\-\-since\fR \fITEXT\fR
+Time window: '30d', '7d', '24h', or 'all'. (default: 30d)
+.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.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-workflow (1),
+.BR avr-workflow-list (1),
+.BR avr-workflow-run (1)