How adityabelgaonkar05/browsy works
Browsy combines a Chrome sidebar assistant with local browser control shared by terminal MCP agents. Sidebar chat loads local settings/history, sends turns through context management and a streaming provider, and routes requested browser tools through the extension background to Chrome. Terminal agents use MCP tools and a local native-messaging/IPC bridge to reach the same extension browser tools. The graph preserves setup/diagnostics and bridge transport layers; unsampled MCP and UI internals are represented at their exact enclosing paths, with documented links cited to the README.
Main entry points: host.ts Native host · engine.ts Turn engine · dispatcher.ts Tool dispatcher · chat.tsx Chat sidebar
Components 23
Sidebar chat
- Chat sidebar
apps/extension/sidebar/chat.tsx - Chat state
apps/extension/chat/storage.ts - Turn engine
apps/extension/chat/engine.ts - Context manager
apps/extension/chat/context.ts - AI providers
apps/extension/providers/provider.ts
Browser control
- Extension background
apps/extension/background/index.ts - Native connection
apps/extension/background/native-connection.ts - Tool dispatcher
apps/extension/browser-tools/dispatcher.ts - Chrome controller
apps/extension/browser-tools/chrome-controller.ts - Browser tool contracts
packages/shared/src/browser-tools.ts
Terminal agent access
- MCP server
packages/mcp/src/index.ts - MCP tool definitions
packages/mcp/src/tools.ts - CLI commands
packages/cli/src/index.ts - Agent setup
packages/cli/src/agents.ts - Bridge installation
packages/cli/src/installation.ts
Local bridge
- IPC client
packages/native-bridge/src/client.ts - Native host
packages/native-bridge/src/host.ts - Frame codec
packages/native-bridge/src/framing.ts - Windows pipe relay
packages/native-bridge/src/windows.ts
Other components
- Chrome user
- AI endpoint
- Chrome tabs
- Terminal agent
Connections 24
- Chrome user → Chat sidebar: asks
- Chat sidebar → Chat state: loads and saves
apps/extension/sidebar/chat.tsx - Chat sidebar → Turn engine: runs turn
apps/extension/sidebar/chat.tsx - Turn engine → Context manager: builds context
apps/extension/chat/engine.ts - Turn engine → AI providers: streams completion
apps/extension/chat/engine.ts - AI providers → AI endpoint: sends requests
- Turn engine → Extension background: requests tools
- Extension background → Tool dispatcher: dispatches tools
apps/extension/background/index.ts - Tool dispatcher → Chrome controller: executes actions
apps/extension/background/index.ts - Chrome controller → Chrome tabs: controls tabs
- Tool dispatcher → Browser tool contracts: uses contracts
apps/extension/browser-tools/dispatcher.ts - Terminal agent → MCP server: invokes tools
- MCP server → MCP tool definitions: uses definitions
packages/mcp/src/index.ts - MCP server → IPC client: sends requests
packages/mcp/src/index.ts - IPC client → Native host: uses local IPC
- Native host → Native connection: forwards browser calls
- Native connection → Tool dispatcher: routes browser tools
apps/extension/background/native-connection.ts - IPC client → Frame codec: encodes frames
packages/native-bridge/src/client.ts - Native host → Frame codec: writes frames
packages/native-bridge/src/host.ts - Native host → Windows pipe relay: uses on Windows
packages/native-bridge/src/host.ts - Terminal agent → CLI commands: runs setup
- CLI commands → Agent setup: configures agent
packages/cli/src/index.ts - CLI commands → Bridge installation: installs bridge
packages/cli/src/index.ts - Bridge installation → Native host: registers host
packages/cli/src/installation.ts