Support

Browse my Chrome Guide

Let your CellCog agent browse and act on the web inside your real Chrome browser, using your sessions, your bookmarks, and your profile.


What is Browse my Chrome?

Browse my Chrome lets a CellCog agent drive your real Chrome browser during a chat. Instead of a separate browser, the agent works inside your Chrome: the sites you are already logged into, the cookies you already have, the bookmarks you already saved.

Once enabled, an agent can:

  • Open and navigate websites in your authenticated Chrome session
  • Read page content, forms, and the accessibility structure of a page
  • Click buttons, fill forms, upload files, and download files
  • Take screenshots and capture page state
  • Adopt tabs you already have open and act on them
  • Work across multiple sites in the same chat

Key principle: you stay in control. The agent works inside a dedicated cyan "CellCog" tab group in your Chrome window. Tabs outside that group stay private. Every action is classified by risk and gated by your approval threshold, and Chrome itself shows a yellow safety banner whenever CellCog is driving a tab.


Browse my Chrome vs Cowork

Browse my Chrome is the peer of Cowork. Both require the CellCog Desktop app and extend the agent's reach in different directions:

table
UseCoworkBrowse my Chrome
Edit local files (code, docs)YesNo
Run terminal commands on your machineYesNo
Visit and interact with websitesNoYes
Use your logged-in sessionsNoYes
Fill forms, click buttons, take page screenshotsNoYes
Trust boundaryWorking directory on diskThe "CellCog" tab group

You can enable both in the same chat, for example "research these products in Chrome, then write a comparison into my project directory".


Browse my Chrome vs Cloud Browsers

Browse my Chrome uses your Chrome on your machine, authenticated as you, and only while your computer and the desktop app are on. On a paid account, AI employees also have their own cloud browsers: a persistent Chrome per employee that runs on CellCog's servers, keeps its own logins between shifts, and works while your machine is off.

table
Browse my ChromeCloud Browsers
Whose identityYours (your Chrome profile, your logins)The employee's own (separate identity and logins per employee)
Where it runsYour machineCellCog's servers
Needs your computer onYesNo
Who can use itAny chat where you enable BrowseAI employees
Logging inYou are already logged inYou log the employee in once through a live view

Use Browse my Chrome for errands that must happen as you; give employees cloud browsers for long-running, autonomous work. See the Cloud Browsers Guide.


Getting Started

Step 1: Install the CellCog Desktop App

Browse my Chrome runs on top of the CellCog Desktop app, the same app used by Cowork.

  1. Open the Browse my Chrome page at cellcog.ai/cowork/browse (also reachable from the Browse chip in the chat editor via Set up or Manage, or from your profile page). When you open it from a chat, Back to chat at the top takes you straight back.
  2. If the desktop app is not installed yet, download it from there for macOS, Windows, or Linux, install and open it, then click Add account and approve the connection in your browser

If CellCog Desktop is already connected, skip to Step 2. Full desktop setup details are in the Cowork Guide.

If the chat or the page says the desktop app is not connected while the app says Connected, the app is signed in to a different CellCog account. The chat names the account your browser is signed in as ("Open the app and sign in as you@example.com."); switch the app to that account.

CellCog Desktop open on two computers? Commands pause until you pick one. The chat says "CellCog is open on two computers. Pick the one Browse should use. Cowork and Browse will both use it." Click Use next to the computer you want.

Step 2: Install the CellCog Browse Chrome Extension

  1. Click Add to Chrome (on the Browse my Chrome page, in the chat, or in the Browse chip). This opens the CellCog Browse listing on the Chrome Web Store.
  2. Add the extension in the Chrome profile you use for work, the one with your logins. The Web Store opens in whichever Chrome profile is in front, so switch to that profile first.
  3. The page, the chat and the chip update by themselves once the extension connects.
  4. If you want the agent to attach files from your computer to web forms (uploads), open chrome://extensions/, click Details on CellCog Browse, and turn on Allow access to file URLs. Chrome only lets the extension attach local files with this permission on; without it, the agent can still browse, fill forms, and take screenshots, but every upload is refused.

The extension lives inside one Chrome profile. If you have several profiles (Personal, Work), install it in each one you want to use.

Install here (newer CellCog Desktop versions): when your desktop app can do it, each Chrome profile without the extension shows Install here instead of the single Add to Chrome. Click it and CellCog Desktop opens the Web Store page in exactly that profile on your computer. If it cannot (the desktop app is closed, two computers are open, or the app needs an update), the reason is shown next to the link; fix it and click Install here again. Install here is only offered to the owner of the computer.

