How writronic/wherever works
Wherever is a macOS file-search app with a Rust indexing and search engine. The main workflow is to enter a query in the app, pass it through a search session to the engine, search indexed file metadata, and display ranked results; users can also search document contents and inspect or edit archives. The graph includes the documented launcher, CLI, live updates, and volume selection. Some UI-to-service wiring and unsampled feature internals are not shown, so those relationships are omitted or marked unverified.
Main entry points: engine.rs Search Engine · SearchService.swift Search Service · SearchModel.swift Search State · LauncherPanel.swift Launcher
Components 22
macOS App
- Search Interface
Wherever/Views/Search/SearchView.swift - Search State
Wherever/Views/Search/SearchModel.swift - Search Filters
Wherever/Views/Filter/SearchFilters.swift - Results and Inspector
Wherever/Views/Results/ResultsTable.swift - Launcher
Wherever/Views/Launcher/LauncherPanel.swift - Disk Selection
Wherever/Views/Settings/LocationsModel.swift
Service Bridge
- App Services
WhereverKit/WhereverServices.swift - Search Service
WhereverKit/SearchService.swift - Event Adapter
WhereverKit/EngineEvents.swift - Search API
Packages/WhereverInterface/Sources/WhereverInterface/Search.swift
Search Engine
- Search Engine
Engine/wherever-core/src/engine.rs - Filesystem Crawl
Engine/wherever-core/src/crawl.rs - Persistent Index
Engine/wherever-core/src/index.rs - Query Matching
Engine/wherever-core/src/query.rs - Result Ranking
Engine/wherever-core/src/rank.rs - Live Index Updates
Engine/wherever-core/src/live.rs - Filesystem Events
Engine/wherever-core/src/fsevents.rs
Content and Archives
- Document Text Search
Engine/wherever-core/src/text/search.rs - Archive Operations
Engine/wherever-core/src/archive.rs
Other Entry Points
- Command-Line Search
Engine/wherever-cli/src/main.rs - Menu Bar Helper
WhereverHelper/HelperApp.swift
Other components
- Mac User
Connections 25
- Mac User → Search Interface: enters query
README.md - Search Interface → Search State: updates state
Wherever/ContentView.swift - Search State → Search Filters: uses filters
Wherever/Views/Search/SearchModel.swift - Results and Inspector → Search State: shows results
- Launcher → Search State: searches names
- Search State → Search Service: requests searches
- App Services → Search Service: creates service
WhereverKit/WhereverServices.swift - Search Service → Search Engine: calls engine
WhereverKit/SearchService.swift - Search Service → Search API: implements client
WhereverKit/SearchService.swift - Search Service → Event Adapter: forwards events
WhereverKit/SearchService.swift - Disk Selection → Search Service: selects volumes
- Search Engine → Filesystem Crawl: crawls files
Engine/wherever-core/src/engine.rs - Search Engine → Persistent Index: builds index
Engine/wherever-core/src/engine.rs - Search Engine → Query Matching: runs matching
Engine/wherever-core/src/engine.rs - Search Engine → Result Ranking: ranks matches
Engine/wherever-core/src/engine.rs - Search Engine → Live Index Updates: updates index
Engine/wherever-core/src/engine.rs - Search Engine → Filesystem Events: configures watching
Engine/wherever-core/src/engine.rs - Search Engine → Document Text Search: searches contents
Engine/wherever-core/src/engine.rs - Search Engine → Archive Operations: handles archives
Engine/wherever-core/src/engine.rs - Mac User → Command-Line Search: searches terminal
README.md - Mac User → Launcher: opens shortcut
README.md - Menu Bar Helper → Launcher: opens launcher
- Mac User → Document Text Search: searches document text
README.md - Mac User → Archive Operations: inspects archives
README.md - Mac User → Disk Selection: chooses disks
README.md