Sentinel - Project Health, Issue Scanner & Asset Cleaner

Sentinel is a Unity Editor extension for project auditing, build validation, and asset cleanup. It scans your scenes and prefabs for missing scripts, broken references, and unused assets - then helps you fix, clean, and track them over time.

Unlike simple missing script finders, Sentinel combines four specialized tools in one window to cover every aspect of Unity project health - from scene validation to CI/CD pipeline integration.

Online Documentation

🔍 Issues Finder

A full scene validator and prefab auditor that scans both open and closed scenes (without opening them) for 10 built-in issue types: missing scripts, broken references, null materials, shader errors, invalid layers, invalid tags, empty UnityEvents, unused components, and more. Severity is configurable per issue type. One-click auto-fixes with full Undo support.

🗑️ Project Cleaner

A dead file remover and unused asset cleaner powered by a root-tracing dependency scanner. Flags assets that are truly unreferenced - not just "not in a scene," but unreachable from every build scene, Resources folder, Addressables group, and asset bundle. Deletions go to a reversible Trash folder by default, with an automatic backup ZIP for permanent deletions.

🔗 References Finder

A full-project dependency tracker that instantly answers "where is this asset used?" across scenes, prefabs, and ScriptableObjects, with YAML-level fallback search for complete accuracy.

📈 Trends & Health Score

Every scan produces a 0-100 Health Score. A built-in trends chart tracks errors, warnings, and totals across up to 60 historical scans. Lock a Baseline to separate intentional technical debt from new regressions - critical for team workflows and code reviews.

🚀 CI/CD Ready

Run headless project audits from the command line. Outputs both a machine-readable JSON report and a JUnit XML report compatible with GitHub Actions, Jenkins, and GitLab CI. A ready-to-use GitHub Actions workflow is included. Install a git post-merge hook to auto-scan after every pull.

🛡️ Build Validation

Enable "Fail Build on Errors" to automatically block player builds if critical issues exist. A fast pre-build check (missing scripts + broken references only) runs before every build to catch problems before they reach your players.

🔔 Notifications

Send scan results to a Slack or Discord channel via webhook with one URL paste.

🔧 Extensible

Add your own project-specific detectors by extending SentinelExtensionBase. Auto-discovered via TypeCache - no registration needed. Suppress false positives with the [SentinelIgnore] attribute directly in code, or exclude entire folders from the dependency scanner.

📧 Support & Questions

For any questions, bug reports, or feature requests, reach out at ragendom@gmail.com

We typically respond within 24-48 hours.

Zero runtime footprint. Editor-only assembly. Nothing added to your player builds. Compatible with Unity 2021.3 LTS through Unity 6. No external dependencies.