Skip to main content

multi

CLI reference

Description

Capture, inspect, delete, or push multi-repository branch sets for changes that span several workspace repositories. 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 to publish the coordinated set.

Usage

esysrepo multi [options ...]

Options

Available options (mutually exclusive task flags):

  • --capture / -c: Capture branches that differ from the manifest for all repositories
  • --show / -s: Show the captured branches
  • --delete / -d: Delete the captured branches (notes)
  • --push / -p: Push the captured branches (and related notes)
  • --folder / -f PATH: Workspace folder (common option; default is the current directory)

Examples

Capture divergent branches across the workspace:

esysrepo multi --capture

Show the current capture:

esysrepo multi --show

Delete the capture:

esysrepo multi --delete

Push the captured set:

esysrepo multi --push