@talhaorak/mac-dash
v1.0.6
Published
Beautiful macOS system dashboard — monitor services, processes, resources and logs in real-time
Maintainers
Readme
What is mac-dash?
mac-dash is a lightweight, real-time system dashboard for macOS. It runs a local web server and gives you a beautiful browser-based interface to:
- Monitor CPU, memory, and disk usage with live gauges and charts
- Manage LaunchAgents and LaunchDaemons (start, stop, enable, disable)
- Explore running processes (sort, filter, kill)
- Stream macOS unified logs in real-time
- Extend with plugins
Built with Bun + Hono (server) and React + Tailwind (client). No Electron. ~50ms overhead.
Installation
Quick Start (npx)
npx macdashGlobal Install (npm)
npm install -g @talhaorak/mac-dash
macdashHomebrew
brew install talhaorak/tap/macdash
macdashFrom Source
git clone https://github.com/talhaorak/mac-dash.git
cd mac-dash
bun install
cd client && bun install && cd ..
bun run devRequirements: macOS + Bun runtime
Features
System Dashboard
Real-time CPU, memory, and disk monitoring with animated gauges, sparkline charts, and hardware info.
Service Manager
Browse all LaunchAgents and LaunchDaemons across user, global, and system directories. Start, stop, enable, or disable services with one click.
Process Explorer
View running processes sorted by CPU or memory. See detailed command arguments. Kill processes when needed.
Log Viewer
Stream macOS unified logs in real-time via WebSocket. Filter by log level (error, warning, info, debug) or by process name.
Plugin System
Extend mac-dash with custom plugins that add new pages, API endpoints, and dashboard widgets.
plugins/
my-plugin/
manifest.json # Plugin metadata
server.ts # Backend API routes
client.tsx # React UI componentSee plugins/README.md for the full plugin development guide.
Usage
# Start with default port (7227)
macdash
# Custom port
macdash --port 8080
# Or use environment variable
PORT=8080 macdashThen open http://localhost:7227 in your browser.
Run as Background Service
Install mac-dash as a LaunchAgent that starts on login:
./scripts/install-launchagent.shTech Stack
| Layer | Technology | |-------|-----------| | Runtime | Bun | | Server | Hono | | Frontend | React 19 | | Styling | Tailwind CSS 4 | | Bundler | Vite | | Real-time | WebSocket | | State | Zustand | | Charts | Recharts |
Project Structure
mac-dash/
server/ # Bun + Hono backend
core/ # System info, launchctl, process manager, log reader
routes/ # REST API endpoints
ws/ # WebSocket hub with topic-based subscriptions
plugins/ # Plugin registry
client/ # React + Vite + Tailwind frontend
src/
components/ # UI components (Gauge, MiniChart, GlowCard, etc.)
pages/ # Dashboard, Services, Processes, Logs, Plugins
hooks/ # Custom hooks (useWebSocket)
stores/ # Zustand state stores
lib/ # API client, utilities
plugins/ # Plugin directory
website/ # Landing page (GitHub Pages)
scripts/ # Helper scriptsContributing
We welcome contributions! Please see our Contributing Guide for details.
Support
If you find mac-dash useful, consider supporting the project:
Author
Talha Orak — Software Architect
- GitHub: @talhaorak
- Website: talhaorak.github.io/mac-dash
License
MIT © Talha Orak
