$ show exelban/stats
Stats is a native macOS menu bar system monitor that provides real-time hardware and software metrics for CPU, GPU, RAM, Disk, Network, Battery, Sensors (temperature/voltage/fan), Bluetooth, and Clock. Built entirely in Swift with AppKit, it uses private IOKit, SMC, and IOReport APIs to collect system data, and offers highly customizable widgets (mini, line/bar/pie charts, tachometer, text, etc.) drawn directly in the menu bar. The architecture is modular: each monitored subsystem lives in its own 'Module' directory with a consistent structure (main.swift, readers, popup, settings, notifications, portal). A shared 'Kit' framework provides reusable components including a reader base class with interval management and history persistence via bundled LevelDB, a thread-safe key-value store wrapper, and a set of custom drawing chart widgets. The app also supports remote monitoring via an optional cloud service (System Stats), privileged helper for fan control, macOS widget extensions, and extensive localization (40+ languages). The codebase demonstrates strong engineering practices with clean abstractions, encapsulation, and reusability, though some modules exhibit boilerplate duplication and the project relies on several deprecated or private APIs that may require updates for future macOS releases.
The LLM identified 3 files worth highlighting for reuse:
A thread-safe wrapper around UserDefaults with an in-memory cache and support for exporting/importing all preferences. It uses a custom private queue for synchronization and provides typed getters/setters (string, bool, int, data, etc.), with a 'key' pattern for type-safe access. The export/import methods encode/decode to a dictionary, making it easy to migrate or backup user settings. This pattern is reusable in any macOS/iOS app that needs more robust UserDefaults management.
A wrapper around a bundled LevelDB library (LLDB) for storing time-tagged key-value pairs with automatic TTL cleanup and async write batching. It supports batch writes with completion callbacks, read-by-key with optional TTL check, and periodic background cleanup of expired entries. The design is isolated and could be extracted into any Swift project needing a lightweight persistent time-series store with TTL, especially for caching or history data.
A generic base class Reader<T> that manages periodic data collection from system APIs. It provides setup/read methods, configurable intervals with callback dispatch, automatic pause/resume based on popup/menu bar visibility, optional persistence of history to the DB, and support for multiple readers per module. The pattern cleanly separates data acquisition from UI, and the callback-based interface allows easy integration into any SwiftUI or AppKit view. Highly reusable for any app that polls sensors or metrics at fixed intervals.