How webbrain-one/webbrain works
WebBrain is an AI browser-agent extension: a user asks or delegates from the side panel; the agent reads the current page, optionally plans, invokes browser tools under Ask/Act/Dev permissions, and returns a result using a selected local or cloud model. It also supports reusable workflows, scheduled/watch tasks, offline emergency and retrieval resources, and external MCP/LM Studio delegation. The README establishes the product workflow and capabilities; source excerpts and the index support selected implementation links, while unsampled subsystems are represented without speculative call edges.
Main entry points: agent.js Agent loop · sidepanel.js Side panel · offline-rag-worker.js Index worker · index.ts LM Studio plugin
Components 24
Browser experience
- Side panel
src/chrome/src/ui/sidepanel.js - Page access
src/chrome/src/content/accessibility-tree.js
Agent execution
- Agent loop
src/chrome/src/agent/agent.js - Task planning
src/chrome/src/agent/planner.js - Browser tools
src/chrome/src/agent/tools.js - Saved workflows
src/chrome/src/agent/workflows.js - Scheduled watches
src/chrome/src/agent/scheduler.js
Model connections
- Provider manager
src/chrome/src/providers/manager.js - Model providers
src/chrome/src/providers/openai.js - Firefox OpenAI
src/firefox/src/providers/openai.js
Offline knowledge
- Offline retrieval
src/chrome/src/agent/offline-rag.js - Offline index
src/chrome/src/agent/offline-rag-index.js - Index worker
src/chrome/src/agent/offline-rag-worker.js - Emergency corpus
src/chrome/src/agent/emergency-corpus.js - Emergency mode
src/chrome/src/agent/apocalypse-mode.js - Resource downloads
src/chrome/src/agent/emergency-download-controller.js
External delegation
- MCP client
- MCP server
mcp-server/src/index.ts - Browser bridge
mcp-server/src/bridge.ts - LM Studio plugin
lmstudio-plugin/src/index.ts - Bridge client
lmstudio-plugin/src/util/bridgeClient.ts - URL research tools
lmstudio-plugin/src/tools/researchUrl.ts
Other components
- Browser user
- LM Studio user
Connections 22
- Browser user → Side panel: asks or delegates
README.md - Side panel → Agent loop: starts tasks
- Agent loop → Page access: reads page
README.md - Agent loop → Task planning: plans tasks
README.md - Agent loop → Browser tools: invokes tools
README.md - Agent loop → Provider manager: generates with
- Provider manager → Model providers: dispatches to
src/chrome/src/providers/manager.js - Side panel → Saved workflows: saves runs as
README.md - Side panel → Scheduled watches: schedules watches
README.md - Agent loop → Offline retrieval: retrieves locally
- Index worker → Offline retrieval: builds passages for
src/chrome/src/agent/offline-rag-worker.js - Index worker → Offline index: parses vector index
src/chrome/src/agent/offline-rag-worker.js - Index worker → Emergency corpus: reads corpus files
src/chrome/src/agent/offline-rag-worker.js - Resource downloads → Emergency mode: uses store
src/chrome/src/agent/emergency-download-controller.js - Resource downloads → Emergency corpus: manages corpus
src/chrome/src/agent/emergency-download-controller.js - MCP client → MCP server: delegates browser task
README.md - MCP server → Browser bridge: starts and awaits runs
mcp-server/src/index.ts - Browser bridge → Agent loop: commands browser
- LM Studio user → LM Studio plugin: uses tools
lmstudio-plugin/src/index.ts - LM Studio plugin → URL research tools: calls research tools
lmstudio-plugin/src/index.ts - LM Studio plugin → Bridge client: delegates browser tasks
lmstudio-plugin/src/index.ts - Bridge client → Agent loop: sends browser commands