hermes-watchdog

Community

Hermes gateway watchdog for uptime.

Authorhuidge
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Launchd alone restarts Hermes on process exit, but it cannot detect a hung or unresponsive gateway. This watchdog adds a heartbeat-based check that monitors the /health endpoint to keep Hermes responsive.

Core Features & Use Cases

  • Heartbeat monitoring: polls the gateway health endpoint every 2 minutes.
  • Auto-restart: restarts Hermes via launchctl after 3 consecutive health check failures.
  • High availability: uses a KeepAlive launchd plist to keep the watchdog running continuously.
  • Mac sleep/wake resilience: handles sleep/wake cycles to recover from transient states.
  • Simple setup: provides scripts and plist templates for quick deployment.

Quick Start

Create the watchdog script, configure the launchd plist, and load the service.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: hermes-watchdog
Download link: https://github.com/huidge/hermes-skills/archive/main.zip#hermes-watchdog

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.