Skip to main content

Prerequisites

  • ByteRover CLI installed (brv --version works)
  • You’re running a version that ships the web UI (v3.x or later)
The daemon auto-starts on demand — you don’t need to start it manually before running brv webui.

Launch the web UI

From any project directory:
brv webui
ByteRover picks a free port on first run, prints the URL, and opens your default browser at http://localhost:<port>. The port is persisted, so subsequent brv webui calls reuse it and bookmarks keep working. Terminal running brv webui with the browser opening to the web UI

First-run tour

The first time you open the web UI, a guided tour walks you through the essentials: setting up a provider, running your first curate and query, and connecting a coding agent. You can skip it anytime — to replay it later, open the Help menu and choose Restart the tour.

Pick a custom port

Use --port (or -p) to force a specific port. The choice is remembered until you change it again:
brv webui --port 8080

Next steps

Projects

Switch and manage projects in the UI.

Troubleshooting

Fix common issues.