> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.byterover.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Launch the local web UI in your browser

## 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:

```bash theme={null}
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.

<img src="https://mintcdn.com/demo-a750c123/5tECPaFEBQ8jki7W/images/local-web-ui/getting-started-launch.png?fit=max&auto=format&n=5tECPaFEBQ8jki7W&q=85&s=9da046c1d0e5c8d482b6041004db0fcb" alt="Terminal running brv webui with the browser opening to the web UI" width="3456" height="1896" data-path="images/local-web-ui/getting-started-launch.png" />

## First-run tour

The first time you open the web UI, a four-step guided tour walks you through the essentials: connecting a provider, running your first curate, running your first query, and installing a coding-agent connector.

The tour teaches by clicking through. Instead of auto-opening the composer for you, it routes you to the **Tasks** tab, dims the rest of the page, and points a glowing arrow at the **New task** button — you click it yourself. When the composer opens, it pre-fills sample input for the current step (curate or query) so you can submit and see the result.

If a task fails or is cancelled during the tour, an inline banner suggests **Try again** — the retry button on the failure card carries the original prompt back into the composer so you don't have to re-type it.

You can skip the tour anytime. To replay it later, open the Help menu and choose **Restart the tour**.

<Note>
  The screenshot above is the bare web UI. The tour overlay (dimmed page + glowing arrow) is not pictured here.
</Note>

## Pick a custom port

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

```bash theme={null}
brv webui --port 8080
```

## Next steps

<CardGroup cols={2}>
  <Card title="Projects" icon="folder-open" href="/local-web-ui/projects">
    Switch and manage projects in the UI.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/local-web-ui/troubleshooting">
    Fix common issues.
  </Card>
</CardGroup>