What is Git-Semantic Version Control?
Git-Semantic version control lets you track every change to your context tree — the knowledge base that your AI agents rely on. Save snapshots of your context, undo mistakes, experiment on branches, and optionally share with your team via the cloud. If you’ve used Git before, you’ll feel right at home — the commands map directly. If you haven’t, don’t worry: the workflow is simple and the guides walk you through each step.No account required for local use. Git-Semantic works entirely on your machine — no login, no cloud account, no remote space needed. Initialize with
brv vc init, then save, branch, and merge freely. Cloud sync (push, pull, fetch, clone) is optional and requires a ByteRover account and a remote space.How It Works
Git-Semantic operates on your.brv/context-tree/ directory — the hierarchical knowledge base that stores your project’s domains, topics, and subtopics. It tracks changes using a model similar to Git:
- Working tree — The current state of your context tree files on disk
- Staging area — A holding area where you prepare changes before saving them
- Commit history — A chain of saved snapshots, each recording what changed, when, and by whom
- Branches — Independent lines of work, so you can experiment without affecting the main context
- Remote — ByteRover cloud, for syncing context across machines and team members (optional)
Git vs Git-Semantic
If you know Git, the commands map directly. If you’re new to version control, the Getting Started guide walks you through each one.Why Version Control for Context?
Your context tree evolves alongside your codebase. Without version control, changes are invisible and irreversible. With it, you get:- Full history — See what changed, when, and by whom. Every save (called a “commit”) records the author, timestamp, and a descriptive message.
- Safe experimentation — Create a branch to try a different context structure. If it doesn’t work, switch back — your main context is untouched.
- Team collaboration — Multiple people can curate context in parallel, then merge their work together. ByteRover detects conflicts when the same file is edited by two people.
- Undo mistakes — Made a change that degraded your agent’s context quality? Roll back to a previous commit to restore what worked.
- Cloud sync — Optionally push context to ByteRover cloud and pull it on another machine, keeping your team aligned on a single source of truth.
CLI vs TUI
All 16 version control commands are available in two modes:- CLI
- TUI (REPL)
Run commands directly from your terminal. Best for scripting, automation, CI/CD pipelines, and headless environments.CLI commands follow the pattern:
brv vc <subcommand> [args] [flags]Available Commands
Commands are organized into four groups. The first three groups work entirely locally — no account, no internet, no remote space required. Only the Remote Sync group requires a ByteRover account and a remote space.Setup
Staging & History
Branching & Merging
Remote Sync (requires login + remote space)
* vc remote itself doesn’t require authentication — it only configures the remote URL locally. Authentication is checked when you actually communicate with the remote (push, pull, fetch, clone).Next Steps
Getting Started
Initialize version control, configure your identity, and clone your first space
Staging & Committing
Stage changes, create commits, view history, and undo mistakes
Branching & Merging
Work in parallel with branches and resolve merge conflicts
Remote Sync
Push, pull, and sync context with ByteRover cloud