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

Health Score

Testing

# Unit tests
python3 -m pytest tests/ -v

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

Coverage: 82%
Tests: 20+ passing

Quality Metrics

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 🌀