/install-watchdog

# install-watchdog Install a system-level daemon that monitors the egregore and relaunches it after crashes, rate limits, or context overflows. ## What It Does On macOS, installs a launchd agent (`com.egregore.watchdog`) that runs the watchdog script at a fixed interval. On Linux, installs a systemd user timer (`egregore-watchdog.timer`) instead. The watchdog checks: 1. Whether active work items remain in the manifest. 2. Whether a cooldown period is still active. 3. Whether a session is already running (via pidfile). If work remains and no session is running, the watchdog relaunches ...

install-watchdog

Install a system-level daemon that monitors the egregore and relaunches it after crashes, rate limits, or context overflows.

What It Does

On macOS, installs a launchd agent (com.egregore.watchdog) that runs the watchdog script at a fixed interval. On Linux, installs a systemd user timer (egregore-watchdog.timer) instead.

The watchdog checks:

Whether active work items remain in the manifest.
Whether a cooldown period is still active.
Whether a session is already running (via pidfile).

If work remains and no session is running, the watchdog relaunches the egregore.

Prerequisites

jq must be installed (used to parse manifest and budget files).
The claude CLI must be on your PATH.

Options

Option	Default	Description
`--window`	`5h`	Time window for the session
`--interval`	`300`	Check interval in seconds