/ Documentation

New Add-Ons

Extend Git Genie with powerful optional capabilities designed to improve commit hygiene and developer workflow efficiency.

gg split

gg split is an intelligent commit-splitting tool that analyzes mixed changes in your working directory and helps you break them into clean, logical commits.

What gg split Does

  • Analyzes staged and unstaged changes
  • Groups related modifications together
  • Suggests logical commit boundaries
  • Allows interactive review before committing

The Problem It Solves

Developers often make multiple types of changes in a single working session — bug fixes, refactors, formatting updates, and feature additions. These frequently get committed together, resulting in:

  • Messy commit history
  • Difficult code reviews
  • Harder rollbacks
  • Reduced traceability

gg split ensures each commit represents one logical unit of work.

When & Why Developers Should Use It

  • After long coding sessions with mixed changes
  • Before opening a pull request
  • When preparing clean commits for open-source contributions
  • When maintaining high-quality project history

Key Usage Examples

Standard intelligent split:

gg split

Preview changes without committing:

gg split --dry-run

Enable AI-powered grouping:

gg split --genie

Intelligent Capabilities

  • AI-powered grouping (opt-in) — Uses intelligent analysis to cluster related changes.
  • Heuristic fallback — Ensures grouping works even without AI enabled.
  • Interactive review flow — Lets you confirm or adjust commit boundaries before finalizing.