Install¶
MacMon needs macOS 15 or later and runs on Apple silicon and Intel Macs.
Download and open¶
- Download MacMon-latest.dmg. A specific version is at
MacMon-<version>.dmg, with a.sha256file next to it if you want to check the download. - Open the disk image and drag MacMon to Applications.
- Open MacMon. Releases are signed with an Apple Developer ID and notarized by Apple, so Gatekeeper opens them without a warning.
First-run setup¶
The first window walks through setup. Every step can be skipped, and nothing is turned on or written until you click.
Monitor in the background. MacMon's collector runs as a login item, so it keeps watching while the app is closed. You can see and change it at any time in System Settings › General › Login Items & Extensions, or in MacMon's Settings › General.
Switch from a command-line install. If an earlier command-line version is found, MacMon offers to point its background job and the agent hook at the app's own collector.
Full Disk Access (optional). Granting it to the collector lets MacMon read the privacy permission database, which is what the checks on camera, microphone, screen recording, accessibility and Full Disk Access grants need. Without it those checks report "not checked" and everything else works. It is more access than the rest of MacMon needs, so grant it only if you want those checks. The grant is made in System Settings › Privacy & Security › Full Disk Access, for the collector inside the app; the setup step has a button that opens the pane and one that shows the collector in Finder.
Real-time events (optional). By default MacMon collects every 15 minutes and within seconds of a change to a watched folder. Turning on real-time events installs a small root daemon that uses Apple's own event logging, so changes arrive as they happen and each one names the program that made it. macOS asks you to approve the daemon in Login Items & Extensions. It is off unless you turn it on, and Settings › Real-time turns it off again.
Log Claude Code tool calls (optional). Installs the logging hook in Claude Code's settings. Hooks for Codex and other agents are in Settings › Agent Hooks. See AI coding agents.
Trust this Mac as it is now. The last step records what is on the Mac today as expected, so the first run doesn't flag every existing login item and extension. It shows what it would accept before it writes anything. From then on, MacMon alerts on changes.
Finishing setup starts the first run, which takes a few minutes: it runs the slow checks and reads recent logins and agent sessions. Later runs take a few seconds.
The command line¶
MacMon's collector is also a command-line tool. Settings › Command line links macmon into ~/.local/bin, so macmon status, macmon alerts and the rest work in Terminal against the same data as the app.
Where MacMon keeps its data¶
- Data and database:
~/Library/Application Support/macmon, readable only by your account - Configuration:
~/.config/macmon/config.json
Both are shown, with Reveal buttons, in Settings › About.
Updating¶
MacMon checks for a new version once a day and offers it in the app. Nothing is installed until you click. See Updates.
Uninstalling¶
MacMon has no separate uninstaller; everything it added can be turned off from its own Settings, in this order:
- If the Mac is enrolled in a fleet, unenroll in Settings › Fleet.
- Settings › Agent Hooks: remove the hooks from each agent. If you installed the protected hook, remove it there too; it asks for an administrator password.
- Settings › Real-time: turn the root daemon off, if it was on.
- Settings › General: turn background monitoring off. This removes the login item.
- Quit MacMon and move it from Applications to the Trash.
- Delete
~/Library/Application Support/macmonand~/.config/macmonif you don't want the history and configuration kept. - If you linked the command line, remove
~/.local/bin/macmon.
If you granted Full Disk Access, the entry for the collector disappears from System Settings on its own once the app is gone, or you can remove it there.