Reference
Extension Changelog
ab-connect is the browser extension that drives your real Chrome, talking to the
CLI over native messaging. It has its own version numbers
(0.5.x), separate from the CLI. chrome-use extension status shows which
version is installed and which the store serves. Since 0.5.23 the extension asks Chrome to check
for updates itself, so most users never update it by hand.
chrome-use command line's own
versions (1.5.x) are on the CLI Changelog. The two ship
independently: the extension through the Chrome Web Store, the CLI through GitHub Releases.
0.5.x
- v0.5.83 (Pending review): New messages after a model capacity error or interrupted turn continue the same conversation and model. Older queued messages remain paused until explicitly resumed. Contributors: @leeguooooo.
- v0.5.82 (Unreleased): Stealth mode switch on the options page, on by default. While it is on, the agent cursor overlay is not drawn whatever its own setting says, and its switch is greyed out with the reason; the status reports
stealthMode. Contributors: @leeguooooo. - v0.5.81 (Unreleased): When Chrome restores the last session, the tabs of restored agent tab groups leave their group, which deletes the saved groups Chrome kept for them; no tab is closed (#692). Contributors: @leeguooooo.
- v0.5.80 (Unreleased): When an old
__nm-hostis still running after a CLI upgrade, the extension reconnects once while idle before calling the CLI too old, instead of wrongly asking you to reinstall (#684). Contributors: @Jerryx333. - v0.5.79 (Unreleased): Copy elements and Copy message under the picked elements put their context (and your words) on the clipboard as text, for handing to another agent or tool (#680). Agent tabs always leave their group before closing, so Chrome keeps no saved tab group; right after a worker restart, for agent pop-ups and for tabs the cleanup closed directly they used to be missed (#674). Contributors: @leeguooooo.
- v0.5.78 (Unreleased): A warm new look: the side panel, popup, settings page and Inspect & Ask frame share one set of colours and fonts (paper ground, clay accent, serif titles and replies), with contrast rechecked in light and dark. New icon. Agents & models is grouped by whether you can chat with an agent, missing agents collapse into chips, and a whole row opens its configuration. Contributors: @leeguooooo.
- v0.5.77 (Unreleased): Remembers which agent tabs you switched to and stayed on (over 1.5 seconds; the agent's own switches and pop-ups that flash by do not count), so the cleanup of an ended session leaves them for you. A tab kept with
done --keepis released by the extension, with no debugger left attached. The agent cursor no longer slides in from the top-left corner and its tip sits on the click point. Needs CLI 1.5.242. Contributors: @leeguooooo. - v0.5.76 (Unreleased): App Store Connect, Vercel, Netlify, Cloudflare, Firebase/Google Cloud and Sentry pages are matched by project: the local folder that names the project is preselected as "Matched by project", and remembering defaults to "This app / This project", named by the page title (or the page heading when the extension may read the site; no debugger). Needs CLI 1.5.241. Contributors: @leeguooooo.
- v0.5.75 (Unreleased): A repository page preselects your local checkout of that repository, shown as "Matched by repository", instead of the project bound to all of github.com; the remember question lets you pick the scope in place (this repository / this path / whole site), defaulting to the repository on repository pages; bindings on the options page can change scope. Needs CLI 1.5.240; with an older CLI the site-wide remember works as before. Contributors: @leeguooooo.
- v0.5.74 (Unreleased): The popup and side panel show version state. A newer CLI gets a banner with an Update CLI button when the CLI can replace itself, or the command to run when it cannot; a failed background upgrade shows why; a CLI from before 1.5.239 is asked to reinstall once; a newly installed CLI is switched to when no agent is working. The extension's own update says what it is waiting for, offers Update now when that is safe, and shows "updated to X" for a day. The button and version details need CLI 1.5.239. Contributors: @leeguooooo.
- v0.5.73 (Unreleased): A tab an agent tab opens (a link, a pop-up) no longer takes over the tab you are looking at: once Chrome puts it in front, the extension brings back the tab that was there, and the new tab stays open behind it, adopted by the agent's session again (
--followfollows it; in your window that failed because Chrome names your front tab as its opener). Contributors: @leeguooooo. - v0.5.72 (Unreleased): In /resume, the confirmation for a session still running in a terminal stays inside the picker instead of overlapping the panel below.
- v0.5.71 (Unreleased): Messages sent while the agent is working no longer show twice. They used to appear in the conversation with "Checks not recorded" under them, as if they had run, and again in the queue below; now they stay in the queue, where they can be edited or removed, and move into the conversation when their turn starts. Thermo's tab organizer can add tabs to a group it made earlier, and new groups stay in the tabs' own window instead of moving to the focused one. Contributors: @leeguooooo.
- v0.5.70 (Unreleased): Picking a button with Pick element no longer clicks it (picking a search button used to submit the search): the picker swallows the whole click that ended the pick.
- v0.5.69 (Unreleased): A Pick element button in the side panel composer toolbar: click it, click an element on the page, and it flashes "Added to chat" and lands in the composer as a chip at once (screenshot and source location fill in afterwards); one pick per click, Shift for several, Esc or the button again to stop; chips match the page chip and show the screenshot, selector and source on hover or focus. Inspect & Ask goes to the side-panel chat by default. After picking elements, "Add to chat" (or Enter) opens this tab's own side panel, puts the elements above its composer as chips and the question from the picker into its message box; nothing is sent, and a conversation already running there is not touched. Pick again to add more, remove a chip with Γ; on send the message carries each element's selector, its iframe or shadow DOM place, a locate expression, source location, text and HTML snippet, with screenshots as image attachments, folded in the transcript. Chips are marked "page changed" after the page navigates and are cleared with the tab. The terminal session (ocs) is the other choice at the top of the panel, remembered per site, and works as before; the switch in Options now only governs that destination. Picking now reaches into open shadow roots and same-origin iframes; a cross-origin iframe is picked as a whole. Fixed: quick multi-picks lost their screenshots to Chrome's captures-per-second limit; element HTML sent to agents no longer carries the picker's temporary attribute. New optional permission optional_host_permissions (http/https): a click in the side panel grants no activeTab, so Pick element asks Chrome once per site the extension cannot access yet; nothing is requested at install. Requires CLI 1.5.223. Contributor: @leeguooooo. Options adds "Allow element picking on all sites": Chrome asks once instead of the first time you pick on each site.
- v0.5.68 (Unreleased): When an older chrome-use build is still running and the update cannot take over, the notice shows
chrome-use upgrade -fwith a Copy command button; running it in a terminal stops the older build's conversations and lets the update take over. No new permissions. Requires CLI 1.5.229. Contributors: @leeguooooo. - v0.5.67 (Unreleased): A tidier side panel composer. The attached page and "Agent works in" share one row above the message as matching chips; Attach images and Conversation options are icon buttons; Full access, recording and Stop & send share one style; recording is a dot toggle that turns red when on. No new permissions. Contributors: @leeguooooo.
- v0.5.66 (Unreleased):
/resumegroups sessions by project: by folder, the projects with the latest activity first, the current site's remembered project at the top, folderless sessions under Other; each project shows three sessions with Show more, folds on a click and shows its full path on hover; search matches titles, project names and paths; ββ, Enter and Esc work. Fixes Codex sessions all showing "just now" and "Active elsewhere": times come from the session's own records instead of the file's modification time. No new permissions. The time fix requires CLI 1.5.227. Contributors: @leeguooooo. - v0.5.65 (Unreleased): A redesigned Agents & models view in the side panel. Agents, skills and schedules are card lists with status badges; schedules show their cadence, last result and next run; an agent's configuration opens under its row and can be closed; the schedule and skill editors stay closed until New or Edit, with model and tool options folded away; checkboxes are switches. The project folder choice in the composer is a folder chip: "No project folder" until you pick one, then the folder's name. The keyboard hint moved from the message box to the send button, so it no longer covers the controls below. No new permissions. Requires CLI 1.5.222. Contributors: @leeguooooo.
- v0.5.64 (Unreleased): Lending fixes: an automatic lend no longer goes to a conversation you switched to meanwhile; a tab taken back in a panel tab is not lent again by the side panel; switching a tab's conversation while it is sending no longer leaves two panels on one conversation.
- v0.5.63 (Unreleased): One side panel per tab. The toolbar button opens a panel for the tab you clicked it on; switching tabs shows that tab's own panel and conversation, or none if you never opened one there, and switching back shows the earlier one again. A new tab starts a new conversation; closing a tab keeps its conversation in the history. By default the agent now works in the tab its panel belongs to instead of opening its own window: the tab is lent automatically, with the AI badge, the grant bar and "Take back the tab". Chrome pages, the Web Store, a refused lend or a take-back leave the agent in its own window, and the panel says so. "Agent works in: this tab / its own window" is a default in Settings and a choice per conversation. Taking a tab back now refuses the side-panel sessions it was lent to, not chrome-use in your terminal; Stop no longer takes the tab back. Skills complete anywhere in a message (type / after a space; ββ, Tab or Enter, Esc), including the skills of enabled Claude Code plugins. Text missing from Chrome's message cache falls back to English instead of showing a message key. When an older chrome-use build is still busy and blocks an update, the panel names the conversations holding it, with Open and Stop it for each. No new permissions. Requires CLI 1.5.223. Contributors: @leeguooooo.
- v0.5.62 (Unreleased): Tab modes for the Agent side panel. "Open in a tab" (the arrow in the panel header) opens the current conversation as a full-page tab in a wide, centred column; the side panel and the tab show the same conversation and both update live, and opening the tab does not change what the side panel shows. In the tab, "this page" is the last web tab you used in that window, or the one you pick from the list. "Let the agent use this tab" lends one of your own tabs to one conversation: the agent works in it with your logins, never closes it, and the tab shows an AI badge on the toolbar icon while a bar in the panel names it. "Take back the tab", Stop, deleting the conversation or closing the tab ends the grant at once; a taken-back tab is refused to every agent until you lend it again or close it. Chrome pages and the Chrome Web Store cannot be lent. No new permissions. Requires CLI 1.5.221. Contributors: @leeguooooo.
- v0.5.61 (Unreleased): Replies from agents. When the agent session answers an Inspect & Ask request, the answer is shown in the Inspect & Ask frame under the sent request, in a "Replies from agents" list in the side panel, and as a notification with a toolbar count (clicking it opens the list). Requests now go out under a per-profile sender name that no agent session uses, so an agent's reply can no longer wake an unrelated session. Replies are redacted and shortened before they are kept. Continue a session started in a terminal:
/resume(or "Resume a sessionβ¦" in the conversation menu) lists recent Claude Code, Codex, OpenCode and Pi sessions on this computer, warns before taking over one that is still active elsewhere, and shows its earlier messages, redacted, as a collapsed "Earlier in this session" block; deleting such a conversation keeps the CLI's own session. A new conversation can work in a project folder: pick a recent one (from earlier conversations, Claude Code and Codex sessions and Inspect & Ask bindings) or "Otherβ¦" to open the system folder picker; the folder is fixed at creation and shown in the header, and the panel's own files and captures stay out of it. A site can remember its project in the same bindings Inspect & Ask uses, listed on the options page. No new permissions. Requires CLI 1.5.220. Contributors: @leeguooooo. - v0.5.60 (Unreleased): The extension UI is available in Simplified Chinese. The side panel, toolbar popup, Options page, Inspect & Ask frame, notifications, store description and shortcut description follow Chrome's UI language (Chinese or English; other languages get English). Text sent to the agent (prompts, Inspect & Ask context) stays English. Fixes the Options page's bound-sites list when Options opens in a tab (it showed "Agent services require the packaged extension panel"). Includes 0.5.59's redesigned Inspect & Ask panel. No new permissions. Requires CLI 1.5.215. Contributors: @leeguooooo.
- v0.5.59 (Unreleased; never published, included in 0.5.60): Redesigned Inspect & Ask panel: one line at the top names the receiving session, and the chooser replaces it instead of stacking under it; session options are whole-row choices with ~ paths; buttons read Use for this site / This tab only / Change; element cards no longer overflow, with the remove button in the corner and source locations that keep the file name and line; the instruction box and Send, Copy and Add element form one composer. No new permissions. Requires CLI 1.5.215. Contributors: @leeguooooo.
- v0.5.58 (Unreleased): Turn cards in the side panel (pages sent from and acted on, step verdicts, result cards for screenshots and downloads, check badge, recovery actions, per-message recording consent), task-finish notifications with a toolbar count (Settings β Notifications), HEIC/HEIF attachments converted by the local CLI, and approval replies bound to the request revision shown. No new permissions. Requires CLI 1.5.215 (#631). Contributors: @leeguooooo.
- v0.5.57 (Unreleased): Includes everything in the never-published 0.5.56 (Inspect & Ask, random picker names). Adds the page-to-session confirmation card, pending-claim banners, tab-only targets, path-scoped bindings and their management in Options; the side panel keeps stop and send together. No new permissions. Requires CLI 1.5.214 (#628). Contributors: @leeguooooo.
- v0.5.56 (Unreleased): Adds Inspect & Ask: Alt+Shift+C or the popup button starts an element picker; the change request is written in an extension frame on the page and goes through the local chrome-use host and ocs to the project's agent session. New activeTab and scripting permissions, used only on the current tab when the shortcut or button is pressed. Options gain an on/off switch (off by default), an editor choice and site-binding management. Requires CLI 1.5.213 (#626). Contributors: @leeguooooo.
- v0.5.54 (October 14, 2026): Adds /skill selection, library editing/imports, image attachments, conversation options and scheduled prompt settings. Run results use the existing notifications permission; no new extension permissions. Requires CLI 1.5.210. Passed Google review and publicly available. Contributors: @leeguooooo.
- v0.5.53 (October 14, 2026): The toolbar popup follows the side panel theme and system dark mode, adds Settings access, and updates store listing images (#615).
- 0.5.51 (unreleased): A user tab mixed into the agent window no longer refuses new agent tabs. The window becomes the user's, its agent tabs keep working, and new agent tabs go to one fresh agent window that later sessions share. Contributors: @leeguooooo.
- 0.5.50 (unreleased): Schedule native-host reconnection after disconnect, starting at 1 second and backing off to at most 30 seconds on repeated failures. Confirmation resets the backoff; cancelled timers cannot trigger duplicate reconnects. Old request replies are not replayed into the replacement host. Contributors: @leeguooooo.
- 0.5.48 (October 13, 2026): Adds guarded native tab grouping for Thermo. The extension handles only reviewed background tabs, journals and rechecks each page around the mutation, preserves existing groups plus active, pinned, audible, private, agent and debugger tabs, and never crosses a window or Chrome profile. Undo is idempotent and uncertain outcomes are never replayed. Generic
ABExt.callstill refuses foreign-tab mutations. - 0.5.28 (September 23, 2026): Merges community contribution #342 (thanks @AmeerAliAnwar) and fixes the regressions in it. Kept: nine high-frequency CDP events the CLI never reads are no longer forwarded (a test scans the CLI sources and fails if anything starts reading one); the owned-tab storage race is fixed; duplicateTab's three inspection reads are bounded by the transaction deadline; a new tab is attached immediately instead of after 100ms. Fixed: the 1 MB cap on messages to the host is gone β Chrome's 1 MB limit is on messages from the host, messages to it may be 64 MiB, and the cap would have turned an ordinary Wikipedia viewport screenshot (~1.2 MB base64'd) into an error; session recovery's retry windows are restored (sized from live reproductions in #23 and #24, and cut by more than half); duplicateTab again falls back when there is no focused window or active tab, and again stops starting stages once its deadline has passed; URL scheme rewriting that turned
blob:intohttps://blob:...is removed (the CLI already adds a scheme). Removed: an uncalled viewport scanner that wrote attributes into the user's page and named its results like the CLI's own refs, and a test file that only tested copies of the code. - 0.5.27 (September 21, 2026): A timed-out
Input.insertTextis no longer failed too early. The payload-scaled budget was capped at 120s, which started cutting into the per-byte allowance from 56 KB and left 0.8ms/byte at 150 KB, below the measured worst case; the cap is now 300s. The timeout message also no longer suggests inserting in pieces β the approach that scrambles text at every boundary. (Added late; missed when released.) - 0.5.26 (September 10, 2026):
Input.insertText's timeout now scales with the payload. For a command that costs time per character, a flat 8s budget is not a health check β it is a size limit in disguise: 34 KB into a rich-text editor measured ~15s and was cut off at 8s, which madekeyboard inserttext --fileuseless at exactly the sizes it exists for. The budget is now 8s + 2ms/byte, capped at 120s β roughly 4Γ the measured worst case, so a healthy renderer never trips it, while the cap keeps a pathological payload from hanging a session forever. The timeout message is distinct too: a budget that already scaled with the payload and still ran out means the page is slower per byte than expected (a heavy editor, a busy tab), not that "the debugger stopped responding" β which sent callers looking for a hung page that isn't there (#301). - 0.5.25 (2026-09-10): one generic door,
ABExt.callβ a CLI feature that only needs an allow-listedchrome.tabs / tabGroups / windows / downloads / webNavigationmethod no longer needs a new extension release. Mutating calls are allowed only on tabs the agent created (adopted tabs stay read-only,windows.create/removeare refused, anddebugger / identity / storage / runtime / managementare never reachable this way). NewABExt.statereturns everything the extension holds, owns and is configured to in one call. Permissions unchanged, so the update installs without re-approval (#294). - 0.5.24 (2026-09-09):
tabsreports the tab the relay is actually attached to, not only the one the session requested, and speaks up when the two disagree β so a dropped relay tab no longer reads like a permissions bug (#279). - 0.5.23 (2026-09-09): self-update β the extension asks Chrome to check the store instead of waiting for its own multi-hour schedule, and applies a downloaded update the moment no tab is attached. No new permission; an update that never finds a quiet moment is applied by Chrome when the worker stops (#272).
- 0.5.22 (2026-09-09): raised the trustworthiness of relay recovery, observations, and connection status.
- 0.5.21 (2026-09-08): tab-group naming for
session nameβ name the session at the start of a task, before opening tabs (#236). - 0.5.20 (2026-09-04): fixed a batch of upload, select, idle and relay regressions (#212).
- 0.5.19 (2026-09-02): fixed #201β#206 (idle detach, press/xpath, CJK read-back, click focus, cwd session, shadow-DOM snapshot).
- 0.5.18 (2026-08-30): converged relay, ref and macOS leak issues; an explicit
open/navigatenow recovers a renderer-scopedPage.navigatetimeout through Chrome's browser-level tab API, keeping the same session and tab (#198). - 0.5.17 (2026-08-24): store package, permission notes completed.
- 0.5.16 (2026-07-31): fixed recording, snapshot, find and frozen-tab issues; the
tab inspectprobe channel dates from here (#151 #154β#157). - 0.5.14 β 0.5.15 (2026-07-28): fixed open-relay, dialog, status and site-adapter issues, plus release-review follow-ups.
- 0.5.13 (2026-07-24): native downloads and a versioned local HTTP API (#132).
- 0.5.12 (2026-07-16): agent tabs open in a dedicated window by default, plus a smarter default profile choice (#120).
- 0.5.10 (2026-07-06): traffic links in the popup footer; silenced the native-host lastError.
- 0.5.9 (2026-07-02): added
identity/identity.emailso the hello carries the profile's account email. - 0.5.8 (2026-06-30): pierced the OAuth GSI sign-in iframe (OOPIF) and early-attached login popups.
- 0.5.7 (2026-06-29): reconnect the relay on wake-from-sleep via
chrome.idle(#72). - 0.5.6 (2026-06-29): stopped persisting adopted tabs, clearing a stuck "debugging this browser" banner (#71).
- 0.5.5 (2026-06-28): attach only the agent's own tabs β no debugger banner on user pages (#68).
- 0.5.4 (2026-06-27): stopped the reattach retry storm on permanently-unattachable tabs (#64).
- 0.5.3 (2026-06-26): the hello reports which Chrome profile the relay is driving (#60).
- 0.5.2 (2026-06-26): a proactive 20s heartbeat so the MV3 worker never idle-drops the relay (#59).
- 0.5.0 β 0.5.1 (2026-06-24): icon and UX overhaul (friendly icon, polished popup, options page, agent cursor); rounded transparent icon.
0.4.x and earlier (early history)
The 0.4 series is where the relay was made reliable: a stable per-tab session id, auto-reconnect after a
cross-process detach, recovery of a churned-tabId session by its stable CDP targetId, loud
failure on a stale sessionId instead of routing to a random tab, plus adopt for pre-existing
tabs, group-scoped Target.getTargets, and default idle-shutdown with keep.
Before that, 0.1.0 β 0.3.0 (2026-06-09) laid the foundation: the MV3 connect extension adapted
from openclaw-browser-relay, the zero-token native-messaging transport, and force-install through a Chrome
config profile (no Load-unpacked).