whats-new

What's New

Help Mode

If the argument is ? or --help, print this block and STOP — do not execute any steps:

Cross-reference Claude Code release notes against your personal config,
then verify each impact item with concrete tool calls before reporting.
Surfaces what changed that actually requires action, recommends new
features worth adopting, and summarizes the rest.

Usage: /whats-new [version]

Arguments:
  (none)          Analyze all releases since last reviewed
  <version>       Analyze a specific version only (e.g., 2.1.83)
                  Does not update the last-reviewed tracking.

Examples:
  /whats-new                  Full analysis since last review
  /whats-new 2.1.83           Analyze a specific version
  /whats-new ?                Show this help

Each IMPACT item is verified with grep / read / file-check before being
reported as actionable. Items that the verification proves don't affect
your config are demoted to GENERAL — no false alarms.

In since-last-review mode, after the report it independently reviews each
derived config edit, then proposes the vetted changes as a numbered list
(each with a plain-language explanation and the review's verdict); reply
with the numbers to apply, "all", or "none". Applied changes are logged to
~/.claude/whats-new-applied.md.

---

Step 1 — Parse Arguments

Read $ARGUMENTS:

• If empty: set mode = since-last-review
• If the value matches a semver pattern like 2.1.83 (digits, dot, digits, dot, digits): set mode = specific-version, set target_version = that value
• If ? or --help: already handled by Help Mode above — stop here

Step 2 — Get Current Version

Use Bash tool to run:

claude --version | grep -oE '[0-9]+\.[0-9]+\.[0-9]+'

Store the result as current_version.

Step 3 — Determine Version Range

If mode = since-last-review:

1. Use the Read tool to read ~/.claude/whats-new-last-version.txt
2. If the file exists and has content: set from_version = file contents (trimmed of whitespace)
3. If the file is missing or empty: skip to Step 4 to fetch the releases list first, then:
   • Find current_version in the newest-first release list
   • Set from_version = the version 5 positions further into the list (i.e., releases[current_idx + 5])
   • If current_version is not in the list, use the most recent published release as from_version