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 is fork() for machines. Branch a live VM — memory, processes, sockets and all — in under a third of a millisecond. Commit a state, restore it anywhere, run a thousand agent trajectories in parallel. If you’ve ever wanted git branch for an entire running system, that’s Vers.

Branch p50

258.3 µs

Branch p99

329.2 µs

End-to-end

< 1 ms

Isolation

hardware-level, per-VM kernel
Sub-millisecond branching is the load-bearing fact. It moves branching from a batch operation to a primitive you call in a tight loop.

Ask Claude about this page

Opens Claude.ai with a prompt referencing this page’s URL.

Read as Markdown

Raw Markdown you can paste into any AI tool.

​
The idea in 30 seconds

# 1. Boot a root VM
vers run

# 2. Get to an interesting state — install deps, load data, run a script
vers connect

# 3. Branch from here. Parent keeps running. Child inherits everything.
vers branch --alias try-plan-a

# 4. Snapshot a known-good state as a commit
vers commit

# 5. Restore that commit anywhere, later. Time-travel for infra.
vers run-commit c1a2b3c4
Four primitives: run, branch, commit, run-commit. That’s the whole mental model.

​
Start here

Core concepts

Projects, VMs, HEAD, branches, commits. Read this before writing any code.

Install the CLI

One-line curl install. macOS and Linux today.

Quickstart

Your first VM and your first branch, end-to-end.

​
Common use cases

Agent swarms

Fork one golden VM into N parallel agents. Build a full-stack app in ~60 seconds.

Parallel web testing

Navigate to a form once, branch to test every input path simultaneously.

Database state testing

Snapshot a seeded DB, branch per migration, compare outcomes in parallel.

Bad-deploy rollback

Commit before risky changes. If the deploy blows up, restore in one call — memory and all.

​
Keep going

Why Vers?

How Vers differs from sandbox platforms, hypervisors, and schedulers.

Architecture

VM tree, copy-on-write branching, content-addressable commits.

Essays

Long-form arguments for branchable compute — stateless’s limits, time-travel debugging, content-addressable everything.

CLI reference

Every command, every flag, every example.

​
Plug these docs into your AI editor

Vers hosts a Model Context Protocol (MCP) server for this documentation. One click and Cursor or VS Code can search and read every page directly.

Add to Cursor

Installs vers-docs as a remote MCP server.

Add to VS Code

Installs into your .vscode/mcp.json.
Claude Code, Claude Desktop, and manual setups are documented in the installation guide.