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.Navigate a page
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.
- 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).
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.
Set the default browser
Chats you haven’t picked a browser for use the Default browser setting:- Open Settings and go to the Kombai Browser tab.
- Set Default browser to New Tab or External 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:- Open Settings and go to the General tab.
- Next to Clear browser cookies and site data, click Clear.
- In the Clear browser data? dialog, click Clear.
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
Why can't I use Web Capture in the in-app browser?
Why can't I use Web Capture in the in-app browser?
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.