English Français العربية

changelogai

Registre officiel Outils de développement

Generate changelogs and suggest semver bumps from git history

Code source Site web Documentation

Que pouvez-vous faire avec changelogai ?

  • 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @ura-dev/changelogai
Claude Code 
claude mcp add changelogai -- node -y @ura-dev/changelogai@1.1.3 '<changelogai-mcp>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "changelogai": {
            "command": "node",
            "args": [
                "-y",
                "@ura-dev/changelogai@1.1.3",
                "<changelogai-mcp>"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. changelogai
  2. Install
  3. Quick Start
  4. Features
  5. Options
  6. MCP Server
  7. AI Mode
  8. License

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

FlagDescriptionDefault
--from <ref>Start ref (tag/commit)Latest tag
--to <ref>End refHEAD
--output <file>Write to filestdout
--format <fmt>markdown, json, plainmarkdown
--groupGroup by commit typefalse
--aiAI-enhanced descriptionsfalse
--model <model>Claude model for AI modeclaude-haiku-4-5-20251001
--prependPrepend to existing filefalse
--version-bumpSuggest semver bumpfalse
--repo <path>Git repo path.
--max-commits <n>Max commits to process500

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
ToolDescription
changelogai_generateGenerate a changelog from git history. Returns markdown, JSON, or plain text.
changelogai_version_bumpAnalyze 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

Questions fréquentes

Qu'est-ce que changelogai ?

Generate changelogs and suggest semver bumps from git history

Comment installer changelogai ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add changelogai -- node -y @ura-dev/changelogai@1.1.3 '<changelogai-mcp>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour changelogai ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

changelogai est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient changelogai ?

Il est publié par ura-tools. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.