---
title: "Introduction"
description: "What ver is, who it's for, and where to start."
---

> Documentation Index
> Fetch the complete documentation index at: https://ver-vcs.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

<div class="flex justify-center">

</div>

`ver` (from the Latin _ver_, "spring") is an intuitive, easy-to-use, and non git-like version control system. It tracks your files as content-defined chunks, stores them in a content-addressable blob store, and syncs to S3, GCS, or Azure Blob Storage.

> **Alpha release**
>
> Expect rough edges, breaking changes, and missing features. Use at your own risk.

## What you can do

- Snapshot a project with `ver snap full` and restore it with `ver goto`. There is no staging area and no branches.
- Keep several **contexts** for the same project (local disk, S3, GCS, Azure) and move snapshots between them with `ver sync`.
- Merge two diverged copies of a project with a three-way merge and interactive conflict resolution.

## Get started with your agent

Point your coding agent at ver's agent-readable documentation index and let it install and set up ver for you:

## Get started manually

1. **Install**

   ```sh
   cargo install ver-vcs
   ```
2. **Initialize ver globally**

   ```sh
   ver ctx init --global
   ```

   This creates `~/.ver/`, where your contexts live.
3. **Scaffold a local context**

   ```sh
   ver ctx scaffold myproject --fs local --kv embedded
   ```

   Then edit `~/.ver/contexts.toml` to fill in the paths, switch to the context with `ver ctx switch myproject`, and run `ver ctx init` inside it.
4. **Take a snapshot**

   ```sh
   ver snap full --name my-first-snapshot
   ```

## Where to next

- [Concepts](/concepts/): contexts, snapshots, chunks, and how ver stores your data.
- [Snapshotting](/guides/snapshotting/): full and partial snapshots, restoring, history.
- [Syncing](/guides/syncing/): replicate a context to another backend.
- [Merging](/guides/merging/): reconcile diverged histories.
- [CLI reference](/reference/cli/): every command and flag.

Source: https://ver-vcs.net/index.mdx