Research & Papers

MergeNB: A new VS Code extension to resolve Jupyter notebook merge conflicts

No more buggy nbdime – this open-source tool rethinks notebook diffs from scratch.

Deep Dive

MergeNB is a fresh take on a pain point many data scientists and researchers know well: merging conflicting Jupyter notebooks in git. Created by Avni2000 after six months of side-project work, the tool is currently a VS Code extension that replaces nbdime with a more intuitive web-based UI. It highlights cell-level changes, outputs, and metadata diffs in a way that is easier to scan than legacy diff tools, which often break when notebooks contain rich outputs or execution counts.

The extension is open source and already has a growing set of features, including robust handling of reordered cells and merged outputs. Avni2000 plans to expand MergeNB into a full git mergetool, making it usable outside VS Code. For now, it integrates directly into the VS Code merge editor workflow. The project’s documentation is hosted on GitHub Pages and includes usage guides and contribution notes. Given how many teams rely on Jupyter notebooks for collaborative development, a reliable merge resolver could significantly reduce friction in version control.

Key Points
  • MergeNB is a VS Code extension with a web UI for Jupyter notebook merge conflicts.
  • Addresses bugs and usability issues of nbdime, offering clearer cell-level diffs.
  • Planned roadmap includes becoming a standalone git mergetool beyond VS Code.

Why It Matters

Simplifies collaboration for data teams using Jupyter notebooks, reducing merge headaches and saving hours of manual conflict resolution.