VERS CLI
Get started with the Vers command-line interface
INSTALLATION
Shell Install (Recommended)
curl -sSL https://vers.sh/api/install | bash vers login
Build from Source
git clone https://github.com/hdresearch/vers-cli cd vers-cli && make build-and-install
CORE CONCEPTS
Head Reference
In Vers, head is a reference to a VM. It doesn't mean it's the VM you're currently connected/SSH'd into.
# Change head pointer to a different VM vers checkout <vm_id>
Commands (after setting head)
kill
branch
connect
commit
pause
resume
execute
copy
SNAPSHOTS & COMMITS
The vers commit command creates a snapshot and returns a commit ID. The VM is paused momentarily during snapshot but resumes immediately after.
Create a snapshot:
vers commit
Deploy from a snapshot:
vers run-commit <commit_id>
This spins up a new VM with that commit's snapshotted state.
API TOKEN
After installation, authenticate with an API token from your organization settings.
vers login
QUICK START
1. Verify installation:
vers --version
2. Authenticate:
vers login
3. Initialize a project:
vers init
4. Create a branch:
vers branch my-feature
5. Switch branches:
vers checkout main
RESOURCES
docs.vers.sh →Need help? Email us at SUPPORT@VERS.SH