An interactive CLI tool that makes git commit squashing simple and intuitive. Select multiple commits using an interactive interface, provide a new commit message, and squash them into a single commit.
- 🔍 Interactive commit selection with checkboxes
- 📝 Preview commit details (hash, date, message)
- ⚡️ Simple keyboard-based navigation
- 🔄 Automatic stashing of uncommitted changes
- 🚀 Dry-run mode to preview changes
- 💬 Optional preset commit messages
# Install globally
npm install -g gitsquash
# Or run directly with npx
npx gitsquash# Basic interactive mode - shows last 10 commits
gitsquash
# Show only last 5 commits
gitsquash -n 5
# Squash with a preset commit message (skips the message prompt)
gitsquash -m "feat: combine recent changes"
# Preview what would happen without making changes
gitsquash --dry-run| Option | Description |
|---|---|
-n, --number <count> |
Number of recent commits to show (default: 10) |
-m, --message <message> |
Preset commit message (skips the message prompt) |
--dry-run |
Preview squash operation without making changes |
--help |
Display help information |
--version |
Display version number |
- Shows you a list of recent commits
- Use space bar to select commits you want to squash
- Press enter to confirm selection
- Enter a new commit message (or use preset with
-m) - The selected commits will be squashed into a single commit
- Requires git to be installed and available in PATH
- Works on any git repository
- Automatically handles uncommitted changes by stashing them
- Minimum of 2 commits required for squashing
MIT