Handbook
Welcome to the claude-guardian handbook. This is the complete guide to keeping your Claude Code sessions healthy, capturing evidence when things go wrong, and letting Claude self-monitor via MCP.
What’s inside
Section titled “What’s inside”- Getting Started — Install and first health check
- Commands — Full CLI reference
- MCP Server — The 8 tools Claude can call mid-session
- Configuration — Knobs, thresholds, and aggressive mode
- Architecture — Design principles and how the watchdog works
- Security — Trust model and data scope
What is claude-guardian?
Section titled “What is claude-guardian?”Claude Guardian is a local reliability layer that keeps Claude Code sessions healthy. It detects log bloat, disk pressure, and hangs before they cause problems, captures evidence when things go wrong, and exposes an MCP server so Claude can self-monitor mid-session.