Agent Friendly Code

Changelog

What's shipped from the roadmap, not a dev log. Every bullet corresponds to a roadmap item that landed.

0.6.0Auto-refresh — scores stay fresh on their own2026-05-20
  • Scheduled rescoring — a 6-hourly GitHub Actions cron re-runs `bun run seed` over every tracked repo, commits the refreshed `data/rank.db` to `main`, and Vercel redeploys. Scores stay current without anyone re-running the seed by hand. The job skips the commit when no `overall_score` actually changed.
  • Score-delta on the repo page — `/repo/:id` shows a `+N.N` / `-N.N` diff (green/red) under the overall score so a regression since the last rescore is visible at a glance. Hover or focus reveals a score-history popover with the previous value, the change, and the absolute scored-at date. Hidden on a repo's first scoring.
  • 16 new seed repos in the curated set so the cron has more material to refresh on each cycle.
0.5.0Scorer ships outside the dashboard2026-05-02
  • PR score-diff GitHub Action — `hsnice16/agent-friendly-action` on the GitHub Marketplace. Scores base + head locally inside CI and posts a single PR comment with the overall delta + per-signal breakdown. Vendored scorer (works even if the dashboard is down); opt-in via `AGENTS_BADGE_TOKEN`. Repo detail pages now show a copy-paste workflow snippet under "Catch score regressions on every PR".
  • Portable agent skill — `npx skills add hsnice16/agent-friendly-skill#v0` installs into any vercel-labs/skills-compatible host (Claude Code, Codex, Cursor, Cline, Copilot, Continue, Roo Code, …). Scores the user's current repo locally with a vendored scorer and recommends a model — produces identical output regardless of which host invokes it.
  • Dedicated integration pages on the dashboard — `/action` (workflow snippet + Marketplace link + FAQ) and `/skill` (install command, score → model mapping, optional `SessionStart` hook snippets for Claude Code and Codex).
  • Public `GET /api/score?host=<host>&repo=<owner>/<name>` — natural lookup endpoint for any tool that has a repo URL but not the dashboard's internal id. Returns `{ repo, signals, modelScores }` on 200, `{ error: "not_indexed" }` on 404. Both the action and the skill consume this.
0.4.0Credible scores + better discoverability2026-04-27
  • Per-model rationales now cite each agent's official documentation — `/methodology` renders a Sources panel under every model, and the 'illustrative weights' framing is gone. Reweights: Devin CI 1.0 → 0.7, Codex AGENTS.md 0.7 → 0.9, Cursor AGENTS.md 0.6 → 0.8.
  • Four new agent-specific instruction-file signals — `.cursor/rules/*.mdc` (Cursor), `GEMINI.md` (Gemini CLI), `.openhands/setup.sh` (OpenHands), `.aider.conf.yml` (Aider). Each is a per-agent boost on the model that reads it.
  • `/about` page — independent project, no vendor affiliation, links from the footer; gives the methodology a human face for both readers and LLM crawlers.
  • `/llms.txt` markdown manifest — Perplexity / Claude / ChatGPT-search can ingest the site's pages and public API endpoints cleanly.
  • Per-repo Open Graph images — sharing a `/repo/:id` URL renders a 1200×630 preview with the repo + score instead of the default site card.
0.3.0Embeddable scores + broader coverage2026-04-25
  • Embeddable score badges — `/badge/<host>/<owner>/<name>.svg` returns an SVG you can drop into a README; per-model variants via `?model=<id>`. Repo detail pages show a copy-paste markdown snippet.
  • Package lookup — `/package` page (registry dropdown + name input) and `/api/package/<registry>/<name>` JSON resolve npm / PyPI / Cargo packages to their source repo's score; unscored ones get a pre-filled GitHub-issue link to request scoring.
  • Same-language alternatives — repo detail pages show up to 3 alternative repos (same host + same language) ranked for the selected model.
  • Broader agent coverage — Gemini CLI, Aider, OpenHands, and Pi added to the per-model leaderboard with illustrative weights, flagged as such on `/methodology`.
  • Smoother leaderboard navigation — `ScoreBar` fills animate between pages instead of popping in.
0.2.0Complete the dogfood2026-04-24
  • This project scores ≥90 on its own rubric — overall 90.6, with each per-model score within 3 pts of the overall.
  • Leaderboard rows are fully clickable — click anywhere in a row to open the repo detail page (the external open link still goes to the host).
  • Curated set expanded ~5× — ~125 repos now ranked across JS/TS, Python, Rust, Go, JVM, C/C++, Swift, Ruby, Dart, language runtimes, AI-native models, and coding agents (up from ~25 at 0.1.0).
  • Desktop leaderboard shows 32 rows per page (mobile keeps 16), with pagination moved below the list so the toolbar stays clean.
  • Floating back-to-top button appears in the bottom-right when you're near the end of a long page.
  • Leaderboard footer shows the total number of tracked repos and when they were last scored.
0.1.0First public release2026-04-22
  • Public leaderboard ranking open-source repos by agent-friendliness across GitHub, GitLab, and Bitbucket.
  • Per-model scoring — separate ranking for Claude Code, Cursor, Devin, and GPT-5 Codex, each with its own signal weights.
  • Repo detail page — score breakdown per signal and the top improvements ranked by score-gain for the selected model.
  • Methodology page explaining what's measured today and what isn't.
  • Leaderboard controls — live search, host filter (GitHub / GitLab / Bitbucket), rank + stars sort, paginated results.
  • Light + dark theme that follows the OS preference; mobile-friendly layout down to 320-px viewports.
  • JSON API — `GET /api/repos` and `GET /api/repo/:id` for programmatic access.
  • MIT licensed — free to reuse, adapt, and self-host.