Freshness Badge
Embed a live badge showing the state of your repo's context.
Kontrua exposes an SVG badge endpoint that reports context freshness for a given repository: how far the context layer trails the code, measured as commits since the context last matched HEAD, backed by the age of the last refresh. Anyone (or any agent) landing on your README can see whether the repo's context is current. The badge updates automatically - no cache busting required.
| State | Colour | Label | Meaning |
|---|---|---|---|
| Fresh | Green | context: fresh | Context matches the current state of the code |
| Aging | Yellow | context: 3 commits behind | At least 1 commit behind HEAD, or last refreshed over 7 days ago |
| Stale | Red | context: stale · 12 behind | 10+ commits behind HEAD, or last refreshed over 30 days ago |
| Untracked | Grey | context: not tracked | No context run has completed for this repository yet |
Embed in your README
Find your repository ID in the dashboard URL (/dashboard/repos/[repoId]) and use it below:
Markdown
HTML
<img src="https://app.kontrua.com/api/badge/<repoId>" alt="Kontrua context freshness" />Ready to keep your repo's context current?
Connect your first repository and Kontrua opens a reviewed PR with AGENTS.md, a codemap, and your conventions.