Skip to main content

vers status

Get status of VMs.

Usage

Examples

Show all VMs (default)

Show specific VM details

How it works

The status command has two modes:

Default mode (no arguments)

  1. Shows HEAD status: Displays current HEAD VM and its state
  2. Lists all VMs: Shows VM names and their states

VM mode (VM argument)

  1. Resolves VM: Finds VM by ID or alias
  2. Shows VM details: Displays VM name and state

HEAD status variations

Normal HEAD with running VM

HEAD with VM alias

No .vers repository

Empty HEAD

HEAD verification failed

Output format

VM list format

  • VM name: Shows alias if available, otherwise VM ID
  • State: Current VM state (Running, Paused, Stopped, etc.)

Error handling

VM not found

No VMs exist

API failures

Use cases

Environment overview

VM monitoring

Debugging

Prerequisites

  • For VM details: Network connectivity to query API
  • For HEAD status: .vers directory (optional, shows warning if missing)

Common Patterns

Wait for a VM to reach Running

Pipe into other commands

Watch fleet state in a loop

See Also