On this page
Manage structured JSONL changelog entries: add per-commit entries, validate them against schema and coverage, and generate CHANGELOG.md.
#rlsbl changelog
Structured changelog management using JSONL entries. Add and generate CHANGELOG.md from per-commit changelog entries stored in unreleased.jsonl for precise, auditable release notes.
#changelog add
Append a structured changelog entry to the project's unreleased.jsonl file. Each entry includes a human-readable description, an entry type (feature, fix, or breaking), and optional commit hashes linking it to specific changes. The file is auto-committed unless --no-commit is passed. Use --no-user-facing to mark internal changes that should not appear in the published changelog.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--commits | str | Comma-separated commit hashes | |||
--description | str | Entry description | |||
--type | str | Entry type (feature, fix, breaking) | |||
--no-user-facing | bool | Mark as non-user-facing | |||
--no-commit | bool | Skip auto-commit of unreleased.jsonl |
#changelog generate
Compile all validated JSONL changelog entries into a formatted CHANGELOG.md file. Groups entries by type (features, fixes, breaking changes) under the appropriate version heading, preserving existing changelog content for previous releases. Use --dry-run to preview the generated Markdown output without writing to disk, which is useful for reviewing before committing.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--no-commit | bool | Skip auto-commit of generated files |
#changelog amend
Append a changelog entry to a released version's JSONL file. Temporarily unlocks the read-only file, appends the entry, re-locks it, regenerates CHANGELOG.md, and syncs GitHub Release notes. Use --no-resolve to skip hash validation for old or amended commits.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--version | str | Released version to amend (e.g., 0.39.0) | |||
--commits | str | Comma-separated commit hashes | |||
--description | str | Entry description | |||
--type | str | Entry type (feature, fix, breaking) | |||
--no-user-facing | bool | Mark as non-user-facing | |||
--no-resolve | bool | Skip hash validation |