Sentinel — AI Agent State Guardian
# Sentinel — AI Agent State GuardianAutomated backup, integrity monitoring, and self-healing for AI agent workspaces.Sentinel continuously monitors your critical files, detects unexpected changes, creates automatic backups, and can self-heal from corruption. Built for AI agents that can't afford to lose state, memory, or configuration data.---## The ProblemAI agents maintain critical state in files: memory logs, configuration, user profiles, conversation history. When these files get corrupted, accidentally deleted, or unexpectedly modified:- Memory loss — Your agent forgets important context- Broken behavior — Config corruption leads to unpredictable actions- No rollback — Once a file is overwritten, it's gone forever- Silent failures — You don't know something broke until it's too lateManual backups don't work. You forget to run them. Automated backups without integrity checking just back up corruption.## What Sentinel Does### 1. Continuous Monitoring (`sentinel.py`)- Tracks critical files you specify (exact paths or glob patterns)- Computes SHA-256 hashes for change detection- Detects corruption (empty files, unexpected modifications)- Skips files currently in use by running processes- Runs on a configurable schedule (default: every 10 minutes)### 2. Automatic Backups- Creates timestamped backups when files change- Preserves directory structure in backup directory- Keeps configurable number of versions per file- Never deletes files — moves them to backup instead### 3. Self-Healing- Detects file corruption (empty files, hash mismatches)- Automatically restores from last known good backup- Logs all restoration events for audit trail- Configurable auto-restore policy (can be disabled)### 4. Restoration Tools (`sentinel_restore.py`)- Interactive backup selection with preview- Restore latest backup with one command- Restore from specific timestamp- Safety backups before restoration- Verification before restore (checks for empty backups)### 5. Workspace Manifests (`sentinel_manifest.py`)- Generate complete workspace snapshots- Full file inventory with hashes, sizes, timestamps- Compare manifests to detect changes- Diff reports (added, deleted, modified files)- Export to JSON for version control
Get it → shadowyrose.gumroad.com