Keep an eye on every agent's context.

agent-watchdog monitors Claude Code and Codex sessions in cmuxon macOS. Get alerts as context fills up, check session status from your menu bar, and get back to the session that needs you.

Notifications are on by default and are the only thing the daemon sends: it never types into an agent's terminal. Claude sessions also get estimated prompt-cache expiry alerts.

Download for macOS

v0.1.0 Apple silicon 43.7 MB built 28 Sep 2026

Or install from the terminal:

curl -fsSL https://agent-watchdog-downloads.s3.us-east-2.amazonaws.com/agent-watchdog-darwin-arm64.tar.gz | tar -xz && ./agent-watchdog/install.sh

For Apple silicon Macs with cmux and Claude Code or Codex. No Node installation needed. Requirements, checksum, and installation details

Build from source Read the guides

Example context usage58% used

estimated Claude cache expiry: 3m 40s

From the menu bar

Check sessions and adjust alerts without leaving your work. These captures show the actual app with demonstration data.

Agent-watchdog menu bar popover showing plan allowance cards, today's local token activity, and demonstration sessions with context, cache, and handoff controls, and a collapsed inactive section. — See plan allowances and each session's context, cache, and local activity. Focus a session's cmux terminal, or generate and view its handoff.Explore the menu bar controls.

Agent-watchdog settings showing warning, critical, and cache alert thresholds, with Save and Restart daemon controls. — In Settings, change the warning, critical, and cache alert thresholds, then save and restart the daemon to apply them.Configure alerts.

How it works

Find your sessions: The daemon discovers Claude Code and Codex sessions through cmux's agent hooks and local transcripts. Both agents are monitored by default.
Get context alerts: Get a warning at 35% context usage and a critical alert at 75%. Change either threshold in settings. Alerts arrive as macOS notifications.
Watch Claude cache expiry: Get an alert when an idle Claude session's prompt cache is nearing its estimated expiry. Codex cache expiry is currently unavailable.
See which session needs attention: Check context usage in the menu bar app. From the menu, focus a session, open a handoff, review recent alerts, or change settings.
Know when to ask for a handoff: The critical and cache-expiry notifications tell you which session to visit so you can ask the agent to write a handoff. When the agent writes handoff-<session>.md, the menu bar shows it and opens it for you.

The prebuilt download includes the daemon, menu bar app, and runtime for Apple silicon Macs. No separate Node installation is needed. See the download pagefor requirements, or build from source. The code is available on GitHub.