How patch-it notices, on its own, that something your code depends on changed. Each plugin watches one provider's own source (an API spec, a changelog, a shutdown notice, a release feed) and turns what changed into a change event, with the source linked and quoted.
Why: when anything your code depends on changes (APIs, packages, SDKs, runtimes, CI, AI models), patch-it finds the code that breaks and opens the pull request that fixes it. In your CI, on your key. You get the fix, not the alert. These plugins are the trigger: nobody has to assign an alert or open a ticket.
flowchart LR
A["Provider's own source<br/>spec · changelog · shutdown notice · feed"] -->|"read daily"| B["Plugin<br/>(this repo)"]
B -->|"what changed, quoted"| C["Change event<br/>breaking · deprecation · date · source"]
C --> D["patch-it in your CI<br/>finds the lines, an AI model writes the change"]
D --> E["Pull request in your repo<br/>your CI runs your tests, you merge it"]
-
It notices on its own. A plugin here sees the change where the provider announces it, and patch-it picks it up from there: no alert to triage, no ticket to assign. That includes changes that never bump a version, like an AI model or an API shut down on a date.
-
It writes the fix. An AI model (on your own key) reads the change and the lines it affects and writes the code change. It arrives as a pull request: your CI runs your tests on it, like any PR, and you review and merge it. The code change, not just the version.
-
Proof: 8 pull requests opened by the early version have been merged by outside maintainers.
-
What it covers:
Layer Noticed (a plugin here watches it) Fixed (patch-it writes the PR) APIs: Stripe, GitHub, GitLab, Datadog, Vercel, Supabase, Algolia, MongoDB Atlas, Cloudflare live live AI models: OpenAI and Anthropic model retirements live live AI models: Vertex AI model retirements live planned Packages and SDKs: NumPy, Textual, urllib3, the Anthropic Python SDK live in testing Runtimes: Redis live building CI: GitHub Actions runner retirements live planned As of 2026-11-19; every plugin is in docs/plugins.md.
-
Start: docs.patch-it.dev sets up the GitHub Action in your repo. To have it watch a provider it doesn't cover yet, add a plugin (below).
You need Go (the version in go.mod), make and Python 3. Pick the format that reads your provider's source (which one), then:
1. Scaffold it.
URL=https://acme.example/changelog.xml # your provider's source
go run ./cmd/new-plugin --api acme --provider Acme --format feed --source "$URL"Scaffolded acme (Acme, format feed):
docs/plugins.md
plugins/feed/acme.go (new)
plugins/feed/acme_test.go (new)
...
Next steps (every place to fill in says TODO(new-plugin): ...)
2. Save a real copy of the source and write the golden file. Fill in the TODO(new-plugin)s: the reader in plugins/feed/acme.go, the saved file's row in testdata/README.md, and "Why this source" in providers/acme.md.
curl -fsSL -o plugins/feed/testdata/acme.rss.xml "$URL"
go test ./plugins/feed -run TestAcme -update # writes testdata/golden/acme.json: read it like code3. Check it, the way CI will.
make plugins-json && make check...
make check: all passed
4. Open the pull request (git commit -s, one plugin per PR). Details: docs/writing-a-plugin.md. Stuck? Ask in Discussions. Looking for a first change? Good first issues.
- Fetch. The plugin asks its environment for the source (
env.Get); it never opens connections itself. Pages that change in place are also cited through a Web Archive snapshot, so the link in an event keeps showing what the plugin read. - Compare. It compares the source to the last version it saw (the baseline): two OpenAPI specs, two versions of a deprecations page, a new release's changelog section.
- Emit events. Each change becomes one event in patch-it's change-event format: what changed, how bad it is (breaking, deprecation, behavior change, non-breaking), the date it takes effect, and the source URL with a quote. No source, no event. When unsure, a plugin emits nothing: a wrong event would become a wrong pull request.
Most providers are an entry for a shared format plugin (openapi, retirements, migrationguide, removedmembers, changelog, feed, apichangelog, catalog), not new code. patch-it's hosted ingestion service runs every plugin daily and serves the events to the patch-it GitHub Action and CLI.
docs/plugins.md lists every plugin: provider, layer, what it watches, its source. The same list is on docs.patch-it.dev, and as JSON in docs/plugins.json (make plugins-json).
| Path | What's there |
|---|---|
plugin/ |
The Plugin interface, the registry (Register, Lookup, Names), Env, Result |
plugins/ |
The format plugins; plugins/all imports every one |
cmd/new-plugin/, cmd/list-plugins/ |
The starter for a new provider; the generator of docs/plugins.json |
kit/, kit/kittest/ |
What plugins share (the unchanged-page check, Wayback citing) and the test kit (in-memory store, saved pages, golden files) |
event/, migrate/ |
The change-event types of patch-it's contract, and the v1 → v2 conversion |
diff/, normalize/, hint/, adapter/ |
The OpenAPI diff engine: compare two specs, turn the changes into events, attach changelog hints; one adapter per spec provider |
retire/, sdkguide/, fetch/ |
The deprecations-page and migration-guide readers; the HTTP fetch and cache |
contract/fixtures/ |
A copy of patch-it's change-event fixtures |
providers/ |
One page per provider: why that source, what the plugin reads |
docs/ |
The plugin list, how to write a plugin, the README template patch-it's public repos share |
make check # what CI runs: tidy, build, gofmt, vet, import and net/http guards, go test -race, no TODO(new-plugin) left, leak guardThe tests are offline: every plugin's test reads a saved copy of its source from testdata/ and compares the events with a golden file. After an intended change to a plugin's output, go test ./plugins/<name> -update rewrites its golden files; review that diff like code.
GITHUB_TOKEN (optional, no scopes) only raises GitHub's rate limit when the openapi adapters look up release tags; the tests never use it. Nothing else is read from the environment.
Releases are v0.x.y tags on main with a GitHub release and generated notes. The Release workflow tags a patch release on its own every Monday and Thursday at 14:00 UTC when something new was merged, and maintainers can run it by hand (how). patch-it's hosted ingestion service runs the latest release, so a merged plugin is running within a few days. Tags are never moved or deleted.
go get github.com/patch-it-dev/patch-it-plugins@latestNew providers and fixes are welcome: CONTRIBUTING.md has the rules (DCO sign-off, golden tests, the plugin list), docs/writing-a-plugin.md the how-to. AI coding agents: AGENTS.md. Questions and ideas: Discussions.
Apache-2.0, copyright patch-it contributors.