# wox-launcher/wox architecture

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

- Interactive diagram: https://gitdiagram.com/wox-launcher/wox
- Repository: https://github.com/wox-launcher/wox

## Overview

Wox is a native, cross-platform desktop launcher: a user opens it, enters a keyboard-first query, and receives results or actions from built-in and extensible plugins. The repository also contains substantial AI, file-search, settings, themes, and cloud-sync capabilities. The README documents the product workflow and plugin model; sampled source confirms plugin initialization and file-search indexing/storage, but much of the runtime wiring was not shown, so unverified connections are marked dashed.

Main entry points: [`wox.core/ui/manager.go`](https://github.com/wox-launcher/wox/blob/master/wox.core/ui/manager.go) (UI manager), [`wox.core/plugin/manager.go`](https://github.com/wox-launcher/wox/blob/master/wox.core/plugin/manager.go) (Plugin manager), [`wox.core/plugin/system`](https://github.com/wox-launcher/wox/tree/master/wox.core/plugin/system) (Built-in plugins), [`wox.core/plugin/host`](https://github.com/wox-launcher/wox/tree/master/wox.core/plugin/host) (Plugin hosts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launcher["Launcher experience"]
  node_launcher_ui["Launcher UI<br/>[app.go]"]
  node_ui_manager["UI manager<br/>[manager.go]"]
end

subgraph group_plugins["Plugin runtime"]
  node_plugin_manager["Plugin manager<br/>[manager.go]"]
  node_system_plugins["Built-in plugins<br/>[system]"]
  node_plugin_hosts["Plugin hosts<br/>[host]"]
  node_python_sdk["Python SDK<br/>[api.py]"]
  node_node_host["Node.js host<br/>[index.ts]"]
end

subgraph group_capabilities["Search and AI"]
  node_file_search["File search<br/>[engine.go]"]
  node_file_index[("Search index")]
  node_ai["AI providers<br/>[provider.go]"]
  node_ai_tools["AI tools<br/>[load_tools.go]"]
end

subgraph group_platform["Settings and platform services"]
  node_settings["Settings<br/>[manager.go]"]
  node_hotkeys["Hotkeys<br/>[service.go]"]
  node_themes["Themes<br/>[theme_runtime.go]"]
end

subgraph group_sync["Cloud sync"]
  node_cloud_sync["Cloud sync"]
  node_sync_client["Sync service"]
  node_account["Account service<br/>[service.go]"]
end

node_user(("User"))
node_external_sync{{"Wox cloud"}}

node_user -->|"opens and queries"| node_launcher_ui
node_launcher_ui -.->|"dispatches UI"| node_ui_manager
node_ui_manager -.->|"routes query"| node_plugin_manager
node_plugin_manager -->|"initializes"| node_system_plugins
node_plugin_manager -.->|"runs plugins"| node_plugin_hosts
node_plugin_hosts -.->|"hosts SDK"| node_python_sdk
node_plugin_hosts -.->|"hosts runtime"| node_node_host
node_python_sdk -->|"returns query results"| node_plugin_manager
node_plugin_manager -.->|"returns results"| node_launcher_ui
node_system_plugins -.->|"offers local search"| node_file_search
node_file_search -->|"reads and writes index"| node_file_index
node_system_plugins -.->|"provides AI features"| node_ai
node_ai -.->|"uses tools"| node_ai_tools
node_ui_manager -.->|"registers hotkeys"| node_hotkeys
node_ui_manager -.->|"reads preferences"| node_settings
node_ui_manager -.->|"applies theme"| node_themes
node_settings -.->|"syncs settings"| node_cloud_sync
node_cloud_sync -.->|"exchanges records"| node_sync_client
node_sync_client -.->|"connects remotely"| node_external_sync
node_account -.->|"supports account"| node_cloud_sync

click node_launcher_ui "https://github.com/wox-launcher/wox/blob/master/wox.core/ui/launcher/app.go"
click node_ui_manager "https://github.com/wox-launcher/wox/blob/master/wox.core/ui/manager.go"
click node_plugin_manager "https://github.com/wox-launcher/wox/blob/master/wox.core/plugin/manager.go"
click node_system_plugins "https://github.com/wox-launcher/wox/tree/master/wox.core/plugin/system"
click node_plugin_hosts "https://github.com/wox-launcher/wox/tree/master/wox.core/plugin/host"
click node_python_sdk "https://github.com/wox-launcher/wox/blob/master/wox.plugin.python/src/wox_plugin/api.py"
click node_node_host "https://github.com/wox-launcher/wox/blob/master/wox.plugin.host.nodejs/src/index.ts"
click node_file_search "https://github.com/wox-launcher/wox/blob/master/wox.core/util/filesearch/engine.go"
click node_file_index "https://github.com/wox-launcher/wox/blob/master/wox.core/util/filesearch/filesearch_sqlite_storage.go"
click node_ai "https://github.com/wox-launcher/wox/blob/master/wox.core/ai/provider.go"
click node_ai_tools "https://github.com/wox-launcher/wox/blob/master/wox.core/ai/builtintool/load_tools.go"
click node_settings "https://github.com/wox-launcher/wox/blob/master/wox.core/setting/manager.go"
click node_hotkeys "https://github.com/wox-launcher/wox/blob/master/wox.core/hotkey/service.go"
click node_themes "https://github.com/wox-launcher/wox/blob/master/wox.core/common/theme_runtime.go"
click node_cloud_sync "https://github.com/wox-launcher/wox/blob/master/wox.core/cloudsync/cloud_sync_manager.go"
click node_sync_client "https://github.com/wox-launcher/wox/blob/master/wox.core/cloudsync/cloud_sync_client.go"
click node_account "https://github.com/wox-launcher/wox/blob/master/wox.core/account/service.go"

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_launcher_ui,node_ui_manager,node_user toneBlue
class node_plugin_manager,node_system_plugins,node_plugin_hosts,node_python_sdk,node_node_host toneAmber
class node_file_search,node_file_index,node_ai,node_ai_tools toneMint
class node_settings,node_hotkeys,node_themes toneRose
class node_cloud_sync,node_sync_client,node_account,node_external_sync toneIndigo
```

## Components

### Launcher experience

- [Launcher UI](https://github.com/wox-launcher/wox/blob/master/wox.core/ui/launcher/app.go): `wox.core/ui/launcher/app.go`
- [UI manager](https://github.com/wox-launcher/wox/blob/master/wox.core/ui/manager.go): `wox.core/ui/manager.go`

### Plugin runtime

- [Plugin manager](https://github.com/wox-launcher/wox/blob/master/wox.core/plugin/manager.go): `wox.core/plugin/manager.go`
- [Built-in plugins](https://github.com/wox-launcher/wox/tree/master/wox.core/plugin/system): `wox.core/plugin/system`
- [Plugin hosts](https://github.com/wox-launcher/wox/tree/master/wox.core/plugin/host): `wox.core/plugin/host`
- [Python SDK](https://github.com/wox-launcher/wox/blob/master/wox.plugin.python/src/wox_plugin/api.py): `wox.plugin.python/src/wox_plugin/api.py`
- [Node.js host](https://github.com/wox-launcher/wox/blob/master/wox.plugin.host.nodejs/src/index.ts): `wox.plugin.host.nodejs/src/index.ts`

### Search and AI

- [File search](https://github.com/wox-launcher/wox/blob/master/wox.core/util/filesearch/engine.go): `wox.core/util/filesearch/engine.go`
- [Search index](https://github.com/wox-launcher/wox/blob/master/wox.core/util/filesearch/filesearch_sqlite_storage.go): `wox.core/util/filesearch/filesearch_sqlite_storage.go`
- [AI providers](https://github.com/wox-launcher/wox/blob/master/wox.core/ai/provider.go): `wox.core/ai/provider.go`
- [AI tools](https://github.com/wox-launcher/wox/blob/master/wox.core/ai/builtintool/load_tools.go): `wox.core/ai/builtintool/load_tools.go`

### Settings and platform services

- [Settings](https://github.com/wox-launcher/wox/blob/master/wox.core/setting/manager.go): `wox.core/setting/manager.go`
- [Hotkeys](https://github.com/wox-launcher/wox/blob/master/wox.core/hotkey/service.go): `wox.core/hotkey/service.go`
- [Themes](https://github.com/wox-launcher/wox/blob/master/wox.core/common/theme_runtime.go): `wox.core/common/theme_runtime.go`

### Cloud sync

- [Cloud sync](https://github.com/wox-launcher/wox/blob/master/wox.core/cloudsync/cloud_sync_manager.go): `wox.core/cloudsync/cloud_sync_manager.go`
- [Sync service](https://github.com/wox-launcher/wox/blob/master/wox.core/cloudsync/cloud_sync_client.go): `wox.core/cloudsync/cloud_sync_client.go`
- [Account service](https://github.com/wox-launcher/wox/blob/master/wox.core/account/service.go): `wox.core/account/service.go`

### Other components

- **User**
- **Wox cloud**

## Connections

- User → Launcher UI: opens and queries (evidence: `README.md`)
- Launcher UI → UI manager: dispatches UI
- UI manager → Plugin manager: routes query
- Plugin manager → Built-in plugins: initializes (evidence: `wox.core/plugin/manager.go`)
- Plugin manager → Plugin hosts: runs plugins
- Plugin hosts → Python SDK: hosts SDK
- Plugin hosts → Node.js host: hosts runtime
- Python SDK → Plugin manager: returns query results
- Plugin manager → Launcher UI: returns results
- Built-in plugins → File search: offers local search
- File search → Search index: reads and writes index (evidence: `wox.core/util/filesearch/engine.go`)
- Built-in plugins → AI providers: provides AI features
- AI providers → AI tools: uses tools
- UI manager → Hotkeys: registers hotkeys
- UI manager → Settings: reads preferences
- UI manager → Themes: applies theme
- Settings → Cloud sync: syncs settings
- Cloud sync → Sync service: exchanges records
- Sync service → Wox cloud: connects remotely
- Account service → Cloud sync: supports account
