# kirby-watchdog

> Self-healing watchdog for gateway health monitoring

- Author: acceptc00kies
- Repository: acceptc00kies/kirby-gateway
- Version: 20260127091115
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/acceptc00kies/kirby-gateway
- Web: https://mule.run/skillshub/@@acceptc00kies/kirby-gateway~kirby-watchdog:20260127091115

---

---
name: kirby-watchdog
description: Self-healing watchdog for gateway health monitoring
metadata: {"clawdbot":{"emoji":"🐕","skillKey":"kirby-watchdog","requires":{"config":["plugins.entries.kirby-bridge.enabled"]}}}
---

# Kirby Watchdog

Self-healing capabilities for the Clawdbot/Dreamland gateway. Detects stuck states and automatically recovers.

## Tool

Use `kirby_watchdog` for agent-initiated health monitoring and repair.

Actions:
- `check_health` - Check gateway health status
- `diagnose` - Run full diagnostics
- `auto_repair` - Attempt automatic repair
- `force_kill` - Force kill stuck processes
- `list_processes` - List Clawdbot-related processes

## Examples

### Check gateway health
```json
{
  "action": "check_health"
}
```

### Run diagnostics
```json
{
  "action": "diagnose"
}
```

### Auto-repair (diagnose + fix + verify)
```json
{
  "action": "auto_repair"
}
```

### Force kill stuck tasks
```json
{
  "action": "force_kill"
}
```

### List all processes
```json
{
  "action": "list_processes"
}
```

## Stuck Detection

The watchdog detects stuck states based on processing duration:
- **5 minutes**: Passive abort attempted
- **10 minutes**: Force kill triggered

## Why Tasks Get Stuck

Clawdbot's abort mechanism is **passive** - it only sets a flag (`signal.aborted`). Background processes explicitly ignore this flag and must timeout or be force-killed.

## CLI Commands

```bash
# Quick check
python ~/.kirby/kirby-toolkit/watchdog/clawdbot_watchdog.py --once

# Run daemon (continuous monitoring)
python ~/.kirby/kirby-toolkit/watchdog/clawdbot_watchdog.py --daemon

# Force kill
python ~/.kirby/kirby-toolkit/watchdog/force_kill.py

# List processes without killing
python ~/.kirby/kirby-toolkit/watchdog/force_kill.py --list

# Full auto-repair
python ~/.kirby/kirby-toolkit/watchdog/auto_repair.py
```

## Configuration

Requires the kirby-bridge plugin to be enabled.