Agentic Version Control

Local version control built for AI agents.
Snapshot, diff, branch, and merge — without the complexity of Git.

~/my-project

$ avc init --skills claude-code      # wire AVC into your coding agent
✓ MCP server + agent skills configured

# The agent now versions its own work as it goes, in an isolated
# workspace — your main project is never touched directly:
#   → avc_branch_create  feat/auth
#   → avc_snapshot       "add bcrypt hashing"
#   → avc_snapshot       "fix failing test"

$ avc branch diff feat/auth          # review everything the agent did
  3 files changed  (+127 -32)

$ avc merge feat/auth                # ship it — or `avc restore` to roll back
✓ Merged feat/auth into main

Why AVC?

Built for agents

Every agent action is captured as a reversible snapshot. Branch, experiment, and roll back without fear.

Simpler than Git

Four primitives: snapshot, diff, branch, merge. No staging, no rebase, no detached HEAD.

Local-first

Your code never leaves your machine. Pure-Go SQLite + content-addressed storage. No cloud, no telemetry.

Multi-surface

CLI, VSCode extension, standalone web UI, and an MCP server so AI agents can call AVC as a tool.

Quick start

# Install
brew install trevarix/tap/avc                                                # macOS
scoop bucket add trevarix https://github.com/trevarix/scoop-bucket && scoop install avc  # Windows
# Linux: download a release tarball — see the Installation guide

# Initialize and start using
avc init
avc snapshot "Baseline"
# ...let an agent work...
avc snapshot "After agent run" --agent claude --notes "Refactored auth"
avc diff snap-abc snap-def
avc restore snap-abc                       # if needed

Read the Quick Start guide Initialize a project, take a snapshot, make changes, diff, and restore — in five minutes.

Surfaces

CLI The primary interface. Every command supports --json for scripting.

VSCode Extension Sidebar, Source Control integration, file history, gutter annotations.

Web UI avc ui serves a standalone web app at http://localhost:3004 — no editor required.

Agent Integration MCP server + auto-generated configs for Claude Code, Cursor, and Windsurf.