Skip to content
agent-watchdog

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

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:

  1. Checks that your Mac uses Apple silicon.
  2. Removes the quarantine flag macOS puts on browser downloads, then starts the daemon binary once with --version to check that the executable can start before registering the background services.
  3. Copies the unpacked tree to ~/.local/share/agent-watchdog (override with --app-dir).
  4. Links agent-watchdog and agent-watchdog-menubar into ~/.local/bin (override with --dir).
  5. Runs agent-watchdog install, which writes the launch agents for the daemon and the menu bar app and starts them. Pass --no-install to 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.