How wox-launcher/wox works
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: ui/manager.go UI manager · plugin/manager.go Plugin manager · system Built-in plugins · host Plugin hosts
Components 19
Launcher experience
- Launcher UI
wox.core/ui/launcher/app.go - UI manager
wox.core/ui/manager.go
Plugin runtime
- Plugin manager
wox.core/plugin/manager.go - Built-in plugins
wox.core/plugin/system - Plugin hosts
wox.core/plugin/host - Python SDK
wox.plugin.python/src/wox_plugin/api.py - Node.js host
wox.plugin.host.nodejs/src/index.ts
Search and AI
- File search
wox.core/util/filesearch/engine.go - Search index
wox.core/util/filesearch/filesearch_sqlite_storage.go - AI providers
wox.core/ai/provider.go - AI tools
wox.core/ai/builtintool/load_tools.go
Settings and platform services
Cloud sync
- Cloud sync
wox.core/cloudsync/cloud_sync_manager.go - Sync service
wox.core/cloudsync/cloud_sync_client.go - Account service
wox.core/account/service.go
Other components
- User
- Wox cloud
Connections 20
- User → Launcher UI: opens and queries
README.md - Launcher UI → UI manager: dispatches UI
- UI manager → Plugin manager: routes query
- Plugin manager → Built-in plugins: initializes
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
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