Documentation — Spybara

app/chrome-extension.md +86 −55

Details

1# Chrome extension1# Chrome extension

2 2

~~3Use ChatGPT with Chrome for browser tasks that need your signed-in browser~~3Use the Chrome extension to let ChatGPT control your Chrome browser. ChatGPT can

~~4state. Use it when ChatGPT needs to read or act on sites such as LinkedIn,~~4read or act on sites where you're already signed in, such as LinkedIn,

5Salesforce, Gmail, or internal tools.5Salesforce, Gmail, or internal tools.

6 6

~~7For local development servers, file-backed previews, and public pages that do~~7To let ChatGPT control its built-in browser instead, use `@Browser`. The

~~8not require sign-in, use the [built-in browser](https://learn.chatgpt.com/docs/browser?surface=app) first. The~~8[built-in browser](https://help.openai.com/en/articles/20001277-using-the-built-in-browser-in-the-chatgpt-desktop-app)

~~9built-in browser keeps preview and verification work inside ChatGPT without using~~9supports sign-in and keeps browsing work inside ChatGPT without using your

~~10your Chrome profile.~~10Chrome profile.

11 11

12ChatGPT can also switch between tools as a task requires, using plugins when a12ChatGPT can also switch between tools as a task requires, using plugins when a

13dedicated integration is available, Chrome when it needs logged-in browser13dedicated integration is available, Chrome when it needs logged-in browser

22 />22 />

23</div>23</div>

24 24

~~25## Set up Chrome from Plugins~~25## Use ChatGPT from Chrome

26 26

~~27Install the Chrome plugin to start setup:~~27Open ChatGPT beside the page you're viewing to ask about the page or continue

28into tasks that can use its context alongside local files and connected apps.

29ChatGPT can use context from your open tabs when a task needs it.

28 30

~~291. Open the ChatGPT desktop app, select ChatGPT Work or Codex, and go to **Plugins**.~~311. Open the page you want to work with.

~~302. Add the **Chrome** plugin.~~322. Select ChatGPT from the Chrome toolbar or **Extensions** menu. On macOS, you

~~313. Follow the setup flow. It guides you through installing the [Chrome~~33 can also press <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>.</kbd>.

~~32 extension](https://chromewebstore.google.com/detail/codex/hehggadaopoacecdllhhajmbjkdcmajg)~~343. Ask a question about the page or give ChatGPT a task.

~~33 and approving Chrome's permission prompts.~~35

~~344. Open Chrome and confirm the extension shows **Connected**.~~36The panel stays with the tab where you opened it. Threads you start in Chrome

37are available in the ChatGPT app, and you can open recent ChatGPT threads in

38Chrome, so you can continue work in either place.

40<Illustration description="ChatGPT open beside the current Chrome tab.">

41 <ChromeSidePanelIllustration

42 ariaLabel="ChatGPT open beside the current Chrome tab."

43 backgroundImage="/images/codex/codex-wallpaper-1.webp"

44 />

45</Illustration>

47## Set up the Chrome extension

49In the ChatGPT desktop app, open the Plugins Directory and install **Chrome**.

50Other Chromium-based browsers aren't currently supported. Follow the setup flow

51to:

531. Install the [Chrome

54 extension](https://chromewebstore.google.com/detail/chatgpt/hehggadaopoacecdllhhajmbjkdcmajg).

552. Approve Chrome's permission prompts.

563. Open Chrome and confirm the ChatGPT side chat loads.

58<Illustration description="Computer Use settings showing Google Chrome connected through the Chrome extension.">

59 <ComputerUseSettingsIllustration

60 ariaLabel="Computer Use settings showing Google Chrome connected through the Chrome extension."

61 aspectRatio="3 / 1"

62 controlRows={[

63 {

64 id: "chrome",

65 title: "Google Chrome",

66 description: "Connected to browser extension for additional control",

67 icon: "chrome",

68 enabled: true,

69 connected: true,

70 manageLabel: "Manage",

71 },

72 ]}

73 showAlwaysAllowedApps={false}

74 />

75</Illustration>

77## Start a Chrome task from ChatGPT

35 78

36After the plugin setup is complete, start a new task in Work or Codex. ChatGPT79After the plugin setup is complete, start a new task in Work or Codex. ChatGPT

~~37can suggest Chrome when a task needs a signed-in website. You can also invoke it~~80can use Chrome automatically when a task needs a website and you're already

~~38directly in a prompt:~~81signed in to Chrome. You can also invoke it directly in a prompt:

39 82

40```text83```text

41@Chrome open Salesforce and update the account from these call notes.84@Chrome open Salesforce and update the account from these call notes.

52When ChatGPT asks to use a website, you can choose the option that matches the95When ChatGPT asks to use a website, you can choose the option that matches the

53task and your risk tolerance:96task and your risk tolerance:

54 97

~~55- Allow the website for the current task.~~98- **Allow once** to let ChatGPT use the website one time.

~~56- Always allow the host so ChatGPT can use that website again without asking.~~99- **Allow for this site** so ChatGPT can use the website again without asking.

~~57- Decline the website.~~100- **Allow for all sites** so ChatGPT can use websites without asking.

101- **Decline** to prevent ChatGPT from using the website.

58 102

~~59### Manage the allowlist and blocklist~~103### Manage allowed and blocked websites

60 104

~~61In Computer Use settings, you can manage an allowlist and blocklist for~~105In the ChatGPT desktop app, go to **Settings** > **Computer Use**, then select

~~62domains. The allowlist contains domains ChatGPT can use without asking again. The~~106**Manage** next to **Google Chrome** to manage an allowlist and blocklist for

~~63blocklist contains domains ChatGPT shouldn't use.~~107domains. The allowlist contains domains ChatGPT can use without asking again.

108The blocklist contains domains ChatGPT shouldn't use.

64 109

65Removing a domain from the allowlist means ChatGPT asks again before using it.110Removing a domain from the allowlist means ChatGPT asks again before using it.

66Removing a domain from the blocklist means ChatGPT can ask again instead of111Removing a domain from the blocklist means ChatGPT can ask again instead of

67treating the domain as blocked.112treating the domain as blocked.

68 113

~~69#### Always allow browser content <ElevatedRiskBadge class="ml-2" />~~114#### Allow for all sites <ElevatedRiskBadge class="ml-2" />

70 115

~~71If you turn on always allow browser content, ChatGPT no longer asks for~~116If you select **Allow for all sites**, ChatGPT no longer asks for confirmation

~~72confirmation before using websites.~~117before using websites. Only choose this option if you trust ChatGPT to use any

118website open in Chrome.

73 119

74#### Browser history <ElevatedRiskBadge class="ml-2" />120#### Browser history <ElevatedRiskBadge class="ml-2" />

75 121

125access isn't in the blocklist in Settings. If the website isn't blocked, work171access isn't in the blocklist in Settings. If the website isn't blocked, work

126through these checks:172through these checks:

127 173

1281. Open the extension from the Chrome toolbar or Chrome's extensions1741. Update the ChatGPT desktop app. If you have more than one ChatGPT or Codex

129 menu. Make sure it shows **Connected**. If it shows disconnected or mentions175 desktop app installed, update each one or remove copies you no longer use.

130 a missing native host, remove and re-add the Chrome plugin from **Plugins**1762. Close the ChatGPT side panel, restart Chrome, then reopen the extension from

131 in Work or Codex in the ChatGPT desktop app, then follow the setup flow177 the Chrome toolbar or **Extensions** menu. Confirm the side chat loads. If

132 again.178 it doesn't load or mentions a missing native host, remove and re-add the

1332. In the app, select Work or Codex, open **Plugins**, and confirm that the179 Chrome plugin from **Plugins** in Work or Codex in the ChatGPT desktop app,

180 then follow the setup flow again.

1813. In the app, select Work or Codex, open **Plugins**, and confirm that the

134 Chrome plugin is on. If the plugin is off, turn it on and182 Chrome plugin is on. If the plugin is off, turn it on and

135 try the task again.183 try the task again.

1363. Make sure you are using the same Chrome profile where the extension is1844. Make sure you are using the same Chrome profile where the extension is

137 installed. If you use more than one Chrome profile, install and enable the185 installed. If you use more than one Chrome profile, install and enable the

138 extension in the active profile.186 extension in the active profile.

1394. Start a new task in Work or Codex and try the Chrome task again. This can1875. Start a new task in Work or Codex and try the Chrome task again. This can

140 clear task-specific connection state.188 clear task-specific connection state.

1415. Restart Chrome and the app, then try again. If the extension1896. Restart the ChatGPT desktop app, then try again. If the extension still

142 still doesn't connect, uninstall the Chrome extension, remove and re-add the Chrome190 doesn't connect, uninstall the Chrome extension, remove and re-add the Chrome

143 plugin from **Plugins**, and follow the setup flow again.191 plugin from **Plugins**, and follow the setup flow again.

1446. If the extension shows **Connected** but ChatGPT still can't use Chrome, run1927. If the side chat loads but ChatGPT still can't use Chrome, run `/feedback`

145 `/feedback` in the app and include the task ID when you contact193 in the app and include the task ID when you contact support.

146 support.

~~147~~

148<CodexScreenshot

149 alt="Chrome extension showing connected status"

150 lightSrc="/images/codex/app/chrome-connected-light.png"

151 darkSrc="/images/codex/app/chrome-connected-dark.png"

152 maxHeight="300px"

153 class="mt-4"

154/>

155 194

156### Upload files195### Upload files

157 196

1643. Turn on **Allow access to file URLs**.2033. Turn on **Allow access to file URLs**.

165 204

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

~~167~~

168<CodexScreenshot

169 alt="Chrome extension settings showing Allow access to file URLs enabled for ChatGPT"

170 lightSrc="/images/codex/app/chrome-file-url-access-light.webp"

171 darkSrc="/images/codex/app/chrome-file-url-access-dark.webp"

172 maxHeight="420px"

173 class="mt-4"

174/>

chrome-extension.md +86 −55