oh-my-changeloggy

Generate changelogs from git conventional commits.

Install

# With Bun (recommended)
bun install -g oh-my-changeloggy

# With npm
npm install -g oh-my-changeloggy

Usage

# Interactive
changeloggy

# CLI
changeloggy --since last-tag --release v1.0.0 -o CHANGELOG.md

# Prepend to existing
changeloggy --since v1.1.0 --release v1.2.0 -o CHANGELOG.md --prepend

# Include internal commits
changeloggy --since last-tag --include-internal

# JSON output
changeloggy --since last-tag --format json

# Dry run with stats
changeloggy --since last-tag --dry-run

# Auto-detect version bump
changeloggy --since last-tag --dry-run --auto-version

# Filter by scope
changeloggy --since last-tag --scope api,auth

Output

Markdown:

# Changelog

## v1.2.0 (2026-02-12)

### ✨ New Features

- **cli**: add --prepend flag for updating existing changelogs
- **core**: add support for conventional commit scopes

### 🐛 Bug Fixes

- add back registry-url for OIDC Trusted Publishing

### ♻️ Refactoring

- modularize source code into testable components

JSON:

{
  "feat": [
    {
      "hash": "fa4e029",
      "subject": "add --prepend flag for updating existing changelogs",
      "scope": "cli",
      "author": "Lukasdias",
      "date": "2026-02-10"
    }
  ],
  "fix": [...]
}

Commit Types

feat, fix, refactor, perf, security, deps, docs, config, style, test, chore, ci, build, revert

Internal types (chore, ci, style, test, build, deps, config) filtered by default.

Breaking changes are extracted from commit bodies (BREAKING CHANGE: description) and placed in a dedicated section.

Config File

Create .changeloggy.json in your project root:

{
  "output": "CHANGELOG.md",
  "format": "markdown",
  "includeInternal": false,
  "scopes": ["api", "ui"]
}

Development

bun install
bun run dev        # Run in development
bun run typecheck  # Type checking
bun run build      # Build to dist/
bun run test       # Run tests

Release

bun run release patch   # 1.2.4 -> 1.2.5
bun run release minor   # 1.2.4 -> 1.3.0
bun run release major   # 1.2.4 -> 2.0.0

MIT