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

# In-app browser

> Kombai can now access an in-app browser to navigate, interact, and perform tasks.

export const Globe = props => {
  return <div style={{
    display: "inline",
    justifyContent: "center",
    alignItems: "center"
  }}>
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="18" height="18" fill="currentColor" stroke="currentColor" strokeWidth="0" style={{
    display: "inline"
  }} {...props}>
        <path d="M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1Zm3.241 10.5v-.001c-.1-2.708-.992-4.904-1.89-6.452a13.919 13.919 0 0 0-1.304-1.88L12 3.11l-.047.059c-.354.425-.828 1.06-1.304 1.88-.898 1.547-1.79 3.743-1.89 6.451Zm-12.728 0h4.745c.1-3.037 1.1-5.49 2.093-7.204.39-.672.78-1.233 1.119-1.673C6.11 3.329 2.746 7 2.513 11.5Zm18.974 0C21.254 7 17.89 3.329 13.53 2.623c.339.44.729 1.001 1.119 1.673.993 1.714 1.993 4.167 2.093 7.204ZM8.787 13c.182 2.478 1.02 4.5 1.862 5.953.382.661.818 1.29 1.304 1.88l.047.057.047-.059c.354-.425.828-1.06 1.304-1.88.842-1.451 1.679-3.471 1.862-5.951Zm-1.504 0H2.552a9.505 9.505 0 0 0 7.918 8.377 15.773 15.773 0 0 1-1.119-1.673C8.413 18.085 7.47 15.807 7.283 13Zm9.434 0c-.186 2.807-1.13 5.085-2.068 6.704-.39.672-.78 1.233-1.118 1.673A9.506 9.506 0 0 0 21.447 13Z"></path>
      </svg>
    </div>;
};

In the Kombai desktop app, the Kombai Browser opens as a tab in your chat's [right panel](/get-started/navigating-the-desktop-app#right-panel) instead of in a separate Chrome window. You and Kombai's agent work on the same pages, next to the chat.

The in-app browser is available only in the desktop app. The IDE extension always opens the Kombai Browser in a Chrome window.

## Open the in-app browser

| From | Do this |
| - | - |
| Top bar | Click the <Globe /> icon in the [top bar](/get-started/navigating-the-desktop-app#top-bar). |
| Right panel | Click **+** and choose **Browser**. If the panel is empty, click **Browser**. Requires an open project. |
| Chat | Click a localhost link that Kombai posts after it starts your project. |
| Agent | Ask Kombai to do a task in the browser. |

## How browser pages work across chats

Each chat has a separate browser session. Every page you or the agent opens in a chat belongs to that particular chat's session. The agent can only see the pages from the current chat. To have the agent work on a page that's open in another chat, open the page again in the current chat.

## Navigate a page

Each page has a navigation row with **Back**, **Forward**, **Reload** (**Stop** while the page loads), and an address field. Kombai treats what you type in the address field as an address, not a search.

| Shortcut (page focused) | Action |
| - | - |
| <kbd>⌘ R</kbd> / <kbd>Ctrl R</kbd> | Reload the page. Add <kbd>Shift</kbd> to reload without the cache. |
| <kbd>⌘ =</kbd> / <kbd>Ctrl =</kbd> | Zoom in. |
| <kbd>⌘ -</kbd> / <kbd>Ctrl -</kbd> | Zoom out. |
| <kbd>⌘ 0</kbd> / <kbd>Ctrl 0</kbd> | Reset zoom to **Desktop**. |
| <kbd>⌘ W</kbd> / <kbd>Ctrl W</kbd> | Close the page's tab. |

## Set the page's screen size

Click the zoom chip or the <Icon icon="ellipsis" size={16} /> **Page menu** button, then pick a preset or set the zoom yourself:

| Preset | Layout width |
| - | - |
| **Desktop** (default) | 1280px |
| **Laptop** | 1440px |
| **Tablet** | 768px |
| **Mobile** | 390px |

You can also use <kbd>Cmd</kbd> or <kbd>Ctrl</kbd> + <kbd>−</kbd>/<kbd>+</kbd> to change the page zoom.

## Choose where the browser opens

Each chat uses one of two browsers:

* **New Tab**: The in-app browser described on this page.
* **External Browser**: A separate Chrome window with the [Kombai Browser extension](/browser/get-started#extension-ui).

To change a chat's browser, click the chevron next to the <Globe /> icon in the top bar and choose **New Tab** or **External Browser**. A check marks the chat's current browser. Your choice opens a page and applies to that chat until you close it or restart the app.

To open one in-app page in a Chrome window, open the **Page menu** and choose **Open in Chrome window**. That chat then uses the Chrome window.

Switching doesn't move pages that are already open. The agent keeps using any browser it already has open, and its next new browser opens in the chat's new choice.

### Set the default browser

Chats you haven't picked a browser for use the **Default browser** setting:

1. Open [Settings](/account/settings) and go to the **Kombai Browser** tab.
2. Set **Default browser** to **New Tab** or **External Browser**.

The setting applies the next time a chat opens a browser.

### What works in each browser

The agent's browser tools — navigating, clicking, typing, screenshots, inspection, and audits — work the same in both. The browser extension's sidebar exists only in the Chrome window.

| | New Tab | External Browser |
| - | - | - |
| [Agent browser operations](/browser/autonomous-agent-operations) | Yes | Yes |
| Extension sidebar: element selector, snipping tool, text and DOM editors, Web Capture, Layers, and Design | No | Yes |
| Agent reads your element selections from the sidebar | No | Yes |

If you want to send elements or visual edits from the page, switch the chat to **External Browser**. See [Capabilities](/browser/capabilities) for the sidebar tools.

## Sign-ins and cookies

Sign-ins in the in-app browser persist across chats and app restarts. If you [imported a Chrome profile](/browser/get-started#import-cookies-from-chrome-profiles), its cookies apply to in-app pages too.

Sites in the in-app browser can't use your camera or microphone, and other permission requests are denied, because the app has no permission prompt.

To clear in-app sign-ins:

<Warning>
  Clearing also deletes the cookies you imported from Chrome profiles, including for the Kombai IDE extension. You can import them again from **Settings > Kombai Browser**.
</Warning>

1. Open [Settings](/account/settings) and go to the **Other** tab.
2. Next to **Clear browser cookies and site data**, click **Clear**.
3. In the **Clear browser data?** dialog, click **Clear**.

The row shows **Browser data cleared.** when it finishes. Open pages stay open, signed out. Signing out of Kombai clears the same data.

## FAQ

<AccordionGroup>
  <Accordion title="Why can't I select or snip elements in the in-app browser?">
    The element selector, snipping tool, and the other [browser extension tools](/browser/capabilities) run only in a Chrome window. The in-app browser doesn't have them.

    To use them, switch to **External Browser** in one of these ways:

    * **For the current chat:** Click the chevron next to the <Globe /> icon in the top bar and choose **External Browser**.
    * **For all chats by default:** Change the [**Default browser** setting](#set-the-default-browser) to **External Browser**.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.