# @changesets/get-release-plan

> Reads changesets and adds information on dependents that need bumping

Latest version **5.0.2** (published 2026-09-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install @changesets/get-release-plan
pnpm add @changesets/get-release-plan
yarn add @changesets/get-release-plan
bun add @changesets/get-release-plan
```

## Health

**Score 70/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 5.0.2 |
| Published | 2026-09-14 |
| First published | 2019-09-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | ^22.11 \|\| ^24 \|\| >=26 |
| Dependencies | 6 |
| Unpacked size | 4.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 12466 |
| Maintainers | emmatown, andarist |

## Links

- npm: https://www.npmjs.com/package/@changesets/get-release-plan
- Repository: https://github.com/changesets/changesets
- npm.io page: https://npm.io/package/@changesets/get-release-plan

## Dependencies (6)

- [@changesets/pre](https://npm.io/package/@changesets/pre.md) ^3.0.0
- [@changesets/read](https://npm.io/package/@changesets/read.md) ^1.0.1
- [@changesets/types](https://npm.io/package/@changesets/types.md) ^7.0.0
- [@changesets/config](https://npm.io/package/@changesets/config.md) ^4.0.1
- [@manypkg/get-packages](https://npm.io/package/@manypkg/get-packages.md) ^3.1.0
- [@changesets/assemble-release-plan](https://npm.io/package/@changesets/assemble-release-plan.md) ^7.0.0

## Recent versions

- 5.0.2 (latest) — 2026-09-14
- 5.0.0-next.11 (next) — 2026-08-10
- 0.0.0-pr1845.8583df5 (pr1845) — 2026-02-18
- 3.0.7-temp.0 (temp) — 2022-02-19
- 5.0.1 — 2026-09-04
- 5.0.0 — 2026-08-11
- 5.0.0-next.10 — 2026-08-03
- 5.0.0-next.9 — 2026-07-25
- 5.0.0-next.8 — 2026-07-17
- 5.0.0-next.7 — 2026-07-01
- 5.0.0-next.6 — 2026-06-24
- 5.0.0-next.5 — 2026-05-28
- 5.0.0-next.4 — 2026-05-13
- 5.0.0-next.3 — 2026-05-07
- 5.0.0-next.2 — 2026-05-04
- … 55 more at https://npm.io/package/@changesets/get-release-plan/versions

## README

# @changesets/get-release-plan

[![Open on npmx.dev](https://npmx.dev/api/registry/badge/version/@changesets/get-release-plan?name=true)](https://npmx.dev/package/@changesets/get-release-plan)
[![View changelog](https://npmx.dev/api/registry/badge/version/@changesets/cli?color=229fe4&value=View+changelog&label=+)](./CHANGELOG.md)

A function that reads information about the current repository

```js
import { getReleasePlan } from "@changesets/get-release-plan";

const releasePlan = await getReleasePlan(cwd, since, passedConfig);
```

## cwd: string

The directory to run `getReleasePlan` in - most often `process.cwd()`

## since: string

Sets whether to use all changesets present, or only those changesets that are new since the branch
diverged from another one.

## passedConfig?: Config

The changeset config options as defined in `@changesets/types`. This is optional, and can be used to overwrite any written config options.

---
_Source: https://npm.io/package/@changesets/get-release-plan · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._