# undermove/meridian-browser architecture

> Architecture diagram of the GitHub repository undermove/meridian-browser, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/undermove/meridian-browser
- Repository: https://github.com/undermove/meridian-browser

## Overview

Meridian is an Electron browser that combines an Arc-style browsing workflow with built-in AI and coding-agent tools. Users browse through the browser UI, import Arc data, or ask an assistant or MCP client to inspect and control tabs; coding agents can also run in the Workbench, with Mission Control tracking their activity. The graph includes documented browser capabilities and sampled main-process integrations. Several renderer features are represented at their existing source paths, but their internal calls were not sampled, so those links are omitted.

Main entry points: [`src/main.js`](https://github.com/undermove/meridian-browser/blob/main/src/main.js) (Electron main process), [`src/dev/index.js`](https://github.com/undermove/meridian-browser/blob/main/src/dev/index.js) (Workbench runtime), [`src/ai/assistant.js`](https://github.com/undermove/meridian-browser/blob/main/src/ai/assistant.js) (Built-in assistant), [`src/agent/hub.js`](https://github.com/undermove/meridian-browser/blob/main/src/agent/hub.js) (Agent hub)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser experience"]
  node_browser_ui["Browser interface<br/>[app.js]"]
  node_spaces_tabs["Spaces and tabs"]
  node_command_bar["Command bar<br/>[home.js]"]
  node_split_peek["Split and Peek"]
  node_boosts["Boosts"]
  node_air_traffic["Link routing<br/>[atc.js]"]
  node_settings["Settings and shortcuts<br/>[settings.js]"]
  node_ad_blocking["Ad blocking<br/>[adblock-fixes.js]"]
end

subgraph group_ai["AI and browser control"]
  node_agent_hub["Agent hub<br/>[hub.js]"]
  node_agent_tools["Browser tools<br/>[tools.js]"]
  node_mcp["MCP server<br/>[meridian-mcp.js]"]
  node_assistant["Built-in assistant<br/>[assistant.js]"]
  node_local_agents["AI providers<br/>[local-agents.js]"]
  node_cloud_keys["Cloud AI keys<br/>[cloud-keys.js]"]
  node_agent_setup["Agent setup<br/>[agent-setup.js]"]
end

subgraph group_workbench["Workbench and agents"]
  node_workbench_ui["Workbench interface<br/>[workbench.js]"]
  node_workbench["Workbench runtime<br/>[index.js]"]
  node_workbench_pro["Workbench Pro<br/>[workbench-pro.js]"]
  node_sandbox["Agent sandbox<br/>[sandbox.js]"]
  node_environment["Shell environment<br/>[env.js]"]
  node_vault["Secrets vault<br/>[vault.js]"]
  node_mission["Mission Control<br/>[mission.js]"]
  node_mission_ui["Mission interface<br/>[mission.js]"]
end

subgraph group_platform["Main process and import"]
  node_main["Electron main process<br/>[main.js]"]
  node_arc_import["Arc sidebar import<br/>[arc.js]"]
  node_arc_cookies["Arc login import<br/>[arc-cookies.js]"]
end

node_user(("Browser user"))

node_user -->|"uses"| node_browser_ui
node_browser_ui -.->|"sends browser actions"| node_main
node_main -->|"invokes import"| node_arc_import
node_main -->|"invokes login import"| node_arc_cookies
node_main -->|"configures hub"| node_agent_hub
node_main -->|"configures assistant"| node_assistant
node_main -->|"configures providers"| node_local_agents
node_main -->|"configures setup"| node_agent_setup
node_main -->|"configures mission"| node_mission
node_mcp -->|"uses tool definitions"| node_agent_tools
node_agent_hub -->|"dispatches tools"| node_agent_tools
node_assistant -->|"uses browser control"| node_agent_hub
node_assistant -->|"runs provider chats"| node_local_agents
node_local_agents -->|"checks provider keys"| node_cloud_keys
node_agent_setup -->|"reads shell environment"| node_environment
node_workbench_ui -.->|"drives workbench"| node_workbench
node_workbench -->|"uses shell environment"| node_environment
node_workbench -->|"starts sandbox"| node_sandbox
node_workbench -->|"uses vault"| node_vault
node_workbench -->|"reports agent activity"| node_mission
node_workbench_pro -.->|"supports workbench"| node_workbench
node_mission -.->|"reports activity"| node_mission_ui
node_user -->|"organizes browsing"| node_spaces_tabs
node_user -->|"searches and asks"| node_command_bar
node_user -->|"arranges pages"| node_split_peek
node_user -->|"customizes sites"| node_boosts
node_user -->|"routes links"| node_air_traffic
node_user -->|"configures browser"| node_settings
node_user -->|"browses with blocking"| node_ad_blocking

click node_browser_ui "https://github.com/undermove/meridian-browser/blob/main/src/renderer/app.js"
click node_spaces_tabs "https://github.com/undermove/meridian-browser/tree/main/src/renderer"
click node_command_bar "https://github.com/undermove/meridian-browser/blob/main/src/renderer/home.js"
click node_split_peek "https://github.com/undermove/meridian-browser/tree/main/src/renderer"
click node_boosts "https://github.com/undermove/meridian-browser/tree/main/src/renderer"
click node_air_traffic "https://github.com/undermove/meridian-browser/blob/main/src/atc.js"
click node_settings "https://github.com/undermove/meridian-browser/blob/main/src/renderer/settings.js"
click node_ad_blocking "https://github.com/undermove/meridian-browser/blob/main/src/adblock-fixes.js"
click node_main "https://github.com/undermove/meridian-browser/blob/main/src/main.js"
click node_arc_import "https://github.com/undermove/meridian-browser/blob/main/src/importers/arc.js"
click node_arc_cookies "https://github.com/undermove/meridian-browser/blob/main/src/importers/arc-cookies.js"
click node_agent_hub "https://github.com/undermove/meridian-browser/blob/main/src/agent/hub.js"
click node_agent_tools "https://github.com/undermove/meridian-browser/blob/main/src/agent/tools.js"
click node_mcp "https://github.com/undermove/meridian-browser/blob/main/mcp/meridian-mcp.js"
click node_assistant "https://github.com/undermove/meridian-browser/blob/main/src/ai/assistant.js"
click node_local_agents "https://github.com/undermove/meridian-browser/blob/main/src/ai/local-agents.js"
click node_cloud_keys "https://github.com/undermove/meridian-browser/blob/main/src/ai/cloud-keys.js"
click node_agent_setup "https://github.com/undermove/meridian-browser/blob/main/src/ai/agent-setup.js"
click node_workbench_ui "https://github.com/undermove/meridian-browser/blob/main/src/renderer/dev/workbench.js"
click node_workbench "https://github.com/undermove/meridian-browser/blob/main/src/dev/index.js"
click node_workbench_pro "https://github.com/undermove/meridian-browser/blob/main/src/renderer/dev/workbench-pro.js"
click node_sandbox "https://github.com/undermove/meridian-browser/blob/main/src/dev/sandbox.js"
click node_environment "https://github.com/undermove/meridian-browser/blob/main/src/dev/env.js"
click node_vault "https://github.com/undermove/meridian-browser/blob/main/src/dev/vault.js"
click node_mission "https://github.com/undermove/meridian-browser/blob/main/src/agents/mission.js"
click node_mission_ui "https://github.com/undermove/meridian-browser/blob/main/src/renderer/mission.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser_ui,node_spaces_tabs,node_command_bar,node_split_peek,node_boosts,node_air_traffic,node_settings,node_ad_blocking,node_user toneBlue
class node_agent_hub,node_agent_tools,node_mcp,node_assistant,node_local_agents,node_cloud_keys,node_agent_setup toneAmber
class node_workbench_ui,node_workbench,node_workbench_pro,node_sandbox,node_environment,node_vault,node_mission,node_mission_ui toneMint
class node_main,node_arc_import,node_arc_cookies toneRose
```

## Components

### Browser experience

- [Browser interface](https://github.com/undermove/meridian-browser/blob/main/src/renderer/app.js): `src/renderer/app.js`
- [Spaces and tabs](https://github.com/undermove/meridian-browser/tree/main/src/renderer): `src/renderer`
- [Command bar](https://github.com/undermove/meridian-browser/blob/main/src/renderer/home.js): `src/renderer/home.js`
- [Split and Peek](https://github.com/undermove/meridian-browser/tree/main/src/renderer): `src/renderer`
- [Boosts](https://github.com/undermove/meridian-browser/tree/main/src/renderer): `src/renderer`
- [Link routing](https://github.com/undermove/meridian-browser/blob/main/src/atc.js): `src/atc.js`
- [Settings and shortcuts](https://github.com/undermove/meridian-browser/blob/main/src/renderer/settings.js): `src/renderer/settings.js`
- [Ad blocking](https://github.com/undermove/meridian-browser/blob/main/src/adblock-fixes.js): `src/adblock-fixes.js`

### AI and browser control

- [Agent hub](https://github.com/undermove/meridian-browser/blob/main/src/agent/hub.js): `src/agent/hub.js`
- [Browser tools](https://github.com/undermove/meridian-browser/blob/main/src/agent/tools.js): `src/agent/tools.js`
- [MCP server](https://github.com/undermove/meridian-browser/blob/main/mcp/meridian-mcp.js): `mcp/meridian-mcp.js`
- [Built-in assistant](https://github.com/undermove/meridian-browser/blob/main/src/ai/assistant.js): `src/ai/assistant.js`
- [AI providers](https://github.com/undermove/meridian-browser/blob/main/src/ai/local-agents.js): `src/ai/local-agents.js`
- [Cloud AI keys](https://github.com/undermove/meridian-browser/blob/main/src/ai/cloud-keys.js): `src/ai/cloud-keys.js`
- [Agent setup](https://github.com/undermove/meridian-browser/blob/main/src/ai/agent-setup.js): `src/ai/agent-setup.js`

### Workbench and agents

- [Workbench interface](https://github.com/undermove/meridian-browser/blob/main/src/renderer/dev/workbench.js): `src/renderer/dev/workbench.js`
- [Workbench runtime](https://github.com/undermove/meridian-browser/blob/main/src/dev/index.js): `src/dev/index.js`
- [Workbench Pro](https://github.com/undermove/meridian-browser/blob/main/src/renderer/dev/workbench-pro.js): `src/renderer/dev/workbench-pro.js`
- [Agent sandbox](https://github.com/undermove/meridian-browser/blob/main/src/dev/sandbox.js): `src/dev/sandbox.js`
- [Shell environment](https://github.com/undermove/meridian-browser/blob/main/src/dev/env.js): `src/dev/env.js`
- [Secrets vault](https://github.com/undermove/meridian-browser/blob/main/src/dev/vault.js): `src/dev/vault.js`
- [Mission Control](https://github.com/undermove/meridian-browser/blob/main/src/agents/mission.js): `src/agents/mission.js`
- [Mission interface](https://github.com/undermove/meridian-browser/blob/main/src/renderer/mission.js): `src/renderer/mission.js`

### Main process and import

- [Electron main process](https://github.com/undermove/meridian-browser/blob/main/src/main.js): `src/main.js`
- [Arc sidebar import](https://github.com/undermove/meridian-browser/blob/main/src/importers/arc.js): `src/importers/arc.js`
- [Arc login import](https://github.com/undermove/meridian-browser/blob/main/src/importers/arc-cookies.js): `src/importers/arc-cookies.js`

### Other components

- **Browser user**

## Connections

- Browser user → Browser interface: uses (evidence: `README.md`)
- Browser interface → Electron main process: sends browser actions
- Electron main process → Arc sidebar import: invokes import (evidence: `src/main.js`)
- Electron main process → Arc login import: invokes login import (evidence: `src/main.js`)
- Electron main process → Agent hub: configures hub (evidence: `src/main.js`)
- Electron main process → Built-in assistant: configures assistant (evidence: `src/main.js`)
- Electron main process → AI providers: configures providers (evidence: `src/main.js`)
- Electron main process → Agent setup: configures setup (evidence: `src/main.js`)
- Electron main process → Mission Control: configures mission (evidence: `src/main.js`)
- MCP server → Browser tools: uses tool definitions (evidence: `mcp/meridian-mcp.js`)
- Agent hub → Browser tools: dispatches tools (evidence: `src/agent/hub.js`)
- Built-in assistant → Agent hub: uses browser control (evidence: `src/ai/assistant.js`)
- Built-in assistant → AI providers: runs provider chats (evidence: `src/ai/assistant.js`)
- AI providers → Cloud AI keys: checks provider keys (evidence: `src/ai/local-agents.js`)
- Agent setup → Shell environment: reads shell environment (evidence: `src/ai/agent-setup.js`)
- Workbench interface → Workbench runtime: drives workbench
- Workbench runtime → Shell environment: uses shell environment (evidence: `src/dev/index.js`)
- Workbench runtime → Agent sandbox: starts sandbox (evidence: `src/dev/index.js`)
- Workbench runtime → Secrets vault: uses vault (evidence: `src/dev/index.js`)
- Workbench runtime → Mission Control: reports agent activity (evidence: `src/dev/index.js`)
- Workbench Pro → Workbench runtime: supports workbench
- Mission Control → Mission interface: reports activity
- Browser user → Spaces and tabs: organizes browsing (evidence: `README.md`)
- Browser user → Command bar: searches and asks (evidence: `README.md`)
- Browser user → Split and Peek: arranges pages (evidence: `README.md`)
- Browser user → Boosts: customizes sites (evidence: `README.md`)
- Browser user → Link routing: routes links (evidence: `README.md`)
- Browser user → Settings and shortcuts: configures browser (evidence: `README.md`)
- Browser user → Ad blocking: browses with blocking (evidence: `README.md`)
