Skip to main content

Browser Runtime (si browser)

Browser MCP si browser manages the Dockerized Playwright MCP runtime used by SI agents. Related:

Commands

si browser build
si browser start
si browser status
si browser logs
si browser stop
si browser proxy

Quickstart

si browser build
si browser start
si browser status
Default endpoints after start:
  • MCP endpoint: http://127.0.0.1:8932/mcp
  • noVNC endpoint: http://127.0.0.1:6080/vnc.html?autoconnect=1&resize=scale
  • Internal Docker endpoint for SI containers: http://si-playwright-mcp-headed:8931/mcp

Proxy mode (optional)

Use proxy mode for legacy /mcp SSE clients:
si browser proxy --upstream http://127.0.0.1:8932

Operational notes

  • si browser start can build the image automatically unless --skip-build is set.
  • si browser start attaches the browser runtime to the SI Docker network (si by default, override with --network / SI_BROWSER_NETWORK).
  • SI-managed codex/dyad containers auto-register MCP server si_browser to the browser MCP endpoint.
  • Keep profile directories isolated per environment.
  • Use si browser logs --follow during smoke tests and rollout checks.