Documentation

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.

Ask Docs

Ask a question and open it in your AI assistant. The prompt tells it to answer from the Runzivo docs and link the pages it used.

Try asking

Your question opens in the assistant you pick, under its own terms. Runzivo does not see or store it.