HG-NBMERGEWEB(1)

✨ hg-nbmergeweb ✨

okay bestie, pull up a chair 💖 this is the manual page for hg-nbmergeweb, and it lives in section 1 (User Commands) of the manual, so that's the level of "you type it in a shell and it does a thing" we're operating at. Buckle up.

---

🦋 NAME 🦋

hg-nbmergeweb — a mercurial web-based merge tool for notebooks. literally what it says on the tin, no cap.

---

🌸 SYNOPSIS 🌸

usage: hg-nbmergeweb [-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] base local
              remote merged

---

👑 DESCRIPTION 👑

so the whole ~concept~ is: this is a mercurial web-based merge tool for notebooks.

it uses nbdime to merge notebooks instead of doing plain text merges of JSON. that's the entire point, and it's giving "I refuse to read raw JSON diffs ever again" energy. see the documentation for how to correctly configure mercurial to use this — fr, go read it, don't just yolo it 🙈

use it with:

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

---

🎀 positional arguments

these four are not optional, bestie. they're the whole meal.

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

---

💅 OPTIONS 💅

one bullet per option, exactly as the original lists them, no skipping the "boring" ones because none of them are boring:

• -h, --help — show this help message and exit. classic.
• --version — show program's version number and exit.
• --config — list the valid config keys and their current effective values.
• --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.
• -p, --port PORT — specify the port you want the server to run on. Default is 0 (random).
• -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).
• --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 comprimise the security of your computer. Use with care!

🚨 bestie listen. that --ip one? that is a do not be cute with this flag. anything other than 127.0.0.1/localhost and you might be compromising your computer's security. use with care. for real for real.

• -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
• --identical-lines-margin IDENTICAL_LINES_MARGIN — Margin for collapsing identical lines in editor; set to -1 to deactivate.

---

🧚 ignorables 🧚

Set which parts of the notebook (not) to process. this is your "I only care about these bits" 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, no crumbs left. every flag, every default, every bracket in the usage line — all accounted for. iykyk 💜

---

and a little sign-off from me to you: this page is from hg-nbmergeweb 4.0.4, dated February 2026, and it's the HG-NBMERGEWEB(1) page, bestie — go merge some notebooks and slay ✨🎀