turbo vm

Show the current local Turbo VM version and, when available, the latest version published to the configured Hub.

Usage

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

Description

The command reads the head version of the /xvm system image from the local image store. When you are logged in and the command is not offline, it also queries the configured Hub for the latest published Turbo VM version.

Use turbo pull /xvm to download the latest VM image, or turbo pull /xvm:<version> to download a specific version. Session commands such as turbo run, turbo new, and turbo start accept --vm=<version> when you need to select a particular VM release.

Options

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

Examples

# Compare the local head VM with the latest Hub version
turbo vm

# Report the local head without accessing online resources
turbo vm --offline

# Return machine-readable local VM information
turbo vm --offline --format=json

Output

Text output reports the local head and, when queried successfully, the latest Hub version:

Local head VM version is 26.3.18 (latest is 26.4.1)

With --format=json, the command-result envelope contains a result object with the following shape. The vms array may be empty when no local VM exists and the command runs offline.

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

Related Commands

• turbo vms — List all available local and Hub VM versions.
• turbo pull — Download /xvm releases.
• turbo run — Start a session and optionally select a VM with --vm.