Browser
CrispyVibe includes a built-in browser that lives inside your workspace. Use it for previewing web apps, reading documentation, or letting AI agents browse and interact with pages on your behalf.
Opening the browser
- Click a web link in a terminal — it opens in a browser spotlight preview.
- Pin the preview to the terminal board as a tile, or to the content viewer as a tab.
- Agents can open URLs programmatically via the
crispy browser openCLI command.
Navigation
The browser supports full navigation controls:
- Address bar with smart URL resolution
- Back, forward, reload, and stop buttons
- Page zoom (in, out, reset)
- Find-in-page with
Cmd+F— highlights matches and navigates 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.
Board tile and spotlight
The browser integrates with the terminal board and spotlight:
- Board tile — pin a browser to the terminal board grid alongside your terminals
- Spotlight preview — terminal links open in a spotlight overlay; pin to dock or content viewer from there
- Persistence — browser tiles save their URL, history stacks, zoom level, and theme mode across app restarts
Agent automation
AI agents can control the browser programmatically using the crispy CLI:
crispy browser open "https://docs.rs/clap"
crispy browser wait --load_state networkidle
crispy browser snapshot --interactive --json
crispy browser click --ref 7
crispy browser type --ref 12 --text "search query"
crispy browser eval "document.title"
This enables agents to research documentation, fill forms, verify deployments, and extract information from web pages — all without leaving your workspace.
💡 Tip: Use crispy browser snapshot --interactive to get a numbered element tree that agents can reference with --ref for clicks and typing.
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 respects your CrispyVibe theme (dark/light)