# gitdebt

> Cool statistics for public GitHub repositories: star history, growth, contributors, ownership risk, language activity, churn, bug magnets, maintenance cadence, and README-ready media.

Gitdebt analyzes public repositories only. Private repositories are ignored and never counted. Star-history read surfaces use gitdebt's Postgres cache; repository-health analysis runs asynchronously against the public Git repository.

## Preferred representations

- One rule: the Markdown for any page is `https://api.gitdebt.com/api/md/{path}`, where `{path}` is that page's site path. The home page is `https://api.gitdebt.com/api/md/`.
- Adding `.md` to a site URL still works, but as a 302 to the route above. The site serves no Markdown itself.
- Use the page's `<link rel="alternate" type="text/markdown">` to discover the route rather than constructing it.
- Every shape resolves: `/api/md/about`, `/api/md/badges`, `/api/md/{owner}/{repo}`, `/api/md/{login}`, `/api/md/compare/{category}`, `/api/md/vs/{owner1}/{repo1}/{owner2}/{repo2}`.
- A repository report carries its measured star and health figures plus paste-ready README snippets, and works for ANY public repository, analyzed or not. It answers 202 and queues the analysis when nobody has analyzed the repository yet; add `?enqueue=0` to look without queueing.
- Repository alias, the same document under the repository's own API prefix: `https://api.gitdebt.com/api/repos/{owner}/{repo}/report.md`
- The complete embed catalog, every snippet, every query parameter, and a ready-made prompt for adding these to a README: `https://api.gitdebt.com/api/md/badges`
- Repository star history: `https://api.gitdebt.com/api/repos/{owner}/{repo}/stars.json`
- Repository health: `https://api.gitdebt.com/api/repos/{owner}/{repo}/stats.json`
- Repository health summary: `https://api.gitdebt.com/api/repos/{owner}/{repo}/health.json`
- Queue status and ETA: `https://api.gitdebt.com/api/repos/{owner}/{repo}/progress.json`

## Primary pages

- https://gitdebt.com/
- https://gitdebt.com/report
- https://gitdebt.com/leaderboard
- https://gitdebt.com/compare
- https://gitdebt.com/badges
- https://gitdebt.com/about

## More detail

- https://gitdebt.com/llms-full.txt