# Release Please

generate release PRs based on the conventionalcommits.org spec

Repository: https://github.com/googleapis/release-please
Canonical: https://ross.abutalabs.com/products/release-please
Homepage: https://www.conventionalcommits.org
Language: TypeScript
License: Apache-2.0
License Family: permissive
Last push: 2026-08-24T21:20:29+00:00
Link (homepage): https://www.conventionalcommits.org

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 2687, "days_push": 9, "days_rel": 9, "gap_med": 7, "n_releases_24m": 38}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7401, forks 582 (observed 2026-08-28T04:09:59.675456+00:00)

## What it is
Release Please is a tool by Google that automates changelog generation, GitHub releases, and version bumps by parsing Conventional Commit messages from git history and maintaining release PRs. It is available as a CLI and a GitHub Action.

## Use cases
- automate changelog generation from commit messages
- create GitHub releases automatically
- bump package. versions via release PRs
- enforce conventional commits for semantic versioning
- set up release automation as a GitHub Action

## When to choose
- your project follows conventionalcommits.org conventions
- you want automated CHANGELOG.md and version bump PRs
- you release from a linear git history with squash merges

## When to avoid
- you need automatic publication to package managers
- you need complex multi-branch release management
- your commits don't follow conventional commit format

## Facets
- artifact type: cli-tool
- maturity: active
- function: ci-cd, version-control, developer-tools, workflow-automation
- domain: developer-tools, version-control
- platform: cli
- tags: conventional-commits, changelog, release-automation, github-action, semver, automation, devops, nodejs, github

## Member repositories
- googleapis/release-please (main) score 99
- googleapis/release-please-action (plugin) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:59.675456+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:38:02.767966+00:00, confidence not recorded.
  - readme: https://github.com/googleapis/release-please (fetched 2026-08-28T04:09:59.675456+00:00, sha 2beadbb1ede1)
  - homepage: https://www.conventionalcommits.org (fetched 2026-08-29T08:33:49.515075+00:00, sha 503eca3845b7)
- Data as of 2026-08-30T08:39:29.467469+00:00.