No Chrome found? Browse needs Google Chrome (or another Chromium browser such as Edge, Brave or Vivaldi) on the computer running CellCog Desktop. While the desktop app looks for it you see "Looking for Chrome". If none turns up, the chat says "Chrome isn't on this computer" with Get Chrome; install it and the chat updates by itself.

Step 3: Open Chrome with That Profile

Keep the chosen profile open in Chrome so the extension can connect to the desktop app. The Browse my Chrome page shows each profile's state: Connected, "Open this profile in Chrome to connect", or "Extension not added".

Step 4: Check Your Approval Level

Browse follows your one approval level, the same one that covers your computer and your tools. Set it in Profile > Approvals, or for one chat with Auto-approve in the + menu of the message box (see the levels below).

Step 5: Enable Browse for a Chat

  1. Start a new chat or open an existing one
  2. In the editor toolbar, click the Browse chip
  3. Click the Chrome profile this chat should use. One click turns Browse on in that profile.
  4. Send your message

Browse requires the desktop app to be connected. Turning Browse on also turns on Cowork for the chat (in your home folder, or in the folder the chat used before), because Browse runs through the same desktop connection.

The Browse Card in a Chat

When an agent asks for Browse, it shows a Browse card in the chat. The card always shows where you are and the next step, and it updates by itself:

  • Desktop app missing or closed: download or open CellCog Desktop
  • Extension not added: Add to Chrome (or Install here per profile, see Step 2)
  • One Chrome profile has the extension: one click on Turn on Browse
  • Several profiles have it: pick one (the one you used last is preselected), then Turn on Browse
  • Browse is on: "Browse is on" with the profile name, and Change opens the Browse chip to switch profiles

If Browse is on but cannot run, the card turns amber and names the one thing in the way, in this order: the desktop app is not connected, the extension is missing from the chat's profile, the chat's profile is gone (Choose a profile), or that profile is not open in Chrome. Fix it and the card moves to the next problem, if any, then shows Browse is on. The Browse chip shows the same words.

On a phone, the card says "Set this up from CellCog on your computer" for the steps that need your computer.

On an AI employee shared with you, only the employee's owner can set Browse up; you see "Only <owner> can set this up for this employee." and the chip is view only.


Using Browse my Chrome in Chats

The CellCog Tab Group

When the agent first opens a tab, it creates a cyan tab group labeled "CellCog" in your Chrome tab strip. This group is the shared agent workspace:

  • Every Browse-enabled chat using the same Chrome profile sees the tabs inside this group, including chats of other CellCog accounts signed in to CellCog Desktop on this computer
  • Tabs outside the group are private to you; the agent cannot read or act on them on its own
  • It is a standard Chrome tab group: collapse it, move it, close tabs in it, and it survives Chrome restarts

Adopting Tabs You Already Have Open

If you already have a tab the agent should work with (a half-completed form, for example), the agent can adopt it into the CellCog group. Adopting moves your personal tab into the shared workspace, so it is classified moderate and respects your threshold.

Snapshots, Screenshots, Forms, Files

The agent perceives and acts on pages in a few ways:

  • Snapshot: an accessibility-tree view of the page (headings, links, form fields, button states). This is the primary way the agent understands a page.
  • Screenshot: a visual capture, saved to a temporary folder on your machine and shown in chat
  • Form fills, clicks, navigation: including logged-in flows
  • File uploads: the agent can attach files from your machine to a form's file picker
  • Downloads: files the agent downloads land in your normal Chrome download location
  • Mobile view: the agent can switch a tab to a phone or tablet emulation to check a mobile layout

Multiple Profiles

Each Chrome profile needs the extension installed separately. Each chat is bound to one profile via the Browse chip. The Browse my Chrome page and the chip show every detected profile; the ones without the extension say "Extension not added".

Chrome Profiles and Several Accounts

CellCog Desktop can hold several CellCog accounts (see "Several Accounts on One Computer" in the Cowork Guide). Chrome profiles belong to the desktop app, not to one account: every connected account can browse in every Chrome profile on the computer. Which profile a chat uses is your choice in that chat's Browse chip.

  • Choosing at connect time: when you click Add account and CellCog Browse is installed in one or more Chrome profiles, CellCog Desktop first asks which profile to open the connect page in (or your default browser), so you approve with the CellCog account signed in there. This does not tie the profile to that account.
  • Seeing your profiles: click Accounts at the bottom of CellCog Desktop. The Accounts and browsers window lists your connected accounts, then "Browser profiles, shared by all accounts": each profile with its browser and its state, Connected, "Chrome closed" (the extension is there but that profile is not open), or an Install here button.
  • Install here in that window opens the CellCog Browse page of the Chrome Web Store in exactly that profile on this computer. Click Add to Chrome there; the row turns Connected once the extension connects.

