browser: support/verify interactive `browse` driver mode inside the VM
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 4.6k
- Forks
- 251
- Avg merge
- 2d 15h
- Merged PRs (30d)
- 34
Description
The registry browse CLI's interactive driver mode (browse open, browse click, browse fill, …) is currently documented as requiring a sandbox. Per the bundled skill (examples/browserbase/skills/browse/SKILL.md), driver commands auto-start a background daemon that holds the live session (active page, tabs, element refs) between commands and talks to each invocation over a local socket.
This should plausibly work inside the VM — the kernel has a full process table and background processes — but it is currently unverified:
- The docs claim it is unsupported, inherited from the original page copy.
- An attempt to verify e2e locally (
browse openthenbrowse statusacross separateagent.exec()calls) was blocked before reachingbrowse: the local dylib-actor boot path needs the r6 sibling engine build (packages/agentos/tests/actor.test.tsgates this behindAGENTOS_E2E_FULL=1and calls it env-fragile).
Acceptance
- E2E test:
browse open <url>in oneexec,browse statusin a secondexecsees the same session (daemon persisted), interactive commands drive a cloud session from inside the VM. - If the daemon needs runtime support (detached long-lived guest processes + local socket reuse across execs), implement or scope it.
- Update
website/src/content/docs/docs/browser.mdx(Interactive browsing note links here) once supported.
🤖 Generated with Claude Code
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with examples/browserbase/skills/browse/SKILL.md and the browse open/status entry points, then inspect packages/agentos/tests/actor.test.ts and the AGENTOS_E2E_FULL=1 path. Run the two-exec VM E2E to check daemon and session reuse; done means interactive commands work in the VM and website/src/content/docs/docs/browser.mdx no longer says the mode is unsupported.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli, documentation, infrastructure
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100