Skip to main content
Vers provides remote Linux computers with durable, remotely managed state. The vers CLI does not create a local project, keep a HEAD, or infer a computer from the current directory. Anonymous command telemetry is enabled by default and can be disabled persistently or for a stateless invocation; it is separate from project and target state.

​
The command model

Every command names its target explicitly. Friendly names and UUIDs are both accepted where the command reference says COMPUTER.
vers run IMAGE -- COMMAND... is the primary workload command. Public images are resolved by Vers by default. Add --local to export an image from Docker, OrbStack, or Podman on your machine.

​
Predictable automation

  • Structured commands print human-readable output by default and support --json where advertised.
  • Foreground run preserves workload output channels and returns the workload’s exit status.
  • Mutations that continue after the client disconnects return an operation ID that can be inspected with vers operation get or waited on with vers operation wait.
  • Usage errors are rejected before credentials are read or control-plane work begins.

​
Start here

Install the CLI

Install the Rust CLI and configure an API key.

Quickstart

Run a workload, manage a computer, write a file, and clean up.

CLI reference

The complete pre-launch command surface and exit contract.
The CLI intentionally has no login, init, root-level status, checkout, exec, or local-project commands. Use vers run for durable workloads, vers whoami, vers list, and explicit computer references instead.