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

Terminal

npm install -g @ura-dev/changelogai

Quick Start

bash

# 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.).

config.json

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

Or if installed globally:

config.json

{
  "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:

server.ts

export ANTHROPIC_API_KEY=sk-ant-...

Then run with --ai:

bash

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