GitCraft

Craft production-ready releases directly from your Git history.

GitCraft analyzes your commits, determines the correct SemVer bump, applies tags, generates changelogs, and publishes release metadata — all with zero configuration to start.

Features

• Correct SemVer — Detects breaking changes (feat!, BREAKING CHANGE:) and bumps major, minor, or patch accordingly
• Release Channels — Auto-maps branches to channels, or override manually
• Changelog Generation — Generates and prepends to CHANGELOG.md, grouped by commit type
• Monorepo Support — Independent versioning per package using path filtering
• Plugin System — Extend with changelog, AI summaries, Slack notifications, and more
• Azure DevOps — First-class pipeline task with output variables
• Dry Run Mode — Preview exactly what will happen before committing anything

Installation

npm install -g @gitcraft/cli

Usage

# Preview the next release
gitcraft release --dry-run

# Run a release on the current branch
gitcraft release

# Override the release channel
gitcraft release --channel alpha

# Scope to a subdirectory (monorepo)
gitcraft release --path packages/api

Configuration

Create a gitcraft.config.js in your project root:

module.exports = {
  plugins: [
    'changelog',
    // 'ai-notes',
  ],
}

Writing a Plugin

import type { Plugin } from '@gitcraft/cli'

const myPlugin: Plugin = {
  name: 'my-plugin',
  async onResolved(ctx) {
    // Runs after version is computed, before any git actions
    console.log(`Next version: ${ctx.result.nextVersion}`)
  },
  async onSuccess(ctx) {
    // Runs after tag is pushed
    console.log(`Released ${ctx.result.tag}`)
  },
  async onFailure(err) {
    // Runs if the release fails
    console.error(err)
  },
}

module.exports = { plugins: [myPlugin] }

Azure Pipelines

- task: GitCraft@1
  inputs:
    releaseChannel: 'stable'
    tagPrefix: 'v'

Output Variables

| Variable | Description | | ----------------------- | ------------------------------------- | | GitCraft.Version | The new version number (e.g. 1.2.0) | | GitCraft.Tag | The full git tag (e.g. v1.2.0) | | GitCraft.BumpType | major, minor, or patch | | GitCraft.ReleaseNotes | Changelog entry for this release |

GitHub Actions

- uses: actions/setup-node@v4
  with:
    node-version: '24'

- name: Release
  run: npx @gitcraft/cli release --channel stable

License

MIT