multi
CLI reference
Description
Capture, inspect, delete, or push multi-repository branch sets for changes
that span several workspace repositories (ADR-0023). Captures are stored as
git notes (notes ref esysrepo) so they can travel with a commit to remote CI.
Choose one task flag per invocation. Typical workflow: --capture locally,
--show to inspect, then --push (prefer --dry-run first) to publish the
coordinated set.
Usage
esysrepo multi [options ...]
Options
Task flags (exactly one):
--capture/-c: Capture divergent branches as an esysrepo git note--show/-s: Show the captured branches--delete/-d: Delete the captured notes--push/-p: Push dependency-ordered branches then notes--abort: Abort an in-progress multi push--continue: Continue an in-progress multi push
Modifiers:
--dry-run: Print the plan without writing notes or pushing--inter/-i: Confirm when capture note and live state disagree--silent: Accept capture override without prompting (CI)--depends-scope: Limit capture/live scan to ADR-0022 depends-connected repos--folder/-fPATH: Workspace folder (common option)
Examples
esysrepo multi --capture --dry-run
esysrepo multi --capture
esysrepo multi --show
esysrepo multi --push --dry-run
esysrepo multi --push
esysrepo multi --continue
esysrepo multi --abort