Reference

What changed in each release, and why — this page is the full version history, grouped by minor version, newest first. chrome-use's own feature work lives in the v1.x line; further back is the fork era that predates the rebrand, plus the version numbers merged in periodically from upstream agent-browser.

v1.5.x

• v1.5.75 (2026-07-10) — Fixed extension-relay auto-connect creating two about:blank tabs for a new session. The connection now reuses the session-owned scratch tab created during target discovery and creates a fallback only when the page count is zero, so read-only commands, status checks, and pre-navigation failures no longer leave paired blank tabs behind.
• v1.5.74 (2026-07-08) — Skill distribution v2: new chrome-use skill install as the one entry point — it delegates to skills.sh (npx skills add … -g) to install across 20+ runners and never writes runner dirs itself; curl … | sh now installs the skill after the binary and finishes with a doctor self-check plus a copy-paste first prompt for your agent; doctor gains a read-only "is the agent skill installed?" probe (warn, never fail); the stub routing table grows from 5 to 11 symptom→command rows (canvas/network/react/real-chrome/sessions/test, …). Also fixed: skills/chrome-use/SKILL.md's description was invalid YAML (a bare : ), which made npx skills add install core/test/… instead of chrome-use — fixed with a folded block scalar.
• v1.5.73 (2026-07-07) — Four issue fixes: extract --schema no longer silently returns [] on a plain repeating list (auto-detects the repeating container + a diagnostic on no match + accepts an array-shaped schema, #96); site adapters inject the family _helper before running (twitter/* etc. no longer ReferenceError, #99); console --limit N tails the last N entries (#110); real skill tiering (<!-- full --> marker — lean default, --full for everything) + dedup + session handoff synced into the sessions skill (#100).
• v1.5.72 (2026-07-07) — Native commands survive shadow-DOM-heavy apps: select/fill now handle react-select, module-scoped Monaco, and controlled inputs whose @ref anchored a wrapper (#105); sharper on Element-Plus modals — snapshot -i tags controls inside the top modal/drawer with modal, a closest-text hint on selector misses, and a new diagnose verb for blank SPAs (#90). curl … | sh sets up the extension and handles the debugging banner in one command (consent at install → auto-silence at runtime). The skill steers agents to read/click/fill over hand-rolled eval.
• v1.5.71 (2026-07-07) — Docs: new How It Works (with an SVG pipeline diagram), Lineage & Upstream, and Single-pass Scripting chapters, plus a full doc-site audit sweep. No functional change.
• v1.5.70 (2026-07-07) — chrome-use script single-pass scripting (#101): a JSON op-list (value bus + loops + asserts) and synchronous JS (cu.* helpers); a daemon-resident boa engine survives hard navigations, running many steps in one tool call. Also: connect detects enterprise-blocked extensions and guides the escape hatches; opt-in background auto-update (CHROME_USE_AUTO_UPGRADE=1); one-click Web Store install.
• v1.5.69 (2026-07-07) — snapshot -i merges presentation-role / AX-stripped cross-origin iframes (the reCAPTCHA case, #92); snapshot/eval resync before resolving the active tab so they don't drift to about:blank (#93); unlabeled interactive controls named from placeholder / nearest label (#90.2); screenshot resync captures the active tab (#91).
• v1.5.68 (2026-07-02) — Session ownership + human handoff: session handoff/resume/status/list (#89, ported from ego-lite); whoami per-site identity + a global --as account guard.
• v1.5.67 (2026-07-02) — Guided multi-profile extension install: enumerate all profiles, detect stale policy, deep-link Settings + wait for approval + auto-restart; setup wizard localized zh/en; connect <port> / --cdp rebind when the endpoint changes.
• v1.5.66 (2026-07-02) — select no longer silently selects nothing when no <option> matches; it now errors and lists every available option. Default action timeout dropped from 30s to 25s.
• v1.5.65 (2026-07-02) — network route --set-json: structured JSON-field edits on the real response; new chrome-use report packages a de-identified friction log into a paste-ready GitHub issue; MCP --tools all (24 tools).
• v1.5.64 (2026-07-01) — chrome-use mcp: a stdio MCP server (12-tool core profile) for MCP-only hosts like Claude Desktop that can't run a shell command.
• v1.5.63 (2026-07-01) — read [url]: fetch a URL — or, with no URL, the active tab — as agent-readable text; supports --llms / --outline / --filter / --raw.
• v1.5.62 (2026-07-01) — fixed type --clear / --delay parsing; find label now also matches aria-label/aria-labelledby.
• v1.5.61 (2026-07-01) — React renderer fix: pick the actual react-dom renderer instead of hardcoding id 1 (was reading an empty tree on Next.js 16.3 Turbopack RSC apps).
• v1.5.60 (2026-07-01) — network route: edit the real response at the response stage (status/headers/body substring replace).
• v1.5.59 (2026-07-01) — network route: mock responses and rewrite requests via the CDP Fetch domain — no proxy, no cert, no JS injection.
• v1.5.58 (2026-07-01) — chrome-use test: per-case account switching for multi-account YAML suites (account:).
• v1.5.55 (2026-06-29) — friction auto-reporting.
• v1.5.54 (2026-06-29) — form fill can select by visible option text; fixed self-heal on the --launch path.
• v1.5.53 (2026-06-29) — form fill --map: bulk-mapped form filling.
• v1.5.52 (2026-06-29) — --observe: capture the a11y-tree delta around an action; auto ref-heal docs.
• v1.5.51 (2026-06-29) — action guards --if-present / --optional.
• v1.5.50 (2026-06-29) — extract --schema: schema-driven structured scrape to JSON.
• v1.5.49 (2026-06-29) — expect: assertion verb with a matching exit code.
• v1.5.48 (2026-06-29) — ab-connect 0.5.7: wake-from-sleep reconnect via chrome.idle.
• v1.5.47 (2026-06-29) — ab-connect 0.5.6: adopt no longer persists; clears the stuck debugger banner.
• v1.5.46 (2026-06-29) — relay self-heal: a dropped relay recovers on its own, no hang or manual reconnect.
• v1.5.45 (2026-06-28) — fixed adopt-tab command resolution (a regression from #68).
• v1.5.44 (2026-06-28) — adopt switched to on-demand attach (ext 0.5.5): no more debugger banner on user tabs.
• v1.5.43 (2026-06-27) — #65 snapshot --filter + eval top-level-await hint.
• v1.5.42 (2026-06-27) — #60 browser/profile selection: browsers listing + --browser.
• v1.5.41 (2026-06-26) — #60 driving-profile observability + #53 canvas/closed-shadow skill docs.
• v1.5.40 (2026-06-26) — #58 eval --frame, reconnect alias, actionable stale-target errors.
• v1.5.39 (2026-06-26) — snapshot -i now surfaces inline form-validation errors.
• v1.5.38 (2026-06-26) — #52 tab routing scoped to the session group + CI format fix.
• v1.5.37 (2026-06-25) — solve-slider robustness (wait for slices) + pluggable detector hook.
• v1.5.34 (2026-06-25) — solve-slider (NetEase Yidun slider captcha) + drag offset mode.
• v1.5.32 (2026-06-24) — sunny extension UX: friendlier icon, polished popup, options page, agent cursor.
• v1.5.31 (2026-06-24) — fail loudly on relay tab-drift instead of clicking the wrong tab.
• v1.5.30 (2026-06-24) — relay-down guidance + canvas/closed-shadow skill playbook.
• v1.5.29 (2026-06-24) — silenced the chrome.debugger banner + fixed a leftover about:blank scratch tab.
• v1.5.28 (2026-06-22) — the chrome-use skill now prefers live web checks.
• v1.5.27 (2026-06-19) — gated the about:blank cleanup to the relay case only.
• v1.5.26 (2026-06-18) — session stop <name> + session prune + lifecycle docs.
• v1.5.25 (2026-06-18) — default idle-shutdown + keep: stop leaving scratch tabs/groups behind.
• v1.5.24 (2026-06-18) — build fix: include browser.rs's clear_viewport/via_relay + cargo fmt.
• v1.5.23 (2026-06-17) — adopt: drive a pre-existing tab without opening a new one.
• v1.5.22 (2026-06-17) — group-scoped Target.getTargets on the relay: restores follow-popup + cross-session adopt under isolation.
• v1.5.21 (2026-06-17) — rich-editor fill, box centers, screenshot downscale, disabled handling + docs (#41-#45).
• v1.5.20 (2026-06-17) — site: adapter auto-sync + auto-suggest.
• v1.5.19 (2026-06-17) — site: bb-sites adapters — turn any site into a structured-data CLI.
• v1.5.18 (2026-06-17) — issue-reporting guidance + a clear error for data: URLs over the relay.
• v1.5.17 (2026-06-17) — complete multi-agent isolation: clicks no longer adopt foreign tabs/pop-ups.
• v1.5.16 (2026-06-17) — strict multi-agent tab isolation on the relay.
• v1.5.15 (2026-06-17) — trusted activation for in-iframe buttons.
• v1.5.14 (2026-06-17) — fixed the eval-await regression (replMode) + default scroll; green CI (#36, #38).
• v1.5.13 (2026-06-17) — eval replMode (re-declarable let/const) + the snapshot-first skill rule (#37, #38).
• v1.5.12 (2026-06-17) — relay-safe hover/dblclick/drag, deeper iframe snapshot, key-events-based typing.
• v1.5.11 (2026-06-16) — cross-origin iframe scroll/click + open auto-reattach (#35, #36).
• v1.5.10 (2026-06-16) — warn when launching via debug-port while the relay is up.
• v1.5.9 (2026-06-16) — strip zero-width unicode from titles + screenshot --clip/element.
• v1.5.8 (2026-06-16) — file upload over the extension relay.
• v1.5.7 (2026-06-16) — cf-status: a Cloudflare clearance preflight check.
• v1.5.6 (2026-06-15) — pin the adopted tab against transient relay snapshots.
• v1.5.5 (2026-06-15) — a diagnostic log for the remote-debugging consent modal in connect mode.
• v1.5.4 (2026-06-15) — get text --pierce: pierce closed shadow DOM (#30).
• v1.5.3 (2026-06-15) — get text now defaults to cross-frame; #29 (sessions/did-you-mean/tab liveness); CI changelog fix.
• v1.5.1 (2026-06-15) — frame-aware text extraction (get text --all-frames/--main, frames) + #27, ab-connect 0.4.9 targetId recovery.
• v1.5.0 (2026-06-15) — text-selector click, get text defaults to body, tab --activate, click --follow/openedTab; fill now fires input/change/blur; close wording + chrome-use current.

v1.4.x

• v1.4.1 (2026-06-14) — hold-to-move (full keydown/keyup descriptor, #game); requires ab-connect 0.4.8 (#23 reattach hardening).
• v1.4.0 (2026-06-13) — open no longer hijacks focus; tab adopt-by-targetId; keydown/keyup docs; canvas hint; doctor checks version coherence across components.

v1.3.x

• v1.3.0 (2026-06-13) — daemon restart/status (#20.2) + live tab resync, adopt-by-targetId, open --reuse-tab.

v1.0.x – v1.2.x

• v1.2.3 (2026-06-13) — bringToFront command + tab list --full shows untruncated URLs.
• v1.2.2 (2026-06-12) — a non-blocking "update available" notice + release changelogs.
• v1.2.1 (2026-06-12) — relay tab-drift pin on open (#14/#18) + a stable per-tab relay session.
• v1.2.0 (2026-06-12) — chrome-use test: browser test suites.
• v1.1.0 (2026-06-12) — cross-profile cookie export/transfer.
• v1.0.0 (2026-06-12) — rebrand: agent-browser-stealth → chrome-use, de-fork, version reset to 1.0.0.

v0.27.0-fork.x (the fork era before the rebrand)

• v0.27.0-fork.51 (2026-06-12) — rustfmt fix for the issue #7 regression tests (CI format gate).
• v0.27.0-fork.50 (2026-06-11) — tab-title truncation + multi-agent/eval/type docs.
• v0.27.0-fork.49 (2026-06-11) — embedded stealth-status + multi-agent skill guidance.
• v0.27.0-fork.48 (2026-06-11) — iframe-proxy toggle + stealth status.
• v0.27.0-fork.47 (2026-06-11) — tab-drift pin, snapshot -c keeps interactive elements, stale-ref guidance.
• v0.27.0-fork.46 (2026-06-11) — capped the --annotate legend.
• v0.27.0-fork.45 (2026-06-11) — pick combobox as an atomic op.
• v0.27.0-fork.44 (2026-06-11) — eval origin stamp, type --focused, humanize argument validation warning.
• v0.27.0-fork.43 (2026-06-11) — a batch of issue/Hermes fixes (silent-click, live env, eval --file, tab-list, docs).
• v0.27.0-fork.42 (2026-06-11) — close session-owned tabs on exit — no more tab leak.
• v0.27.0-fork.41 (2026-06-11) — relay self-heals silently, no user action needed on a blip.
• v0.27.0-fork.40 (2026-06-11) — no more consent-dialog fallback when the extension is installed.
• v0.27.0-fork.39 (2026-06-11) — cookies set --curl preserves the full set of cookie attributes.
• v0.27.0-fork.38 (2026-06-11) — silent operation — no foreground tab stealing.
• v0.27.0-fork.37 (2026-06-11) — completed humanize (bbox jitter + wheel/drag easing).
• v0.27.0-fork.36 (2026-06-11) — human-like input stealth (humanize).
• v0.27.0-fork.35 (2026-06-11) — skill docs embed Store-install, feedback channel, and stale-binary guidance.
• v0.27.0-fork.34 (2026-06-11) — Web Store live: store-targeted force-install + skill store-install guidance.
• v0.27.0-fork.33 (2026-06-10) — polished two Hermes-found cosmetic issues (invalid-selector wording, empty-URL glob).
• v0.27.0-fork.32 (2026-06-10) — resolved Hermes-found CLI bugs (wait --url, find role, invalid selector, and more).
• v0.27.0-fork.31 (2026-06-10) — Web Store submission ready + two install paths.
• v0.27.0-fork.30 (2026-06-10) — stealth: navigator overrides moved onto the prototype, not the instance.
• v0.27.0-fork.29 (2026-06-10) — fixed the plugin overflowTest, popup-free auto-connect, ab-connect rebrand+icon, README.
• v0.27.0-fork.28 (2026-06-10) — skill docs: headed-by-default, tab groups.
• v0.27.0-fork.27 (2026-06-10) — forbid headless — always headed, for stealth.
• v0.27.0-fork.26 (2026-06-10) — stealth: navigator.platform fixed to MacIntel (anti-detection fix).
• v0.27.0-fork.25 (2026-06-10) — fixed the relay liveness check (answer Browser.getVersion locally) — stops the reconnect-storm drift.
• v0.27.0-fork.24 (2026-06-10) — passive tab discovery no longer hijacks the active tab (per-session control).
• v0.27.0-fork.23 (2026-06-10) — tolerate minimal targetInfo from the relay (extension connect's getTargets).
• v0.27.0-fork.22 (2026-06-09) — extension connect uses the relay URL, fixing a --session connect hang.
• v0.27.0-fork.21 (2026-06-09) — multi-client relay (concurrent agents).
• v0.27.0-fork.20 (2026-06-09) — per-session tab groups (ab-connect 0.4.0).
• v0.27.0-fork.19 (2026-06-09) — a new extension id (Web Store signing key) + store-aware install.
• v0.27.0-fork.18 (2026-06-09) — extension connect: zero-token native-messaging control of real Chrome + click reliability + eval-first/find-url/site-notes.
• v0.27.0-fork.17 (2026-06-05) — the eval-first skill + find-url (local bookmark search) + the site-notes convention.
• v0.27.0-fork.16 (2026-06-05) — click reliability (scroll-into-view + DOM fallback) + skill docs (console opt-in, CLICK_MODE, form/hidden-input eval).
• v0.27.0-fork.15 (2026-06-04) — stealth hardening (lazy Runtime.enable, native timezone/WebRTC, opt-in canvas noise) + adaptive @ref relocation.
• v0.27.0-fork.14 (2026-06-01) — upgrade fix + CI on Node 24.
• v0.27.0-fork.13 (2026-06-01) — --profile auto.
• v0.27.0-fork.12 (2026-06-01) — embedded skill docs.
• v0.27.0-fork.11 (2026-06-01) — stealth is now fully applied on the FullLaunch path (previously only on some launch paths).
• v0.27.0-fork.10 (2026-06-01) — a UX batch + stealth coverage/webdriver handling.
• v0.27.0-fork.9 (2026-06-01) — routine fix iteration.
• v0.27.0-fork.8 (2026-05-09) — built-in retry for transient overlay occlusion.
• v0.27.0-fork.7 (2026-05-09) — catch transient overlay occlusion before mis-clicking.
• v0.27.0-fork.6 (2026-05-09) — capped defensive CDP timeouts, fixed a misleading chrome://inspect tip.
• v0.27.0-fork.5 (2026-05-09) — fixed a misleading warning + a connect liveness probe + wait @ref.
• v0.27.0-fork.4 (2026-05-09) — fixed the SPA click race + @ref identity verification + wait --gone.
• v0.27.0-fork.3 (2026-05-09) — SPA click race fix + the wait --gone primitive.
• v0.27.0-fork.2 (2026-05-09) — a friendlier find error + restore the URL after a version-mismatch restart.
• v0.27.0-fork.1 (2026-05-09) — synced with upstream v0.27.0, added skills.sh support.

Earlier history

chrome-use periodically merges in upstream agent-browser releases (v0.27–v0.31, e.g. glob support in --wait from v0.30.0, a sandbox-package publish-metadata fix from v0.29.0). chrome-use's own development sits on top of these and diverges heavily, so the two version lines aren't in lockstep.

Earlier v0.x releases (v0.6.0 – v0.26.0, January–April 2026) inherit from the upstream agent-browser base; they're not worth listing individually here.

Related reading