🔧
Build Tool2M+/wkMIT

@changesets/cli

Changesets is a tool for managing versioning and changelogs in multi-package repositories, focusing on the workflow of documenting changes incrementally as they

Installation

npm
npm install -D @changesets/cli
yarn
yarn add -D @changesets/cli
pnpm
pnpm add -D @changesets/cli

Import

ESM
// Used as CLI: npx changeset

Quick Example

usage
// Create a changeset:
// npx changeset
// → Select changed packages
// → Choose bump type (major/minor/patch)
// → Write summary

// Apply changesets and publish:
// npx changeset version
// npx changeset publish

About @changesets/cli

Changesets is a tool for managing versioning and changelogs in multi-package repositories, focusing on the workflow of documenting changes incrementally as they are made rather than all at once before release. When a developer makes a change, they run the changeset command to create a markdown file describing the change and specifying which packages are affected and the semver bump type (major, minor, patch). These changeset files are committed alongside the code changes and accumulate between releases. At release time, the changesets version command consumes all pending changesets, determines the appropriate version bumps for each affected package (including bumping dependents), updates package.json versions, and generates or updates CHANGELOG.md files. The changesets publish command then publishes the updated packages to npm. Changesets integrates with CI through a GitHub bot/action that creates a pull request summarizing all pending changesets and performing the version bumps automatically. This workflow is particularly valuable for open-source projects and organizations where multiple contributors make changes that need to be documented and released coherently.

Quick Facts

Package@changesets/cli
CategoryBuild Tool
Weekly Downloads2M+
LicenseMIT
Installnpm install -D @changesets/cli

Related Packages

Browse npm Packages by Category

Explore our reference of 200 popular npm packages with install commands, examples, and quick-start guides.