Command overview

Updated Oct 19, 2026

mapsplice supports four operations:

mapsplice append <target> <file-to-append>
mapsplice insert <target> <anchor> <file-to-insert>
mapsplice insert --after <target> <anchor> <file-to-insert>
mapsplice delete <target> <anchor>
mapsplice replace <target> <anchor> <file-to-replace-with>

By default the rewritten roadmap is written to standard output. Use --in-place or -i to rewrite the target file instead.

Help and diagnostics

Use mapsplice --help for the command list or mapsplice help insert for help on one operation. Top-level help begins with the stable usage line Usage: mapsplice [OPTIONS] <COMMAND>. Successful roadmap output and help text are written to standard output. If a reader closes that output pipe, including while writing roadmap output or help, mapsplice exits successfully. Other standard-output write failures produce a diagnostic on standard error and an unsuccessful exit. Invalid command-line input and errors from reading, validating, or editing roadmap files also produce diagnostics on standard error and exit unsuccessfully. The unreleased help and diagnostic logging changes are listed in the 0.2.0 migration notes.