+
+
+
# BrowserCode
-An AI coding agent that drives real browsers. Forks
-[anomalyco/opencode](https://github.com/anomalyco/opencode) and ships a
-TypeScript port of
-[browser-use/browser-harness](https://github.com/browser-use/browser-harness).
+A streamlined coding agent that drives real browsers through unconstrained CDP.
+
+The unbounded power of the browser working seamlessly with your code. The agent adapts to every site at runtime and writes scripts to reuse later.
+
+
+
-## Install
+## One-Line Install Command
+
+Run this in a terminal that supports bash:
```sh
curl -fsSL https://bcode.sh/install | bash
```
-Installs `bcode` to `~/.bcode/bin`. macOS, Linux, and Windows (Git Bash).
-Requires Chrome with `chrome://inspect` enabled (or `BU_CDP_WS` set to a
-remote CDP endpoint).
+## Usage
-## What's different from opencode
+Open the TUI:
-- One new tool, `browser_execute(code)`, that runs JavaScript/TypeScript
- in a real browser via CDP. The CDP session persists across calls within
- an agent session.
-- Everything else from opencode works the same. Same providers, same TUI,
- same config (`opencode.json`).
+```sh
+bcode
+```
-## Run from source
+Run an agent headlessly:
```sh
-git clone https://github.com/browser-use/browsercode.git
-cd browsercode
-bun install
-bun run --cwd packages/opencode dev
+bcode run "Connect to my browser and find the cheapest way to SF via any bus/train/rideshare"
```
-Needs `bun >= 1.3.13` plus the runtime prereqs above.
+### Connect an LLM
+
+BrowserCode supports any model you can reach with an API key, plus every provider OpenCode supports.
+
+[OpenCode provider docs](https://opencode.ai/docs/providers)
-## Configure browser permission
+Use `/connect` in the TUI, or set provider API keys in your environment.
-`browser_execute` is enabled by default. To disable or gate it, edit
-`opencode.json`:
+
+
+
+
+
-```jsonc
-{
- // disable entirely
- "tools": { "browser_execute": false }
+Recommended models from current BrowserCode evals:
- // or prompt every call
- "permission": { "browser_execute": "ask" }
-}
+- Frontier: `claude-opus-4-7`, `gpt-5.5`
+- Value: `glm-5.1`, `mimo-v2.5-pro`
+- Budget: `gemini-3-flash-preview`
+
+### Connect a Browser
+
+Let the agent connect for you. It knows how. You can prompt:
+
+```text
+Connect to my current tab at https://amazon.com and look for a better deal for 64GB DDR5 RAM and return the URLs
+```
+
+The agent will take control of your actual browser.
+
+```text
+Make a new browser profile and work in the background to QA test http://localhost:3000, fix any bugs and open a PR
```
-## Repo layout
+The agent will work locally in its own browser profile.
+
+```text
+Open a remote browser and extract every item sold at https://mcdonalds.com in SF
+```
+
+The agent will control a Browser Use Cloud browser and give you a link to watch it.
+
+#### Cloud Browsers
+
+- Browser Use Cloud offers unlimited free browsers, limited to 3 concurrent sessions, with stealth, captcha solving, and proxies.
+- Just set `BROWSER_USE_API_KEY` in your environment. The agent can sign up completely autonomously; just ask it to. To upgrade further, go to [cloud.browser-use.com](https://cloud.browser-use.com).
-- `packages/opencode/` — vendored from `anomalyco/opencode` (treat as
- upstream; modifications are deliberate exceptions).
-- `packages/bcode-browser/` — BrowserCode-specific code: in-process CDP
- harness, `browser_execute` implementation, embedded skills.
+## Philosophy
-## Maintenance docs
+Browser ability and code-writing ability are deeply connected.
-- `UPSTREAM.md` — modification zones, sync log.
-- `opencode-sync.md` — runbook for syncing from anomalyco/opencode.
-- `AGENTS.md` — code style + maintenance notes for agents working in this repo.
-- `install.sh` — what `bcode.sh/install` serves.
+We turned browser interaction into a coding problem; the agent writes JavaScript that drives Chrome directly through CDP. Maximal power to the agent. Minimal abstractions.
+
+#### Do more with less.
+
+*BrowserCode outperforms every browser agent we have tested it against.*
+
+## Architecture
+
+BrowserCode is a fork of [OpenCode](https://github.com/anomalyco/opencode) with a vendored TypeScript port of [Browser Harness](https://github.com/browser-use/browser-harness).
+
+It adds one core browser primitive:
+
+```text
+browser_execute(code)
+ -> runs JavaScript in-process
+ -> talks to Chrome through the DevTools Protocol
+ -> keeps the browser session alive across calls
+ -> returns logs, values, and screenshots to the agent
+```
+
+Reusable browser scripts are written to:
+
+```text
+.bcode/agent-workspace/
+```
+
+*BrowserCode is not built by the OpenCode team and is not affiliated with OpenCode in any way.*
## Telemetry
-BrowserCode sends anonymous usage traces to help improve the project. To opt
-out, set `DO_NOT_TRACK=1` in your environment.
+BrowserCode sends anonymous usage traces to help improve the project. To opt out, set `DO_NOT_TRACK=1` in your environment.
+
+## Contributing
+
+Most upstream contributions belong in one of the projects BrowserCode builds on:
+
+- Browser automation: [browser-use/browser-harness](https://github.com/browser-use/browser-harness)
+- Core coding-agent: [anomalyco/opencode](https://github.com/anomalyco/opencode)
+
+Run from source:
+
+```sh
+git clone https://github.com/browser-use/browsercode.git
+cd browsercode
+bun install
+bun run --cwd packages/opencode dev
+```
+
+---
-## License
+
Tell your computer what to do, and it gets it done.
-MIT. See `LICENSE`.
+
diff --git a/static/browser_harness_by_model_dark.png b/static/browser_harness_by_model_dark.png
new file mode 100644
index 000000000..b9cc48485
Binary files /dev/null and b/static/browser_harness_by_model_dark.png differ
diff --git a/static/browser_harness_by_model_light.png b/static/browser_harness_by_model_light.png
new file mode 100644
index 000000000..9ed646219
Binary files /dev/null and b/static/browser_harness_by_model_light.png differ
+
+
+
+
+
+
+