changelogai

io.github.ura-toolsPublished by GitHub account ura-toolsv1.1.3Updated Oct 24, 2026

Generate changelogs and suggest semver bumps from git history

VerifiedSTDIODesktop onlyDeveloper ToolsAI & ML

Overview

AI-generated overview

Generates changelogs and suggests semver version bumps from a local git repository's commit history.

What you can do
Exposes two tools: changelogai_generate, which reads git history between refs and returns a changelog in markdown, JSON, or plain text, optionally grouped by conventional-commit type; and changelogai_version_bump, which analyzes commits and suggests a major, minor, or patch bump. An optional AI mode rewrites technical commit messages into user-facing release notes. Output can be written to a file or prepended to an existing CHANGELOG.md.
When to use it
Useful when preparing releases and you want an assistant to draft release notes or recommend a version bump from commit history. Fits projects that follow conventional commits and want changelog generation inside an IDE or agent workflow.
Requirements
Runs locally as a Node.js process, typically via npx with the @ura-dev/changelogai package; the manifest declares no authentication and no environment variables. It needs access to a local git repository. AI mode additionally requires an Anthropic API key set as ANTHROPIC_API_KEY.
Before you install
AI mode sends commit messages to Anthropic's Claude service and requires the ANTHROPIC_API_KEY secret; the README notes it is billed per changelog. Writing output with --output and --prepend modifies files such as CHANGELOG.md, so review changes before committing. The server reads git history from the repository path given.

Installation

In SourceWeft

  1. Open changelogai in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npm install -g @ura-dev/changelogai

Quick Start

bash
# Run without installingnpx @ura-dev/changelogai
# Generate changelog since last tagchangelogai
# Grouped by categorychangelogai --group
# AI-enhanced (requires ANTHROPIC_API_KEY)changelogai --ai --group
# Write to filechangelogai --group --output CHANGELOG.md
# Prepend new release to existing changelogchangelogai --group --output CHANGELOG.md --prepend
# JSON output for CI/CDchangelogai --format json
# Suggest semver bumpchangelogai --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.).

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

Or if installed globally:

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

bash
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

Source: README.md at commit 8c9e59c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts