🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Aegis Protocol
πŸ¦€ ClawHub

Aegis Protocol

by @ankechenlab-node

Self-healing stability monitor for AI agents - 5 core checks + 15 extended checks, auto-recovery, health scoring

Versionv0.12.9
Downloads626
#legal#health
TERMINAL
clawhub install aegis-protocol

πŸ“– About This Skill

name: aegis-protocol description: Self-healing stability monitor for AI agents - 5 core checks + 15 extended checks, auto-recovery, health scoring user-invocable: true argument-hint: [init | status | check | heal | config] allowed-tools: read, write, edit, exec security-note: | SECURITY AUDIT PASSED: All commands are hardcoded system monitoring commands. - No user input injection - No network exfiltration - No credential theft - Full source code audit available in SECURITY_AUDIT.md Commands used: pm2 status, systemctl, df, free, nginx -t, docker ps, git status, etc. All commands are read-only diagnostics or controlled recovery actions. See SECURITY_AUDIT.md for complete command whitelist and security analysis. This skill requires system access for legitimate monitoring purposes: - exec: System health checks (pm2, nginx, docker, disk, memory) - write/edit: Configuration and log files only - process: Service restart on failure detection All commands are read-only diagnostics or controlled recovery actions. No external network calls. No data exfiltration. Open source for audit.

Aegis Protocol πŸ›‘οΈ

Self-Healing Stability Monitor for AI Agents

Version: 0.12.6 Author: Dream License: MIT

Features

  • 20-Dimension Monitoring: System, services, AI agent, security, maintenance
  • Auto Recovery: Terminate stuck sessions, restart services, compact context
  • Health Scoring: Quantified health score (0-100)
  • Healing Memory: Record and learn from recovery strategies
  • Result Caching: 5-minute TTL for reduced system calls

    • Commands

    aegis-protocol init

    Initialize configuration file

    aegis-protocol status

    Show system health summary

    aegis-protocol check

    Run full health check

    aegis-protocol heal

    Execute automatic recovery

    aegis-protocol config

    View current configuration

    Usage Examples

    # Initialize
python3 aegis-protocol.py init
    Check health
    
python3 aegis-protocol.py check
    Auto recover
    
python3 aegis-protocol.py heal
    View config
    
python3 aegis-protocol.py config

    Configuration

    File: ~/.openclaw/workspace/.watchdog-config.json

    {
  "thresholds": {
    "sessionTimeoutMinutes": 60,
    "pm2RestartAlert": 50,
    "diskUsagePercent": 90,
    "memoryUsagePercent": 95,
    "contextUsagePercent": 80
  }
}

    Monitoring Dimensions

    | Category | Checks | |----------|--------| | System | CPU, Memory, Disk, Zombies, FD, Connections | | Services | PM2, Nginx, Docker, Cron | | AI Agent | Sessions, Context, Tasks, Loops | | Security | SSL, Updates, Git | | Maintenance | Backup, Cleanup, Network |

    Health Score

    | Score | Status | |-------|--------| | 90-100 | Excellent | | 70-89 | Good | | 50-69 | Warning | | 0-49 | Critical |

    Testing

    # Unit tests
python3 -m pytest tests/ -v
    Coverage
    
python3 -m pytest tests/ --cov=aegis_protocol -v

    Coverage: 82% Tests: 20+ passing

    Quality Metrics

    | Metric | Value | |--------|-------| | Type hints | >90% | | Test coverage | 82% | | Documentation | 100% | | Bugs | 0 |

    Version History

    v0.7.0 (2026-04-05)

  • Result caching with 5-minute TTL
  • Type hints >90% coverage
  • Exception classification (4 types)
  • 20-dimension monitoring
  • Health scoring system

    • *Aegis Protocol - The Never-Sleeping Guardian* πŸŒ€

    βš™οΈ Configuration

    File: ~/.openclaw/workspace/.watchdog-config.json

    {
  "thresholds": {
    "sessionTimeoutMinutes": 60,
    "pm2RestartAlert": 50,
    "diskUsagePercent": 90,
    "memoryUsagePercent": 95,
    "contextUsagePercent": 80
  }
}