repo-heal
v1.0.3
Published
A static website repair CLI with deterministic fixes and AI fallback
Readme
Repo Heal
Repo Heal is a static website repair tool. Install or run it in a target repo, set a Gemini API key, and let it scan HTML, CSS, and browser JavaScript files. It applies deterministic fixes first and only escalates harder issues to an LLM fallback.
Use In Any Repo
npx repo-heal setupThe setup command creates:
.github/workflows/repo-heal.yml.healignore.env.repo-heal.example
Then add GEMINI_API_KEY to your local .env file or to GitHub Actions secrets.
Run Locally
npx repo-heal runTo report issues without changing files:
npx repo-heal scanTo apply only deterministic static website fixes:
npx repo-heal fixFor local development inside this package:
npm run setup
npm run healCommands
repo-heal setup: install config into the current repositoryrepo-heal scan: report static website issues without changing filesrepo-heal fix: run deterministic HTML/CSS/JS repairsrepo-heal run: scan and repair the current repositoryrepo-heal summary: print a markdown summary from the latest run metricsrepo-heal help: show CLI help
Notes
Repo Heal works on the current working directory. It is meant to be used from the root of the static website repository you want to repair, not from a bundled demo app.
