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

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

Flag	Description	Default
--from <ref>	Start ref (tag/commit)	Latest tag
--to <ref>	End ref	HEAD
--output <file>	Write to file	stdout
--format <fmt>	markdown, json, plain	markdown
--group	Group by commit type	false
--ai	AI-enhanced descriptions	false
--model <model>	Claude model for AI mode	claude-haiku-4-5-20251001
--prepend	Prepend to existing file	false
--version-bump	Suggest semver bump	false
--repo <path>	Git repo path	.
--max-commits <n>	Max commits to process	500

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

Tool	Description
changelogai_generate	Generate a changelog from git history. Returns markdown, JSON, or plain text.
changelogai_version_bump	Analyze git commits and suggest next semver bump (major/minor/patch).

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