# kunkka19xx/look architecture

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

- Interactive diagram: https://gitdiagram.com/kunkka19xx/look
- Repository: https://github.com/kunkka19xx/look

## Overview

Look is a local-first, keyboard-driven launcher for macOS, Windows, and Linux. Users open the launcher, type a query or command, inspect results, then launch or act on them; search parsing and the native bridge form the core internal path. Separate branches cover quick actions, clipboard and file previews, AI assistance, and platform integrations. The tree and README document these capabilities, but sampled source is partial, so uncertain connections—especially indexing and the Tauri frontend-to-command wiring—are omitted.

Main entry points: [`apps/macos/LauncherApp/look-app/Views/Launcher/LauncherView.swift`](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Views/Launcher/LauncherView.swift) (macOS launcher UI), [`apps/macos/LauncherApp/look-app/Views/Launcher/LaunchpadController.swift`](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Views/Launcher/LaunchpadController.swift) (Quick actions), [`core/engine/src/query.rs`](https://github.com/kunkka19xx/look/blob/main/core/engine/src/query.rs) (Query parsing), [`apps/macos/LauncherApp/look-app/Support/Launcher/EngineBridge.swift`](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/Launcher/EngineBridge.swift) (Engine bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Search and launcher"]
  node_mac_ui["macOS launcher UI<br/>[LauncherView.swift]"]
  node_web_ui["Desktop web UI<br/>[app.js]"]
  node_engine_bridge["Engine bridge<br/>[EngineBridge.swift]"]
  node_ffi["FFI APIs<br/>[lib.rs]"]
  node_query["Query parsing<br/>[query.rs]"]
end

subgraph group_actions["Actions and commands"]
  node_quick_actions["Quick actions"]
  node_action_adapters["System controls"]
  node_mac_controls["macOS controls"]
  node_commands_ui["Command screens"]
  node_action_controller["Action controller"]
end

subgraph group_assist["AI and previews"]
  node_ai_router["AI provider router"]
  node_ai_providers["AI providers"]
  node_preview["File previews"]
end

subgraph group_runtime["Platform runtime"]
  node_tauri["Tauri runtime<br/>[main.rs]"]
  node_tauri_commands["Desktop commands<br/>[commands.rs]"]
  node_mac_apps["macOS app discovery<br/>[apps.rs]"]
  node_win_apps["Windows app discovery<br/>[apps.rs]"]
  node_clipboard[("Clipboard history")]
end

node_user(("User"))
node_os(("Operating system"))

node_user -->|"types and selects"| node_mac_ui
node_user -->|"types and selects"| node_web_ui
node_mac_ui -->|"requests search"| node_engine_bridge
node_engine_bridge -->|"calls C APIs"| node_ffi
node_ffi -->|"parses queries"| node_query
node_query -.->|"uses app candidates"| node_mac_apps
node_query -.->|"uses app candidates"| node_win_apps
node_web_ui -.->|"invokes commands"| node_tauri
node_tauri -->|"registers commands"| node_tauri_commands
node_user -->|"activates tiles"| node_quick_actions
node_quick_actions -->|"resolves controls"| node_action_adapters
node_quick_actions -->|"refreshes tiles"| node_engine_bridge
node_quick_actions -->|"sends media commands"| node_os
node_action_adapters -->|"selects adapters"| node_mac_controls
node_user -->|"proposes actions"| node_action_controller
node_user -->|"requests answers"| node_ai_router
node_ai_router -->|"selects provider"| node_ai_providers
node_ai_providers -.->|"uses local model"| node_os
node_mac_ui -->|"requests thumbnails"| node_preview
node_mac_ui -.->|"shows clipboard results"| node_clipboard
node_commands_ui -.->|"presents action results"| node_action_controller

click node_mac_ui "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Views/Launcher/LauncherView.swift"
click node_web_ui "https://github.com/kunkka19xx/look/blob/main/apps/linows/src/js/app.js"
click node_tauri "https://github.com/kunkka19xx/look/blob/main/apps/linows/src-tauri/src/main.rs"
click node_tauri_commands "https://github.com/kunkka19xx/look/blob/main/apps/linows/src-tauri/src/commands.rs"
click node_engine_bridge "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/Launcher/EngineBridge.swift"
click node_ffi "https://github.com/kunkka19xx/look/blob/main/bridge/ffi/src/lib.rs"
click node_query "https://github.com/kunkka19xx/look/blob/main/core/engine/src/query.rs"
click node_mac_apps "https://github.com/kunkka19xx/look/blob/main/core/engine/src/platform/macos/apps.rs"
click node_win_apps "https://github.com/kunkka19xx/look/blob/main/core/engine/src/platform/windows/apps.rs"
click node_quick_actions "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Views/Launcher/LaunchpadController.swift"
click node_action_adapters "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/QuickActions/ActionAdapterRegistry.swift"
click node_mac_controls "https://github.com/kunkka19xx/look/tree/main/apps/macos/LauncherApp/look-app/Support/QuickActions/Controls"
click node_commands_ui "https://github.com/kunkka19xx/look/tree/main/apps/macos/LauncherApp/look-app/Views/Commands"
click node_action_controller "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/Actions/ActionController.swift"
click node_ai_router "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/AI/AIQueryRouter.swift"
click node_ai_providers "https://github.com/kunkka19xx/look/tree/main/apps/macos/LauncherApp/look-app/Support/AI"
click node_preview "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/QuickLookPreviewService.swift"
click node_clipboard "https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/Launcher/ClipboardHistoryStore.swift"

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_mac_ui,node_web_ui,node_engine_bridge,node_ffi,node_query,node_user toneBlue
class node_quick_actions,node_action_adapters,node_mac_controls,node_commands_ui,node_action_controller toneAmber
class node_ai_router,node_ai_providers,node_preview toneMint
class node_tauri,node_tauri_commands,node_mac_apps,node_win_apps,node_clipboard toneRose
class node_os toneIndigo
```

## Components

### Search and launcher

- [macOS launcher UI](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Views/Launcher/LauncherView.swift): `apps/macos/LauncherApp/look-app/Views/Launcher/LauncherView.swift`
- [Desktop web UI](https://github.com/kunkka19xx/look/blob/main/apps/linows/src/js/app.js): `apps/linows/src/js/app.js`
- [Engine bridge](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/Launcher/EngineBridge.swift): `apps/macos/LauncherApp/look-app/Support/Launcher/EngineBridge.swift`
- [FFI APIs](https://github.com/kunkka19xx/look/blob/main/bridge/ffi/src/lib.rs): `bridge/ffi/src/lib.rs`
- [Query parsing](https://github.com/kunkka19xx/look/blob/main/core/engine/src/query.rs): `core/engine/src/query.rs`

### Actions and commands

- [Quick actions](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Views/Launcher/LaunchpadController.swift): `apps/macos/LauncherApp/look-app/Views/Launcher/LaunchpadController.swift`
- [System controls](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/QuickActions/ActionAdapterRegistry.swift): `apps/macos/LauncherApp/look-app/Support/QuickActions/ActionAdapterRegistry.swift`
- [macOS controls](https://github.com/kunkka19xx/look/tree/main/apps/macos/LauncherApp/look-app/Support/QuickActions/Controls): `apps/macos/LauncherApp/look-app/Support/QuickActions/Controls`
- [Command screens](https://github.com/kunkka19xx/look/tree/main/apps/macos/LauncherApp/look-app/Views/Commands): `apps/macos/LauncherApp/look-app/Views/Commands`
- [Action controller](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/Actions/ActionController.swift): `apps/macos/LauncherApp/look-app/Support/Actions/ActionController.swift`

### AI and previews

- [AI provider router](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/AI/AIQueryRouter.swift): `apps/macos/LauncherApp/look-app/Support/AI/AIQueryRouter.swift`
- [AI providers](https://github.com/kunkka19xx/look/tree/main/apps/macos/LauncherApp/look-app/Support/AI): `apps/macos/LauncherApp/look-app/Support/AI`
- [File previews](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/QuickLookPreviewService.swift): `apps/macos/LauncherApp/look-app/Support/QuickLookPreviewService.swift`

### Platform runtime

- [Tauri runtime](https://github.com/kunkka19xx/look/blob/main/apps/linows/src-tauri/src/main.rs): `apps/linows/src-tauri/src/main.rs`
- [Desktop commands](https://github.com/kunkka19xx/look/blob/main/apps/linows/src-tauri/src/commands.rs): `apps/linows/src-tauri/src/commands.rs`
- [macOS app discovery](https://github.com/kunkka19xx/look/blob/main/core/engine/src/platform/macos/apps.rs): `core/engine/src/platform/macos/apps.rs`
- [Windows app discovery](https://github.com/kunkka19xx/look/blob/main/core/engine/src/platform/windows/apps.rs): `core/engine/src/platform/windows/apps.rs`
- [Clipboard history](https://github.com/kunkka19xx/look/blob/main/apps/macos/LauncherApp/look-app/Support/Launcher/ClipboardHistoryStore.swift): `apps/macos/LauncherApp/look-app/Support/Launcher/ClipboardHistoryStore.swift`

### Other components

- **User**
- **Operating system**

## Connections

- User → macOS launcher UI: types and selects
- User → Desktop web UI: types and selects
- macOS launcher UI → Engine bridge: requests search
- Engine bridge → FFI APIs: calls C APIs
- FFI APIs → Query parsing: parses queries
- Query parsing → macOS app discovery: uses app candidates
- Query parsing → Windows app discovery: uses app candidates
- Desktop web UI → Tauri runtime: invokes commands
- Tauri runtime → Desktop commands: registers commands
- User → Quick actions: activates tiles
- Quick actions → System controls: resolves controls
- Quick actions → Engine bridge: refreshes tiles
- Quick actions → Operating system: sends media commands
- System controls → macOS controls: selects adapters
- User → Action controller: proposes actions
- User → AI provider router: requests answers
- AI provider router → AI providers: selects provider
- AI providers → Operating system: uses local model
- macOS launcher UI → File previews: requests thumbnails
- macOS launcher UI → Clipboard history: shows clipboard results
- Command screens → Action controller: presents action results