How vicinaehq/vicinae works
Vicinae is a native desktop command palette: users search for commands or items, then launch actions or navigate into results. Its documented built-ins cover apps, files, clipboard history, snippets, browser tabs, emoji, calculations, windows/workspaces, fonts, and volume; extensions and script commands add further capabilities. The graph emphasizes these product stages and the extension runtime. Several connections use dashed edges because the available source excerpts do not show their runtime wiring.
Main entry points: root-item-manager.cpp Root Item Manager · extension-manager.cpp Extension Manager · navigation-controller.cpp Navigation Controller · root-search-model.cpp Root Search
Components 25
Search and Navigation
- Navigation Controller
src/server/src/navigation-controller.cpp - Root Search
src/server/src/builtins/root/root-search-model.cpp - Root Item Manager
src/server/src/services/root-item-manager/root-item-manager.cpp - Fuzzy Matching
src/lib/fuzzy/include/fuzzy/fuzzy-searchable.hpp
Built-in Capabilities
- App Search
src/server/src/builtins/system/browse-apps-model.cpp - File Search
src/server/src/builtins/file/search-files-model.cpp - Clipboard History
src/server/src/builtins/clipboard/history/clipboard-history-controller.cpp - Text Snippets
src/snippet/src/server.cpp - Browser Tabs
src/server/src/builtins/browser/browser-tabs-model.cpp - Emoji Picker
src/server/src/builtins/vicinae/emoji-grid-model.cpp - Calculator
src/server/src/builtins/calculator/calculator-extension.hpp - Window Switcher
src/server/src/builtins/wm/switch-windows-model.cpp - Font Browser
src/server/src/builtins/font/font-grid-model.cpp - Volume Control
src/server/src/builtins/media/media-extension.hpp
Extension Platform
- Extension Manager
src/server/src/extension/manager/extension-manager.cpp - Extension Runtime
src/server/src/extension/extension-command-runtime.cpp - Node Worker
src/typescript/extension-manager/src/worker.tsx - Extension API
src/server/src/extension/api/storage-service.hpp - Script Commands
src/lib/script-command/src/script-command.cpp
System Services
- Local Storage
src/server/src/services/local-storage/local-storage.cpp - File Indexer
src/file-indexer/src/file-indexer-query-engine.cpp
External Integrations
- Browser Extension
src/browser-extension/src/browser.cpp - Desktop Environment
- Extension Stores
Other components
- Desktop User
Connections 26
- Desktop User → Navigation Controller: searches and navigates
- Navigation Controller → Root Search: opens search
- Root Search → Root Item Manager: requests items
- Root Item Manager → Fuzzy Matching: ranks matches
src/server/src/services/root-item-manager/root-item-manager.cpp - Root Item Manager → App Search: offers app search
- Root Item Manager → File Search: offers file search
- Root Item Manager → Clipboard History: offers clipboard history
- Root Item Manager → Text Snippets: offers snippets
- Root Item Manager → Browser Tabs: offers tab switching
- Root Item Manager → Emoji Picker: offers emoji search
- Root Item Manager → Calculator: offers calculations
- Root Item Manager → Window Switcher: offers window switching
- Root Item Manager → Font Browser: offers font browsing
- Root Item Manager → Volume Control: offers volume control
- Root Item Manager → Extension Manager: manages extensions
- Extension Manager → Extension Runtime: starts commands
- Extension Runtime → Node Worker: runs extension code
- Node Worker → Extension API: uses APIs
src/typescript/extension-manager/src/worker.tsx - Extension API → Local Storage: accesses storage
src/server/src/extension/api/storage-service.hpp - Extension Manager → Extension Stores: provides store integration
- Desktop User → Script Commands: invokes script commands
- File Search → File Indexer: queries indexed files
- Browser Tabs → Browser Extension: receives tab data
- Clipboard History → Desktop Environment: integrates with clipboard
- Window Switcher → Desktop Environment: reads window state
- Text Snippets → Desktop Environment: expands text