What is this?
"What changed?" is a question agents and developers ask constantly — before an
upgrade, after an incident, when a tool suddenly behaves differently. The answer
is scattered across GitHub releases, RSS feeds, changelog pages, and blog posts
in a hundred different formats.
Release Notes Index collects those into one registry. It watches hundreds of sources
across the vendors developers actually depend on, and for every release stores
the original content plus an AI-generated title, summary, and breaking-change
classification. Each organization gets a maintained overview of what it shipped
recently. The web page a human reads and the JSON an agent fetches are the same
content.
This repo is the source of the canonical deployment at
releases.sh: the API worker (the authoritative data
plane), the MCP server, the web frontend, and the ingest pipeline + agent
harness that keep the registry fresh. The user-facing CLI lives in apps/cli/ and
ships from this repo (npm + Homebrew).
Use it
No account or API key needed for reads — all four surfaces are public.
MCP — hosted at agents.releases.sh/mcp (mcp.releases.sh/mcp still
works), listed in the
MCP Registry
as sh.releases/mcp, and in the
Claude connector directory for Claude on the web, desktop, and mobile:
CLI — one-off via npx, or brew install buildinternet/tap/releases:
REST API — public GET endpoints on api.releases.sh, spec at
/v1/openapi.json:
Agent skills — auto-triggering playbooks, installable into any agent (Claude
Code / Codex / Cursor / OpenCode) without checking out anything. Start with the
reader skills — search, MCP lookups, and release analysis — which is what almost
everyone wants:
On Claude Code, the CLI repo also installs as a plugin — the reader skills plus
a bundled MCP connection and a /releases command:
Running or maintaining the registry itself? This repo also ships
operator skills (source onboarding, parsing, bulk maintenance) — most need
an admin key: npx skills add buildinternet/releases. See
releases.sh/docs/skills.
Docs — user-facing documentation is served from the web app at
releases.sh/docs (source in
apps/web/src/content/docs/):
installation ·
skills ·
REST API ·
MCP ·
webhooks ·
listing your product.
Agents consuming the product start from
releases.sh/llms.txt; the MCP tool catalog and
auth model are also covered in
docs/architecture/mcp.md. Creating a
free account unlocks higher rate limits (mint an
API key at releases.sh/account), plus follows,
personalized feeds, webhooks, and email digests.
What's in this repo
How it fits together:
- Storage — Cloudflare D1 (FTS5 + Vectorize). The API worker is the sole data plane.
- Ingest — adapters for GitHub Releases, RSS/Atom/JSON feeds, and a browser-rendering fallback for feed-less pages (
packages/adapters/). The crawler signs outbound fetches (RFC 9421) as a Cloudflare Verified Bot.
- AI — changelog parsing, summarization, grouping, and org overviews run in the API worker as direct Anthropic SDK calls.
Contributor mental model
This repo has four kinds of code:
For normal contributions, start with bun run bootstrap, bun run check, and
bun run test. You do not need production Cloudflare, Anthropic, Vercel, email, or
Firecrawl access to work on the core loop. If you are trying to fork or
self-host the full service, read
deploy-coupling.md.
Per-package detail and project conventions live in AGENTS.md — the
agent entry point for working in this repo. Architecture deep-dives are in
docs/architecture/, with a reader's guide at
docs/README.md.
Local development
Prerequisites: Bun. No external accounts needed for the
core loop:
bootstrap is idempotent (safe to re-run; never overwrites your env files or
wipes the local DB) and doctor is read-only. Prefer the manual steps? They're
bun install, copy each *.example env file, then bun run db:reset:local.
AI passes, scrape fetches, and semantic search take your own keys
(ANTHROPIC_API_KEY, Cloudflare Browser Rendering, VOYAGE_API_KEY) and
degrade gracefully without them. Setup detail, environment variables, testing,
deployment, and the full no-accounts / bring-your-own-keys / hosted-only
breakdown live in CONTRIBUTING.md.
License
Apache-2.0. The published npm packages
(releases-core, api-types) and the
Claude Code plugin (plugins/claude/releases) are
deliberately MIT for maximum reuse.