Skip to main content
Recommended — native binary (no Node.js required):
curl -fsSL https://byterover.dev/install.sh | sh
This installs a self-contained binary to ~/.brv-cli/bin/brv and updates your shell config (.bashrc, .zshrc, .profile, or fish) automatically.Supported platforms: macOS ARM64, Linux x64, Linux ARM64.Alternative — npm:
npm install -g byterover-cli
Requires Node.js >= 20.Verify your installation:
brv --version
If installed via curl:
curl -fsSL https://byterover.dev/uninstall.sh | sh
Add --yes or -y to skip the confirmation prompt.This removes the installation directory (~/.brv-cli/), shell PATH entries, global config, logs, and stored credentials.If installed via npm:
npm uninstall -g byterover-cli
Project-level .brv/ directories (your local context trees) are not removed by either uninstall method. Delete them manually if needed.
The automatic update notifier applies to the npm installation method. If you installed via the curl script, the CLI automatically updates in the background.
When a new version of ByteRover CLI is available, you’ll see a prompt before your command runs:
? Update available: 1.2.0 → 1.2.1. Would you like to update now? (Y/n)
  • Press Enter or type y to update immediately
  • Type n to skip and continue with your command
If you accept the update, your original command will not run. You’ll need to run it again after the update completes.
If the automatic update encounters an error, you’ll see:
Updating byterover-cli...
<npm error output>
⚠️  Automatic update failed. Please run manually: npm update -g byterover-cli
Your original command will still proceed. To update manually:npm install:
npm update -g byterover-cli
curl install:
brv update
brv restart stops all ByteRover processes (daemon, agents, background servers) and starts a fresh daemon. Use it when:
  • ByteRover is unresponsive or stuck
  • You’ve just installed an update
  • The TUI is behaving unexpectedly
brv restart
The command retries up to 3 times if the daemon fails to start. No flags or arguments are needed.