Support external browser containers by connecting via CDP

[hotzen]

Add connect_url to BrowserConfig so agents can connect to an external chromedp/headless-shell container via CDP instead of launching a local Chrome process.

• Workers share the container (one tab each);
• Browser Cntainer is managed externally, e.g. Docker Compose.

Config (src/config.rs)

• Added connect_url: Option to BrowserConfig
• handle_launch() branches: Browser::connect() for external, Browser::launch() for local
• handle_close() drops the struct without sending CDP Browser.close for external browsers (sending it would kill the shared sandbox and all other workers' tabs)

Docs (docs/docker.md)

• Added "External Browser" section with compose examples: host+Docker, both-in-Docker, per-agent dedicated sandboxes

[jamiepine]

Woah! Love this

[hotzen]

next: testing

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[hotzen]

generally works.

issues with screenshots vs. docker though, need to fix:

message=executed tool file with args {"operation":"read","path":"/home/xxx/.spacebot/agents/main/data/screenshots/screenshot_20260224_221337_957.png"}. result: Toolset error: ToolCallError: ToolCallError: ToolCallError: File operation failed: ACCESS DENIED: Path is outside the workspace..