Skip to content

Conflict Resolution

When a merge, rebase, or pull can’t apply cleanly, ichi opens the conflict resolution view instead of leaving you to untangle conflict markers in an editor.

Any operation that can conflict drops you into this view automatically:

  • :merge a branch with divergent changes
  • :rebase onto a branch that touched the same lines
  • :pull when local and remote both changed a file

The view walks you through the conflicting files and hunks, showing the competing sides so you can choose what to keep. Navigate with the usual keys:

KeyAction
j / kMove between conflicts
TabSwitch focus / side
EnterChoose / confirm
EscBack

Once a conflict is resolved, the file is staged so you can continue the merge or rebase. Press ? in the view for the exact keys available.

When every conflict is settled, finish the operation and review the result:

  • Return to the graph (g) to confirm history looks right.
  • Commit the merge if one is pending.