Skip to content

Using MacMon

The menu bar shield

The shield in the menu bar shows a checkmark when no alert is open and an exclamation mark, colored by the worst open alert, when one is. It turns to a warning tint if background monitoring has stalled. Clicking it shows the open alerts, how many checks are failing and when the last run was, with Run now, Full scan, Open MacMon and Settings.

The main window

  • Overview: posture at a glance, open alerts by severity, recent activity, and the banner when an update is available.
  • Alerts: everything that needs attention, in groups.
  • Checks: every check, passing or failing, with why it matters and how to fix it.
  • Inventory: what is installed and what starts automatically, with the history of each item.
  • Activity: logins, unlocks, sudo and SSH sessions, and the timeline.
  • AI agents: the agents on this Mac, their configuration, their sessions and tool calls, skills and MCP servers.
  • Settings: monitoring, permissions, agent hooks, real-time events, network, checks, allowlists, updates and fleet.

Alerts and groups

An alert is a change or a check failure that deserves a look. Alerts about the same thing are shown as one group, and the Alerts section sorts groups into three buckets:

  • Needs a decision: something new, something removed, a rule that matched, or a change nothing signed can account for.
  • Routine: a known item changed by the same signed program as before, typically an app updating itself. These never notify.
  • Resolved: alerts that closed themselves, kept in view for two weeks.

The control at the top arranges the list by subject, by the program behind the alerts, or flat. Each group and each alert carries a next step: what to look at, or the fix.

Acknowledge marks alerts as seen. They leave the open list and stay in the history.

Accept adds the item behind an alert to the matching allowlist, so that login item, listener or extension is expected from now on, and acknowledges the alert. It is offered only when the whole group can be accepted the same way. Only accept what you recognize.

Trust, for an agent configuration item such as a hook or an MCP server, accepts that exact content. If the content changes later, it is flagged again.

Skip, in Settings › Checks, turns a check off for this Mac. Skipped checks are counted in Settings so they aren't forgotten.

For an AI tool-call alert that is expected in a particular project, Acknowledge as expected here keeps that rule quiet for that folder.

Review

Review steps through the groups one at a time, those that need a decision first, then the routine ones. Each shows the owner, the reason it was grouped that way, the count and time span, the next step, and the newest alert in full, with Acknowledge, Accept, Details and Skip. It is the fastest way through a morning's alerts. The command line has the same flow as macmon review.

Runs

The collector runs every 15 minutes, and within seconds of a change to a watched folder or log. Run now starts a run immediately; Full scan also runs the slow checks, which otherwise repeat once a day. Settings › General shows the last run, how many checks passed and failed, and lets you pause monitoring for a while.

Allowlists and the baseline

Allowlists hold what is expected on this Mac: admin accounts, login items, listening ports, browser extensions and so on. Setup fills the empty ones from the Mac's current state, which is what Trust this Mac as it is now means. Settings › Allowlists shows every list and lets you add or remove entries; Fill Empty Lists repeats the setup step for lists that are still empty, for example after an update adds a new check, without touching the lists you already have.

Notifications

With notifications on (Settings › General), MacMon notifies when a run finds new alerts that need a decision; routine ones are only counted in the text. Clicking the notification opens the alert in the app.

The timeline

Every alert has an Around this time view in Activity: the events, logins and agent tool calls from the minutes before and after it, so a change can be read in context.