Download

One tarball for Apple silicon Macs: the daemon, the menu bar app, and an install script. The daemon is a single binary with its own runtime built in, which is why the download is about 42.5 MB; nothing else needs to be installed first. Unpack it anywhere and run install.sh; it copies the files to a stable location and registers the launch agent for you.

File

agent-watchdog-0.1.0-e512c54-darwin-arm64.tar.gz

Version

0.1.0

Commit

e512c54

Built

19 Sep 2026

Platform

darwin-arm64

Size

42.5 MB (44,609,485 bytes)

SHA-256

8038a41fa1a89221809270f61534cdaa5c1fd996680122786919988d8e7ef106 (.sha256 file)

Install from the terminal

Downloads the stable-named tarball, unpacks it into the current directory, and runs the bundled installer:

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

What install.sh does, in order:

1. Checks that this is macOS on Apple silicon, and stops with a hint if not.
2. Removes the quarantine flag macOS puts on browser downloads, then starts the daemon binary once with --version so a Gatekeeper block shows up as a message here rather than as a launch agent that never starts.
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 -- --message-agents.

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.

Requirements

• A Mac with Apple silicon running macOS 13 or newer.
• cmux, the terminal the daemon watches sessions in.
• Claude Code as the agent (the only provider today).

Node is not required: the daemon binary embeds Node 26.7.0 and the launch agent runs that binary directly, so a Node on your PATH, or the lack of one, has no effect on it.

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

Intel Macs, older macOS releases, and anyone who wants to change the code can build from a clone: the quick start covers it, and the usage guide applies to both paths once agent-watchdog is on your PATH.