How open-webui/tether works
Tether is an Electron desktop companion for Open WebUI: users configure a WebUI connection, select it in the desktop interface, and work with it alongside local terminal access. The graph covers the renderer-to-main-process boundary, connection/session handling, terminal runtime and workspace sandboxing, plus Spotlight and MCP integrations documented by the README. Relationships involving unsampled modules are limited to source-index references or explicit README statements; MCP wiring is shown as unverified.
Main entry points: connections.ts Connection manager · index.ts IPC bridge · Settings.svelte Settings · App.svelte Connection workspace
Components 22
Desktop experience
- Connection workspace
src/renderer/src/App.svelte - Settings
src/renderer/src/components/Settings.svelte - Spotlight UI
src/renderer/src/components/Spotlight.svelte - Terminal view
src/renderer/src/components/Terminal.svelte - IPC bridge
src/preload/index.ts - Electron main
src/main/index.ts
WebUI connections
- Connection manager
src/main/connections.ts - Connection sessions
src/main/sessions.ts - Network checks
src/main/network.ts - Connection relay
src/main/relay.ts - App state store
src/main/store.ts - Access handling
src/main/access.ts
Local terminal
- Terminal settings
src/renderer/src/components/Settings/OpenTerminal.svelte - Local runtime
src/main/runtime.ts - Managed service
src/main/process/managedService.ts - Workspace sandbox
src/main/sandbox/index.ts - Sandbox policy
src/main/sandbox/policy.ts
Desktop services
- MCP integrations
src/main/mcp.ts - Spotlight service
src/main/spotlight.ts
Other components
- Desktop user
- Open WebUI
- MCP servers
Connections 23
- Desktop user → Connection workspace: uses
README.md - Connection workspace → IPC bridge: invokes API
src/renderer/src/App.svelte - Settings → IPC bridge: invokes API
- Terminal view → IPC bridge: uses terminal API
src/renderer/src/components/Terminal.svelte - IPC bridge → Electron main: bridges IPC
src/preload/index.ts - Electron main → Connection manager: initializes
src/main/index.ts - Connection manager → Connection sessions: uses sessions
src/main/connections.ts - Connection manager → Network checks: checks network
src/main/connections.ts - Connection manager → Connection relay: uses relay
src/main/connections.ts - Connection manager → App state store: uses store
src/main/connections.ts - Connection manager → Access handling: uses access
src/main/connections.ts - Connection sessions → App state store: reads state
src/main/sessions.ts - Connection sessions → Network checks: checks network
src/main/sessions.ts - Connection workspace → Open WebUI: connects to
README.md - Settings → Local runtime: configures runtime
- Local runtime → Managed service: manages process
src/main/process/managedService.ts - Managed service → Workspace sandbox: launches sandbox
src/main/sandbox/index.ts - Workspace sandbox → Sandbox policy: verifies workspace
src/main/sandbox/index.ts - Terminal view → Managed service: streams terminal
- Electron main → Spotlight service: initializes
src/main/index.ts - Spotlight UI → Spotlight service: controls
- Settings → MCP integrations: configures servers
- MCP integrations → MCP servers: connects servers
README.md