Approvals and Auto-Approval

Browse uses the same agent-classifies, you-gate model as Cowork and connected Tools. The agent classifies every browser action by the data it touches, and shows the classification and a one-sentence reason on the approval card. Your threshold decides what runs without a click.

table
LevelBrowse examples
SafeReading a public article, searching on a public site, expanding a menu
ModerateSnapshotting your inbox, a private repository, or a banking dashboard; reading cookies; listing or adopting your personal tabs
DangerousSubmitting forms, sending email, paying, deleting, writing cookies, downloading files

What each level means in the browser:

table
ThresholdWhat it auto-approves
NoneNothing. Every browser action requires your approval.
SafeSide-effect-free actions on public content. Reading your private pages and any data change still require approval. This is the default.
ModerateAlso actions that read your private data: logged-in page snapshots, cookies, personal-tab discovery. Anything that changes data still requires approval.
DangerousAlso actions that change data: form submits, cookie writes, file downloads. The most permissive setting.

You can override the level for a single chat from the Browse chip (hover the chip, click the colored dot). The full model, including pending approvals and AI employees, is in the Approvals & Safety Guide.

The Yellow Banner

Chrome shows a yellow banner across the top of every tab CellCog is driving:

"CellCog Browse started debugging this browser." with a Cancel button

This is Chrome's built-in safety indicator and CellCog cannot hide it. It appears while the agent is actively executing a batch of commands and clears shortly after the batch completes. Click Cancel at any time to revoke control of that tab; the agent sees an error on its next attempt.

Revoking Access

  • Single tab: click Cancel on the yellow banner
  • Single chat: turn the Browse chip off in the editor toolbar
  • All chats in this Chrome profile: disable the extension at chrome://extensions/
  • All of CellCog on this machine: quit the CellCog Desktop app

Privacy and Safety

What the Extension Can See

When Browse is enabled for a chat:

  • Page content (text, URLs, accessibility tree) of tabs inside the CellCog tab group
  • Form values on those tabs, excluding passwords and credit-card fields, which are redacted
  • Screenshots of those tabs when the agent captures them
  • The list of open tabs in the Chrome profile, only when the agent lists tabs (a moderate action)

What the Extension Cannot See on Its Own

  • Tabs outside the CellCog tab group
  • Browsing history
  • Bookmarks
  • Saved passwords in Chrome's password manager
  • Tabs in a different Chrome profile
  • Anything when Browse is not enabled for a chat

Sensitive-Data Redaction

Before any data leaves Chrome, the extension redacts:

  • Password fields (type=password)
  • Credit-card number fields (autocomplete=cc-number)
  • Credit-card security code fields (autocomplete=cc-csc)

The agent sees <redacted> in those fields.

Cookies, localStorage, Screenshots

These are not auto-redacted because they sometimes legitimately need to flow through the agent:

  • Cookies and localStorage: only read when the agent's script explicitly requests them. Reads are moderate, writes are dangerous.
  • Screenshots: capture whatever is visible. A logged-in page is classified moderate by the agent.

For full disclosure of these data flows, see the Privacy Policy.

Where the Data Flows

  • Between Chrome and CellCog Desktop: locally on your machine, via Chrome's Native Messaging
  • From CellCog Desktop to CellCog's servers: encrypted in transit (TLS), as part of your authenticated chat session
  • Page content the agent reads and screenshots it takes become part of the chat's context so the agent can reason about them

