changelogai

Generate professional changelogs from your git history — instantly.

Works out of the box with conventional commits. Optional AI mode uses Claude to rewrite technical commit messages into user-facing release notes.

Install

npm install -g @ura-dev/changelogai

Related MCP server: pr-narrator-mcp

Quick Start

# Run without installing
npx @ura-dev/changelogai

# Generate changelog since last tag
changelogai

# Grouped by category
changelogai --group

# AI-enhanced (requires ANTHROPIC_API_KEY)
changelogai --ai --group

# Write to file
changelogai --group --output CHANGELOG.md

# Prepend new release to existing changelog
changelogai --group --output CHANGELOG.md --prepend

# JSON output for CI/CD
changelogai --format json

# Suggest semver bump
changelogai --version-bump

Features

• Zero config — auto-detects latest tag, parses conventional commits

• Smart grouping — categorizes commits into Features, Bug Fixes, Performance, etc.

• AI mode — rewrites commit messages into clear, user-facing descriptions using Claude

• Multiple formats — Markdown, JSON, plain text

• Version bump suggestion — analyzes changes and suggests major/minor/patch

• Prepend mode — add new releases to the top of existing CHANGELOG.md

• No dependencies — pure Node.js, works everywhere

Options

MCP Server

changelogai includes a Model Context Protocol server for AI agents and IDE integrations (Claude Desktop, Cursor, VS Code, etc.).

{
  "mcpServers": {
    "changelogai": {
      "command": "npx",
      "args": ["-y", "-p", "@ura-dev/changelogai", "changelogai-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "changelogai": {
      "command": "changelogai-mcp"
    }
  }
}

Available Tools

AI Mode

Set your Anthropic API key:

export ANTHROPIC_API_KEY=sk-ant-...

Then run with --ai:

changelogai --ai --group --output CHANGELOG.md

AI mode rewrites technical commit messages into clear, user-facing release notes. Uses Claude Haiku by default (fast and cheap — ~$0.001 per changelog).

License

MIT