A lightweight macOS menu bar app that monitors CPU and memory usage of running processes, logging those that exceed configurable thresholds.
- Download
Overseer.zipfrom releases - Unzip and move
Overseer.appto Applications - Right-click → Open (first time only)
- Look for the eye icon (👁️) in your menu bar
See DISTRIBUTION.md for detailed installation instructions.
# Clone the repo
git clone <repo-url>
cd Overseer
# Build from source
./build_app.sh
# Or run directly
swift run
# Or build and run
swift build && .build/debug/OverseerWhen you first launch Overseer:
- An eye icon (👁️) appears in your menu bar
- Green dot = monitoring active, Gray dot = paused
- Click the icon to open settings
- Adjust thresholds as needed
- CPU Threshold: Log processes using more than this % CPU (10-100%)
- Memory Threshold: Log processes using more than this % of total RAM (10-100%)
- Sampling Interval: How often to check processes (1-30 seconds)
- Log Rate Limit: Maximum log frequency per process (1-60 seconds)
- Monitoring Status: Shows if monitoring is active or paused
- Pause/Resume: Toggle monitoring on/off
- Current Thresholds: Quick view of CPU and Memory thresholds
- Open Logs Folder: Opens
~/Library/Logs/Overseer/in Finder - Quit Overseer: Exit the application
[2026-03-17 17:45:23] Chrome (1234): CPU=85.3%, MEM=2.1GB (duration: 15s)
[2026-03-17 17:45:28] Chrome (1234): CPU=87.1%, MEM=2.2GB (duration: 20s)
Each log entry includes:
- Timestamp
- Process name and PID
- CPU usage percentage
- Memory usage (MB or GB)
- Duration process has been above threshold
- ProcessMonitor: Main monitoring engine using
proc_pidinfo()andtask_info() - LoggerService: Asynchronous logging with rotation
- ConfigurationManager: UserDefaults-based settings persistence
- AppDelegate: Menu bar integration and app lifecycle
- SettingsView: SwiftUI configuration interface
- Smart Sampling: Only monitors top 20 processes by CPU
- Efficient APIs: Uses low-level BSD syscalls instead of parsing shell output
- Adaptive Polling: 5-second base interval
- Self-Monitoring: Automatically throttles if own usage exceeds 2% CPU
User preferences are stored in macOS UserDefaults:
~/Library/Preferences/com.overseer.app.plist
~/Library/Logs/Overseer/
├── overseer-2026-03-17.log
├── overseer-2026-03-16.log
└── ...
Logs automatically rotate daily and are retained for 30 days.
- Ensure you're running macOS 13.0 or later
- Check that the app has accessibility permissions (System Settings > Privacy & Security > Accessibility)
- Check that
~/Library/Logs/Overseer/directory exists - Verify monitoring is active (green dot in menu bar)
- Ensure some processes are exceeding your thresholds
- Increase sampling interval to 10-30 seconds
- Increase log rate limit to reduce write frequency
- Check logs for "WARNING: Overseer CPU usage high" messages
Overseer/
├── Overseer/
│ ├── OverseerApp.swift # App entry point
│ ├── AppDelegate.swift # Menu bar and lifecycle
│ ├── Monitoring/
│ │ ├── ProcessMonitor.swift # Core monitoring logic
│ │ └── ProcessInfo.swift # Process data model
│ ├── Services/
│ │ ├── LoggerService.swift # Async logging
│ │ └── ConfigurationManager.swift # Settings management
│ └── UI/
│ ├── SettingsView.swift # Main settings interface
│ └── MenuBarView.swift # Menu bar popover (unused currently)
├── Package.swift # Swift Package Manager config
└── Overseer.xcodeproj/ # Xcode project
The app is designed to be extensible:
- Add new metrics in
ProcessMonitor - Extend log format in
LoggerService - Add UI controls in
SettingsView - Persist settings in
ConfigurationManager
Potential features for future versions:
- Historical graphs and charts
- Multiple threshold profiles
- Process killing from menu
- Alert sounds or notifications
- Network and disk I/O monitoring
- Export logs to CSV
- Launch at login option
- Custom icon states (idle/alert)
This project is licensed under the PolyForm Noncommercial License 1.0.0. See the LICENSE file for details. This means you are free to use, modify, and share this code for personal or academic purposes, but commercial use is strictly prohibited.
This is a personal project, but suggestions and feedback are welcome! CPU and Memory monitor