Releases: browser-use/browsercode
Releases · browser-use/browsercode
v0.0.3 — first multi-platform build
v0.0.2 — un-versioned harness cache + F7 phone-home/branding cut
v0.0.2 — Linux x64 prerelease
Second internal-testing build. Picks up two PRs since v0.0.1:
- #11 (C8) — un-versioned harness cache. Harness is now extracted to
~/.cache/bcode/harness/(no version subdir). On every launch the binary walks the embed map and overwrites baseline files (daemon.py,admin.py, skill.mdfiles,pyproject.toml, etc.) — excepthelpers.py, which is preserved if it already exists. Net effect: agent edits tohelpers.pysurvive every binary upgrade automatically; new curated skills + daemon fixes still land on upgrade. - #12 (F7) — phone-home and branding triage. XDG dirs
~/.config/opencode/→~/.config/bcode/(and data + state);opencode.db→bcode.db; project-level.opencode/→.bcode/andopencode.json→bcode.json; 38$schemaURLs →bcode.sh; LLM provider attribution headers (HTTP-Referer,X-Title,X-Source,X-Cerebras-3rd-Party-Integration) →bcode.sh/bcode; MCP OAuthclient_uri→bcode.sh; default system prompts rewritten to identify as BrowserCode while acknowledging OpenCode lineage; uninstall + TUI keybind + tip text. No XDG migration logic —bcodereads the new paths only. Anyone who tested v0.0.1 will see fresh state underbcode/and the legacyopencode/dirs are not touched. - CRITICAL safety fix in #12. Upstream's auto-upgrade-on-launch was wired to query opencode-ai's npm/brew/scoop/choco/curl registries — on a
bcodebinary it would have silently replaced the binary withopencodeon first launch. Disabled viaBCODE_UPGRADE_DISABLEDflag. Auto-upgrade is a no-op; manualbcode upgradereturns a friendly "download from GitHub Releases" error.
Install (Linux x64)
# raw binary
curl -L -o bcode https://github.com/browser-use/browsercode/releases/download/v0.0.2/bcode-linux-x64
chmod +x bcode
./bcode --version
# or tarball
curl -L -o bcode.tar.gz https://github.com/browser-use/browsercode/releases/download/v0.0.2/bcode-linux-x64.tar.gz
tar xzf bcode.tar.gz
./bcode --versionPrereqs
- Linux x64.
uvon PATH — required forbrowser_execute(the harness builds its venv on first call).- A Chromium-based browser running with remote debugging on, OR
BU_CDP_WS=ws://...set explicitly. For headless on the same box:chrome-headless-shell --no-sandbox --headless --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-prof about:blank. - An LLM API key configured (e.g.
ANTHROPIC_API_KEY, set viabcode auth loginorbcode.json).
Verified
End-to-end on a fresh-state Sprite (no ~/.config/bcode/, no ~/.cache/bcode/):
bcode --version→0.0.2.- First
bcode runcreates~/.config/bcode/,~/.local/share/bcode/bcode.db,~/.cache/bcode/harness/cleanly. - Harness extracts (104 files),
uvbuilds the venv,browser_executedrives headless Chrome over CDP,goto_url("https://example.com") + page_info()returnsExample Domain. bcode upgrade <target>detects unknown install method and short-circuits to the friendly bcode error (does not install opencode)./doc→{title:"bcode",description:"bcode api"}./→<title>BrowserCode</title>.
Assets
bcode-linux-x64— 141 MB raw ELF. sha256:6829963e3534ef641ad3a5e1aa51fcdbde7e5858e1b30d42c83d9f64d907c7b9.bcode-linux-x64.tar.gz— 50 MB gzipped. sha256:471e79bdaff750d6f48965468ddba743939aabc4080f0250056f795912ed40de.
Built from 27d1d0a09 with OPENCODE_VERSION=0.0.2 OPENCODE_CHANNEL=latest.
What's still deferred
- Other platforms (linux-arm64, darwin-x64/arm64, win32-x64). C1 ticket: GitHub Actions cross-platform builds.
- One-line installer at
bcode.sh/install. C4 + A1 (domain registration). Discussion thread queued. bcode githubsubcommand wiring — points at OpenCode's GitHub App, not yet rewired. Whole feature.- OpenCode-as-a-provider upsell dialogs — only shown if user picks OpenCode as their LLM provider. Pending product call on whether to keep OpenCode as a usable provider option.
A6— deny-listdaemon.py/admin.pyedits at the agent'sedittool layer (the un-versioned cache puts them at a stable path now).- Phase B —
FetchUse.Service(cloud-gated capability lift).
v0.0.1 — first installable Linux x64 binary
First installable BrowserCode binary. Linux x64 only. Internal testing.
What this is
A single-file ~141MB bcode executable: opencode + the embedded browser-harness. On first browser_execute call, the harness extracts to ~/.cache/bcode/harness/0.0.1/, uv builds a venv inside that dir, and python drives a Chrome over CDP.
Install
# tarball (recommended)
curl -fsSL -o bcode.tar.gz https://github.com/browser-use/browsercode/releases/download/v0.0.1/bcode-linux-x64.tar.gz
tar -xzf bcode.tar.gz
sudo install -m 755 bcode-linux-x64 /usr/local/bin/bcode
bcode --version
# or raw binary
curl -fsSL -o /usr/local/bin/bcode https://github.com/browser-use/browsercode/releases/download/v0.0.1/bcode-linux-x64
chmod +x /usr/local/bin/bcode
Prerequisites
- Linux x64, glibc.
uvon PATH (curl -fsSL https://astral.sh/uv/install.sh | sh). Required by the browser harness.- A Chrome / Chromium with
--remote-debugging-port=9222running locally, orBU_CDP_WS=ws://...pointing at a CDP browser endpoint.
Smoke test verified on the build sprite
bcode --version->0.0.1bcode --helpshowsbcode <cmd>(CLI argv0 detection adapts).- Compiled-mode harness extraction: 104 files written to
$HOME/.cache/bcode/harness/0.0.1/, atomic via.bcode-extractedmarker. Idempotent on re-run. uv run --project <extracted_dir>builds the venv inside the cache dir.- End-to-end browser drive:
bcode run --model anthropic/claude-haiku-4-5 --dangerously-skip-permissions "... browser_execute ... goto_url(example.com) ... page_info()"returns the page title from a real headless Chrome over CDP.
Known issues (out of scope for this release; tracked for F7)
- Config / data / cache dirs still use
~/.config/opencode/,~/.cache/opencode/, etc. (Yellow-zone branding.) - Server OpenAPI
info.title="opencode", web UI<title>OpenCode</title>. - Background plugin install fails:
NpmInstallFailedError: @opencode-ai/plugin@0.0.1 not found— opencode tries to fetch a version of its own plugin SDK matching the binary version. Non-fatal. Performing one time database migrationruns on every--helpor first invocation, regardless of subcommand.
Checksums
cad37df99265967f98e3d7fb20796d6efdaf959fb505dcb5992ceb43f862e64f bcode-linux-x64
56a7f04b18a62a27cf462d43615d30ce116fb5f77daefc8602ba4f0e7df97585 bcode-linux-x64.tar.gz
Distribution scope
Internal testing only. Not yet published to npm / Homebrew / Actions CI / a website. Manual release upload per ROADMAP.md C0 step 5; cross-platform (linux-arm64, darwin, win32) and automation come in C1+.