Skip to content
TakoAPI
Back to skills

agent-defibrillator

by hazy2go

iOS & macOS Development
543Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Watchdog that monitors your AI agent gateway and restarts it when it crashes.

Description

What This Skill Does

Watchdog service for macOS that monitors an AI agent gateway running under launchd and automatically restarts it when it crashes or becomes stale. Checks gateway health every 10 minutes with configurable retry and cooldown logic. Optionally sends Discord notifications when a restart occurs.

Uses native macOS launchd instead of cron or external process managers, so the watchdog itself survives reboots and user sessions without extra setup.

When to Use It

  • Keep an AI agent gateway running overnight without manual intervention
  • Get notified on Discord when your local agent crashes and recovers
  • Prevent restart storms with cooldown protection after repeated failures
  • Detect and respond to version mismatches after updating the gateway
  • Monitor agent uptime on a development machine without third-party tools

Example Workflow

INPUT

User asks: install the defibrillator watchdog

AGENT
  1. 1

    Clones the agent-defibrillator repository

  2. 2

    Runs install.sh to register the launchd plist and deploy the script to ~/.openclaw/scripts/

  3. 3

    Verifies the service appears in launchctl list

  4. 4

    Optionally sets DISCORD_CHANNEL in defibrillator.sh for restart notifications

  5. 5

    Confirms the watchdog is active and begins polling the gateway every 10 minutes

OUTPUT

Watchdog service running under launchd, auto-restarting the AI agent gateway on crash with optional Discord alerts

Requirements

  • macOS (launchd required)
  • Discord channel ID (optional, for notifications only)

Installation

clawhub install hazy2go/agent-defibrillator

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links