AVC 0.2.0

Added

• avc status shows which files have changed since the last snapshot, giving agents and users an at-a-glance view of unstaged work before deciding whether to snapshot or restore.
• Storage management: avc gc reclaims space occupied by unreferenced objects (dry-run by default, --run to apply), and avc storage shows a disk-usage breakdown by branch or snapshot.
• Snapshot tags: label any snapshot with avc snapshot tag / avc snapshot untag for easy retrieval; avc_tag and avc_untag MCP tools expose the same capability to agents.
• avc export and avc import bundle an entire AVC repository — snapshots, history, and object store — into a portable .tar.gz for backup or migration between machines.
• avc search as a convenient shorthand for avc list --search, with new --agent and --changed filters for targeted snapshot discovery.
• avc branch rename renames an existing branch without disturbing its workspace or snapshot history.
• avc diff --stat prints a compact changed-file summary instead of the full unified diff, useful for a quick size check before reviewing details.
• Three new MCP tools for agent workflows: avc_status (working-tree state), avc_restore_file (single-file restore without touching the rest of the workspace), and avc_annotate (line-by-line snapshot attribution).
• Conflict resolution MCP tools: avc_list_conflicts and avc_resolve_conflict let agents resolve merge conflicts programmatically without leaving the agent loop.
• Pre- and post-hook support for snapshot and restore operations, fired with AVC_* environment variables so external scripts can react to AVC lifecycle events.
• Snapshot retention policy to automatically prune snapshots beyond a configurable limit, keeping the object store from growing unbounded on long-running projects.
• MCP tool tiers (--tools core/standard/full) give operators control over which tools are exposed to agents, enabling minimal surface-area deployments.
• Cross-platform release pipeline: GoReleaser configuration, cosign artifact signing, Homebrew tap and Scoop bucket support, and avc --version populated via build-time ldflags.
• Web UI gains a branch selector, merge panel, and status view; branch creation and merge operations are now accessible directly from the browser.

Fixed

• Branch mapping, snapshot search scoping, and post-merge active-branch state are now correctly handled when importing an exported repository bundle.
• Annotate (line-blame) queries are now O(1) instead of O(N), eliminating slowdowns on histories with many snapshots.
• Conflict markers upgraded to diff3 style, providing additional surrounding context that makes manual and agent-driven conflict resolution more reliable.

Changed

• SQLite now runs in WAL mode with query indexes, improving concurrent read performance and reducing lock contention during multi-agent workloads.
• Branch names are validated against a strict pattern, preventing names that would be ambiguous or unsafe as workspace directory paths.
• Branch workspace creation uses hardlinks where the filesystem supports them, making materialisation significantly faster for large projects.
• GitHub organization renamed from SkillMythOrg to trevarix; documentation site migrated to trevarix/avc-docs.

---

Install

macOS

Recommended — Homebrew handles PATH and removes the Gatekeeper prompt automatically.

brew install trevarix/tap/avc

Windows

Recommended — Scoop handles PATH and bypasses the SmartScreen warning automatically.
No admin rights required. avc is available in any terminal immediately after install.

scoop bucket add trevarix https://github.com/trevarix/scoop-bucket
scoop install avc

Linux

curl -sfL https://github.com/trevarix/agentic-vc/releases/download/v0.2.0/avc_0.2.0_linux_amd64.tar.gz | tar xz
sudo mv avc /usr/local/bin/

---

Direct download (without a package manager)

macOS — extract the archive, then:

# Remove the Gatekeeper quarantine flag
xattr -rd com.apple.quarantine avc
chmod +x avc
sudo mv avc /usr/local/bin/

Windows — extract the .zip, then either:

# Option A — move to an existing PATH location (no admin needed)
Move-Item avc.exe "$env:LOCALAPPDATA\Microsoft\WindowsApps\"

# Option B — create a personal bin directory and add it to your PATH
New-Item -ItemType Directory -Force "$env:USERPROFILE\bin"
Move-Item avc.exe "$env:USERPROFILE\bin\"
[Environment]::SetEnvironmentVariable(
    "PATH",
    "$env:USERPROFILE\bin;" + [Environment]::GetEnvironmentVariable("PATH","User"),
    "User"
)
# Restart your terminal after running this

You can also right-click avc.exe → Properties → check Unblock → OK
before moving it, to dismiss the SmartScreen warning on first run.

Verify the download (optional)

cosign verify-blob \
  --certificate checksums.txt.pem \
  --signature checksums.txt.sig \
  checksums.txt

---

After installing

avc --version                     # confirm the installed version
avc init                          # initialize AVC in your project
avc init --skills claude-code     # configure Claude Code integration