Write a changelog from git commits
commits_to_changelogTurn git log output or commit messages into a Keep a Changelog 2.0.0 section (Added, Changed, Deprecated, Removed, Fixed, Security) with breaking changes flagged and their migration steps, plus plain-language release notes. Reads Conventional Commits (feat:, fix:, ! and BREAKING CHANGE: footers) and plain subjects; leaves out merges, release commits and chores; stops at the previous release's tag and suggests the next version. Deterministic, nothing stored. Run git log <last-tag>..HEAD --no-merges and pass its output as log.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "commits_to_changelog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| log | No | git log output in any format: full (best, keeps BREAKING CHANGE: footers), --oneline (with --decorate to show tags) or one subject per line. Use this or commits. | |
| date | No | Release date as YYYY-MM-DD. Default: the tagged commit's date, else today (UTC). | |
| output | No | What the text answer contains: "markdown" (the changelog section), "notes" (release notes) or "both" (default). | |
| commits | No | Commit messages, newest first; each is the subject, optionally followed by a blank line and the body. Use this or log. | |
| version | No | The version being released, e.g. "1.5.0". Leave out for an [Unreleased] section, or to use a tag on the newest commit. | |
| unsorted | No | Entries without a type of change (docs:, deps:): "omit" (default) or "changed" to list them under Changed. | |
| include_chores | No | Keep chore, ci, build, test and style commits (listed under Changed). Default false. | |
| repository_url | No | github.com or gitlab.com repository (or owner/repo for GitHub), for the version compare link and pull request links. | |
| previous_version | No | The last released version, when the log shows no tag: used for the compare link and the suggested next version. |