Skip to content

Add progress.sh for AI-powered commit summaries #459

@livid

Description

@livid

progress.sh — Generate progress summaries between git refs

A helper script that summarizes what was built between two git refs using the claude CLI.

Usage

./progress.sh

How it works

  1. Prompts for a From and To ref (defaults To to HEAD if left empty)
  2. Provides live autocomplete as you type — matches against tags and branches, shows up to 3 candidates
  3. Use arrow keys to highlight a candidate, Enter to select
  4. Displays the date range and span between the two refs
  5. Collects all commits in the range and pipes them to claude for summarization
  6. Output is organized into four fixed sections:
    • New Features
    • Improvements
    • Bug Fixes
    • Cleanup & Refactoring
  7. Summary is automatically copied to clipboard (pbcopy)

Supported refs

Works with any valid git ref — tags, branches, or commit SHAs.

Example

Generate a progress summary between two git refs.
Use arrow keys to select, Enter to confirm.

From: release-0.18
  > release-0.18.3
    release-0.18.2
    release-0.18.1

To [HEAD]: ⏎

  release-0.18.3  2025-01-15
  HEAD             2025-03-14  (2 months)

Found 42 commits. Generating summary...

### New Features
- ...

### Improvements
- ...

### Bug Fixes
- ...

### Cleanup & Refactoring
- ...

Copied to clipboard.

Requirements

  • claude CLI
  • pbcopy (macOS)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions