macmon

Mac Developer Monitor + System Cleaner CLI — CCleaner Pro level, 100% local.

Install • Quick Start • Features • Commands • SoClose

---

What is macmon?

A powerful terminal-based monitoring and management tool for macOS. Think CCleaner Pro + Activity Monitor + Security Scanner + Docker Manager — all in one CLI with a beautiful live TUI dashboard.

28+ commands · 16 modules · Live dashboard · Keyboard shortcuts that execute real actions · Autopilot daemon · Thermal management · Security scanner · 100% local, zero telemetry

---

Features

Live Dashboard Full-screen TUI with real-time monitoring: CPU per-core with sparkline history RAM / Swap / Wired / Active breakdown Disk I/O rates & Network sparklines Thermal monitoring (CPU temp, fan RPM, throttle detection) Security score & Docker containers live panels Process list with category icons Alerts & smart suggestions

Interactive Keyboard Shortcuts Execute real actions directly from the dashboard: Key Action S Sweep: kill zombies, orphans, stale locks P Purge inactive RAM C Full system clean (junk, caches, browsers) G Dev garbage collector (node_modules, venvs) H Health check + auto-fix K Full security audit D Docker overview F Focus mode (quit apps, DND) 1-9 Kill process #N from the list Q Quit

System Cleaner System junk (temp, logs, crash reports) 8 browsers (Chrome, Safari, Firefox, Arc, Brave, Opera, Edge, Chromium) App caches (Xcode, VSCode, Cursor, Slack, Spotify, JetBrains...) Clipboard & recent items clear Schedule via launchd	Dev Garbage Collector npm / pnpm / yarn / bun caches Stale node_modules and venvs __pycache__, .DS_Store Homebrew, Docker, Xcode DerivedData iOS Simulators, Go, Cargo	Security Scanner Security score /100 Firewall, SIP, Gatekeeper, FileVault Suspicious port detection (Metasploit, IRC, backdoors) Remote tool detection (TeamViewer, AnyDesk, VNC) Malware indicators & crypto miners IP blocking via pf & process quarantine
Process Manager Category detection (IDE, browser, Docker, Node, Python...) Kill / suspend / resume / renice / quit / restart Zombie & orphan sweep Port manager with lsof fallback	Docker Manager Container / image / volume / network listing Full prune, stop-all, restart, logs, live stats Compose project listing Security scan (privileged, host network, root, public ports)	Autopilot Daemon Background rules engine: RAM critical → purge CPU runaway → renice Thermal management → auto-throttle Security monitoring → alerts Browser RAM hog → notification Low disk & weekly clean reminders
Privacy Cleaner Recent items, Finder, QuickLook cache Shell history (zsh/bash/fish) REPL history (Python/Node/SQLite/IRB) Spotlight, SSH known_hosts, Siri	Health Check 13+ system checks with score /100 Auto-fix for safe issues Report saving & history	More Tools Startup Manager — LaunchAgents, daemons, cron App Uninstaller — full leftover detection Duplicate Finder — 3-phase xxhash + SHA-256 Disk Analyzer — big files, categorization Focus Mode — quit apps, DND, restore

---

Installation

git clone https://github.com/SoCloseSociety/macmon.git
cd macmon
bash install.sh

This will:

1. Check Python 3.9+
2. Create a venv at ~/.macmon/venv
3. Install dependencies (rich, psutil, typer, send2trash, xxhash)
4. Create /usr/local/bin/macmon wrapper
5. Initialize config at ~/.macmon/config.toml

Build DMG (optional)

bash build_dmg.sh
open dist/macmon.dmg

---

Quick Start

# Launch the live dashboard
macmon

# Full system clean
macmon clean --all -y

# Dev garbage collector
macmon gc --all -y

# Security audit
macmon security

# Health check + auto-fix
macmon health --fix

# Kill zombies & orphans
macmon sweep -y

# Purge RAM
macmon purge

# Start autopilot daemon
macmon auto --start

# Focus mode
macmon focus

# All commands
macmon --help

---

Command Reference

Command	Description
macmon	Live dashboard
macmon ps	Process list with categories
macmon kill <target>	Kill process
macmon suspend / resume <target>	Suspend / resume process
macmon nice <target> <val>	Renice process
macmon quit / restart <app>	Graceful quit / restart app
macmon sweep	Kill zombies, orphans, stale locks
macmon ports	Port manager
macmon clean --scan	Preview cleanable junk
macmon clean --all -y	Full system clean
macmon clean --browsers	Browser cleaner
macmon gc --scan	Preview dev garbage
macmon gc --all -y	Full dev GC
macmon privacy --scan	Preview privacy traces
macmon privacy --full -y	Wipe all traces
macmon health	Health check /100
macmon health --fix	Auto-fix safe issues
macmon startup --list	List startup items
macmon startup --audit	Audit suspicious items
macmon uninstall <app>	Uninstall + leftover cleanup
macmon dupes <path>	Find duplicate files
macmon bigfiles	Find large files
macmon disk	Disk usage analyzer
macmon network	Network connections
macmon flush-dns	Flush DNS cache
macmon security	Security audit /100
macmon security --block-ip <ip>	Block IP via pf firewall
macmon security --quarantine <proc>	Kill + block process
macmon docker	Docker overview
macmon docker --prune -y	Docker full cleanup
macmon docker --scan	Docker security audit
macmon auto --start / --stop	Start / stop autopilot daemon
macmon focus / restore	Focus mode on / off
macmon purge	Purge inactive RAM
macmon report	Session report
macmon config --show / --edit	View / edit config

---

Architecture

macmon.py                CLI router (typer, 28+ commands)
modules/
  dashboard.py           Live TUI (rich) — 12 panels, keyboard shortcuts
  processes.py           Process manager, sweep, ports
  cleaner.py             System cleaner (junk, browsers, apps)
  gc.py                  Dev garbage collector
  security.py            Security scanner & IP blocking
  docker_mgr.py          Docker container/image/volume management
  autopilot.py           Daemon, thermal rules, security rules, focus mode
  health.py              Health check /100 & reports
  privacy.py             Privacy traces wiper
  startup.py             Startup/login items manager
  uninstaller.py         App uninstaller with leftover detection
  duplicates.py          Duplicate file finder (xxhash + SHA-256)
  disk.py                Disk analyzer & big file finder
  network.py             Network monitor
  config.py              TOML config manager
  utils.py               Shared utilities, SQLite DB, logging

Tech Stack

Config

Config lives at ~/.macmon/config.toml:

macmon config --edit

Key sections: dashboard, thresholds, cleaner, privacy, gc, focus_mode, notifications, autopilot.

License

MIT — see LICENSE.

---

_{Built with purpose by SoClose — Digital Innovation Through Automation & AI}