name: gsd-whats-new description: See whats new in GSD since your installed version allowed-tools: Read, Bash
<objective> Display changes between installed version and latest available version.Shows version comparison, changelog entries for missed versions, and update instructions. </objective>
<process> <step name="get_installed_version"> Read installed version from manifest file:cat .github/get-shit-done/.gsd-install-manifest.json 2>/dev/null | grep -o '"version"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4
If manifest file missing:
## GSD What's New
**Installed version:** Unknown
Your installation doesn't include version tracking.
**To fix:** `npx get-shit-done-multi --copilot`
This will reinstall with version tracking enabled.
STOP here if no manifest file. </step>
<step name="fetch_remote_changelog"> Fetch latest CHANGELOG.md from GitHub:Use WebFetch tool with:
- URL:
https://raw.githubusercontent.com/shoootyou/get-shit-done-multi/main/CHANGELOG.md - Prompt: "Extract all version entries with their dates and changes. Return in Keep-a-Changelog format."
If fetch fails: Fall back to local changelog:
cat .github/get-shit-done/CHANGELOG.md 2>/dev/null
Note to user: "Couldn't check for updates (offline or GitHub unavailable). Showing local changelog." </step>
<step name="parse_versions"> From the remote (or local) changelog:- Extract latest version - First
## [X.Y.Z]line after## [Unreleased] - Compare with installed - From VERSION file
- Extract entries between - All version sections from latest down to (but not including) installed
Version comparison:
- If installed == latest: "You're on the latest version"
- If installed < latest: Show changes since installed version
- If installed > latest: "You're ahead of latest release (development version?)" </step>
If up to date:
## GSD What's New
**Installed:** 1.4.26
**Latest:** 1.4.26
You're on the latest version.
[View full changelog](https://github.com/shoootyou/get-shit-done-multi/blob/main/CHANGELOG.md)
If updates available:
## GSD What's New
**Installed:** 1.4.23
**Latest:** 1.4.26
---
### Changes since your version:
## [1.4.26] - 2026-01-20
### Added
- Feature X
- Feature Y
### Changed
- **BREAKING:** Changed Z behavior
## [1.4.25] - 2026-01-18
### Fixed
- Bug in feature A
---
[View full changelog](https://github.com/shoootyou/get-shit-done-multi/blob/main/CHANGELOG.md)
**To update:** `npx get-shit-done-multi --global`
Breaking changes: Surface prominently with BREAKING: prefix in the output. </step>
</process><success_criteria>
- Installed version read from .gsd-install-manifest.json
- Remote changelog fetched (or graceful fallback to local)
- Version comparison displayed clearly
- Changes since installed version shown (if any)
- Update instructions provided when behind </success_criteria>