Repository navigation
Merge Tool Bugs We Fixed
github-actions[bot] edited this page Oct 18, 2026
·
1 revision
The bugs found in the merge tool, what caused each, and why we fixed it the way we did. The user side is in Merge Tool.
The engine check compared too few merges.
- The issue: the test failed with "too few clean cases compared: 8".
- Why it happened: random edits hit one line in 12, so nearly every merge conflicted.
- The fix and why we chose it: one line in 40, 300 runs, over 50 clean comparisons required and under 5% disagreement, so the check means something.
Undo could restore the wrong chunk state.
- The issue: undoing grouped steps could bring back buttons from the wrong moment.
-
Why it happened: grouped undo events carry several
setChunkseffects, oldest last. -
The fix and why we chose it:
chunkFieldtakes the lastsetChunkseffect of a transaction.
Apply non-conflicting could send overlapping edits.
- The issue: after heavy manual edits, one click could produce overlapping edits, which CodeMirror rejects.
- Why it happened: a chunk grown by typing could touch the previous one.
-
The fix and why we chose it:
applyNonConflictingleaves such a chunk for you instead of guessing.
Word highlights on unrelated lines.
- The issue: mostly rewritten lines got scattered word highlights instead of one block.
- Why it happened: the "unrelated text" guard counted matching whitespace, and skipped base tokens were counted twice.
-
The fix and why we chose it:
changedSpanscounts only matched words and returns null under 30% match.
Cmd+Enter added a line instead of applying.
- The issue: in the Result pane, Cmd+Enter inserted a blank line, so you had to click a side pane or Apply.
- Why it happened: CodeMirror's default keymap binds Cmd+Enter to "insert blank line". The Result is editable, so the editor used the key first, and the window handler, which skips handled keys, never saw it.
-
The fix and why we chose it:
applyKeymapadds a high-priority Cmd+Enter binding to all three panes and their search bars. Winning inside CodeMirror is simpler and safer than bending the window handler's "already handled" rule.
The close button dropped your work.
- The issue: the X in the title bar closed the tool at once and threw away an edited result, while Cancel and Esc asked first.
-
Why it happened: the X called
repoStore.closeMerge()directly; the "Discard Changes" question lived only in the editor's cancel. -
The fix and why we chose it:
MergeEditorexportscancel()and the X calls it, so the X, Cancel and Esc share one path and one question. With no editor shown (loading, errors, binary files) the X closes at once, as there is nothing to lose.
These pages are generated from docs/wiki. To correct something, open a pull request against the source file; edits made here are overwritten.
Using Nibtree
- Getting Started
- Welcome Screen
- Workspaces
- Files Panel
- File Operations
- File Icons
- Rounded Panels
- Editor and Tabs
- Pin Reorder and Wrap Tabs
- Single Tab Title
- Split Editor
- New File and Unsaved Changes
- Unload Hidden Tabs
- Editing Code
- Code Appearance
- Markdown Editor
- Image and PDF Preview
- Search Everywhere
- Recent Files
- Navigation Bar
- Find and Replace
- Changes and Commits
- Sign In Prompts
- Commit Box Layout
- Repository Actions
- Commit Options
- Ignoring Files
- Diffs
- Inline Diffs
- Staging View
- Revert a Change
- Resolving Conflicts
- Merge Tool
- Blame
- History and Log
- Merge Commits
- Branches and Tags
- Branches Popup
- Remotes
- Stashes
- Shelf
- Git Menu
- Git Dialogs
- Interactive Rebase
- Worktrees
- AI Agents
- AI Tasks
- AI Usage
- Keep Computer Awake
- Submodules
- Git LFS
- GitHub
- Git Console
- Terminal
- Terminal Features
- Scripts
- Navigation
- Menus
- Settings
- Settings Search
- Color Themes
- Settings Terminal and Automation
- Settings Files
- Updates
- Status Bar and Help
- Notifications
- Memory Use
- Clear Cache
- MCP and CLI
- Git Mergetool
- Keyboard Shortcuts
- Keyboard Shortcuts Editor
- Troubleshooting
- Troubleshooting Git
Developers
- Developer Guide
- Architecture
- Project Layout
- Backend
- How Folder Watching Works
- Folder Watching Bugs We Fixed
- How Workspace Files Work
- How the Preview Scheme Works
- Backend Services
- How Terminal Features Work
- Terminal Bugs We Fixed
- Frontend
- How the Rich Markdown Editor Works
- Rich Markdown Bugs We Fixed
- Git Menu Links
- Menu Keys and Routing
- Frontend Modules
- Blame Bugs We Fixed
- Project Color And Title Bar
- One Diff View
- Diff Bugs We Fixed
- Merge Tool Layouts
- Merge Tool Bugs We Fixed
- Color Theme Bugs We Fixed
- How the Connected Diff Works
- Rounded Panels Bugs We Fixed
- Update Bugs We Fixed
- Status Bar Bugs We Fixed
- MCP and CLI Bugs We Fixed
- Repository Actions Bugs We Fixed
- How the Changes Tab Works
- CodeMirror Patterns
- How the Cursor Works
- How Editor Features Work
- How the Path Bar Works
- Commands and Events
- Settings Reference
- Commands Workspace and Changes
- Commands Branches and Remotes
- Commands History and Extras
- Commands App and Tools
- Testing
- Test Suites
- Debugging
- Debugging with MCP
- Measuring Setting Memory
- How Terminal Memory Is Measured
- How Markdown Diagrams Work
- Releases and CI
- Publishing the Wiki
- Versioning and Changelog
- Browser Version Packages
- Browser Release Checks
- Docker Image
- Platforms and Signing
- Windows Support
- Windows Bugs We Fixed
- Windows MCP and CLI
- Docs and Screenshots
- UI Library
- UI Library MCP
- UI Library Bugs
- UI Library Migration
- Contributing
How features work
- Welcome screen
- Workspaces and folders
- Files panel
- File operations
- File icons
- Editor and tabs
- Pin, reorder and wrap tabs
- Single tab title
- Split editor
- New File and unsaved changes
- Unload hidden tabs
- Editing code
- Code appearance
- Markdown editor
- Image and PDF preview
- Search Everywhere
- Recent Files
- Navigation Bar
- Find and replace
- Changes and commits
- Sign-in prompts
- Commit box layout
- Repository actions
- Commit options
- Ignoring files
- Diffs
- Inline diffs
- Staging view
- Revert a change
- Resolving conflicts
- Merge tool
- Blame
- History and log
- Merge commits
- Commit tabs
- Branches and tags
- Branches popup
- Remotes
- Stashes
- Shelf
- Git menu
- Git dialogs
- Interactive rebase
- Worktrees
- AI agents
- AI usage
- Keep computer awake
- AI tasks
- Submodules
- Git LFS
- GitHub account
- Git Console
- Back and Forward
- Integrated terminal
- Scripts tool window
- Menu bar
- Settings
- Search in Settings
- Color themes
- Rounded panels
- Updates and release channels
- Status bar and help links
- Notifications
- Memory readout and memory log
- Clear Cache
- MCP server and command line tool
- git mergetool mode