NBMERGE-WEB(1)

🌸 NAME 🌸

nbmerge-web — merge two Jupyter notebooks 💖 (yes bestie, it's the mergetool for Nbdime, and it's iconic)

---

✨ DESCRIPTION ✨

okay so here's the whole vibe. you run this thing and it takes three notebooks — a base, a local, and a remote — and it helps you merge them. the usage looks like this:

nbmerge-web [-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] [-p PORT] [-b BROWSER] [--persist] [--ip
            IP] [-w WORKDIRECTORY] [--base-url BASE_URL] [--show-unchanged]
            [--identical-lines-margin IDENTICAL_LINES_MARGIN] [--no-base]
            [--out OUT] base local remote

Mergetool for Nbdime. 🫶

🎀 positional arguments 🎀

• base — the base notebook filename. the blueprint, the og, the starting point.
• local — the local modified notebook filename. this one's your version, your edits, your moment.
• remote — the remote modified notebook filename. and this is everybody else's changes coming at you.

💅 options 💅

• -h, --help — show this help message and exit. classic. we love a helpful king 👑
• --version — show program's version number and exit.
• --config — list the valid config keys and their current effective values. receipts, basically. 📋
• --log-level {DEBUG,INFO,WARN,ERROR,CRITICAL} — set the log level by name. pick how chatty you want it to be, from DEBUG (spills everything) to CRITICAL (only the emergencies).
• --merge-strategy {inline,use-base,use-local,use-remote} — the merge strategy to use. the big one. how do you wanna handle the chaos.
• --input-strategy {inline,use-base,use-local,use-remote} — the merge strategy to use for inputs (overrides 'merge-strategy' for inputs). so it just overrides the merge strategy, but only for the 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). note it's got two extra moves the other ones don't: remove and clear-all. 🧹
• --no-ignore-transients — disallow deletion of transient data such as outputs and execution counts in order to resolve conflicts. so by default it may delete that stuff to fix conflicts, and this flag says nah, don't. 🙈
• -p, --port PORT — specify the port you want the server to run on. Default is 0 (random). let it pick, it'll surprise you ✨
• -b, --browser BROWSER — specify the browser to use, to override the system default.
• --persist — prevent server shutting down on remote close request (when these would normally be supported). it simply refuses to leave. main character energy fr.
• --ip IP — specify the interface to listen to for the web server. NOTE: Setting this to anything other than 127.0.0.1/localhost might compromise the security of your computer. Use with care!

🚨 bestie PLEASE read that one again. anything other than 127.0.0.1/localhost can genuinely put your machine at risk. Use with care!

• -w, --workdirectory WORKDIRECTORY — specify the working directory you want the server to run from. Default is the actual cwd at program start.
• --base-url BASE_URL — The base URL prefix under which to run the web app.
• --show-unchanged — show unchanged cells by default. sometimes you wanna see the parts that didn't change, iykyk.
• --identical-lines-margin IDENTICAL_LINES_MARGIN — Margin for collapsing identical lines in editor; set to -1 to deactivate.
• --no-base — Don't display the base version. skip the base, live your truth.
• --out OUT — if supplied, the merged notebook is written to this file. Otherwise it cannot be saved. so like… if you want your merge to actually survive, you need this. no --out, no save. 😭

🦋 ignorables 🦋

Set which parts of the notebook (not) to process. the "do I even care about this bit" section. 🎀

• -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.

---

and that's the whole page, bestie 💜 it's nbmerge-web version 4.0.4, from February 2026, and honestly? she ate. go merge something. 🦋✨🌸