turbo vms

List the Turbo VM versions available locally and from the configured Hub.

Usage

turbo vms [--offline] [--format=VALUE]

Description

The command lists releases of the /xvm system image. Local releases are always included. When online, the command also queries the configured Hub; Hub releases are available when the registry permits the request and may require you to log in.

Use --offline when you need a deterministic inventory of the VM versions already cached on the machine.

Options

Flag	Description	Default/Values	Notes
--offline	Do not query the Hub.	Off	Lists only locally available VM releases.
--format=VALUE	Select the output format.	Text; json, json-stream	json returns the command-result envelope described below.

Examples

# List local and available Hub releases
turbo vms

# List only locally cached VM releases
turbo vms --offline

# Return the local inventory as JSON
turbo vms --offline --format=json

Output

Text output groups the available Turbo VM versions and marks locally cached releases. With --format=json, the command-result envelope contains a result object with the following shape. A version that exists both locally and in the Hub can appear once for each source.

{
  "vms": [
    { "version": "26.3.18", "isLocal": true },
    { "version": "25.10.4", "isLocal": true }
  ]
}

Related Commands

• turbo vm — Show the local head and latest Hub VM versions.
• turbo pull — Download /xvm releases.
• turbo run — Start a session and optionally select a VM with --vm.