How krishgokulk/context-dock works
DoraX is a macOS coordination layer that carries context and actions between apps through four launcher surfaces. Its central workflow is to capture the user’s request and app context, resolve an action or multi-step workflow, obtain route-specific approval where needed, execute through available integrations, and report results with verification limits. The graph combines explicit README capabilities with sampled-source references; unsampled subsystems are represented at their existing directory paths, and undocumented wiring is omitted.
Main entry points: LauncherView.swift Launcher shell · L2AppActionRouter.swift App action router · L2WorkflowEngine.swift Saved workflows · GeneralChatWindowModel.swift General Chat
Components 22
Launcher surfaces
- Launcher shell
Context-Dock/Search/LauncherView.swift - Global Context
Context-Dock/Services/GlobalContextEngine.swift - Context Dock
Context-Dock/Services/ContextDockEngine.swift - General Chat
Context-Dock/AI/GeneralChatWindowModel.swift - Selection Scope
Context-Dock/Search/LauncherView+SelectionRouter.swift
Context and routing
- App context reader
Context-Dock/Services/ContextDetector.swift - User context
Context-Dock/Services/UserContext.swift - Live menu access
Context-Dock/Accessibility/AXMenuReader.swift - Intent routing
Context-Dock/AI/L2IntentSystem.swift
Action execution
- Saved workflows
Context-Dock/AI/L2WorkflowEngine.swift - Task executor
Context-Dock/AI/L2AITaskExecutor.swift - App action router
Context-Dock/AI/L2AppActionRouter.swift
Providers and integrations
- AI providers
Context-Dock/AI/AIProviderService.swift - App adapters
Context-Dock/Services/AppAdapterManager.swift - Apple app tools
Context-Dock/Services/AppleAppsAPI.swift - MCP servers
Context-Dock/Services/MCPRuntime.swift - CLI tools
Context-Dock/Services/TerminalAIBridge.swift - Shortcuts
Context-Dock/Services/ShortcutRunner.swift
Privacy and verification
- Route approvals
Context-Dock/AI/ApprovalCenter.swift - Action verification
Context-Dock/AI/CommandOutcomeVerifier.swift - Privacy settings
Context-Dock/App/AppSettings.swift
Other components
- User
Connections 23
- User → Launcher shell: opens and requests
- Launcher shell → App context reader: reads app context
Context-Dock/Search/LauncherView.swift - App context reader → User context: detects selection
Context-Dock/Services/UserContext.swift - Launcher shell → Global Context: shows global actions
Context-Dock/Search/LauncherView.swift - Launcher shell → Context Dock: shows app actions
Context-Dock/Search/LauncherView.swift - Launcher shell → General Chat: opens cross-app chat
- Launcher shell → Selection Scope: routes selection
Context-Dock/Search/LauncherView+SelectionRouter.swift - Global Context → Live menu access: reads live menus
Context-Dock/Services/GlobalContextEngine.swift - Context Dock → Live menu access: refreshes menus
Context-Dock/Services/ContextDockEngine.swift - General Chat → Intent routing: resolves requests
- Intent routing → Saved workflows: selects workflow
- Saved workflows → Task executor: runs task steps
- Task executor → App action router: dispatches actions
- Saved workflows → Apple app tools: uses app data
Context-Dock/AI/L2WorkflowEngine.swift - Saved workflows → CLI tools: runs commands
Context-Dock/AI/L2WorkflowEngine.swift - App action router → App adapters: uses app adapters
- App action router → MCP servers: uses MCP tools
- App action router → Shortcuts: runs shortcuts
- General Chat → AI providers: requests AI
- Privacy settings → AI providers: selects provider
- Privacy settings → Route approvals: sets privacy choices
- App action router → Route approvals: requests approval
- App action router → Action verification: checks outcome