BrowserCode

An AI coding agent that drives real browsers. Forks anomalyco/opencode and vendors browser-use/browser-harness.

curl -fsSL https://bcode.sh/install | bash

Installs bcode to ~/.bcode/bin. macOS, Linux, and Windows (Git Bash). Also requires uv (install) and Chrome with chrome://inspect enabled (or BU_CDP_WS set to a remote CDP endpoint).

• One new tool, browser_execute(python), that runs Python against a long-lived browser daemon. The daemon connects to your real Chrome via CDP and persists across calls within a session.
• Everything else from opencode works the same. Same providers, same TUI, same config (opencode.json).

git clone https://github.com/browser-use/browsercode.git
cd browsercode
bun install
bun run --cwd packages/opencode dev

Needs bun >= 1.3.13 plus the runtime prereqs above.

The first browser_execute call builds a Python venv at packages/bcode-browser/harness/.venv/ (cold ~15s, warm ~50ms after).

browser_execute is enabled by default. To disable or gate it, edit opencode.json:

{
  // disable entirely
  "tools": { "browser_execute": false }

  // or prompt every call
  "permission": { "browser_execute": "ask" }
}

• packages/opencode/ — vendored from anomalyco/opencode (treat as upstream; modifications are deliberate exceptions).
• packages/bcode-browser/ — BrowserCode-specific code:
  • src/ — browser_execute Effect service.
  • harness/ — vendored from browser-use/browser-harness.

• UPSTREAM.md — modification zones, sync log against both upstreams.
• opencode-sync.md — runbook for syncing from anomalyco/opencode.
• harness-sync.md — runbook for syncing from browser-use/browser-harness.
• AGENTS.md — code style + maintenance notes for agents working in this repo.
• install.sh — what bcode.sh/install serves.

MIT. See LICENSE.