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

# Overview

> Browser-based UI for ByteRover, served by your local daemon on localhost

## Why a web UI?

Some things are just faster in a browser — reading long context files, scanning diffs, kicking off a task and walking away. The web UI gives you a visual way to do everything ByteRover already does, without replacing the CLI or TUI. It runs on your own machine, served by the local daemon, so nothing leaves your laptop unless you explicitly push.

<img src="https://mintcdn.com/demo-a750c123/5tECPaFEBQ8jki7W/images/local-web-ui/overview-home.png?fit=max&auto=format&n=5tECPaFEBQ8jki7W&q=85&s=7022ed0c7f700eafa1bb0113a3b234ff" alt="Web UI home — header with project dropdown and tabs" width="2782" height="2026" data-path="images/local-web-ui/overview-home.png" />

The header also shows a compact ByteRover credits pill (e.g. `12.4k cr`) when the built-in provider is active — see [Providers & Models](/local-web-ui/providers-and-models#credits-in-the-header).

## What you get

<CardGroup cols={2}>
  <Card title="Projects" icon="folder-open" href="/local-web-ui/projects">
    Switch between projects from the header.
  </Card>

  <Card title="Tasks" icon="list-checks" href="/local-web-ui/tasks">
    Run curate and query tasks visually.
  </Card>

  <Card title="Contexts" icon="folder-tree" href="/local-web-ui/contexts">
    Browse and edit your project's context tree.
  </Card>

  <Card title="Changes" icon="git-branch" href="/local-web-ui/changes">
    Review and commit changes to your context tree.
  </Card>

  <Card title="Configuration" icon="settings" href="/local-web-ui/configuration">
    Manage git identity, the origin remote, and agent connectors.
  </Card>

  <Card title="Providers & Models" icon="cpu" href="/local-web-ui/providers-and-models">
    Connect LLM providers and pick a model.
  </Card>
</CardGroup>

## How it fits with CLI and TUI

The CLI, TUI, and web UI are three ways to drive the same ByteRover. Pick whichever matches the moment.

| Client                                 | Best for                                                                     |
| -------------------------------------- | ---------------------------------------------------------------------------- |
| **CLI** (`brv query`, `brv curate`, …) | Agent-driven calls and one-shot commands                                     |
| **TUI** (`brv`)                        | Keyboard-first interactive sessions in the terminal                          |
| **Web UI** (`brv webui`)               | Visual authoring, diff review, identity and remote setup, long-running tasks |

## Local-first

* Runs on your machine at `http://localhost:<port>` — not exposed to the network
* Context, tasks, and history come straight from your local `.brv/` directory
* Pushing to the remote space is always an explicit action

## Next steps

<CardGroup cols={2}>
  <Card title="Getting Started" icon="rocket" href="/local-web-ui/getting-started">
    Launch the web UI.
  </Card>

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