pi-changelog

Zero-config changelog generator for pi.dev projects from conventional commits.

Installation

pi install npm:pi-changelog

What It Does

Parses your git history for Conventional Commits and generates a clean, grouped markdown changelog. No configuration needed — just point it at your repo.

• Parses conventional commit format (feat:, fix:, chore:, etc.)
• Groups changes by type with clear section headers
• Highlights breaking changes (feat!: or fix!:)
• Auto-detects version from latest git tag
• Links commit hashes to GitHub/GitLab URLs

Tools

generate_changelog

Generate a markdown changelog from git history.

Parameters:

• from_ref (string, optional) — Git ref to start from (tag, commit, branch). Defaults to latest tag.
• to_ref (string, optional) — Git ref to end at. Defaults to HEAD.
• version (string, optional) — Version label for the changelog header. Auto-detected from latest tag.

Example:

Use the generate_changelog tool with no parameters to generate from the latest tag to HEAD

Commands

/changelog

Generate and display a changelog from git conventional commits. Runs with sensible defaults (latest tag → HEAD).

Supported Commit Types

| Type | Section | |------|---------| | feat | Features | | fix | Bug Fixes | | perf | Performance Improvements | | refactor | Code Refactoring | | docs | Documentation | | style | Styles | | test | Tests | | ci | CI/CD | | build | Build System | | chore | Miscellaneous | | revert | Reverts |

Example Output

# Changelog

## [v1.0.0] - 2026-06-25

### ⚠ BREAKING CHANGES

- **config:** redesign config format (abc1234)

### Features

- add user authentication (def5678)
- **api:** new REST endpoint (ghi9012)

### Bug Fixes

- resolve memory leak (jkl3456)

Resources

• npm
• GitHub
• pi.dev

License

MIT