{
  "markdown": "# changelogai\n\nGenerate professional changelogs from your git history — instantly.\n\nWorks out of the box with conventional commits. Optional AI mode uses Claude to rewrite technical commit messages into user-facing release notes.\n\n## Install\n\n```bash\nnpm install -g @ura-dev/changelogai\n```\n\n## Quick Start\n\n```bash\n# Run without installing\nnpx @ura-dev/changelogai\n\n# Generate changelog since last tag\nchangelogai\n\n# Grouped by category\nchangelogai --group\n\n# AI-enhanced (requires ANTHROPIC_API_KEY)\nchangelogai --ai --group\n\n# Write to file\nchangelogai --group --output CHANGELOG.md\n\n# Prepend new release to existing changelog\nchangelogai --group --output CHANGELOG.md --prepend\n\n# JSON output for CI/CD\nchangelogai --format json\n\n# Suggest semver bump\nchangelogai --version-bump\n```\n\n## Features\n\n- **Zero config** — auto-detects latest tag, parses conventional commits\n- **Smart grouping** — categorizes commits into Features, Bug Fixes, Performance, etc.\n- **AI mode** — rewrites commit messages into clear, user-facing descriptions using Claude\n- **Multiple formats** — Markdown, JSON, plain text\n- **Version bump suggestion** — analyzes changes and suggests major/minor/patch\n- **Prepend mode** — add new releases to the top of existing CHANGELOG.md\n- **No dependencies** — pure Node.js, works everywhere\n\n## Options\n\n| Flag | Description | Default |\n|---|---|---|\n| `--from <ref>` | Start ref (tag/commit) | Latest tag |\n| `--to <ref>` | End ref | HEAD |\n| `--output <file>` | Write to file | stdout |\n| `--format <fmt>` | markdown, json, plain | markdown |\n| `--group` | Group by commit type | false |\n| `--ai` | AI-enhanced descriptions | false |\n| `--model <model>` | Claude model for AI mode | claude-haiku-4-5-20251001 |\n| `--prepend` | Prepend to existing file | false |\n| `--version-bump` | Suggest semver bump | false |\n| `--repo <path>` | Git repo path | . |\n| `--max-commits <n>` | Max commits to process | 500 |\n\n## MCP Server\n\nchangelogai includes a Model Context Protocol server for AI agents and IDE integrations (Claude Desktop, Cursor, VS Code, etc.).\n\n```json\n{\n  \"mcpServers\": {\n    \"changelogai\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@ura-dev/changelogai\", \"changelogai-mcp\"]\n    }\n  }\n}\n```\n\nOr if installed globally:\n```json\n{\n  \"mcpServers\": {\n    \"changelogai\": {\n      \"command\": \"changelogai-mcp\"\n    }\n  }\n}\n```\n\n### Available Tools\n\n| Tool | Description |\n|---|---|\n| `changelogai_generate` | Generate a changelog from git history. Returns markdown, JSON, or plain text. |\n| `changelogai_version_bump` | Analyze git commits and suggest next semver bump (major/minor/patch). |\n\n## AI Mode\n\nSet your Anthropic API key:\n```bash\nexport ANTHROPIC_API_KEY=sk-ant-...\n```\n\nThen run with `--ai`:\n```bash\nchangelogai --ai --group --output CHANGELOG.md\n```\n\nAI mode rewrites technical commit messages into clear, user-facing release notes. Uses Claude Haiku by default (fast and cheap — ~$0.001 per changelog).\n\n## License\n\nMIT\n",
  "bytes": 2972,
  "sha": "b4a59df4a86b5cef7ca0b67aa0e0950cae06de4a51b7f4fc0e5191706f2a2c36",
  "repo_slug": "ura-tools/changelogai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ura_tools_changelogai_4dc179a9/readme"
}