A command-line tool for managing Git branch commits and cherry-picking between production and homologation branches.

chr helps developers manage commits between production (PRD) and homologation (HML) branches in Git workflows. It intelligently identifies commits that need to be cherry-picked and handles the rebase-safe commit matching problem.

• Rebase-Safe Commit Detection: Uses composite matching (author + date + message) to identify commits even after rebases change their hashes
• Automatic User Filtering: Only shows commits from the current Git user
• Date-Based Filtering: Filter commits by today, yesterday, or custom date ranges
• Dry-Run Mode: Preview commits before cherry-picking (default behavior)
• Colored Output: Syntax highlighting for different commit types and authors
• Configurable Branch Naming: Support for custom prefixes and suffixes

curl -sSf https://raw.githubusercontent.com/carlosarraes/chr/main/install.sh | sh

This will install chr to ~/.local/bin. Make sure this directory is in your PATH.

Download the latest binary from the releases page and place it in your PATH.

git clone https://github.com/carlosarraes/chr
cd chr
make build
sudo cp dist/chr /usr/local/bin/

Or install locally:

make install-local

# Show commits that need to be picked (dry-run)
chr

# Actually cherry-pick the commits
chr --pick

# Show specific number of commits
chr --count 10

# Show commits from today only
chr --today

# Show commits from yesterday
chr --yesterday

# Show commits since a specific date
chr --since 2024-01-01

# Show commits until a specific date
chr --until 2024-01-31

# Interactive mode
chr --interactive

# Disable colored output
chr --no-color

# View current configuration
chr config

# Set branch prefix
chr config --set-key prefix --set-value "ACME-"

# Set production branch suffix
chr config --set-key suffix_prd --set-value "-prod"

# Set homologation branch suffix  
chr config --set-key suffix_hml --set-value "-stage"

# Enable/disable colors
chr config --set-key color --set-value true

# Interactive configuration setup
chr config --setup

chr expects branches to follow this naming pattern:

• Current Branch: Can be any branch (usually a feature branch)
• Production Branch: {prefix}{card-number}{suffix_prd}
• Homologation Branch: {prefix}{card-number}{suffix_hml}

With default configuration:

• Prefix: ZUP-
• Production suffix: -prd
• Homologation suffix: -hml

For card number 123:

• Production branch: ZUP-123-prd
• Homologation branch: ZUP-123-hml

1. Branch Detection: Extracts the card number from the current branch name
2. Commit Retrieval: Gets commits from the PRD branch that aren't in the HML branch
3. User Filtering: Filters to show only commits by the current Git user
4. Date Filtering: Applies any date-based filters specified
5. Duplicate Detection: Uses composite matching to identify already-picked commits (solving the rebase problem)
6. Display/Action: Shows commits or cherry-picks them based on the mode

Traditional tools fail when commits are rebased because Git assigns new hashes to rebased commits. chr solves this by using "commit signatures" that combine:

• Author name
• Commit date
• First line of commit message

This allows matching commits even after their hashes change due to rebasing.

Configuration is stored at ~/.config/chr.toml:

# Configuration file for chr tool

# The prefix for branch names (default: "ZUP-")
prefix = "ZUP-"

# The suffix for production branches (default: "-prd")
suffix_prd = "-prd"

# The suffix for homologation branches (default: "-hml")
suffix_hml = "-hml"

# Enable colored output (default: true)
color = true

Configuration can also be set via environment variables:

• CHR_PREFIX: Branch name prefix
• CHR_SUFFIX_PRD: Production branch suffix
• CHR_SUFFIX_HML: Homologation branch suffix
• CHR_COLOR: Enable/disable colors (true/false)

Command-line flags override environment variables, which override the config file.

# Check what commits need to be picked today
chr --today

# Pick all your commits from today
chr --today --pick

# Check commits from the last few days
chr --since 2024-01-20 --count 20

# Even after rebasing, chr will still find your commits
git rebase main
chr --pick  # Will correctly identify and pick your rebased commits

# Set up for a different project
chr config --set-key prefix --set-value "PROJ-"
chr config --set-key suffix_prd --set-value "-production"
chr config --set-key suffix_hml --set-value "-staging"

# Now chr will look for branches like PROJ-123-production and PROJ-123-staging

chr provides helpful error messages for common issues:

• Invalid branch name: Branch doesn't match expected format
• Missing branches: PRD or HML branches don't exist
• Not in Git repo: Current directory isn't a Git repository
• No commits found: No commits match the criteria
• Cherry-pick conflicts: Git conflicts during cherry-pick operation

go build -o chr .

go test ./...

chr/
├── cmd/                    # CLI commands and parsing
├── internal/
│   ├── config/            # Configuration management  
│   ├── git/               # Git operations
│   └── picker/            # Commit matching and filtering
├── testdata/              # Test fixtures
├── go.mod
├── go.sum
├── main.go
└── README.md

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Run tests: go test ./...
6. Submit a pull request

MIT License - see LICENSE file for details.