gitsquash - Interactive CLI tool to squash Git commits

1 day ago 5

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.

demo

  • 🔍 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
  1. Shows you a list of recent commits
  2. Use space bar to select commits you want to squash
  3. Press enter to confirm selection
  4. Enter a new commit message (or use preset with -m)
  5. 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

Read Entire Article