# rzv command reference

The commands in rzv 0.19.0, grouped by what they act on. Every command accepts --json and --help.

## Workspaces and access

- rzv workspaces list shows the workspaces you belong to. rzv workspaces select \<slug or id\> chooses one for later commands. rzv workspaces create --slug \<slug\> --name \<name\> creates and selects a workspace. rzv accounts is an older alias for workspaces.
- rzv workspaces settings show|update reads or changes the workspace name and logo. rzv workspaces members list|role|remove and rzv workspaces invitations list|invite|resend|revoke|teams|accept manage people.
- rzv teams list|show|create|rename|permissions|add-member|remove-member|delete manages teams. rzv permissions shows your permissions and the permission catalogue.
- rzv workspaces closures list|request|cancel asks staff to close a workspace, or withdraws the request. Nothing is deleted immediately.

## Jobs, runners and usage

- rzv jobs list, rzv jobs get \<job-id\> and rzv jobs status \<job-id\> read the selected workspace's jobs. Status is an alias for get. rzv jobs logs \<job-id\> prints a job's log text.
- rzv insights summary, rzv insights heatmap and rzv insights slow-jobs show job and minute totals, queue activity by UTC hour, and the slowest workflows.
- rzv usage reads recorded billable minutes. rzv concurrency shows the concurrent-job limit and jobs running now. rzv runner-profiles \<repository-id\> and rzv runners \<repository-id\> show the runner labels a repository can use.

## GitHub

- rzv github status and rzv github installations show linked GitHub App installations. rzv repositories list shows the repositories they cover.
- Run rzv github connect to start linking an installation. Complete the link with rzv github authorize --state \<state\> --installation-id \<id\> --github-client-id \<id\>. GitHub prompts for its own authorization when needed.

## Billing

- rzv billing shows the minute balance, packs, and checkout availability. rzv billing purchases shows recent minute-pack orders, and rzv billing invoices lists receipts and invoices.
- rzv billing checkout --pack \<id\> --operation-id \<id\> starts a card checkout, and rzv billing portal prints a link to the payment provider's billing portal. Card checkout is available only for workspaces billed in Canada or the United States.
- rzv billing auto-recharge, rzv billing country and rzv billing codes redeem --code-file \<path\> read or change auto-recharge, the billing country, and redeem a promo code or prepaid voucher.

## API keys

- rzv api-keys list, rzv api-keys create --name \<name\> --scopes \<scope,...\> --idempotency-key \<key\>, rzv api-keys rename \<key-id\> --name \<name\>, and rzv api-keys revoke \<key-id\> manage workspace API keys. Use --permissions \<p,...\> instead of --scopes for fine-grained permissions.
- A new key's secret appears once at creation. Keys expire after 365 days unless --expires-at is earlier. API-key management requires your own signed-in identity and cannot use RZV_API_KEY.
- In scripts and CI, set RZV_API_KEY to a workspace API key instead of signing in, and pass --workspace \<id\> or set RZV_WORKSPACE to the workspace id; a key cannot look up slugs. Commands that need your own sign-in refuse RZV_API_KEY: rzv whoami, rzv workspaces list, select and create, rzv workspaces invitations accept, API-key management, notifications, personal tickets, GitHub linking, AI provider changes and rzv ai settings update.

## Notifications, activity and support

- rzv notifications list|read|settings lists notifications, marks them read, and changes in-app and email delivery per category. It needs your own sign-in.
- rzv activity list|export|status reads the workspace activity log, exports it as CSV, and shows audit signals.
- rzv tickets list|open|show|reply|close works with support tickets. Add --personal for tickets outside a workspace.
- rzv ai providers|settings|usage manages workspace AI connections, settings and usage. Pipelines and AI Fix appear only when they are turned on for your workspace.