Changelog

Manage changelogs and release notes with tenzir-changelog. Provides interactive commands for adding entries, orchestrating releases, and automating changelog workflows through CI.

Features

• 🎯 Managing Entries Skill: Get guided assistance when creating changelog entries. Activates automatically when finishing features, bugfixes, or documenting changes.
• ➕ Add Command: Interactive entry creation with /changelog:add
• 🚀 Release Command: Orchestrate releases with /changelog:release. Stages, reviews, and publishes in one workflow.
• 🤖 Adder Agent: Automate changelog entry creation from PR comments in CI
• 📦 Releaser Agent: Automate release workflows in CI with a specified version bump

Installation

Interactive

Use the plugin manager UI in Claude Code.

1. Run /plugin in Claude Code Enter
2. Go to Marketplaces Tab
3. Select + Add Marketplace Enter
4. Type tenzir/claude-plugins Enter
5. Install changelog from the plugin list

Shell

Run the CLI command with your preferred scope.

# Install to user scope (default)
claude plugin install changelog@tenzir

# Install to project scope (shared with team)
claude plugin install changelog@tenzir --scope project

# Install to local scope (gitignored)
claude plugin install changelog@tenzir --scope local

Settings

Add the marketplace and plugin to your settings file.

.claude/settings.json

{
  "extraKnownMarketplaces": {
    "tenzir": {
      "source": {
        "source": "github",
        "repo": "tenzir/claude-plugins"
      }
    }
  },
  "enabledPlugins": {
    "changelog@tenzir": true
  }
}

Capabilities

Type	Name	Description
Skill	managing-entries	Create and manage changelog entries. Use when adding changelog entries, finishing features or bugfixes, documenting changes, writing release notes, working in changelog/ directories, wrapping up commits and PRs, or cutting a release.
Command	/changelog:add	Add a changelog entry for recent changes (feature, bugfix, breaking, change).
Command	/changelog:release	Guide through releasing a project with tenzir-changelog (detect, stage, review, commit, publish, verify).
Agent	changelog:adder	Create a changelog entry for PR changes. Use for non-interactive CI automation.
Agent	changelog:releaser	Release a project using tenzir-changelog. Use when the user wants to cut/create a release, publish a new version, or bump the version number.

Usage

Adding Entries

After completing work, run /changelog:add:

/changelog:add

Claude analyzes your uncommitted changes and recent commits, then:

1. Suggests an entry type (feature, bugfix, breaking, or change)
2. Proposes a user-facing title
3. Drafts a description explaining what changed and why
4. Creates the entry file in changelog/unreleased/

For module-based projects, Claude targets the correct module’s changelog automatically.

Changelog

View the release history and recent changes.

View on GitHub

Browse the plugin source code and documentation.