HG-NBMERGE(1)

💅 hg-nbmerge — a mercurial CLI merge tool for notebooks

okay bestie, so hg-nbmerge is a mercurial CLI merge tool for notebooks ✨ and honestly? she's iconic. let's get into it.

---

🌸 SYNOPSIS 🌸

usage: hg-nbmerge [-h] [--version] [--config]
              [--log-level {DEBUG,INFO,WARN,ERROR,CRITICAL}] [-s] [-o] [-a]
              [-m] [-i] [-d] [--merge-strategy
              {inline,use-base,use-local,use-remote}] [--input-strategy
              {inline,use-base,use-local,use-remote}] [--output-strategy
              {inline,use-base,use-local,use-remote,remove,clear-all}]
              [--no-ignore-transients] base local remote merged

---

✨ DESCRIPTION ✨

A mercurial CLI merge tool for notebooks. periodt. 💖

She uses nbdime to merge notebooks instead of doing plain text merges of JSON — which, no cap, is the whole glow-up. JSON merges are giving chaos, notebook merges are giving main character energy. See the documentation for how to correctly configure mercurial to use this, iykyk.

Use with:

hg merge [<commit> [<commit>]]

---

🎀 POSITIONAL ARGUMENTS 🎀

• base — the base notebook filename.
• local — the local modified notebook filename.
• remote — the remote modified notebook filename.
• merged — the merge result notebook filename.

---

👑 OPTIONS 👑

• -h, --help — show this help message and exit. the classic. she's always there for you 🫶
• --version — show program's version number and exit.
• --config — list the valid config keys and their current effective values. very "show me your receipts" of her 💅
• --log-level {DEBUG,INFO,WARN,ERROR,CRITICAL} — set the log level by name.
• --merge-strategy {inline,use-base,use-local,use-remote} — the merge strategy to use.
• --input-strategy {inline,use-base,use-local,use-remote} — the merge strategy to use for inputs (overrides 'merge-strategy' for inputs).
• --output-strategy {inline,use-base,use-local,use-remote,remove,clear-all} — the merge strategy to use for outputs (overrides 'merge-strategy' for outputs).
• --no-ignore-transients — disallow deletion of transient data such as outputs and execution counts in order to resolve conflicts.

---

🧚 IGNORABLES 🧚

Set which parts of the notebook (not) to process. pick your battles, babe 🌈

• -s, --sources, -S, --ignore-sources — process/ignore sources.
• -o, --outputs, -O, --ignore-outputs — process/ignore outputs.
• -a, --attachments, -A, --ignore-attachments — process/ignore attachments.
• -m, --metadata, -M, --ignore-metadata — process/ignore metadata.
• -i, --id, -I, --ignore-id — process/ignore identifiers.
• -d, --details, -D, --ignore-details — process/ignore details not covered by other options.

lowkey reminder bestie: these flags come in matching pairs — the lowercase one says "yes queen, process this" and the uppercase one says "not today, skip it." 💀

---

that's the whole page, and she ate fr fr 💖✨

hg-nbmerge version 4.0.4, dated February 2026 — this listing is from the User Commands manual. mwah, go merge something pretty 🎀🦋