English Français العربية

changelogai

السجل الرسمي أدوات المطورين

Generate changelogs and suggest semver bumps from git history

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو changelogai؟

Generate changelogs and suggest semver bumps from git history

كيف أثبّت changelogai؟

يعمل على جهازك. في Claude Code: claude mcp add changelogai -- node -y @ura-dev/changelogai@1.1.3 '<changelogai-mcp>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج changelogai إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل changelogai مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون changelogai؟

ينشره ura-tools. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.