From dbfc632ab8ad93b0e1d4ae11d4c3856ea058616b Mon Sep 17 00:00:00 2001 From: bcode Date: Mon, 11 May 2026 17:43:01 +0000 Subject: [PATCH 1/2] docs: update README for TS harness --- README.md | 24 +++++++++--------------- 1 file changed, 9 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 58a283509..2cb9e7eac 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,7 @@ # BrowserCode An AI coding agent that drives real browsers. Forks -[anomalyco/opencode](https://github.com/anomalyco/opencode) and vendors -[browser-use/browser-harness](https://github.com/browser-use/browser-harness). +[anomalyco/opencode](https://github.com/anomalyco/opencode). ## Install @@ -11,14 +10,14 @@ curl -fsSL https://bcode.sh/install | bash ``` Installs `bcode` to `~/.bcode/bin`. macOS, Linux, and Windows (Git Bash). -Also requires `uv` ([install](https://astral.sh/uv/install.sh)) and Chrome -with `chrome://inspect` enabled (or `BU_CDP_WS` set to a remote CDP endpoint). +Requires Chrome with `chrome://inspect` enabled (or `BU_CDP_WS` set to a +remote CDP endpoint). ## What's different from opencode -- 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. +- 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`). @@ -33,9 +32,6 @@ 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). - ## Configure browser permission `browser_execute` is enabled by default. To disable or gate it, edit @@ -55,15 +51,13 @@ The first `browser_execute` call builds a Python venv at - `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`. +- `packages/bcode-browser/` — BrowserCode-specific code: in-process CDP + harness, `browser_execute` implementation, embedded skills. ## Maintenance docs -- `UPSTREAM.md` — modification zones, sync log against both upstreams. +- `UPSTREAM.md` — modification zones, sync log. - `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. From 98d4aaa80803383a3632bea0b45a4c3ebc9fc6a9 Mon Sep 17 00:00:00 2001 From: bcode Date: Mon, 11 May 2026 17:52:42 +0000 Subject: [PATCH 2/2] docs: link to browser-harness, note TS port --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2cb9e7eac..13a669e78 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,9 @@ # BrowserCode An AI coding agent that drives real browsers. Forks -[anomalyco/opencode](https://github.com/anomalyco/opencode). +[anomalyco/opencode](https://github.com/anomalyco/opencode) and ships a +TypeScript port of +[browser-use/browser-harness](https://github.com/browser-use/browser-harness). ## Install