lacspace-changelog
Conventional Commits → CHANGELOG + semver bump.
npx lacspace-changelogEverything, in one command
lacspace-changelog reads the commits since your last version tag, parses them as Conventional Commits, and decides the next semver bump (breaking→major, feat→minor, fix/perf→patch, with sensible 0.x handling). It renders a Keep-a-Changelog-style section with commit, PR and compare links derived from your repository field, and prepends it to CHANGELOG.md. Separate version and notes commands make it a clean building block for CI pipelines and GitHub releases, and opt-in --bump/--commit/--tag flags can cut a release locally (it never pushes). Zero runtime dependencies.
What's inside
Next-version from commits
breaking→major, feat→minor, fix/perf→patch, 0.x-aware.
Grouped, linked changelog
Features/Fixes/Perf/BREAKING with commit, PR and compare URLs.
CI-native
version and notes subcommands plus --json on everything, non-zero exit on failure.
Prereleases & overrides
--preid beta and --release-as major|minor|patch|<version>.
Safe release actions
Opt-in --bump/--commit/--tag, printed as a plan, never pushes.
Zero dependencies
Hand-written commit parser, semver engine and markdown renderer.
Injection-safe git
Every git call uses execFile with an arg array, never a shell string.
Contributors section
Aggregate unique authors + co-authors, de-duped and sorted, with --contributors.
Custom type config
A .changelogrc.json remaps types to sections and controls which bump the version / stay hidden.
Breaking-change highlighting
A dedicated BREAKING CHANGES block from both type!: and BREAKING CHANGE:, forcing a major.
Compare & issue links
GitHub/GitLab/Bitbucket compare URLs plus #123 and commit-SHA linkifying.
Duplicate-safe merge
Re-runs won't double-prepend a version already in CHANGELOG.md.
Git-range generate
generate --from v1.0.0 --to HEAD reads the log directly, no piping.
Copy, paste, done
Real commands and snippets — from a one-liner to the typed library.
npx lacspace-changelog previewRange, commit counts and the computed bump — writes nothing.
VER=$(npx lacspace-changelog version)Prints only the version, e.g. 1.3.0.
npx lacspace-changelog notes > NOTES.mdJust the new section, grouped and linked.
npx lacspace-changelogPrepends the new section below the header.
npx lacspace-changelog version --preid beta→ 1.3.0-beta.0, then beta.1…
npx lacspace-changelog --bump --commit --tagBumps package.json, commits, tags — never pushes.
npx lacspace-changelog notes --from v1.0.0 --contributorsRelease body with a Contributors list.
npx lacspace-changelog generate --from v1.2.0 --to HEADReads git log directly.
npx lacspace-changelog --config .changelogrc.jsontype→section/bump/hidden mapping honoured by grouping and bump.
What people build with it
✓ Automate release notes in CI
✓ Decide the next semver number before publishing to npm
✓ Generate a GitHub release body
✓ Maintain a Keep-a-Changelog file without a heavy toolchain
Run lacspace-changelog today
Free, open-source, no API keys. It's a CLI and a typed library.
npx lacspace-changelog