How browseros-ai/browseros works
BrowserOS neo is a local, agent-driven secondary browser: users connect MCP-speaking agents, which perform tasks in logged-in browser sessions that can be watched live and replayed. Its documented product branches include Chrome-data import, agent connections, parallel sessions, a cockpit dashboard, and session replay. The repository also contains the distinct Chromium-based BrowserOS product with an integrated AI agent. The README documents these capabilities, but sampled source is sparse for their runtime wiring, so uncertain links are omitted; build and release tooling is outside this product map.
Main entry points: manager.rs Session manager · mcp-manager.ts Agent connections · newtab/App.tsx Agent browser · app/App.tsx AI assistant UI
Components 15
BrowserOS neo
- Agent browser
packages/browseros-agent/apps/claw-app/entrypoints/newtab/App.tsx - Chrome data import
packages/browseros-agent/apps/app/entrypoints/background/index.ts - Onboarding flow
packages/browseros-agent/apps/app-onboard/src/onboarding/Onboarding.tsx
Agent access
- MCP agents
- Agent connections
packages/browseros-agent/apps/server/src/api/routes/mcp-manager.ts - MCP server manager
packages/browseros-agent/apps/server/src/lib/mcp-manager/manager.ts
Sessions and audit
- Live cockpit
packages/browseros-agent/apps/claw-server-rust/src/services/cockpit/query.rs - Session manager
packages/browseros-agent/apps/claw-server-rust/src/services/sessions/manager.rs - Local session storage
packages/browseros-agent/apps/claw-server-rust/src/storage.rs - Session replay
packages/browseros-agent/apps/app/lib/execution-history/storage.ts - Parallel agent tabs
packages/browseros-agent/apps/claw-server-rust/src/services/sessions/manager.rs
BrowserOS browser
- BrowserOS Chromium
packages/browseros/chromium_patches/chrome/browser/browseros/server/browseros_server_manager.cc - AI assistant UI
packages/browseros-agent/apps/app/entrypoints/app/App.tsx - AI providers
packages/browseros-agent/apps/app/modules/llm-providers/llm-providers.api.ts
Other components
- User
Connections 15
- User → Agent connections: connects agents
README.md - MCP agents → Agent connections: connect via MCP
README.md - Agent connections → MCP server manager: manages connections
- MCP agents → Agent browser: assign web tasks
README.md - Agent browser → Session manager: runs sessions
- Session manager → Local session storage: stores locally
- Session manager → Parallel agent tabs: runs in parallel
README.md - User → Live cockpit: watches live
README.md - Session manager → Live cockpit: shows activity
- User → Session replay: replays sessions
README.md - User → Chrome data import: imports Chrome data
README.md - User → Onboarding flow: sets up browser
- User → AI assistant UI: uses AI browser
README.md - AI assistant UI → AI providers: uses AI providers
- User → BrowserOS Chromium: browses with agent
README.md