Repository navigation
Releases
v0.0.16
Automatic updates finish on their own, agents stop driving each other's tabs, and the relay stays up under heavy use.
Major
Updates that finish on their own
browse now waits until no agent is using the browser before replacing itself, and agents pick up the new version without a restart. Before, an update could leave agents failing with "relay is newer than CLI" until they restarted, or keep a machine on an old version for hours.
Each agent gets its own session
Agents and subagents that share one OpenCode process each keep their own browse session, so one agent no longer loads pages in another's tab, and end-of-task cleanup only closes the agent's own tabs.
Improvements
- Many agents running heavy scripts at once share the relay fairly, so one busy agent no longer slows every other agent down.
- A busy relay gets more time to answer before an agent treats it as gone.
- Pi is a supported agent in
browse install. - Adding browse keeps YAML agent configs intact.
- The install script checks pinned npm downloads against their published integrity and cleans up after a failed download.
Fixes
- A browser disconnect during a screen recording no longer stops the relay for every agent.
- After an update, agents on installs from before 0.0.11 no longer hang on browse calls.
- A tab Chrome closed without telling the relay no longer blocks updates or new sessions.
- Stopping the relay works even when an agent's work is stuck.
- An extension that stops answering is reloaded after a minute.
- Long-running scripts on a loaded machine are no longer stopped for using too much CPU.
- Scrolling gives up quickly when an element can't move, instead of scrolling for seconds.
snapshot({ within })works when the selector matches several elements or none.- Network captures keep JSON responses in HAR files.
- Windows PowerShell 7 can run the install script.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify browse-extension-0.0.16.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.16.tgz --repo anomalyco/browsev0.0.15
A batch of fixes: browse keeps running when agent code misbehaves, works better in Vivaldi, Dia and on Windows, and cleans up after itself.
Fixes
- An unhandled error in an agent's script no longer stops browse for every agent.
- Agent tabs no longer hang in Vivaldi, and a navigation that could crash Vivaldi and Chrome is gone.
- browse no longer gets stuck when a tab takes too long to attach; it gives up and closes that tab.
- Screenshots of background agent tabs are no longer blank.
- Closing Chrome's "started debugging this browser" bar releases every tab cleanly: agent tabs stay open until they're idle, lent tabs go back to you, and the agent is told what happened.
- When an agent's tabs close, their empty tab group goes away too.
- Pairing works on Windows npm installs.
- Files agents save (screenshots, downloads) are only readable by you.
- webmcp calls work on newer Chrome versions.
browse uninstallremoves the binary when browse's folders were customized, and custom XDG folders no longer break pairing.browse install --help(and other setup commands) shows help instead of running.
Improvements
- The stable extension download is now named browse-extension-.zip.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify browse-extension-0.0.15.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.15.tgz --repo anomalyco/browsev0.0.14
browse now installs and updates from Anomaly's release service, like Deadbolt.
Improvements
- The install scripts download browse from anoma.ly/release and check each file's size and SHA-256 before installing it.
--versionstill installs older versions from npm. - Installed binaries check for updates at launch and then hourly instead of once a day, and follow staged rollouts. npm installs still update through npm.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.14.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.14.tgz --repo anomalyco/browsev0.0.13
Agent tabs now go into one shared group by default instead of one group per session.
Improvements
- Agent tabs share one "Agents" group per window by default, instead of a separate group for every agent session. You can switch back to per-session groups in browse's settings; if you already picked a grouping, it stays.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.13.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.13.tgz --repo anomalyco/browsev0.0.12
Re-running browse install now pairs a browser that has the extension but isn't paired yet, including over SSH.
Fixes
browse installtreated a browser with the extension added but not paired as having no extension, and told you to add it from the Chrome Web Store again. It now pairs it, or prints a one-time code to enter when it can't open the browser itself (for example over SSH).- browse remembers an unpaired browser for 10 minutes instead of 65 seconds, and the onboarding page says what install will do.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.12.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.12.tgz --repo anomalyco/browsev0.0.11
browse moves to standard XDG folders, updates through whatever installed it, and gives agents a smaller, cheaper set of tools. Most of this came from Aiden's review.
Major
- browse no longer uses ~/.browse. Settings go in ~/.config/browse, data in ~/.local/share/browse, logs and state in ~/.local/state/browse, and the binary in ~/.local/bin/browse. Existing installs move over by themselves.
- Updating reruns whatever installed browse: the install script or npm.
browse rollbackis gone.
Improvements
- Agents get short instructions when they connect instead of a separate skill tool.
- 18 tools instead of 29, each result is sent once, and execute returns its value once, so calls use far fewer tokens.
- Tool descriptions no longer change when browsers connect, so agents' prompt caches stay warm.
- Agents can't change auto-update anymore; you still can with
browse settings. - Read-only tabs are really read-only, and agents can't grant sites browser permissions.
browse installwithout a terminal sets nothing up when it can't tell which agent ran it, and says how to pick one.
Fixes
- Updates no longer get stuck after a cancelled request.
- The extension can't close your own tabs after a browser restart.
- A corrupt sessions.json no longer stops browse from starting.
- Shutdown and slow page scripts can't hang forever.
- The idle cleanup leaves named sessions alone.
- Agent configs are written in one step and no longer break when your node version changes.
- Connections that never pair are closed, with a small size limit before pairing.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.11.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.11.tgz --repo anomalyco/browsev0.0.10
browse no longer drops your agents' sessions when the extension reconnects at the wrong moment, and every command now reads browse.
Fixes
- The installed browse binary kept crashing its relay, dropping every agent's session, when the extension reconnected or a tab closed while a page was opening. It now shrugs it off and keeps going.
Improvements
- Commands and messages say
browse <command>, ornpx @opencode/browse <command>if you installed with npx, instead ofopencode-browser. - The README leads with the one-line installer; Node.js is only needed for npx.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.10.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.10.tgz --repo anomalyco/browsev0.0.9
a new settings page and a clearer agent picker.
Improvements
- settings redesigned to match onboarding: connection status at the top, settings as simple rows, relay address, pairing code and diagnostics under advanced.
- the agent picker in
browse installshows which row you're on and lists the agents you picked by name. - status messages point to where things are on the new settings page.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.9.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.9.tgz --repo anomalyco/browsev0.0.8
install options on the onboarding page, and commands that stay on one line.
Improvements
- "do it yourself" and "another computer" have a menu to pick how to install: curl (or powershell on windows) or npm.
- install commands stay on one line instead of wrapping.
Fixes
- the chrome web store upload works again (the token request had a trailing newline).
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.8.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.8.tgz --repo anomalyco/browsev0.0.7
browse installs as one binary, has a new setup page, and the npm package starts again after 0.0.6 crashed on launch.
Major
Install without Node
curl -fsSL https://opencode.ai/browse/install | sh (or the PowerShell line on Windows) installs browse as a single binary, adds it to your PATH and sets up your agents. It keeps itself up to date. npx @opencode/browse install still works.
A new setup page
The extension opens a short setup page: ask your agent to install browse, or run one line yourself. It ticks itself off as browse connects and your agent opens its first tab. Settings have their own page now.
Improvements
- One install screen: the MCP entry for any agent, then the agents found on your computer, with search across 30 agents.
browse install --remoteconnects the extension to an agent on another computer.- Snapshots of large pages are much faster.
- The deadbolt sign-in integration is gone; site secrets you store yourself work as before.
Fixes
npx @opencode/browse0.0.6 crashed on startup; it starts again.- Error text from your code shows only its own stack frames.
- No JSON-value warning when your code returns nothing.
Install
npx @opencode/browse install
Verify
sha256sum -c SHA256SUMS
gh attestation verify opencode-browser-0.0.7.zip --repo anomalyco/browse
gh attestation verify opencode-browse-0.0.7.tgz --repo anomalyco/browse