@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 install -D @changesets/cli
yarn add -D @changesets/cli
pnpm add -D @changesets/cli
Import
// Used as CLI: npx changeset
Quick Example
// 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 |
| Category | Build Tool |
| Weekly Downloads | 2M+ |
| License | MIT |
| Install | npm install -D @changesets/cli |
Related Packages
Lerna is the original JavaScript monorepo management tool, providing utilities for managing multi-pa…
Turborepo is a high-performance build system for JavaScript and TypeScript monorepos that provides i…
Nx is a powerful build system with first-class monorepo support and powerful integrations that provi…
TypeScript is a strongly typed programming language that builds on JavaScript, adding static type de…
Browse npm Packages by Category
Explore our reference of 200 popular npm packages with install commands, examples, and quick-start guides.