// organic distribution

Your README badge.
Every view = a free impression.

Drop one line into your README. Every developer who reads your README sees that you ship with AI-powered code review. Unpaid distribution — Linus's law for marketing.

Three states, automatically

PullLight: 3 catches PullLight PullLight 3 catches 3 catches
Active — bugs found
Installed and PullLight has caught N issues. Links to your public repo report.
PullLight: watching PullLight PullLight watching watching
Active — no catches yet
Installed but no issues found yet. Signals your repo is under active AI review.
PullLight: enable PullLight PullLight enable enable
Not installed
Repo not yet using PullLight. Great for "Powered by PullLight" — lets visitors click to install.

Get your snippet

Enter your GitHub owner and repo name
GitHub owner
Repository name
[![PullLight](https://pulllight.io/badge/your-org/your-repo.svg)](https://pulllight.io/repos/your-org/your-repo)

Copy & paste

Markdown (for README.md)
[![PullLight](https://pulllight.io/badge/{owner}/{repo}.svg)](https://pulllight.io/repos/{owner}/{repo})
HTML (for docs sites)
<a href="https://pulllight.io/repos/{owner}/{repo}"> <img src="https://pulllight.io/badge/{owner}/{repo}.svg" alt="PullLight"> </a>
Badge URL format: https://pulllight.io/badge/{owner}/{repo}.svg
The badge auto-updates every 5 minutes. No tokens or secrets needed — it's a public URL. The link destination is your public repo report page at pulllight.io/repos/{owner}/{repo}.

FAQ

Does the badge expose any private data?
No. It shows a catch count (total number of AI findings) and repo state — nothing about the content of findings, code, or PRs. The same data is public on your /repos page.
How often does it update?
The badge is cached for 5 minutes at CDN level. GitHub's README renderer also caches images — expect up to 15 minutes for a fresh count to appear.
Can I use this before PullLight has reviewed any PRs?
Yes. If installed but no PRs reviewed yet, the badge shows "watching" in blue — signaling you take code quality seriously. It's a conversion signal even before the first catch.
What if I'm not using PullLight yet?
The badge shows "enable" in gray — a subtle nudge for contributors visiting your README. They can click through to install. It's the "Powered by PullLight" variant mentioned in the task.

Start catching bugs

Install PullLight on your repo in 30 seconds. No credit card, no config file needed.

Install on GitHub → See real catches →