| name | vers-vm |
| description | Manage Vers VMs (vers.sh) - create, branch, commit, restore, pause/resume Firecracker VMs. Use when working with Vers platform, VM orchestration, or when you need isolated execution environments. |
Vers VM Management
Vers provides Firecracker VMs that can be branched like git. Use for isolated environments, parallel exploration, or safe experimentation.
Prerequisites
VERS_API_KEY environment variable set- API endpoint:
https://api.vers.sh/api/v1
Quick Reference
List VMs
curl -s -H "Authorization: Bearer $VERS_API_KEY" \
https://api.vers.sh/api/v1/vms | jq .
Create VM
curl -s -X POST -H "Authorization: Bearer $VERS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vm_config": {"vcpu_count": 1, "mem_size_mib": 512, "fs_size_mib": 512}}' \
https://api.vers.sh/api/v1/vm/new_root | jq .
Add ?wait_boot=true to wait for VM to be ready.
Branch VM (clone current state)
curl -s -X POST -H "Authorization: Bearer $VERS_API_KEY" \
https://api.vers.sh/api/v1/vm/{vm_id}/branch | jq .
Commit VM (snapshot)
curl -s -X POST -H "Authorization: Bearer $VERS_API_KEY" \
https://api.vers.sh/api/v1/vm/{vm_id}/commit | jq .
Returns commit_id for later restore.
