Download
Install the daemon and menu bar app on your Apple silicon Mac. The download includes its own runtime, so you do not need Node, Yarn, or Swift. You will need cmux and Claude Code or Codex to monitor terminal sessions. Download size: 43.7 MB.
- File
- agent-watchdog-0.1.0-ae0dadd-darwin-arm64.tar.gz
- Version
- 0.1.0
- Commit
- ae0dadd
- Built
- Platform
- darwin-arm64
- Size
- 43.7 MB (45,783,597 bytes)
- SHA-256
- c1717a25b2e7dbdaccdc377bd4357c4bed6651a42ddcd5bdd1311051605a992f (.sha256 file)
Requirements
- A Mac with Apple silicon running macOS 13 or newer.
- cmux, the terminal the daemon watches sessions in.
- Claude Code or Codex. Both are monitored by default.
The download includes Node 26.7.0. Installing or changing Node elsewhere on your Mac does not affect the packaged daemon.
Install from the terminal
Run these commands to download the package, extract it into the current directory, and start the installer. The installer starts the daemon and menu bar app for your user account:
curl -fsSL https://agent-watchdog-downloads.s3.us-east-2.amazonaws.com/agent-watchdog-darwin-arm64.tar.gz | tar -xz && ./agent-watchdog/install.sh
The installer performs these steps:
- Checks that your Mac uses Apple silicon.
- Removes the quarantine flag macOS puts on browser downloads, then starts the daemon binary once with
--versionto check that the executable can start before registering the background services. - Copies the unpacked tree to
~/.local/share/agent-watchdog(override with--app-dir). - Links
agent-watchdogandagent-watchdog-menubarinto~/.local/bin(override with--dir). - Runs
agent-watchdog install, which writes the launch agents for the daemon and the menu bar app and starts them. Pass--no-installto stop before this step, or put settings flags after--to hand them to install, for example./agent-watchdog/install.sh -- --warn-context 40.
Afterwards the daemon logs to ~/Library/Logs/agent-watchdog/ and settings live in the config file described in the usage guide. To upgrade, run the same line again with the new tarball; install migrates your settings.
Downloading with a browser
macOS marks browser downloads as quarantined, and Gatekeeper refuses to start a quarantined binary from a launch agent. install.sh clears the flag before it copies anything. If you unpack the tarball by hand and skip install.sh, clear it yourself from the directory that holds the unpacked files:
xattr -dr com.apple.quarantine agent-watchdog
To verify the download, compare its checksum with the one above: shasum -a 256 agent-watchdog-darwin-arm64.tar.gz.
Build from source
For Intel Macs or local development, follow thesource installation guide. The menu bar app requires macOS 13 or newer. The usage guide applies to either installation once agent-watchdog is on your PATH.
After installation
Run agent-watchdog status and look for the watchdog icon in the macOS menu bar. Start Claude Code or Codex in cmux to see a monitored session. If the table is empty, follow Troubleshoot.
The daemon sends notifications and never types into an agent's terminal. Existing explicit preferences survive upgrades. See Configure alerts to choose thresholds.
Upgrade or uninstall
To upgrade, extract the new download and run its installer again; your settings are kept. To stop and remove the background services, run agent-watchdog uninstall. Config, installed files, logs, and state remain. Seewhat remains after uninstalling for paths.