Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vers.sh/llms.txt

Use this file to discover all available pages before exploring further.

vers info shows full metadata for a VM: networking info, lineage (parent commit, grandparent VM), and timestamps. Where vers status is optimized for a fleet-wide glance, vers info is the deep view on one VM.

​
Synopsis

vers info                      # HEAD VM
vers info <vm-id|alias>        # Specific VM
vers info --format json        # Machine-readable
vers info -q                   # Just the VM ID

​
Options

OptionDescription
-q, --quietPrint only the VM ID
--format jsonMachine-readable output

​
Examples

​
Human-readable

vers info vm-abc123

​
Script-friendly

# Pluck the IP
vers info vm-abc123 --format json | jq -r '.ip'

# Walk the lineage
vers info vm-abc123 --format json | jq '{parent_commit, grandparent_vm}'

​
Default to HEAD

vers info

​
Fields

The JSON output includes (at minimum):
FieldDescription
vm_idCanonical VM ID
aliasHuman-readable name, if set via --vm-alias or vers alias
stateRunning, Paused, etc.
ipInternal IP address of the VM
parent_commitCommit this VM was booted from (empty for root VMs)
grandparent_vmVM that produced parent_commit, if available
created_atProvisioning timestamp
resourcesmem_size_mib, vcpu_count, fs_size_mib

​
Common Patterns

​
Pluck the internal IP

IP=$(vers info my-vm --format json | jq -r .ip)

​
Walk a lineage chain

VM=my-branch
while VM=$(vers info "$VM" --format json | jq -r '.grandparent_vm // empty'); [ -n "$VM" ]; do
  echo "parent: $VM"
done

​
Snapshot every running VM’s metadata

for vm in $(vers status -q); do
  vers info "$vm" --format json
done | jq -s .

​
See also