This release refines the workflow and exports, introduces numeric entry prefixes and emoji-styled types, and improves table layout and PR metadata.
💥 Breaking Changes
Section titled “💥 Breaking Changes”Streamline entry browsing and setup
Section titled “Streamline entry browsing and setup”Oct 24, 2025 · @codex
Promotes tenzir-changelog show as the single entry point for browsing changelog
entries. The command defaults to the table view and adds quick transforms—show -c
for cards, show -m for Markdown, and show -j for JSON—so reviewers can pivot
between presentations without juggling subcommands. Markdown and JSON exports now
accept row numbers, entry IDs, release versions, unreleased, or - to gather a
curated bundle, and they respect --compact/--no-compact overrides on top of the
configured default.
Release creation also shortens to tenzir-changelog release <version> --yes, and
the old --release flag has been removed in favor of passing the version (or any
other identifier) directly to show. Retires tenzir-changelog bootstrap in
favor of an automatic setup path: the first tenzir-changelog add now creates
config.yaml, prepares the required directories, and infers the project
identifier so new repositories can capture entries immediately.
This is a breaking change for automation and documentation that previously relied
on tenzir-changelog bootstrap or the separate get/export commands; update any
scripts to call show and release with the new options. Running
tenzir-changelog without arguments now opens the consolidated show view by
default.
Assign numeric prefixes to changelog entries
Section titled “Assign numeric prefixes to changelog entries”Oct 23, 2025 · @codex
Entry filenames now carry zero-padded numeric prefixes so they sort chronologically without relying on file metadata.
Existing unreleased files and archived release entries were renumbered to match the new scheme, updating manifest references as needed.
New entries start at 01 for each unreleased queue and expand past two digits automatically once you exceed 99 items, so identifiers stay compact without manual cleanup.
Release manifests now treat the entries/ directory as the single source of truth, so the redundant entries: lists were removed and the version is implied by the directory name.
🚀 Features
Section titled “🚀 Features”Highlight entry types with emoji styling
Section titled “Highlight entry types with emoji styling”Oct 23, 2025 · @codex
Adds a dedicated 💥 Breaking changes section ahead of other categories,
switches feature highlights to 🚀, and keeps those emoji prefixed headings in
Markdown and JSON exports unless you toggle them off with --no-emoji.
Configure export style defaults
Section titled “Configure export style defaults”Allow setting the preferred release and export layout in config so compact notes no longer need explicit flags.
Declare the preferred layout once in your project’s config.yaml. Choose between
standard (the default sectioned notes) and compact (bullet lists with excerpts):
export_style: compactThen run:
tenzir-changelog --root changelog release vX.Y.Z --yesThe compact notes render automatically without passing the --compact flag. The
same default applies when exporting release notes:
tenzir-changelog --root changelog show -m vX.Y.Z🔧 Changes
Section titled “🔧 Changes”Refine release workflow
Section titled “Refine release workflow”Oct 24, 2025 · @codex
Split the release command into dedicated release create, release notes, and release publish subcommands. Release creation now insists on --yes before mutating state, appends unreleased entries to an existing tag, keeps the manifest lean, remembers the chosen layout, and surfaces a dry-run summary. New --patch, --minor, and --major flags bump from the latest tagged release (respecting prefixes), while release notes re-exports any release (including -) and release publish pushes to GitHub via gh.
Simplify PR metadata
Section titled “Simplify PR metadata”Oct 24, 2025 · @codex
Removes the legacy pr field from changelog exports and relies solely on the prs list.
Refine compact Markdown exports
Section titled “Refine compact Markdown exports”Oct 23, 2025 · @codex
Compact Markdown exports now reuse the entry excerpt as the bullet text instead
of repeating the title, keep author and PR bylines inline with GitHub handles
prefixed by @, and end bullets with concise (By … in #123) annotations.
Polish the table view layout
Section titled “Polish the table view layout”Oct 22, 2025 · @codex
The default tenzir-changelog show table now adapts column widths to the active terminal,
right-aligns row numbers, centers the version column, and inserts release separators so
multi-digit identifiers stay readable even when the screen gets narrow.