What problem does it solve?
Help developers selectively bring changes from other git worktrees or branches into the current branch without performing full merges or losing control over which files, hunks, or commits are applied, reducing merge noise and conflicts.
Core Features & Use Cases
- Selective file checkout: Pull whole files or directories from another branch or worktree into the current branch.
- Interactive patch selection: Choose specific hunks within files using patch-mode style prompts to apply only desired changes.
- Cherry-pick with selective staging: Apply commits without committing and exclude unwanted files before finalizing.
- Manual no-commit merges and conflict resolution: Perform controlled merges with the option to resolve conflicts and stage selectively.
- Multi-worktree composition and cleanup: Combine files from multiple worktrees and optionally remove stale worktrees after merging.
- Use case: Integrating a small bugfix from a feature worktree into main without merging the entire feature branch.
Quick Start
Invoke the merge-worktree skill to import src/module.js from the worktree ../project-feature into your current branch using interactive patch selection.