Identify breaking changes between two versions of a public GitHub repository — fetch the releases, scan the bodies, and generate a tech-debt specification with the LLM provider of your choice.
🌐 Live: breakingchanges.ai
- Paste a GitHub repo URL.
- Pick a current version and a target version.
- Review the aggregated changelog between them.
- Optionally run an AI analysis that produces a markdown tech-debt spec — categorizing breaking changes (API / Behavior / Dependencies / Security / Tooling), proposing an upgrade path, and rating complexity.
Breaking Changes is a bring-your-own-key (BYOK) service. We do not host an LLM key on your behalf, and we do not charge you. You supply a key from one of the supported providers and pay them directly for whatever the analysis costs.
Supported providers:
| Provider | Key prefix | Get a key |
|---|---|---|
| OpenAI | sk-… |
platform.openai.com/api-keys |
| Anthropic | sk-ant-… |
console.anthropic.com/settings/keys |
AIza… |
aistudio.google.com/app/apikey | |
| Mistral | (no prefix) | console.mistral.ai/api-keys |
A GitHub fine-grained PAT is also optional — paste one in to lift the 60 req/hr unauthenticated rate limit on api.github.com.
- Default storage is
sessionStorage— keys live in your browser tab and are wiped when you close it. localStorageis opt-in per provider with a "Remember on this device" toggle. Persisted keys are auto-cleared after 24 hours of inactivity on tab focus.- The server is a transit proxy. When you run an analysis, your key is sent in an
Authorizationheader, immediately forwarded to the provider you chose, and discarded. Nothing is persisted server-side. Error logs strip known key prefixes before writing. - Clear any key (or all keys) at any time from the in-app settings drawer.
Use the most narrowly scoped key your provider supports — set a low spend cap, restrict it to one project / workspace, and revoke it if anything looks off.
- OpenAI — create a Project, scope the key to it, and set a project usage limit.
- Anthropic — create a Workspace and a workspace-scoped key.
- Google AI Studio — create an API key; note that referrer-based restrictions don't apply through this app's proxy.
- Mistral — workspace key with a budget limit.
If you suspect compromise: revoke immediately at the provider console linked above.
Most privacy-preserving option. Self-host gets you the same UI without any third party in the loop.
git clone https://github.com/Hayawan/breakingchanges.git
cd breakingchanges
pnpm install
pnpm dev
# open http://localhost:3000You can either paste keys into the in-app settings drawer (same UX as the hosted version), or set them in .env.local for headless operation:
OPENAI_API_KEY=sk-… # used as a fallback for the OpenAI provider
ALLOW_SERVER_KEY_FALLBACK=true # required for the env-var path to take effect
NEXT_PUBLIC_BYOK_ENABLED=false # optional: hide the BYOK UI entirely (env-only mode)Next.js 15 (App Router), React 19, Mantine 7, TanStack Query, Vercel AI SDK with adapters for OpenAI, Anthropic, Google, and Mistral. TypeScript throughout.
The hosted web app is the easy on-ramp, but the long-term home for this tool is a CLI that local coding agents (Claude Code, Cursor's agent, Aider, etc.) can call directly. The agent feeds in two versions of a dependency, gets back a structured upgrade plan, and acts on it without a human ever leaving the terminal. Tracking issue: #1 — open an issue or reach out via @Hayawan if this is something you'd use.
Open an issue on GitHub, or reach out via @Hayawan.
Breaking Changes is a free service offered as-is. You bring your own key, you're responsible for the charges your provider bills you, and you assume the usual risks of pasting a credential into a third-party browser app — minimized but not eliminated by the BYOK design above. We don't store your keys, prompts, or completions, and we don't run analytics on your usage. If anything below the surface ever changes, this README will say so. For anything else, open an issue.
MIT.