Skip to main content
In the Kombai desktop app, the Kombai Browser opens as a tab in your chat’s 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

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. Each page has a navigation row with the icon (Back), the icon (Forward), the icon (Reload), and an address field. While the page loads, the icon changes to the icon (Stop). Kombai treats what you type in the address field as an address, not a search. Right-click a page’s tab for Duplicate Tab and Close All Tabs, plus Close Other Tabs when more than one tab is open and Close Tabs to the Right when tabs follow it. If a page’s address is an https link ending in .png, .jpg, .jpeg, .webp, or .gif, the icon (Add this image to the chat) appears in the navigation row of a chat you’ve already started. Click it to save the image to your project’s .kombai/assets folder and add it to your chat.

Select and snip

Select an element or snip a region of the page and add it to your chat as context, without switching to External Browser. Both controls are icons in the page’s navigation row. Hover over one to see its name and shortcut. Click the icon again, or press Esc, to stop. Both icons are disabled on a new tab or a crashed page.

Edit elements and text

Edit a page’s text, styles, and layout right in the in-app browser, without switching to External Browser.
  • Edit text: Click the icon (Edit page text), or press ⌘ ⌥ T / Ctrl Alt T, to make every text element on the page editable, then click a text element to edit it. You can also double-click a text element while the icon (Select elements to add to the chat) is on, without turning on the icon. Click away, or press Esc, to stop.
  • Edit styles, move, hide, or delete elements: Turn on the icon (Select elements to add to the chat), then click the icon (Edit panel) that appears next to it, or press ⌘ ⌥ E / Ctrl Alt E, to open the edit panel. Click an element on the page, or a row in the panel, to select it.
The edit panel shows:
  • A layers tree of the page. Drag a row to move its element, click its icon to hide or show it, or click its icon for Copy selector and Delete.
  • A CSS inspector below the layers tree, with Design and CSS tabs, for the selected element’s styles.
  • At the top, the icon (Undo), the icon (Redo), the icon (Discard all unsent edits), and the icon (Close edit panel). Discarding all takes two clicks: the first shows Discard all? next to the icon, and the second discards.
  • A Delete element button at the bottom (disabled with nothing selected, or for the page’s root element).
Kombai refuses some edits: deleting the page’s root element, or moving an element into its own subtree or somewhere it can’t go. Edits you haven’t added to the chat stay listed under Not in chat. On each one, click the icon (Add to chat) to add it, or the icon (Discard these edits) to drop it. While a page has such edits, its navigation row shows a 1 unsent edit (or N unsent edits) button; click it to open the edit panel at that list. The edit panel has no text-editing control of its own. Use the icon (Edit page text), or double-click a text element while the icon (Select elements to add to the chat) is on. To close the edit panel, click the icon (Edit panel) again, or the panel’s icon (Close edit panel). The panel also closes when you turn off the icon (Select elements to add to the chat).

Set the page’s screen size

Click the zoom chip or the icon at the end of the navigation row, then pick a preset or set the zoom yourself: You can also use Cmd or Ctrl + −/+ 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.
To change a chat’s browser, hover over the icon in the chat header and choose New Tab or External Browser from the menu that opens. 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, click the icon at the end of the navigation row 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 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. To use Web Capture or the extension’s own sidebar tools, switch the chat to External Browser. See 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, 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:
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.
  1. Open Settings and go to the General 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 also clears the in-app browser’s cookies and site data, browsing history, and download list, but keeps the cookies you imported from Chrome.

Browsing history and downloads

The in-app browser keeps a history of every page you or the agent visit, and a list of your downloads.
  • While a download is running, and for a day after one finishes, the icon (Downloads) appears in the page’s navigation row, ringed with the progress of running downloads. Click it to see recent downloads. Click a download’s icon (More actions) for Open, Show in Finder (Show in Explorer on Windows, Show in Folder on Linux), Copy Address, Copy Path, Cancel Download (while it’s running), and Remove from List.
  • Open Settings, go to the Kombai Browser tab, and open History or Download history under Browsing data to review the full lists.
  • To remove this data, click Clear… next to Clear browsing data in the same section, choose any combination of Browsing history, Download history, and Cookies and site data, and click Clear data.

New tab page

A new browser tab opens on the New tab page instead of a blank page:
  • Tools shows tiles for Canvas Gallery, Changes, and Files, plus More tools… for Inspirations, Settings, Browsing history, and Downloads.
  • Suggested shows up to eight of the pages you visit most, weighted toward recent visits. Click one to open it in the current tab, or ⌘/Ctrl-click or middle-click to open it in a new tab. Click its × to remove it (and every visit to it) from your history.
  • On macOS, the New tab page shows an Import data from Chrome banner. Click Import to pick a Chrome profile and import its cookies, the same way as importing a Chrome profile. The banner stops appearing once you import or close it.

FAQ

Web Capture runs only in the browser extension, in a Chrome window. The in-app browser has Select and snip and the edit panel for editing text, styles, and layout, but not Web Capture or the rest of the extension’s sidebar.To use Web Capture, switch to External Browser in one of these ways:
  • For the current chat: Hover over the icon in the chat header and choose External Browser.
  • For all chats by default: Change the Default browser setting to External Browser.