E-Pick

Web-based tool for cherry-picking git commits from Excel/CSV files

E-Pick simplifies the process of cherry-picking multiple git commits by allowing you to manage commit lists in spreadsheet files. Upload an Excel or CSV file containing commit hashes, validate them against your repository, and generate ready-to-use cherry-pick commands.

Features

• Upload Excel (.xlsx, .xls) or CSV files containing commit information
• Validates all commits against your repository before cherry-picking
• Interactive 5-step wizard interface
• Automatically sorts commits by date to prevent dependency issues
• Clear error messages for invalid commits
• Save and reuse repository paths with aliases
• Preview all files affected by selected commits
• Generates ready-to-execute cherry-pick commands

Requirements

• Node.js >= 18.0.0
• Git repository

Installation

# Install globally (future - when published to npm)
npm install -g epick

# Or use npx
npx epick

Usage

Start the Tool

# In your git repository
epick

# With specific repository
epick /path/to/repo

# With saved repository alias
epick my-project

# Don't auto-open browser
epick --no-open

The tool will automatically open your browser.

Save Repositories

# Save current directory
epick repo add my-project

# Save specific path
epick repo add work-repo /path/to/repo

# List saved repositories
epick repo list

# Remove repository
epick repo remove my-project

Workflow

1. Upload File: Drag and drop your Excel/CSV file
2. Select Columns: Choose which columns contain commit hashes and descriptions
3. Validate: The tool validates all commits against your repository
4. Review Results: View valid/invalid commits with clear indicators
5. Generate Command: Get a ready-to-execute cherry-pick command
6. Execute: Copy and run the command in your terminal

File Format

Your Excel or CSV file should contain commit hashes:

| Commit Hash | Description | |-------------|-------------| | abc123... | Fix login bug | | def456... | Add new feature | | ghi789... | Update dependencies |

Note: Use full commit hashes (40 characters). Short hashes are not supported.

Troubleshooting

"Not a git repository" error

Run the tool in a git repository directory:

epick /path/to/your/repo

Invalid commit hashes

Make sure your file contains full commit hashes (not shortened versions).

Development

For technical documentation and development setup, see CLAUDE.md.

License

MIT