nyaomaru/Changelog Bot Runner Nyaomaru

Auto-update CHANGELOG.md from git history and release notes, optionally using an LLM. Creates a PR with the changes.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jul 11, 2026
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: nyaomaru/changelog-bot@6af81a9665def4c947cf54854af4dac0a47dd57f # v0.6.5

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
changelog-pathPath to CHANGELOG fileno
config-pathPath to changelog-bot JSON config fileno
base-branchBase branch for the PRno
providerLLM provider to use (openai|anthropic|gemini)no
release-tagGit ref (tag or HEAD) to generate changelog forno
release-nameDisplay name for the version (without 'v')no
release-bodyAdditional release notes body to merge inno
languageLanguage for generated changelog proseno
instructionsAdditional changelog writing and grouping instructionsno
instructions-filePath to a file with additional changelog instructionsno
npm-versionnpm dist-tag or version range for @nyaomaru/changelog-botnolatest
minimum-package-age-daysMinimum age in days required for the npm package version resolved from npm-versionno0
dry-runIf 'true', print updated changelog without writing or PRno
dry-run-json-reportIf 'true', print dry-run provider diagnostics as JSONno
fail-on-llm-errorIf 'true', fail instead of falling back when provider calls failno
require-providerIf 'true', fail when the selected provider API key is missingno
no-aiIf 'true', skip all provider calls and use deterministic outputno
whyIf 'true', extract short WHY notes from PR descriptionsno
why-max-prsMaximum number of PRs to inspect for WHY extractionno
why-max-chars-per-prMaximum preprocessed candidate characters sent per PR for WHY extractionno
why-confidenceMinimum provider confidence for WHY notes (low|medium|high)no
why-labelLabel used for rendered WHY notesno

no outputs