How navidzamankhan/tucked works
Tucked is a native macOS menu-bar system monitor. The user opens its unified shelf from the status item; this switches monitoring from passive aggregate sampling to on-demand diagnostics, whose snapshots and history feed the shelf and status display. The graph preserves the documented telemetry, process recovery, hardware, and network capabilities. Some subsystem wiring is based on the README and coordinator excerpts; unsampled implementation details are not expanded into inferred calls.
Main entry points: MonitoringCoordinator.swift Monitoring coordinator · ShelfModel.swift Shelf model · AppCoordinator.swift App coordinator · OverviewView.swift Overview surface
Components 24
App and shelf
- App lifecycle
Sources/Tucked/App/TuckedApp.swift - App coordinator
Sources/Tucked/App/AppCoordinator.swift - Menu-bar status
Sources/Tucked/Shell/StatusItemController.swift - Shelf controller
Sources/Tucked/Shell/ShelfController.swift
Monitoring
- Monitoring coordinator
Sources/Tucked/Monitoring/MonitoringCoordinator.swift - Metric snapshots
Sources/Tucked/Monitoring/MetricSnapshot.swift - History store
Sources/Tucked/Monitoring/HistoryStore.swift
Sampling and diagnostics
- CPU and memory
Sources/Tucked/Sampling - Network throughput
Sources/Tucked/Sampling/NetworkSampler.swift - Process sampler
Sources/Tucked/Processes/ProcessSampler.swift - Process termination
Sources/Tucked/Processes/ProcessTerminationPolicy.swift - Process icons
Sources/Tucked/Processes/ProcessIconProvider.swift - Thermal provider
Sources/Tucked/Thermal/ThermalProvider.swift - Read-only SMC
Sources/Tucked/Thermal/SMCReader.swift - Wi-Fi reader
Sources/Tucked/Diagnostics/WiFiReader.swift - Network diagnostics
Sources/Tucked/Diagnostics/NetworkDiagnostics.swift
Views and settings
- Shelf model
Sources/Tucked/UI/ShelfModel.swift - Overview surface
Sources/Tucked/UI/OverviewView.swift - Shelf surface
Sources/Tucked/UI/ShelfView.swift - Settings surface
Sources/Tucked/UI/SettingsView.swift - Preferences
Sources/Tucked/Support/Preferences.swift - Login item service
Sources/Tucked/Support/LoginItemService.swift
Other components
- Mac user
- Public network
Connections 29
- Mac user → Menu-bar status: clicks
- App lifecycle → App coordinator: starts
- App coordinator → Monitoring coordinator: starts and stops
- App coordinator → Menu-bar status: binds snapshots
- App coordinator → Shelf model: updates snapshots
- Menu-bar status → Shelf controller: toggles shelf
- Shelf controller → Monitoring coordinator: opens or closes diagnostics
- Shelf model → Monitoring coordinator: resets network totals
- Monitoring coordinator → CPU and memory: samples passive metrics
- Monitoring coordinator → Network throughput: samples throughput
- Monitoring coordinator → Process sampler: samples diagnostics
- Monitoring coordinator → Thermal provider: samples diagnostics
- Monitoring coordinator → Wi-Fi reader: reads diagnostics
- Monitoring coordinator → Network diagnostics: probes diagnostics
- Thermal provider → Read-only SMC: reads sensors
- Network diagnostics → Public network: probes and resolves IP
- Monitoring coordinator → Metric snapshots: publishes
- Monitoring coordinator → History store: updates history
- Metric snapshots → Menu-bar status: updates display
- Metric snapshots → Shelf model: updates model
- History store → Shelf model: supplies history
- Shelf surface → Overview surface: shows overview
- Shelf surface → Settings surface: shows settings
- Shelf model → Overview surface: provides telemetry
- Overview surface → Process sampler: shows process rankings
- Overview surface → Process icons: uses process icons
- Shelf model → Process termination: requests process recovery
- Settings surface → Preferences: reads and updates
- Settings surface → Login item service: controls launch-at-login