> ## Documentation Index > Fetch the complete documentation index at: https://docs.tess.im/llms.txt > Use this file to discover all available pages before exploring further. # Tess in Chrome > Tess works in the browser where you are already signed in: it opens the page, reads the screen, clicks, fills fields, and brings files back to the chat. **Tess in Chrome** is the **Tess Browser Use** extension. With it connected, chat acts in the browser where your session is already open. A request becomes action on the page: open, read, click, type, scroll, download, and upload. You keep the login you already have. Tess uses that open session on the client portal, the internal admin, the ticket queue, or the web spreadsheet. A site with no connector in Tess still fits this flow. You watch it in Chrome. The extension icon stays **Online** while it listens to chat, and the activity list shows each step. **Disconnect** stops it immediately. > [!NOTE] > > The extension is in beta. Leave the browser open, with the extension online, on the same workspace as the chat. ## Which browsers Install it from the Chrome Web Store. It runs in **Chrome** and in other Chromium browsers that accept that store, such as **Brave** and **Edge**. Firefox and Safari are out. ## Who configures it | What | Who | | - | - | | Install, sign in, pick the workspace, and turn it on in chat | Each person, on their own browser | | Use the extension in that workspace | Anyone whose plan or role includes it. Without that, setup says Tess in Chrome is unavailable | | Allowed and blocked domains for the workspace | Anyone who can edit that workspace's settings | | A rule that overrides the workspace list | The platform policy, when one is set | ## What you can hand off > [card] The session you already have > > Tess looks up, fills, and replies inside the site you already signed in to. The session stays in your browser. Chat receives what the page shows and what you asked Tess to do. > [card] A site with no connector > > An old admin, a client portal, or an internal tool becomes something you can ask for in chat, the same way you would ask about a public page. > [card] Files in both directions > > A PDF or CSV on the page lands in the conversation. A file already in the conversation goes into an upload field on the page. > [card] A tab you can see > > The work happens in a tab group for that conversation. Your other tabs stay outside that group. On a login wall or a captcha, Tess stops and tells you what is blocking it. ## Install and connect **1. Install Tess Browser Use** Open the [Chrome Web Store](https://chromewebstore.google.com/detail/tess-browser-use/kmbnaabmlpnphohapalahaedkmihkppa) and add the extension. **2. Sign in with your Tess account** Click the extension icon and choose **Sign in with Tess**. Tess opens its usual login (email, Google, or SSO). After you sign in, you return to the extension. There is no token to copy. **3. Choose the workspace** Tess only acts in the workspace you select. Optionally name this browser, for example "Work laptop", so you can recognize it in your account. **4. Save and connect** Choose **Save and connect**. The status becomes **Connected — Online**. The extension then listens for commands from that workspace. If the workspace has no access to the extension, the setup screen says so. Ask a workspace admin to enable it. ## Use it in chat **1. Open a chat in the same workspace** The chat workspace and the extension workspace have to match. If the extension is on another workspace, chat asks you to switch it and connect again. **2. Turn on Browser Extension** In the composer, open **+**, go to connectors, and turn on **Browser Extension**. The item shows a **Beta** badge. **3. Name the site and the result** Include the address, what to look at, and what to bring back. Example: "Open [https://admin.example.com/orders](https://admin.example.com/orders), filter this week's late orders, and return a table with number, customer, and date." **4. Leave the browser open** Tess opens or reuses a tab, looks at the page, and takes one step at a time. The extension popup lists the activity. > [!TIP] > > On the first run, ask for a reading. On the next message, ask for the action. For example: "Fill the reimbursement form with these fields and stop on the review screen." If this agent does not allow tools, the item stays disabled and the composer says the agent setup blocked it. ### Prompts worth a first session * "Open this status page and tell me which services are degraded right now." * "In the admin, download this month's usage CSV and point out accounts that dropped more than 20%." * "Reply to ticket 441 with this text and send it." * "Upload this conversation file into the attachment field and show me the screen after the upload." ## What Tess does on the page | You ask for | The extension does | | - | - | | Open an address | Navigates in this conversation's tab | | Read the page | Looks at the visible area and, when it must click or quote a passage, reads the page content | | Click or type | Acts on the element it just identified | | A long page | Scrolls and looks again | | More than one page | Opens another tab in the same group and can close it afterward | | A file on the page | Brings the file into the conversation | | A file from the conversation | Sends it to an upload field on the page | ## Which sites it can open Anyone who can edit workspace settings does this in the **Settings** modal, not in the extension. **1. Open Settings** Click your name in the corner of the screen and choose **Settings**. **2. Open Workspace** In the sidebar, under the **Workspace** group, click **Workspace**. **3. Scroll to the extension card** The **Browser extension domain policy** card is at the bottom of that screen, after **Profile Settings** and **Social profiles**. It holds **Allowed domains** and **Blocked domains**. **Manage domains one by one** opens the same lists, one domain at a time. People who cannot edit workspace settings see those fields disabled. * **Allowed domains.** When this list has any domain, the extension only acts on those domains and their subdomains. `example.com` covers `example.com` and `www.example.com`. It does not cover `my-example.com`. * **Blocked domains.** These sites stay out. A domain on both lists stays blocked. * The platform-wide policy overrides the workspace list. Some destinations are blocked from the start: local pages, Google and Microsoft account login screens, and payment surfaces such as PayPal and Stripe. ## When something stalls * **Session expired.** Open the extension settings and sign in with Tess again. * **Extension out of date.** The popup asks for an update. Update it from the Chrome Web Store and connect again. * **Saved, still offline.** In settings, choose **Save and reconnect**. * **Chat does not touch the browser.** Check three things: status **Online**, the same workspace in the popup and in the chat, and **Browser Extension** turned on in the composer. * **Login or captcha on the page.** Tess stops and describes the block. Resolve it in the tab and ask Tess to continue. * **Switch accounts.** In the extension settings, choose **Switch account**. To stop immediately, open the popup and choose **Disconnect**. Questions: [suporte@tess.im](mailto:suporte@tess.im). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.