Git-hex Conflict Resolution

When to use this Skill

This skill should be used when:

• •A git-hex tool reports that an operation is paused because of conflicts.
• •The user says a rebase or cherry-pick is "stuck", "paused", or "in conflict".
• •You need to see which files conflict and decide whether to continue or abort.

Trigger phrases include: "rebase conflict", "cherry-pick conflict", "merge conflict", "stuck on conflicts", "continue the rebase", "abort the cherry-pick".

Workflow

1. •

   Inspect conflict state

   • •Call git-hex-getConflictStatus to determine:
     • •Whether a rebase/merge/cherry-pick/revert is in progress.
     • •Which files are conflicting and the overall operation type (rebase, merge, cherry-pick, or revert).
   • •Use includeContent: true only when necessary to inspect base/ours/theirs content for specific text files.
2. •

   Resolve conflicts per file

   • •For text files:
     • •Propose or apply edits based on base, ours, and theirs.
     • •Ensure conflict markers are removed before resolving.
     • •Call git-hex-resolveConflict with the file path (and resolution: "delete" for delete conflicts when appropriate).

• •For delete conflicts, use the resolution parameter to choose whether to keep or remove the file.

1. •

   Continue or abort the operation

   • •When all conflicts are resolved (or getConflictStatus shows no remaining conflicting files but the operation is still paused), call git-hex-continueOperation.
   • •If the user decides to give up on the rebase or cherry-pick, call git-hex-abortOperation to restore the pre-operation state.
2. •

   Escalate if needed

   • •If the final result after continuing is not what the user wanted, suggest using git-hex-undoLast from the branch cleanup Skill to revert.

Tools to prefer

• •Inspection: git-hex-getConflictStatus
• •Resolution: git-hex-resolveConflict
• •Control: git-hex-continueOperation, git-hex-abortOperation
• •Recovery: git-hex-undoLast (via the branch cleanup Skill)

Conflict types

Operation-level

• •"rebase" - Interactive rebase paused
• •"merge" - Merge in progress
• •"cherry-pick" - Cherry-pick paused
• •"revert" - Revert paused (detected but continueOperation/abortOperation are not supported; use git revert --continue or --abort directly)

File-level

• •"both_modified" - Both sides modified the file
• •"deleted_by_us" - We deleted, they modified
• •"deleted_by_them" - We modified, they deleted
• •"added_by_both" - Both sides added different versions

Delete conflict handling

// To keep the file (must exist on disk):
{ "file": "path/to/file", "resolution": "keep" }

// To accept deletion:
{ "file": "path/to/file", "resolution": "delete" }