How saiakashneela/mackitty works
MacKitty is a native macOS cleaner and hardware-monitoring app, with both a desktop dashboard and a menu-bar companion. The main workflow is scan/preview, review cleanup categories and warnings, then clean selected areas; the README also documents app management and automatic updates. Sampled code confirms the dashboard’s Mole preview and native cleanup paths, system telemetry sampling, and menu-bar popover wiring. Some feature wiring is documented but unsampled, so those relationships are omitted or marked as documented capabilities.
Main entry points: DashboardModel.swift Dashboard model · MoleMateApp.swift MacKitty app · ContentView.swift Main window · StatusBarController.swift Menu bar controller
Components 18
App Experience
- MacKitty app
Sources/MoleMate/App/MoleMateApp.swift - Main window
Sources/MoleMate/Views/ContentView.swift - Dashboard views
Sources/MoleMate/Views/DashboardView.swift - Menu bar controller
Sources/MoleMate/Support/StatusBarController.swift - Tray dashboard
Sources/MoleMate/Views/TrayMiniDashboardView.swift
Cleanup Workflow
- Dashboard model
Sources/MoleMate/Stores/DashboardModel.swift - Cleanup review
Sources/MoleMate/Views/CleanupView.swift - Native cleaner
Sources/MoleMate/Services/NativeCleanerService.swift - Mole command service
Sources/MoleMate/Services/MoleService.swift - Mole CLI
- User cache files
- Running apps
System Insights
- Hardware monitor
Sources/MoleMate/Services/SystemMonitorService.swift - macOS metrics
- Apps manager surface
Sources/MoleMate/Views/PlaceholderFeatureView.swift
Updates & Support
- Update checker
Sources/MoleMate/Services/UpdateCheckerService.swift - Update endpoints
Other components
- Mac user
Connections 20
- Mac user → Main window: uses
- MacKitty app → Main window: shows
- MacKitty app → Dashboard model: creates
- Main window → Dashboard views: presents
- Main window → Dashboard model: shares state
- Dashboard views → Cleanup review: presents
- Cleanup review → Dashboard model: requests actions
- Dashboard model → Mole command service: previews cleanup
- Mole command service → Mole CLI: runs commands
- Dashboard model → Native cleaner: cleans categories
- Native cleaner → User cache files: inspects / cleans
- Dashboard model → Running apps: checks active apps
- MacKitty app → Menu bar controller: sets up
- Menu bar controller → Tray dashboard: hosts popover
- Menu bar controller → Dashboard model: shares state
- Dashboard model → Hardware monitor: samples telemetry
- Hardware monitor → macOS metrics: reads metrics
- Mac user → Apps manager surface: browses apps
- MacKitty app → Update checker: checks updates
- Update checker → Update endpoints: queries / downloads