How browser-use/browsercode works
BrowserCode is a coding agent with a persistent, code-driven browser capability. The main workflow is a user task entering through the CLI/TUI or hosted API, being handled by the agent and an LLM, then executed as JavaScript against a browser over CDP; results return to the agent. The repository also includes server/API, desktop and web clients, reusable browser skills, and telemetry. The README documents hosted runs and local/remote browser options, but the sampled excerpts do not establish all runtime wiring, so uncertain links are omitted.
Main entry points: src Coding agent · index.ts Browser tools · browser-execute.ts Browser execute · routes.ts HTTP server
Components 17
User interfaces
- CLI commands
packages/cli/src/commands/commands.ts - Terminal UI
packages/tui/src/app.tsx - Web application
packages/app/src/app.tsx
Agent runtime
- Coding agent
packages/opencode/src - LLM provider
- Code execution
packages/codemode/src/codemode.ts
Browser execution
- Browser tools
packages/bcode-browser/src/index.ts - Browser execute
packages/bcode-browser/src/browser-execute.ts - CDP session
packages/bcode-browser/src/cdp/session.ts - Session store
packages/bcode-browser/src/session-store.ts - Reusable skills
packages/bcode-browser/src/skills.ts
Services and state
- HTTP server
packages/server/src/routes.ts - Hosted runs
- Usage telemetry
packages/bcode-browser/src/telemetry.ts - Agent storage
packages/opencode/src/storage/storage.ts
Other components
- Engineer
- Chrome browser
Connections 19
- Engineer → CLI commands: submits task
- Engineer → Terminal UI: submits task
- Engineer → Web application: uses
- Engineer → Hosted runs: starts run
- CLI commands → Coding agent: starts agent
- Terminal UI → Coding agent: uses SDK
- Web application → HTTP server: connects
- Hosted runs → HTTP server: dispatches run
- HTTP server → Coding agent: provides services
- Coding agent → LLM provider: requests completion
- Coding agent → Code execution: runs code
- Code execution → Browser tools: exposes tools
- Browser tools → Browser execute: dispatches
- Browser execute → CDP session: controls browser
- CDP session → Chrome browser: sends CDP commands
- Browser execute → Session store: retains session
- Coding agent → Reusable skills: uses scripts
- Browser tools → Usage telemetry: records traces
- Coding agent → Agent storage: reads and writes