How noemica-io/open-claude-in-chrome works
Open Claude in Chrome exposes browser automation to Claude Code through an MCP server, a native-messaging bridge, and a Chromium extension. The main workflow dispatches tool requests to the extension, which operates on browser tabs and returns results. Optional code mode runs model-written code in a sandbox and routes tool callbacks through the upstream server. The extension also humanizes actions and supports imitation-learning recordings and audits. The tree includes a separate REAL browser-agent environment; its unsampled subsystems are shown cautiously, with links only where the index documents imports.
Main entry points: background.js Extension dispatcher · common.js Code-mode plumbing · env.py Browser task environment · mcp-server.js MCP server
Components 28
MCP and host bridge
- MCP server
host/mcp-server.js - Tool definitions
host/tool-definitions.js - Tool runtime
host/tool-runtime.js - Native host
host/native-host.js - Browser endpoint
host/endpoint.js
Browser automation
- Extension dispatcher
extension/background.js - Action humanizer
extension/humanize/index.js - Cursor planner
extension/humanize/cursor.js - Seeded randomness
extension/humanize/rng.js
Recording and audit
- Trace capture
extension/recorder/capture.js - Recording processor
extension/recorder/offscreen.js - Audio transcription
extension/recorder/transcribe.js - Recording viewer
extension/recorder/options.js - Session audit
extension/audit/index.js
Sandboxed code mode
- Code-mode server
host/codemode/server-codemode.js - Hybrid server
host/codemode/server-hybrid.js - Code-mode plumbing
host/codemode/common.js - Sandbox worker
host/codemode/worker/worker.js
REAL agent environment
- Browser task environment
REAL/src/agisdk/REAL/browsergym/core/env.py - Observation builder
REAL/src/agisdk/REAL/browsergym/core/observation.py - Action execution
REAL/src/agisdk/REAL/browsergym/core/action/highlevel.py - Action parser
REAL/src/agisdk/REAL/browsergym/core/action/parsers.py - Task definitions
REAL/src/agisdk/REAL/browsergym/core/task.py - Experiment loop
REAL/src/agisdk/REAL/browsergym/experiments/loop.py - Demo agent
REAL/src/agisdk/REAL/demo_agent/basic_agent.py - Observation utilities
REAL/src/agisdk/REAL/browsergym/utils/obs.py
Other components
- Claude Code
- Chromium browser
Connections 28
- Claude Code → MCP server: stdio MCP
- MCP server → Tool definitions: registers tools
host/tool-definitions.js - MCP server → Tool runtime: dispatches tools
- Tool runtime → Native host: TCP requests
- Native host → Browser endpoint: routes bridge
host/native-host.js - Browser endpoint → Extension dispatcher: TCP bridge
- Extension dispatcher → Chromium browser: controls tabs
- Extension dispatcher → Action humanizer: requests plans
extension/background.js - Action humanizer → Cursor planner: plans movement
extension/humanize/index.js - Action humanizer → Seeded randomness: samples randomness
extension/humanize/index.js - Cursor planner → Seeded randomness: uses distributions
extension/humanize/cursor.js - Extension dispatcher → Session audit: records activity
extension/background.js - Recording viewer → Audio transcription: validates key
extension/recorder/options.js - Recording processor → Audio transcription: transcribes audio
extension/recorder/offscreen.js - Recording viewer → Session audit: shows audit data
extension/recorder/options.js - Claude Code → Hybrid server: stdio MCP
- Claude Code → Code-mode server: stdio MCP
- Code-mode server → Code-mode plumbing: starts plumbing
host/codemode/server-codemode.js - Hybrid server → Code-mode plumbing: starts plumbing
host/codemode/server-hybrid.js - Code-mode plumbing → Sandbox worker: runs sandbox
host/codemode/common.js - Sandbox worker → Code-mode plumbing: tool callbacks
- Browser task environment → Observation builder: builds observations
REAL/src/agisdk/REAL/browsergym/core/env.py - Browser task environment → Action execution: executes actions
REAL/src/agisdk/REAL/browsergym/core/env.py - Browser task environment → Task definitions: sets up task
REAL/src/agisdk/REAL/browsergym/core/env.py - Action execution → Action parser: uses parser
REAL/src/agisdk/REAL/browsergym/core/action/highlevel.py - Experiment loop → Demo agent: uses agent
REAL/src/agisdk/REAL/browsergym/experiments/loop.py - Demo agent → Action execution: imports actions
REAL/src/agisdk/REAL/demo_agent/basic_agent.py - Demo agent → Observation utilities: imports utilities
REAL/src/agisdk/REAL/demo_agent/basic_agent.py