# BrowserHive documentation

BrowserHive is a local MCP server that gives AI agents isolated, stealthy Chromium sessions, with vault-backed logins the model never sees, human takeover, a full audit trail and an operator dashboard.

## Get started

- [Installation](/docs/guide/installation/): Bun, the package, `browserhive init`, `browserhive doctor`
- [Quick start](/docs/guide/quick-start/): first run, the dashboard, common setups
- [Connecting MCP clients](/docs/guide/mcp-clients/): Claude Code, Claude Desktop, Cursor, VS Code, any Streamable HTTP or stdio client

## Guides

- [Dashboard](/docs/guide/dashboard/): a tour of every page
- [Configuration](/docs/guide/configuration/): precedence, naming, the config file
- [Security model](/docs/guide/security/): authentication, bind rules, the vault model, redaction, what is recorded
- [Vault](/docs/guide/vault/): Bitwarden setup, folder policies, bindings, confirmations
- [Human takeover](/docs/guide/attention/): `request_attention` and the live view
- [Stealth](/docs/guide/stealth/): what it does, what it does not, ceilings, proxies
- [Telemetry](/docs/guide/telemetry/): OpenTelemetry export and a local Grafana stack
- [Command line](/docs/guide/cli/): every command and exit code
- [Programmatic API](/docs/guide/programmatic-api/): `createServer`
- [Upgrading and downgrading](/docs/guide/upgrading/): migrations, backups, `db restore`
- [Troubleshooting](/docs/guide/troubleshooting/)
- [FAQ](/docs/guide/faq/)

## Reference

Generated from the source by `scripts/gen-docs.ts`; always in sync with the code.

- [Configuration keys](/docs/reference/configuration/): every key with CLI, environment and file names, type, default
- [MCP tools](/docs/reference/tools/): the 43 tools with parameters, results and errors
- [Errors](/docs/reference/errors/): every error code with cause and resolution
- [REST API](/docs/reference/api/): every admin API endpoint with scope and authentication
- [WebSocket protocol](/docs/reference/websocket/): envelope, topics, commands, screencast frames
- [Config file JSON Schema](/docs/reference/config.schema.json)

## Contributing

- [Architecture](https://github.com/arg1998/BrowserHive/blob/main/docs/contributing/architecture.md): how the code is organised
- [Contributing guide](https://github.com/arg1998/BrowserHive/blob/main/CONTRIBUTING.md)