Skip to content

Overview

avc ui serves a complete graphical interface for managing snapshots — no VSCode required. It’s the best option for users on Cursor, JetBrains, Neovim, Sublime, plain terminal, or anyone who wants a non-editor browser.

Terminal window
avc ui

Output:

AVC UI server listening at http://127.0.0.1:3004
Opening http://127.0.0.1:3004 in your default browser…

The browser opens automatically. Stop the server with Ctrl+C.

FeatureDescription
Snapshot listGrouped by date (Today / Yesterday / etc.), filterable by agent / type / branch
Detail panelMetadata + collapsible folder tree of every file in the snapshot
Diff viewerSide-by-side unified diff with syntax highlighting
RestoreOne-click restore with confirmation (and auto safety snapshot)
File-level restoreRestore individual files from the detail panel
Save snapshotModal with label / agent / notes fields
TimelineVertical visual history of snapshots
DocumentationBuilt-in /docs.html page with full command reference

The UI is plain HTML/CSS/JS — no React, no Vue, no build step. Assets are embedded into the Go binary via //go:embed, so the entire web app ships inside the single avc binary. There’s nothing to install separately.

This keeps the install footprint to one ~15 MB executable that gives you a CLI and a web app.

The UI auto-detects your OS theme (light / dark via prefers-color-scheme) and uses a GitHub-inspired palette. There’s a manual toggle in the top-right of every page.

By default the server binds to 127.0.0.1 only — nobody outside your machine can reach it. There’s no authentication, by design (it’s meant for local use only).

If you bind with --host 0.0.0.0, anyone on your LAN can read, restore, and delete your snapshots. Use that only on networks you trust.