Skip to content

lf whats-new

Print the most recent release entries from the repo's Product Changelog source (docs/en/changelog.md). Each entry is the body of a top-level ## [version] - date heading. The command walks upward from the CLI binary to find that file, falling back to the current working directory and finally to the hosted changelog URL. Version sections only exist once a maintainer has cut a release with pnpm changelog:cut — see Product Changelog vs. Main Branch Activity.

bash
lf whats-new            # latest release
lf whats-new --n 3      # last 3 releases
lf whats-new --json     # structured output

Flags

FlagDefaultDescription
--n <N>1Number of recent releases to show. Floored to at least 1.
--jsonfalseEmit [{ version, date, body }] as JSON instead of formatted text.

Behavior

  1. Resolve docs/en/changelog.md — relative to the CLI binary, or process.cwd().
  2. Parse releases by walking ## [version] - YYYY-MM-DD headings.
  3. Print body, truncating per-release at 40 lines with a "… (truncated)" marker.
  4. Always print the hosted changelog link at the end.

If the file cannot be located, or no version has been cut yet, the command prints only the hosted link and exits 0.


Examples

bash
# Day-to-day: what shipped most recently?
lf whats-new

# Scripted: programmatic access to the latest 5 releases
lf whats-new --n 5 --json | jq '.[].version'