> ## 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

> Detailed metadata for a VM — IP, lineage, timestamps, SSH info.

`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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

| Option          | Description             |
| --------------- | ----------------------- |
| `-q, --quiet`   | Print only the VM ID    |
| `--format json` | Machine-readable output |

## Examples

### Human-readable

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers info vm-abc123
```

### Script-friendly

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers info
```

## Fields

The JSON output includes (at minimum):

| Field            | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `vm_id`          | Canonical VM ID                                              |
| `alias`          | Human-readable name, if set via `--vm-alias` or `vers alias` |
| `state`          | `Running`, `Paused`, etc.                                    |
| `ip`             | Internal IP address of the VM                                |
| `parent_commit`  | Commit this VM was booted from (empty for root VMs)          |
| `grandparent_vm` | VM that produced `parent_commit`, if available               |
| `created_at`     | Provisioning timestamp                                       |
| `resources`      | `mem_size_mib`, `vcpu_count`, `fs_size_mib`                  |

## Common Patterns

### Pluck the internal IP

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
IP=$(vers info my-vm --format json | jq -r .ip)
```

### Walk a lineage chain

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
for vm in $(vers status -q); do
  vers info "$vm" --format json
done | jq -s .
```

## See also

* [vers status](/cli-reference/status) — fleet-wide summary
* [vers connect](/cli-reference/connect) — SSH into the VM
* [vers head](/cli-reference/head) — HEAD VM ID for scripting