Browser

CrispyVibe includes a built-in browser in your workspace. Use it to preview web apps, read documentation, or let AI agents browse and interact with pages.

Opening the browser

Click a web link in a terminal, then choose Open in Crispy from the action popover. To open it directly in a browser Spotlight preview, Cmd-click the link.
In Detailed view, click Open in Viewer to keep the preview as a content-viewer tab. In Terminal Board, click Pin to Dock to keep it as a board tile. Both actions preserve the current page, back and forward history, page zoom, theme, and comments context.
Agents can open URLs programmatically via the crispy browser open CLI command.
Click a web link in a rendered Markdown file and choose Open in Crispy, or set App Settings > Appearance > Markdown Web Links to Crispy Browser to open web links here directly. See Markdown Editor.

The browser provides these navigation controls:

Address bar with URL resolution
Back, forward, reload, and stop buttons
Mouse button 3 for Back and mouse button 4 for Forward
Page zoom (in, out, reset). The setting is saved per tab and remains independent of the global text size set with Cmd++, Cmd+-, and Cmd+0
Find-in-page with Cmd+F. It highlights matches and provides controls to move between them

Address bar suggestions

As you type, the address bar shows history suggestions ranked by frequency and recency. Optional remote search suggestions are available with configurable search engines.

Restored history

Browser history continues across app relaunches. After a browser is restored, addresses you type, links you follow, redirects, and in-page route changes join the existing back and forward sequence instead of replacing it.

Board tile, Spotlight, and Detailed view

A pinned browser shares its current page and history across the Terminal Board, Spotlight, and Detailed view. Navigating in one presentation updates the others. Closing a Detailed view leaves the board tile at the page you last visited.

Board tile — pin a browser to the Terminal Board grid alongside your terminals.
Spotlight preview — terminal links open in a Spotlight overlay. Its header shows Open in Viewer in Detailed view or Pin to Dock in Terminal Board.
Persistence — visible, minimized, and detached browser tiles restore their URL, history, zoom, theme, and comments context.
Focus — clicking an unfocused browser activates it and sends that first click to the page. Background pages do not take focus on their own.

If pinning cannot create a tile, the preview remains open so you can retry.

Project ownership

Each browser belongs to one project. With the content viewer set to Focused Project, only browser tabs owned by that project appear. Pinned previews stay separate by project, so CrispyVibe does not reuse another project’s browser during pinning or restoration.

Removing a project closes its browsers. Parking a project saves each browser’s URL, history, zoom, and theme, then restores them when you activate the project.

Agent automation

AI agents can control the browser programmatically using the crispy CLI:

BROWSER_ID=$(crispy browser open "https://docs.rs/clap" --json | jq -r '.browser_id')
crispy browser wait "$BROWSER_ID" --selector "body"
crispy browser snapshot "$BROWSER_ID" --json
crispy browser click "$BROWSER_ID" --selector "a[href]"
crispy browser type "$BROWSER_ID" --selector "input[type='search']" --text "search query"
crispy browser eval "$BROWSER_ID" "document.title"

Agents can use these commands to research documentation, fill forms, verify deployments, and extract information from web pages in the workspace.

💡 Tip: Add --json to crispy browser snapshot <browser-id> for structured output. Use CSS selectors with click, type, or fill to target page elements.

Security

HTTPS pages display a secure badge in the address bar
Insecure HTTP is blocked by default (configurable allowlist in settings)
WebAuthn and passkeys are supported for authentication flows

🚨 Warning: Do not sign into sensitive accounts in browser panels shared with AI agents. Agents with browser access can read cookies and execute JavaScript via eval.

Developer tools

Web Inspector — attach Safari Web Inspector to the browser panel
Console capture — view console messages from the page
Element picker — overlay for inspecting page elements

Profiles

Named browser profiles provide isolated data stores (cookies, history, storage). Use separate profiles to keep work and personal browsing apart, or to give different agents isolated browser contexts.

Additional features

Context menus — right-click links to open in default browser or download; right-click images to copy
Downloads — files download with a save dialog for choosing location
SSH proxy — route browser traffic through an SSH SOCKS5 tunnel for accessing remote services
History import — import browsing history from Chrome or Safari
Theme injection — the browser uses your CrispyVibe theme (dark/light)