rivet-dev / rivet-dev/agentos

browser: support/verify interactive `browse` driver mode inside the VM

Open
#1,631 0 comments 0 reactions 0 assignees View on GitHub

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 open then browse status across separate agent.exec() calls) was blocked before reaching browse: the local dylib-actor boot path needs the r6 sibling engine build (packages/agentos/tests/actor.test.ts gates this behind AGENTOS_E2E_FULL=1 and calls it env-fragile).

Acceptance

  • E2E test: browse open <url> in one exec, browse status in a second exec sees 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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.