Browser Tabs
Control a real browser from inside Buda — Cloud Browser for remote automation, Local Browser for internal tools.
Browser Tabs
Buda provides two types of browser canvas: Cloud Browser and Local Browser. Both let you view and interact with web content inside the Agent Workspace, but they work differently and serve different purposes.
Cloud Browser
The Cloud Browser connects to a real Chromium instance running inside the Agent's sandbox. It streams the browser screen to your workspace using the Chrome DevTools Protocol (CDP).
What it's for
- Watching the Agent automate web tasks in real time
- Manually navigating websites while the Agent observes
- Debugging browser automation scripts
- Filling forms, clicking buttons, and scraping pages
How it works
Your browser ←→ WebSocket ←→ Buda server ←→ Chromium (in sandbox)The sandbox runs a headless Chromium instance. Buda captures frames via CDP and streams them to your workspace as JPEG images. Your mouse and keyboard inputs are forwarded back to the remote browser.
Opening a Cloud Browser tab
Click + in the tab bar and select Cloud Browser. The tab connects to the sandbox browser. If the sandbox is not running, it starts automatically.
Address bar
Type a URL in the address bar and press Enter to navigate. The remote browser loads the page and streams the result back to you.
AI instruction bar
Below the address bar is the AI instruction bar. Type a natural-language instruction and press Enter:
Click the "Sign up" button and fill in the form with test dataThe Agent interprets the instruction and performs the action in the browser automatically.
Mouse and keyboard
When the Cloud Browser is connected, you can interact directly:
- Click anywhere on the canvas to click in the remote browser
- Scroll to scroll the page
- Type while the canvas is focused to send keystrokes
Connection status
A colored dot in the address bar shows the connection state:
- 🟢 Green — connected and streaming
- 🟡 Yellow (pulsing) — connecting
- 🔴 Red — disconnected
Click Reconnect if the connection drops.
Local Browser
The Local Browser is a simple embedded iframe. It loads any URL directly in your browser — no sandbox, no streaming, no latency.
What it's for
- Viewing internal tools and dashboards (localhost, intranet)
- Browsing documentation while working in the same workspace
- Quick reference lookups without opening a new browser tab
- Previewing locally-served web apps
Default URL
When you open a new Local Browser tab, it loads https://buda.im/docs by default — so you always have the documentation at hand.
Navigating
Type a URL in the address bar and press Enter. The iframe loads the page immediately.
Note: Some websites block embedding via
X-Frame-OptionsorContent-Security-Policyheaders. If a site refuses to load, use the Open in new tab button (↗) to open it in your regular browser instead.
Refresh
Click the ↺ button to reload the current page.
Differences from Cloud Browser
| Feature | Cloud Browser | Local Browser |
|---|---|---|
| Runs in | Agent sandbox | Your browser |
| Latency | ~100–300ms (streaming) | None |
| AI control | ✅ Yes | ❌ No |
| Works with localhost | ❌ No | ✅ Yes |
| Works with all sites | ✅ Yes | ⚠️ Some block iframes |
| Requires sandbox | ✅ Yes | ❌ No |