Skip to content

Browser Panes

Jump to bottom
nick3 edited this page May 28, 2026 · 1 revision

Browser Panes

A pane can be a full Chromium webview instead of a terminal — with back/forward/reload, address bar, bookmarks, history, downloads, find-in-page, and multi-tab support.

Creating a browser pane

Right-click empty pane → Browser → enter a starting URL (or leave blank for about:blank). The pane swaps in immediately.

You can also Convert to Browser an existing terminal pane (kills the PTY first; prompts you to confirm).

Component: src/renderer/components/BrowserPane.tsx. Backend state in src/main/browser-store.ts.

Chrome controls

The top strip of every browser pane has:
← → Back / forward
↻ Reload (Shift+click for hard reload)
Address bar Type URL or search query — search uses your default engine setting
⋮ Overflow menu (bookmarks, history, downloads, find-in-page, saved logins, devtools)
Tab strip One row per open tab (see below)
Drag handle The title bar acts as a drag handle for pane swap

Multi-tab

Click the + at the right of the tab strip to open a new tab. Tabs persist across app restarts — title, favicon, and URL are all saved (in clusterspace-browser-pane-state.json) so reopening lands you in the right place visually before each tab re-fetches its page.

Right-click a tab for Close, Duplicate, Pin (sticks to the left), Mute.

Custom user agent

By default, ClusterSpace presents a UA string that matches stock Chromium for the current Electron version. This avoids bot-detection on services that block Electron-by-name UA strings (Google sign-in, some banking portals).

Override per-pane via the overflow menu → User Agent → pick a preset (iPhone, iPad, Galaxy, Pixel, etc.) or paste a custom string.

Bookmarks

Add the current page via the overflow menu → Bookmark this page (or Ctrl+D while focused on the pane). Bookmarks persist globally — not per pane — so you can navigate to a bookmark from any browser pane.

Manage bookmarks (rename, delete, reorder) via the bookmarks panel in the overflow menu.

History

Last 500 visited pages (per user, global across all panes). View via the overflow menu → History. Click any entry to navigate to it in the current tab.

History is stored in clusterspace-browser-pane-state.json. Wipe via Settings → Clear browsing history.

Downloads

Active downloads appear as chips in the status bar with progress. Completed downloads stay in the chip rail until dismissed (×). Click a finished chip to reveal the file in your OS file manager.

Files land in your OS default download directory (typically ~/Downloads/).

Find in page

Ctrl+F while focused on a browser pane opens an inline find bar. Enter to jump to next match, Shift+Enter for previous, Esc to dismiss.

Pane drag-to-move

Browser panes don't have a tmux tab strip, so we needed a non-content area to grab for pane swap. The title bar (the strip above the chrome controls) is the drag handle. Grab and drop on another pane to swap.

Convert pane

Two conversions are available from the overflow menu (and via the AI tools convert_pane_to_terminal / convert_pane_to_browser):

  • Convert to Terminal — kills the webview, replaces the pane with a fresh terminal. Loses all browser state including open tabs.
  • (When viewing a terminal pane) Convert to Browser — does the inverse.

Conversion is destructive — confirm dialog warns you.

Recipes (replay sequences)

For repeated browser flows (log in, navigate to a report, scrape a value), record a recipe and replay it. Recipes are JSON files: each step is a tool call (navigate, wait_for_selector, click, type, etc.) with its arguments.

Replay via the AI tool browser_run_recipe or expose the recipe to your goal runs. Detailed format in Browser-Recipe-System.

See also

ClusterSpace · Issues · Releases · MIT License · Edit any page via the Edit button (top right of the wiki).

Start here

User guide

AI subsystem

Goal Runner

Developer

Reference

Clone this wiki locally