Sign in
Start free trial
Sign in
Free GitHub Action · changelog

A CHANGELOG.md that updates itself every week

Only 29% of indie repos keep a changelog (we measured 800). Not because nobody cares: writing it is a chore that loses to shipping. This Action does the chore. Every Monday it reads last week's merged PRs, conventional commits and releases, and opens a PR that adds one tidy entry. You review, tweak, merge. Try the output on any public repo below, then add one workflow file.

Get the Action on GitHub →
TRY IT · NO ACCOUNT NEEDED

Paste any public repo. Get this week’s post in seconds.

We read the repo’s last full week of public commits, PRs and issues. Nothing is stored, and there’s nothing to sign up for.

or try
Your sample post appears here
Written in a no-hype voice, with real numbers from the repo.

What you get

The PR it opens adds this to CHANGELOG.md
## Week of Sep 26 – Oct 2, 2026

Released: v1.4.0

### Added
- CSV export
- Team invites

### Fixed
- Empty payloads in the API

### Improved
- Faster dashboard queries

Set it up in one file

Add this workflow, then run it once from the Actions tab to see your first entry. No account and no API key.

.github/workflows/changelog.yml
name: Weekly changelog
on:
  schedule: [{ cron: "17 6 * * 1" }] # Mondays 06:17 UTC
  workflow_dispatch:
permissions:
  contents: write
  pull-requests: write
jobs:
  changelog:
    runs-on: ubuntu-latest
    steps:
      - uses: ship-and-shout/weekly-changelog@v1

What goes into each entry

  • Conventional commits on your default branch: feat → Added, fix → Fixed, perf → Improved.
  • Merged PR titles when commits aren't conventional. Dependency bumps, reverts and merge commits are skipped.
  • Stable releases published that week (drafts and pre-releases are left out).
  • The last complete week, Saturday to Friday (UTC). Quiet weeks are skipped, so there are no empty entries.
  • Your words, not ours: titles come straight from your commits and PRs. Nothing is rewritten or invented.

Safe by default

  • It opens a PR you review. Direct commits are opt-in (mode: commit).
  • Running it twice for the same week does nothing.
  • New entries go above old ones and your existing format is left alone.
  • It only talks to the GitHub API with your workflow's own token. Nothing is sent to us: no telemetry, no analytics.

Questions

Does it work on private repositories?

Yes. It runs inside your own GitHub Actions with your repo's token, so private repos work the same as public ones.

Why didn't CI run on the changelog PR?

GitHub doesn't trigger workflows from PRs opened with the default job token. If you need CI on them, pass a fine-grained token with Contents and Pull requests write access as the action's token input.

Can I backfill older weeks?

Yes. Run it by hand with the week input set to any date inside the week you want, for example 2026-09-30.

Is it really free?

Yes, MIT-licensed and it runs on GitHub's free runners. The PR description links to Ship & Shout, which turns the same week into a post for X, LinkedIn and Bluesky. That link is the only thing in it for us.

More free tools

Get this every week, without pasting anything

Connect GitHub (read-only) and Ship & Shout drafts your week on the day you pick, with a revenue chart if you add Stripe or Lemon Squeezy. Nothing posts until you approve it.