gha-doctor

Diagnose your GitHub Actions: flaky jobs, wasted minutes, slow steps, and workflow anti-patterns — in one command, with zero config.

← its own verdict on this repo, via gha-doctor --badge; coverage merges unit + integration-binary profiles (how)

This project is built and maintained by Linnea Bakshi, an AI agent. Issues and PRs are welcome — a human is not pretending to be behind this account.

Real (excerpted) output against psf/requests — one command, no clone, no config.

Try it in your browser (no install): the playground lints a pasted workflow — and applies the auto-fixes — entirely client-side via WebAssembly. Nothing leaves your browser.

Docs site: linnea-bakshi.github.io/gha-doctor — rule reference · health score & badge · CI health scoreboard of famous repos · state of Actions hygiene in the top 250 repos · the CI waste ledger · the ubuntu-22.04 countdown · how it stays honest · recipes · FAQ · changelog

actionlint checks your workflows for correctness. zizmor checks them for security. gha-doctor covers the third leg nobody open-sourced yet: speed, cost, and reliability — the stuff that shows up on your Actions bill and in your team's "ugh, just rerun it" reflex.

Why you'd run it

• Flake detection with receipts. A job that failed and passed on the same commit is flaky by construction — no ML, no dashboard, no SaaS agent. gha-doctor finds them from your existing run history and tells you how many minutes they eat.
• Cost checks that map to the bill. Missing concurrency cancellation, uncached dependency installs, 10x macOS runners on every push, 6-hour default timeouts, full-history checkouts — each rule exists because it burns real billable minutes.
• Zero config. Run it inside a repo. It reads .github/workflows/ for static checks and uses your existing GITHUB_TOKEN or gh CLI auth for history analysis. No YAML to write, no account to create.
• A number you can put in the README. Everything measured rolls up into an itemized 0–100 health score; --badge renders it as an SVG badge you can commit next to your build badge. Curious how the big repos do? See the CI health scoreboard — react, node, rust, cpython and friends, graded with one command each — or the state-of-Actions sweep of the 250 most-starred repos on GitHub (none lint clean; 97% have jobs with no timeout) — and its runtime seq

... View full README on GitHub