vc:merge-worktree

What problem does it solve?

Merges a git worktree branch back into the main checkout and cleans up the worktree, reducing clutter and keeping the repository in a consistent state.

Core Features & Use Cases

• Safe verification that the current path is a worktree and not the main checkout.
• Merge the worktree branch into the main branch and prune the worktree if the merge is successful.
• Cleanup the local branch and prune residual references, with clear recovery steps in case of conflicts.
• Use case: you created a feature-specific worktree to work on a bug fix, and after completion you want to integrate changes and remove the temporary worktree.

Quick Start

Switch to the main checkout, merge the worktree branch back into main, and remove the worktree if the merge succeeds.