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. Turn on optional agent messages to request a stop or handoff. Claude sessions also get estimated prompt-cache expiry alerts.
v0.1.0 Apple silicon 42.5 MB built 19 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
estimated Claude cache expiry: 3m 40s
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. Notifications arrive through cmux, with a macOS notification fallback.
- 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 cmux sidebar or the optional menu bar app. From the menu, focus a session, open a handoff, review recent alerts, or change settings.
- Request a stop or handoff
- Enable agent messaging to send a
[agent-watchdog]-prefixed request to the session's terminal. Messages are sent only after ownership and activity checks pass. Messaging is off by default.
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.