repo-janitor

You can identify orphan files and broken links by running a read-only repository audit. The scan detects unreferenced assets, dead HTML, and broken Markdown links, generating a structured report of all debris without modifying your files.

The safest cleanup method is a read-only audit that identifies temp files and empty directories, followed by an explicit --fix workflow. This two-step process ensures you review all debris before applying changes to your repository.

Yes, the audit works with documentation repositories containing _manifest.js, docs, and slides folders. It is worktree-aware and specifically targets debris created by ongoing refactors in these structures.

To remove dead HTML and temp files, you apply the explicit --fix workflow after reviewing the audit report. The tool operates in read-only mode by default, requiring this flag to execute approved deletions safely.

Yes, repository cleanup supports codebases of any size with ongoing refactors. The worktree-aware scanning correctly references the repo root to accurately identify orphan files and broken links across complex structures.