changelogai

changelogai

git の履歴からプロフェッショナルな変更履歴を瞬時に生成します。

Conventional Commits であれば、そのまま使えます。オプションの AI モードでは、Claude を使って技術的なコミットメッセージをユーザー向けのリリースノートに書き換えます。

インストール

npm install -g @ura-dev/changelogai

クイックスタート

# 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

機能

• 設定不要 — 最新のタグを自動検出し、Conventional Commits を解析します
• スマートなグループ化 — コミットを機能、バグ修正、パフォーマンスなどに分類します
• AI モード — Claude を使って、コミットメッセージをわかりやすいユーザー向けの説明に書き換えます
• 複数の形式 — Markdown、JSON、プレーンテキスト
• バージョン更新の提案 — 変更を分析し、major／minor／patch を提案します
• 先頭追加モード — 既存の CHANGELOG.md の先頭に新しいリリースを追加します
• 依存関係なし — 純粋な Node.js で、どこでも動作します

オプション

フラグ	説明	デフォルト
--from <ref>	開始 ref（タグ／コミット）	最新のタグ
--to <ref>	終了 ref	HEAD
--output <file>	ファイルに書き込みます	stdout
--format <fmt>	markdown、json、plain	markdown
--group	コミットの種類ごとにグループ化します	false
--ai	AI で説明を強化します	false
--model <model>	AI モードで使用する Claude モデル	claude-haiku-4-5-20251001
--prepend	既存ファイルの先頭に追加します	false
--version-bump	semver の更新を提案します	false
--repo <path>	Git リポジトリのパス	.
--max-commits <n>	処理するコミットの最大数	500

MCP サーバー

changelogai には、AI エージェントや IDE との連携（Claude Desktop、Cursor、VS Code など）向けの Model Context Protocol サーバーが含まれています。

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

グローバルにインストールした場合は、次のようにします。

{
  "mcpServers": {
    "changelogai": {
      "command": "changelogai-mcp"
    }
  }
}

利用可能なツール

ツール	説明
changelogai_generate	git の履歴から変更履歴を生成します。Markdown、JSON、プレーンテキストで返します。
changelogai_version_bump	git のコミットを分析し、次の semver 更新（major／minor／patch）を提案します。

AI モード

Anthropic API キーを設定します。

export ANTHROPIC_API_KEY=sk-ant-...

次に、--ai を付けて実行します。

changelogai --ai --group --output CHANGELOG.md

AI モードでは、技術的なコミットメッセージをわかりやすいユーザー向けのリリースノートに書き換えます。デフォルトでは Claude Haiku を使用します（高速かつ低コストで、変更履歴 1 件あたり約 $0.001）。

ライセンス

MIT