Changelog
All notable changes to this project are documented here. The format follows Keep a Changelog and the project uses Semantic Versioning.
Unreleased
0.3.1 - 2026-11-21
Added
- Listed in the official MCP Registry as
io.github.adityasasidhar/browsercontrol(server.json); each tagged release now publishes it after PyPI. - Codex, OpenCode, Hermes, and OpenClaw install options in the docs.
Changed
- The browser now opens visibly by default (
BROWSER_HEADLESSdefaults tofalse). SetBROWSER_HEADLESS=truefor servers and CI. - Clearer PyPI summary, keywords, and Documentation/Changelog links.
Fixed
browsercontrol.__version__reported0.1.4; it and the HARcreatorversion now come from the installed package metadata.- Docs: tool reference wording, mobile tables, keyboard access, and stale contributor, release, and version info.
0.3.0 - 2026-11-21
Added
- Python 3.14 support on Linux, macOS, and Windows.
- Attach to the user's own Chrome over CDP (
connect_to_chrome,BROWSER_CDP_URL); detaching never closes it. find(query, role, nth): search the whole page, off-screen content, iframes, and shadow DOM included, scroll to a match, and return its element ID.act(steps): run several steps in one call and return one screenshot.export_test: turn a recorded agent session into a pytest-playwright or@playwright/testfile with verified role/label/text locators; typed passwords become environment variables.- Structured extraction:
extract_table,extract_links, and selector-schemaextract. - New actions:
double_click,right_click,drag, key combinations inpress_key,wait_for(text, selector, network idle),handle_dialog, andlist_downloads. - JS dialogs and downloads are handled automatically and reported as
Notice:lines in the next response, instead of dialogs being dismissed silently. - Smart settling after every action (load, network quiet, DOM quiet;
BROWSER_SETTLE_TIMEOUT) replaces the fixed DOMContentLoaded wait. - Network control:
mock_route,clear_mocks,wait_for_response,get_request_details(headers and bodies), andexport_har. - Emulation:
list_devices,emulate_device,set_geolocation,set_timezone,set_color_scheme,throttle_network,reset_emulation. - Isolated sessions (
create_session,switch_session,list_sessions,close_session), with captured data kept per session and each MCP client bound to its own session;BROWSER_ISOLATE_CLIENTSgives every client one automatically. - MCP resources for console logs, network traffic, errors, tabs, downloads, sessions, and the action log (
browser://...). - Streamable HTTP transport:
browsercontrol --transport http(alsoBROWSER_TRANSPORT,BROWSER_HOST,BROWSER_PORT). - Claude Code plugin and marketplace (
.claude-plugin/): installs the MCP server and the agent skill together. - Codex and OpenCode plugin packaging.
- Documentation site rebuilt with VitePress; README rewritten.
- Issue and PR templates, DCO sign-off check, conventional-commit PR title check.
Makefile, max-lines pre-commit check, refreshed pre-commit hooks.- Reuse an installed Google Chrome when Playwright's Chromium is missing.
- Elements inside cross-origin iframes are now numbered and actionable.
- Framework click targets with no
onclickattribute (detected bycursor: pointer) are numbered. - Disabled controls are drawn grey and flagged
(disabled)in the element list. - Real-browser Set of Marks tests (
tests/test_som_real_browser.py).
Fixed
- Actions reach the numbered element itself instead of whatever sits at its centre point, so clicks and typing work inside shadow DOM and iframes.
- Stale element IDs (removed or moved since the screenshot) are refused with a fresh screenshot instead of acting on the wrong element.
- Element maps are kept per tab; IDs from one tab no longer resolve in another.
- Hidden, transparent, and covered elements are no longer numbered.
get_textreads the live element (full text, or a field's current value) instead of the cached 50-character label.- An element animating back and forth is no longer refused as stale when two samples happen to straddle the point where it reverses.
0.2.0 - 2026-07-28
Added
- Configurable Chromium binary and output directories.
- Automated PyPI releases on version tags.
- Documentation site, Spanish README and agent skill.
Fixed
- Form tool semantics, viewport validation and element labels.
- Upgraded Pillow to 12.3.0 for security advisories.
