Skip to content

Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.

3.0 KB
Raw Blame

Renderer

All paths are relative to apps/switch-console-desktop/.

Main Entry Points

  • src/renderer/main.tsx: renderer bootstrap
  • src/renderer/App.tsx: top-level provider composition
  • src/renderer/app/workspace.tsx: main post-onboarding shell
  • src/renderer/app/view-registry.ts: view definitions and navigation guards; switches between views
  • src/renderer/lib/ipc.ts: typed RPC client (rpc) and event emitter (events) used throughout renderer

App Shell (src/renderer/app/)

  • workspace.tsx, home-view.tsx — shell and top-level views
  • modal-registry.ts — central modal registry; all modals are registered here
  • view-registry.ts — central view registry; all views are registered here
  • app-menu-events.tsx — native app menu event wiring

Feature Areas (src/renderer/features/)

  • sessions/ — session experience: create-session-modal/, components/, hooks/, and stores/ (MobX session stores and session-selectors.ts)
  • locations/ — an agent's working directory on a host, and its settings panel; stores/ holds location stores and location-selectors.ts
  • remote-hosts/ — SSH hosts: the host list and detail views, reachability notices, and host setup
  • switch-rooms/ — Switch room membership and the inline bridge pane (room-embed-layer.tsx)
  • chats/ — direct chats with agents: timeline, composer and agent activity
  • switch-servers/ — Switch server connections, including a Switch Console-managed server
  • sidebar/ — app sidebar
  • settings/ — settings view
  • command-palette/ — command palette

Shared Renderer Infrastructure (src/renderer/lib/)

  • ipc.ts — typed RPC client and event emitter
  • modal/ — modal provider, renderer, store, and close-guard infrastructure
  • layout/ — layout, navigation, and panel drag providers
  • commands/ — command registry (registry.ts) and view-level commandProvider hooks
  • hotkeys/ — global hotkey handling
  • updates/ — in-app update surfaces
  • stores/ — cross-feature stores (navigation, dependencies, resource monitor, ...)
  • providers/, hooks/, components/, ui/, theme/ — shared providers, hooks, and UI primitives

There is no editor/ directory. Monaco is still a dependency, but the only integration left in the renderer is lib/components/monaco-keyboard-bridge.tsx.

Tests

  • Renderer unit tests: src/renderer/tests/
  • Playwright-backed browser tests: src/renderer/tests/browser/

When Editing Here

  • Check agents/conventions/renderer-patterns.md for modal, view, SDK transcripts, and store patterns.
  • Call RPC methods via the typed rpc client from src/renderer/lib/ipc.ts (alias @renderer/lib/ipc), e.g. rpc.sessions.create(...).
  • New modals must be registered in src/renderer/app/modal-registry.ts.
  • New views must be registered in src/renderer/app/view-registry.ts.
  • The preload bridge (src/preload/index.ts) exposes only invoke, eventSend, eventOn, and getPathForFile on window.electronAPI; keep renderer-main calls on typed RPC and typed events.