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.

The Vers CLI is deliberately small. Four commands make the tree:
vers runBoot a root VM
vers branchFork a live VM in 258µs
vers commitFreeze a VM as an immutable, content-addressable snapshot
vers run-commitRestore any snapshot to a fresh VM, anywhere
Everything else is convenience: scaffolding a project, connecting to a VM, naming things, moving HEAD around.

​
Project

vers init

Create a project and generate vers.toml.

vers run

Boot a VM from your configuration.

vers run-commit

Restore a VM from a committed snapshot.

vers build

Build a commit from a Dockerfile.

vers deploy

Clone, install, build, and run a GitHub repo on a fresh VM.

​
Tree

vers branch

Fork a live VM or commit into a new branch.

vers checkout

Move HEAD to a different VM.

vers commit

Snapshot a VM as an immutable commit.

vers tag

Named, mutable pointers to commits.

vers repo

Group commits into named, optionally public repositories.

​
VM

vers connect

Interactive SSH into a VM.

vers execute

Run a one-off command on a VM.

vers copy

Transfer files to or from a VM.

vers info

Detailed metadata: IP, lineage, timestamps.

vers tunnel

Forward a local port to a VM port.

vers pause

Suspend a VM.

vers resume

Resume a paused VM.

vers resize

Grow a VM’s disk.

vers kill

Terminate a VM.

vers status

HEAD + VM states at a glance.

​
Environment

vers env

Inject environment variables into newly-created VMs.

​
Auth

vers signup

Create a Vers account.

vers login

Authenticate the CLI against your Vers account.

vers logout

Clear local credentials.

​
Utility

vers alias

Human-readable names for VM IDs.

vers head

Print the HEAD VM ID. Scripting primitive.

vers upgrade

Upgrade the CLI in place.

vers mcp

Model Context Protocol server for AI agents.

​
Reading a reference page

Every command page follows the same shape: 
# vers <command>

Short one-sentence description.

## Synopsis      ← every form of the command
## Description   ← what it actually does
## Basic Usage   ← the 2-3 shapes you'll use most
## Options       ← every flag
## Examples      ← real scenarios
If you’re scanning, start at Synopsis; if you’re stuck, start at Examples.