Install Watchdog
- 76 installs
- 325 repo stars
- Updated August 2, 2026
- athola/claude-night-market
Install a launchd or systemd watchdog so egregore autonomously relaunches agent sessions on your Mac or Linux machine.
About
install-watchdog is an egregore setup skill for solo builders who want autonomous session relaunching on a dedicated Mac or Linux host. After you initialize an egregore project, the skill walks through OS detection and runs the correct installer script so a native scheduler fires a watchdog every five minutes. That script avoids duplicate sessions, respects budget cooldown, and only starts work when the manifest still has active items—bridging long-running agent operations without babysitting terminals. It fits indie operators running personal automation or research agents outside ephemeral CI. The skill is intentionally narrow: it does not replace the egregore orchestrator on pipelines and it is wrong when you want fully manual launch control. Expect shell-level changes under LaunchAgents or systemd and verify paths match your plugin layout before enabling.
- macOS path: install_launchd.sh → ~/Library/LaunchAgents/com.egregore.watchdog.plist on a 300-second interval
- Linux path: install_systemd.sh for an equivalent systemd watchdog unit
- Watchdog checks running session, budget cooldown, and active manifest work items before relaunch
- Explicitly not for CI/CD runners—use the orchestrator directly there
Install Watchdog by the numbers
- 76 all-time installs (skills.sh)
- Ranked #605 of 1,435 DevOps & CI/CD skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/athola/claude-night-market --skill install-watchdogAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 76 |
|---|---|
| repo stars | ★ 325 |
| Security audit | 0 / 3 scanners passed |
| Last updated | August 2, 2026 |
| Repository | athola/claude-night-market ↗ |
What it does
Install a launchd or systemd watchdog so egregore autonomously relaunches agent sessions on your Mac or Linux machine.
Files
Install Watchdog
Overview
Installs a persistent daemon that monitors the egregore process and relaunches it when needed. The daemon uses the OS-native scheduler (launchd on macOS, systemd on Linux) to run a watchdog script every 5 minutes.
The watchdog script checks:
- Whether an egregore session is already running.
- Whether the budget is in cooldown.
- Whether there are active work items in the manifest.
If all conditions are met, it launches a new egregore session.
When To Use
- After initializing an egregore project (
egregore init)
when you want autonomous relaunching.
- When setting up egregore on a new machine.
When NOT To Use
- On CI/CD runners (use the orchestrator directly).
- When you want manual control over session launches.
Installation Steps
1. Detect the operating system
OS=$(uname -s)2. Run the appropriate installer
macOS (launchd):
bash plugins/egregore/scripts/install_launchd.shThis script creates a plist at ~/Library/LaunchAgents/com.egregore.watchdog.plist that runs the watchdog script every 300 seconds (5 minutes).
Linux (systemd):
bash plugins/egregore/scripts/install_systemd.shThis script creates a systemd timer and service unit at ~/.config/systemd/user/ that fires every 5 minutes.
3. Verify installation
macOS:
launchctl list | grep egregoreExpected output: a line containing com.egregore.watchdog with a PID or - status.
Linux:
systemctl --user status egregore-watchdog.timerExpected output: active (waiting) status.
4. Confirm to the user
Report the installation result, the schedule interval, and the log file location:
- macOS:
~/.egregore/watchdog.log - Linux:
journalctl --user -u egregore-watchdog
Uninstall Command
To remove the watchdog, run:
Skill(egregore:uninstall-watchdog)Or invoke the uninstall skill directly via the command /egregore:uninstall-watchdog.
Troubleshooting
- Permission denied on plist: ensure the script runs
as the current user, not root.
- systemd user session not available: run
loginctl enable-linger $USER to enable user services without an active login session.
- Watchdog not firing: check the log output and verify
the scheduler is loaded (launchctl list or systemctl --user list-timers).
Exit Criteria
- [ ] On macOS:
~/Library/LaunchAgents/com.egregore.watchdog.plist
exists after the install script completes
- [ ] On Linux:
~/.config/systemd/user/egregore-watchdog.timer
exists after the install script completes
- [ ] Verification command confirms daemon is loaded: `launchctl list |
grep egregore returns a line (macOS), or systemctl --user status egregore-watchdog.timer shows active (waiting)` (Linux)
- [ ] Schedule interval (300 seconds / 5 minutes) and log file path
reported to the user after installation
- [ ] If
permission deniedoccurs, the error is reported with the
remediation step (run as current user, not root)
Related skills
Azure DeploySafely execute production deployments of already-prepared applications to Microsoft Azure.485k1.3kAzure ValidateRun deep pre-deployment checks on Azure configuration, infrastructure definitions, RBAC roles, and managed identities before pushing to production.485k1.3k
Github Actions DocsGet precise, docs-grounded answers about GitHub Actions workflows, syntax, security, and migration instead of relying on stale knowledge.275k72
Setup Pre CommitAutomatically run Prettier, type checking, and tests on every commit via Husky and lint-staged.170k199k
Deploy To VercelSafely turn any local project into a live Vercel preview with one instruction.99.3k29.7kVercel Cli With TokensDeploy projects to Vercel from agents and scripts using token authentication instead of interactive browser login.74.6k29.7kFAQ
Is Install Watchdog safe to install?
skills.sh reports 0 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.