> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerotwo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Chrome extension

Use the Chrome extension to let ZeroTwo control your Chrome browser. ZeroTwo can
read or act on sites where you're already signed in, such as LinkedIn,
Salesforce, Gmail, or internal tools.

To let ZeroTwo control its built-in browser instead, use `@Browser`. The
[built-in browser](https://help.zerotwo.ai/en/articles/20001277-using-the-built-in-browser-in-the-chatgpt-desktop-app)
supports sign-in and keeps browsing work inside ZeroTwo without using your
Chrome profile.

ZeroTwo can also switch between tools as a task requires, using plugins when a
dedicated integration is available, Chrome when it needs logged-in browser
context, and the built-in browser for localhost.

<Warning />

## Use ZeroTwo from Chrome

Open ZeroTwo beside the page you're viewing to ask about the page or continue
into tasks that can use its context alongside local files and connected apps.
ZeroTwo can use context from your open tabs when a task needs it.

1. Open the page you want to work with.
2. Select ZeroTwo from the Chrome toolbar or **Extensions** menu. On macOS, you
   can also press <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>.</kbd>.
3. Ask a question about the page or give ZeroTwo a task.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/zerotwo/B2FY-6wZG9TdQ3iS/images/codex/chrome-extension/side-panel-light.webp?fit=max&auto=format&n=B2FY-6wZG9TdQ3iS&q=85&s=7e71925d2b8c65c2c71087c97ffdf8e9" alt="A public webpage open beside the ZeroTwo Chrome side panel" width="1540" height="1000" data-path="images/codex/chrome-extension/side-panel-light.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/zerotwo/B2FY-6wZG9TdQ3iS/images/codex/chrome-extension/side-panel-dark.webp?fit=max&auto=format&n=B2FY-6wZG9TdQ3iS&q=85&s=b830f85629ff3dd77dc9da164629336f" alt="A public webpage open beside the ZeroTwo Chrome side panel" width="1540" height="1000" data-path="images/codex/chrome-extension/side-panel-dark.webp" />
</Frame>

The panel stays with the tab where you opened it. Chats you start in Chrome
are available in the ZeroTwo app, and you can open recent ZeroTwo chats in
Chrome, so you can continue work in either place.

## Bring tabs and selected text into a chat

Mention an open Chrome tab in the side chat when you want ZeroTwo to use that
page as context. You can also highlight text on a page and bring the selection
into your chat to ask about a specific passage without copying the whole page.

To start from the page instead, right-click it and select **Ask ZeroTwo**. The
side chat opens with the relevant page context so you can continue the request
in Chrome.

### Ask about a YouTube video

Open a YouTube video, then ask a question about it in the Chrome side chat.
When captions are available, ZeroTwo can use the video's timestamped transcript
to explain, summarize, or answer questions about the content.

Treat webpage content, selected text, and video transcripts as untrusted
context. Review the page and any requested permissions before asking ZeroTwo to
use or act on that information.

## Set up the Chrome extension

In the ZeroTwo desktop app, open the Plugins Directory and install **Chrome**.
Other Chromium-based browsers aren't currently supported. Follow the setup flow
to:

1. Install the [Chrome
   extension](https://chromewebstore.google.com/detail/chatgpt/hehggadaopoacecdllhhajmbjkdcmajg).
2. Approve Chrome's permission prompts.
3. Open Chrome and confirm the ZeroTwo side chat loads.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/zerotwo/B2FY-6wZG9TdQ3iS/images/codex/chrome-extension/connected-light.webp?fit=max&auto=format&n=B2FY-6wZG9TdQ3iS&q=85&s=650d4e7a0ff2f90f5c3f0660e612e8e0" alt="ZeroTwo Computer Use settings showing Chrome connected" width="570" height="56" data-path="images/codex/chrome-extension/connected-light.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/zerotwo/B2FY-6wZG9TdQ3iS/images/codex/chrome-extension/connected-dark.webp?fit=max&auto=format&n=B2FY-6wZG9TdQ3iS&q=85&s=6be481358cb734eaa163b0292deb2539" alt="ZeroTwo Computer Use settings showing Chrome connected" width="570" height="56" data-path="images/codex/chrome-extension/connected-dark.webp" />
</Frame>

## Start a Chrome task from ZeroTwo

After the plugin setup is complete, start a new ZeroTwo Work or ZeroCode chat. ZeroTwo
can use Chrome automatically when a task needs a website and you're already
signed in to Chrome. You can also invoke it directly in a prompt:

```text theme={null}
@Chrome open Salesforce and update the account from these call notes.
```

If Chrome isn't already open, ZeroTwo can open it. Chrome browser tasks run in
Chrome tab groups so the work for a task stays grouped together.

## Control website access

By default, ZeroTwo asks before it interacts with each new website. ZeroTwo bases
the prompt on the website host, such as `example.com`.

When ZeroTwo asks to use a website, you can choose the option that matches the
task and your risk tolerance:

* **Allow once** to let ZeroTwo use the website one time.
* **Allow for this site** so ZeroTwo can use the website again without asking.
* **Allow for all sites** so ZeroTwo can use websites without asking.
* **Decline** to prevent ZeroTwo from using the website.

### Manage allowed and blocked websites

In the ZeroTwo desktop app, go to **Settings** > **Computer Use**, then select
**Manage** next to **Google Chrome** to manage an allowlist and blocklist for
domains. The allowlist contains domains ZeroTwo can use without asking again.
The blocklist contains domains ZeroTwo shouldn't use.

Removing a domain from the allowlist means ZeroTwo asks again before using it.
Removing a domain from the blocklist means ZeroTwo can ask again instead of
treating the domain as blocked.

#### Allow for all sites ⚠️ **Elevated risk**

If you select **Allow for all sites**, ZeroTwo no longer asks for confirmation
before using websites. Only choose this option if you trust ZeroTwo to use any
website open in Chrome.

#### Browser history ⚠️ **Elevated risk**

Browser history can include sensitive telemetry, internal URLs, search terms,
and activity from Chrome sessions on signed-in devices. If you allow ZeroTwo to
access browser history, relevant history entries can become part of the context
ZeroTwo uses for the task. Malicious or misleading page content can increase the
risk that ZeroTwo copies this data somewhere unintended.

ZeroTwo asks when it wants to use browser history. ZeroTwo scopes history access to
the request, and history doesn't have an always-allow option.

## Data and security

### Chrome extension permissions

Chrome asks you to accept extension permissions when you install the extension.
The permission prompt may include:

* Access the page debugger
* Read and change all your data on all websites
* Read and change your browsing history on all your signed-in devices
* Display notifications
* Read and change your bookmarks
* Manage your downloads
* Communicate with cooperating native applications
* View and manage your tab groups

These Chrome permissions make the extension capable of operating browser
workflows. ZeroTwo still uses its own confirmations, settings, allowlists, and
blocklists before using websites or browser history during a task.

### Memories

Computer Use follows your Memories setting. If Memories is on, ZeroTwo can
use relevant saved memories while working in Chrome. If Memories is off, browser
control doesn't use memories.

### What ZeroTwo stores from browsing

ZeroTwo doesn't store a separate complete record of your Chrome actions from the
extension. ZeroTwo stores browser activity only when it becomes part of the ZeroTwo
context, such as text ZeroTwo reads from a page, screenshots, tool calls,
summaries, messages, or other content included in the chat.

Your ZeroTwo data controls apply to content processed in context.
Avoid sending secrets or highly sensitive data through browser tasks unless
they're required and you are present to review each prompt.

## Troubleshooting

If ZeroTwo can't connect to Chrome, first confirm the website ZeroTwo is trying to
access isn't in the blocklist in Settings. If the website isn't blocked, work
through these checks:

1. Update the ZeroTwo desktop app. If you have more than one ZeroTwo or ZeroCode
   desktop app installed, update each one or remove copies you no longer use.
2. Close the ZeroTwo side panel, restart Chrome, then reopen the extension from
   the Chrome toolbar or **Extensions** menu. Confirm the side chat loads. If
   it doesn't load or mentions a missing native host, remove and re-add the
   Chrome plugin from **Plugins** in the ZeroTwo desktop app, then follow the
   setup flow again.
3. In the app, select ZeroTwo and turn on Work in the switcher, or select ZeroCode. Open
   **Plugins** and confirm that the Chrome plugin is on. If the plugin is off,
   turn it on and try the task again.
4. Make sure you are using the same Chrome profile where the extension is
   installed. If you use more than one Chrome profile, install and enable the
   extension in the active profile.
5. Start a new ZeroTwo Work or ZeroCode chat and try the Chrome task again. This can
   clear chat-specific connection state.
6. Restart the ZeroTwo desktop app, then try again. If the extension still
   doesn't connect, uninstall the Chrome extension, remove and re-add the Chrome
   plugin from **Plugins**, and follow the setup flow again.
7. If the side chat loads but ZeroTwo still can't use Chrome, run `/feedback`
   in the app and include the chat ID when you contact support.

### Upload files

If a Chrome task needs to upload a file from your computer, allow the Chrome
extension to access file URLs in Chrome:

1. In Chrome, open the extensions icon in the toolbar, then click **Manage
   Extensions**.
2. On the extension card, click **Details**.
3. Turn on **Allow access to file URLs**.

After you change the setting, start the Chrome task again.
