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.
PortKiller is a cross-platform desktop application for developers to monitor, manage, and kill processes listening on TCP ports. It provides a unified interface across macOS (SwiftUI), Windows (.NET 9 / WinUI 3), and Linux (Python GTK3 + Rust core) with features including real-time port scanning, process type detection, favorites and watched ports with notifications, two-stage process termination (SIGTERM → SIGKILL), Kubernetes port-forward management with auto-reconnect, and Cloudflare tunnel integration (quick and named tunnels). The application also includes an onboarding wizard, sponsor/contributor display, Sparkle-based auto-updates (macOS), and extensive keyboard shortcut support. The architecture is platform-native with shared patterns: each platform implements its own UI layer, port scanner, and process killer, while a Rust core library (`portkiller-core`) provides scanning and process termination for Linux. The macOS version uses an actor-based `PortScanner` and observable state management (`AppState`), the Windows version follows MVVM with a system tray mini-window, and the Linux version uses a GTK3 system tray indicator. All platforms share a common feature set but with varying completeness (macOS is the most feature-rich). External dependencies include `lsof`/`ss` (Linux), `kubectl`, `cloudflared`, `socat`, and system utilities for process enumeration. Key data flows: port scanning via platform-specific commands (lsof, ss, GetExtendedTcpTable) → parsing into `PortInfo` models → filtering/searching → display in tree/table views → user actions (kill, watch, favorite, forward, tunnel). Kubernetes port-forwards and Cloudflare tunnels are managed as subprocesses with monitoring loops for reconnection and log streaming. The application persists user preferences (favorites, watched ports, customizations) using platform-native storage (Defaults on macOS, JSON on Windows/Linux).
CrawlBar is a native macOS menu bar application and CLI tool that serves as a control plane for local-first crawler CLIs (e.g., GitHub, Slack, Discord, Telegram, Notion, WhatsApp). It discovers crawler manifests (built-in or from ~/.crawlbar/apps/), runs commands to retrieve status, freshness, and database inventory, and supports actions such as sync, publish, doctor, search, and backup. The architecture is strictly layered: a core library (CrawlBarCore) with no UI imports provides all data models, command execution, secret redaction, status normalization, and config storage, while a SwiftUI/AppKit frontend renders a menu bar status item and a settings window. A CLI (crawlbarctl) exposes the same functionality outside the GUI. CrawlBar does not crawl data itself; it orchestrates external CLI crawlers via a standardized manifest and status protocol (crawlkit.control.v1). It enforces privacy by redacting secrets from command output, storing action logs with private permissions, and keeping secrets in the macOS Keychain. The system supports remote execution via SSH and integrates with Cloudflare D1 for remote SQLite archives. 12 built-in crawler manifests are provided, covering major messaging and productivity platforms. The project also includes an extensive self-test suite, CI/CD with notarization, and a quality rubric document for code reviews. The core domain is well-abstracted, with reusable patterns for command running, status mapping, config caching, and action coordination. However, the codebase is macOS-only, relies on hardcoded fallback paths and a manual TOML parser, and has many per-crawler special cases in command argument construction. The maintenance is active (frequent releases, changelog, CI), but technical drift is medium due to ecosystem lock-in and custom infrastructure.
boring.notch is a native macOS utility that replaces the system menu bar and notch area with a customizable, expandable control center. Built with SwiftUI and AppKit, it runs as a background LSUIElement app and presents a notch-shaped window that reacts to hover, click, and drag gestures. In production it provides music playback control with a spectrum visualizer, calendar and reminders integration, a drag-and-drop file shelf with Quick Look and sharing, replacement system HUDs for volume/brightness/keyboard backlight, a webcam mirror, battery status, and download/notification indicators. Media playback is supported across Apple Music, Spotify, YouTube Music, and a legacy NowPlaying path, with a private MediaRemote adapter binary used to access now-playing metadata and remote commands.
Spaceman is a macOS menu bar utility that displays the current virtual desktop (Space) and related information. It uses private CGS APIs to observe space changes and renders a custom icon in the status bar showing the active space, fullscreen apps, and multi-display gaps. The app supports multiple display styles (rectangles, numbers, named spaces) and allows users to name spaces. The architecture follows a simple MVVM pattern with AppKit for the status bar and SwiftUI for preferences. It integrates Sparkle for automatic updates, LaunchAtLogin, and KeyboardShortcuts for a force-refresh shortcut. The codebase is well-structured, with clear separation of concerns, though it is tightly coupled to macOS-specific APIs and the Spaceman domain.
BrewServicesManager is a native macOS menu bar application built with SwiftUI and Swift 6 concurrency that provides a graphical interface for managing Homebrew services (start, stop, restart, view status, detect ports, configure service links). The architecture follows a SwiftUI-first pattern with an actor-based `BrewServicesClient` for serialized shell command execution against Homebrew, an `@Observable` `ServicesStore` as the central state manager, and a modular view hierarchy for the menu bar interface. It integrates with Sparkle for automatic updates, uses `NSAppleScript` for privilege escalation when managing system-level services, and employs `lsof`/`pgrep` for port detection. External dependencies include Homebrew, Sparkle framework, and standard macOS command-line tools. The code demonstrates modern Swift practices including strict concurrency, `@Observable` classes, and clean reactively-driven UI with `@Binding` and `@Environment` injection.