| name | change-logger |
| description | Generate and maintain the root CHANGELOG.md in a beginner-friendly, analogy-rich format from git state or a commit range. |
Change Logger — quick diffs
Produce a dated, analogy-rich markdown entry in CHANGELOG.md so reviewers (human or model) see what moved without wading through raw diffs.
Main use case
- Default: include committed changes since the last base marker in
CHANGELOG.mdplus current working tree edits, then record a new base marker. - Optional: limit to staged only or a specific commit range (e.g.,
main..HEAD). - Output: grouped by the first two path segments (e.g.,
skills/brave-search) with A/M/D/R counts and short analogies.
Commands
- Show help:
./scripts/change-logger.ts --help - Working tree (staged + unstaged):
./scripts/change-logger.ts - Staged only:
./scripts/change-logger.ts --staged - Commit range:
./scripts/change-logger.ts --range main..HEAD - Custom section title:
./scripts/change-logger.ts --title "Landing page polish"
Notes
- Requires git in PATH and a repository context.
- Ignored dirs follow git defaults; handles renames via git diff output.
- Writes/updates
CHANGELOG.mdat the repo root with dated sections and analogies; ideal for PRs, oracle prompts, or release notes. - The base commit marker is stored in each new changelog section and used on subsequent runs to avoid re-listing old commits.