agent-model-healer

What problem does it solve?

Zouroboros self-healing watchdog that monitors model health across all scheduled agents. When a model fails (402 credits, 429 rate limit, 503 unavailable, timeout), the healer automatically switches affected agents to the next healthy fallback model. When the original model recovers, it restores agents to their preferred model. Runs as a scheduled watchdog agent.

Core Features & Use Cases

• Automatic health monitoring: continuously checks configured models and detects unhealthy states.
• Deterministic failover: moves affected agents to the next healthy fallback model and preserves a rollback path.
• Zero-cost orchestration: performs agent management via direct MCP calls and minimal probe cost.
• Auditable actions: maintains a per-agent switch history and state for auditing.

Quick Start

Configure and run the healer on a schedule to automatically probe models, switch unhealthy agents to fallbacks, and restore originals when they recover.