Troubleshooting

  • Local files (file://) cannot be opened in your Chrome by the agent. Chrome blocks extension-driven navigation to local files. The agent serves the folder over a local web server and opens http://localhost:<port>/... instead, so a preview of a file on your machine still works, with one extra step.

Extension installed but the profile is not connected

  1. Make sure the matching Chrome profile is actually open in Chrome. The extension only connects when its profile is running.
  2. Make sure CellCog Desktop is connected. Check the Cowork page for Connected.
  3. Reload the extension. Go to chrome://extensions/, find CellCog Browse, click the reload icon, then revisit the Browse my Chrome page.
  4. Open any cellcog.ai tab in that profile. A CellCog tab in the foreground helps wake the extension faster.

On Linux, a Flatpak browser shows "Extension not added"

If Chrome or Chromium is installed as a Flatpak (the default on atomic distributions such as Fedora Silverblue, Bazzite or Bluefin), Browse my Chrome cannot connect yet. The Flatpak sandbox stops the browser from reaching CellCog Desktop, so the profile keeps showing "Extension not added" even with the extension installed. To use Browse today, install Chrome as a regular package (.deb or .rpm). On an atomic distribution, run it inside a Distrobox container and export it to your app menu, then install the extension in that Chrome.

On a Mac, the page still says "Extension not installed" after installing

macOS can block CellCog Desktop from reading Chrome's settings files. When that happens, older versions of CellCog Desktop never see the extension and Browse cannot connect; current versions connect anyway, but cannot list every profile by name. To fix it, open System Settings > Privacy & Security > Full Disk Access, turn on CellCog Desktop, then quit and reopen CellCog Desktop and Chrome. When the current desktop app sees this, the Browse my Chrome page and the Browse chip in a chat show "macOS is blocking CellCog Desktop" with a How to fix link that opens these same steps.

The extension turned itself off after an update

When an extension update requests a new permission, Chrome disables the extension until you approve the change. Open chrome://extensions/, find CellCog Browse, and re-enable it.

The agent says Chrome refused to attach files ("Not allowed")

Uploads through Browse my Chrome need one extra Chrome permission on the extension. Open chrome://extensions/, click Details on CellCog Browse, and turn on Allow access to file URLs, then ask the agent to retry. An extension update can switch this off again, so check it first whenever uploads that used to work start failing. This is a Chrome rule for every extension that drives the browser, not something the agent can change on its own.

The page says Connected but my chat says Browse is not connected

The chat is probably bound to a different Chrome profile than the one with the extension.

  1. Open the Browse chip in the editor toolbar
  2. Check which profile is selected for this chat
  3. Install the extension into that profile, or switch the chat to a profile that has it

A Chrome profile is missing

Every connected account sees every Chrome profile on the computer. If one is missing from the Browse chip, open Accounts in CellCog Desktop: a profile listed with Install here does not have the extension yet, and one listed as "Chrome closed" needs to be opened in Chrome. If the profile is not listed at all, CellCog Desktop has not found it; it checks again every 30 seconds. See "Chrome Profiles and Several Accounts" above.

Yellow banner won't dismiss

The banner goes away when the agent finishes its batch and detaches, or when you click Cancel. If neither happens, check that CellCog Desktop is still running; if it quit mid-session, reload the tab.

Agent says "Tab not in CellCog group"

The agent tried to act on a tab that is not in its workspace. Ask it to adopt the tab (a moderate action), or have it open the URL fresh inside the CellCog group.

Wrong Chrome profile keeps getting picked

Clicking Add to Chrome opens the Chrome Web Store in whichever Chrome profile is currently focused. If the extension landed in the wrong profile:

  1. Remove it from that profile via chrome://extensions/
  2. Switch to the intended profile in Chrome
  3. Click Add to Chrome again, or Install here on the right profile if your desktop app offers it

Frequently Asked Questions

Why do I need both the Desktop app AND the Chrome extension?

The desktop app authenticates you and brokers every command to and from CellCog. The extension is the small piece that talks to Chrome on the desktop app's behalf and does nothing on its own. Splitting them keeps the extension minimal.

Does this work on Firefox, Safari, or Edge?

Edge, yes. Browse my Chrome works with Google Chrome and Microsoft Edge, and the desktop app also detects Brave, Vivaldi, and Chromium profiles. In Edge, install the CellCog Browse extension from the Chrome Web Store (Edge offers to allow extensions from other stores), then pick your Edge profile in CellCog. Firefox and Safari do not offer the browser interface it relies on.

Can the agent see tabs I have open outside the CellCog group?

It can list them (a moderate action, so it auto-runs only at threshold Moderate or above). It cannot interact with them until it adopts one, which is a separate moderate action.

Will my passwords or credit card numbers be sent to CellCog?

No. Password and credit-card fields are redacted before anything leaves Chrome. The agent sees <redacted>.

What happens to screenshots?

Screenshots are saved to a temporary folder on your machine and shown to the agent in chat, where they become part of the chat's context. CellCog does not store them permanently.

What about banking pages or email?

You can use Browse my Chrome on any site. Snapshotting a banking dashboard is moderate; clicking "Transfer" is dangerous. Your threshold decides what runs without your click; most people keep Safe or Moderate for sensitive sites.

Does Browse my Chrome cost extra?

No. Standard credit usage applies to the agent's work, the same as with Cowork; having Browse enabled costs nothing by itself.

Can teammates in my organization use my Browse session?

No. Browse runs against your Chrome profile on your machine, authenticated as you. Teammates install the desktop app and the extension on their own machines.

Do AI employees use my Chrome?

Only when you enable Browse for their chat. Otherwise, on a paid account, they use their own cloud browser, which runs on CellCog's servers with its own logins. See the Cloud Browsers Guide.


Related Guides