AVC 0.4.0

Added

• Agent integration is now set up per project instead of machine-wide. avc init --skills writes the MCP server config into the project itself — .mcp.json for Claude Code, .cursor/mcp.json for Cursor — so the AVC server is scoped to that project rather than registered globally for every project on your machine. The generated agent files are added to .gitignore automatically (respecting a .gitignore you already maintain), and avc init now creates a .gitignore with AVC's entries when your project is a git repository but doesn't have one yet.
• avc check-ignore <path> reports whether a file is excluded from snapshots and names the exact .avcignore rule responsible — the fastest way to answer "why isn't this file being tracked?"
• Snapshots now report how many files are new and how many were kept despite a newly matching ignore rule, so an unexpected spike — like a flood of test output entering tracking — is visible immediately instead of being discovered at merge time.
• Running a command in a workspace now reports the files that command created, so build or test artifacts can be excluded before they enter a snapshot.
• Branch diffs can be requested as a compact per-file summary (file names and line counts, no inline diff), and for agents the branch-diff tool automatically falls back to that summary — and truncates it if needed — when a full diff would be too large to return, so reviewing a large branch no longer fails outright.

Fixed

• Adding a path to .avcignore no longer removes files that are already tracked and still present on disk. Previously this made a branch appear to delete those files, and merging it would have deleted them from your real project. As in git, ignoring a file never stops tracking it — delete the file to do that.
• The default ignore rules no longer hide application source. A bare vendor/ pattern matched any folder named vendor at any depth, silently leaving first-party source out of every snapshot; it is now limited to the project root, where Go's dependency folder lives.
• Editing the project's .avcignore now takes effect on active branches immediately, instead of applying only to branches created afterward.
• Diff line counts are now exact for large files. A one-line change in a big file previously reported the entire file as rewritten; it now shows only the lines that actually changed.
• The first snapshot taken on a new branch is now always restorable. In some cases it referenced file contents that were never stored, leaving the snapshot impossible to restore or diff — those contents are now saved reliably.
• VSCode extension: the Timeline button in the Snapshots view toolbar now shows its icon. It previously rendered as a blank (but still clickable) button.

Changed

• Line annotations are now readable and show authorship. Both avc annotate and the VSCode extension's inline annotations group lines blame-style — one annotation per block of lines from the same snapshot, instead of repeating on every line — and label each block by who made the change: you for your own edits (including automatic save-snapshots), or the agent's name for AI-authored blocks. Blank lines are no longer annotated.
• Creating a branch is roughly four times faster on large projects, and restoring a snapshot is faster too, by processing files in parallel. Very large files are now copied without being read fully into memory.
• Installation instructions now cover Scoop on Windows.

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.4.0/avc_0.4.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