WP Changelog Digest
AI reads WordPress plugin and theme changelogs before you update. Get plain-English summaries with safety ratings: safe, caution, or breaking.
by Bilal Mahmood · github.com/sahibbilal/wp-changelog-digest · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/sahibbilal/wp-changelog-digest/archive/refs/heads/master.zipReadme
WP Changelog Digest
AI reads plugin and theme changelogs before you update. Know what changed, what broke, and whether it's safe — in plain English.
WP Changelog Digest fetches the changelog for every pending plugin and theme update from WordPress.org, then asks Claude AI to summarize it in plain English with a safety rating: safe to update, test first, or breaking changes detected.
What It Does
- Changelog Digest dashboard — lists all pending plugin and theme updates with version pills (old → new)
- ✨ Read Changelog per update — fetches the changelog from WordPress.org and asks Claude to summarize it
- Safety rating — one of three: ✅ Safe to update / ⚠️ Test before updating / 🔴 Breaking changes
- Plain-English summary — what actually changed, written for a site owner, not a developer
- Highlights list — key new features and improvements
- Breaking changes list — anything that could break the site
- ✨ Digest All Updates — processes every pending update sequentially with a live progress bar
- 3-day result cache — summaries are cached so you don't pay for the same changelog twice
- Banner on native Updates screen — one-click link to the Digest dashboard when updates are pending
Safety Ratings
| Rating | Meaning |
|---|---|
| ✅ Safe | Bug fixes and minor improvements — update freely |
| ⚠️ Caution | Major version, database changes, or API changes — test on staging first |
| 🔴 Breaking | Explicitly breaking changes, removed features, or manual migration required |
File Structure
wp-changelog-digest/
├── wp-changelog-digest.php # Bootstrap
├── includes/
│ ├── class-fetcher.php # WordPress.org API — fetch plugin/theme changelogs + update lists
│ ├── class-summarizer.php # Claude API — summarize changelog, return safety rating
│ └── class-admin.php # Dashboard UI, settings, AJAX handlers, Updates screen banner
├── assets/
│ ├── admin.css
│ └── admin.js
└── README.md
Installation
- Upload
wp-changelog-digestto/wp-content/plugins/ - Activate
- Go to Changelog Digest → Settings and add your Claude API key
- Go to Changelog Digest to see all pending updates with digest buttons
API Cost
- Model:
claude-haiku-4-5 - ~$0.002 per changelog summarized
- Results cached for 3 days — same update won't be charged twice
- A site with 20 updates/month ≈ $0.04
Part of the 30-Day WordPress AI Plugin Series
Day 8 of building one open-source WordPress + AI plugin every day.
Follow along: bilalmahmood.dev
License
GPLv2 or later