Examples

🚀Workflow Examples

Dry-run First

Preview repository-aware tag, release-recovery, and container workflows before authorizing persistent changes.

Commandreflow

📦Category

Examples

🚀Quick Command

reflow [GLOBAL OPTIONS] COMMAND

---

Replace tag formats

Local PEP 440 to SemVer

bash

# Preview local tag-ref replacement
reflow --dry-run -C ../project tags convert local --to semver

# Apply after reviewing the plan

reflow -C ../project tags convert local --to semver --yes

Remote SemVer to PEP 440

bash

# A URL is cloned into a managed temporary workspace for discovery
reflow --dry-run --repository-url https://github.com/acme/project.git tags convert remote --to pep440

# Remote scope performs the guarded push; --push is not used

reflow --repository-url https://github.com/acme/project.git tags convert remote --to pep440 --yes

Preview external workflows

Terminal

bash

# Find tags whose GitHub releases are missing; do not re-push
reflow --dry-run -C ../project releases recover

# Resolve tagged images; do not build, push, or clean images

reflow --dry-run -C ../project dockerize

⚠️Dry-run is not authorization

Remove --dry-run only after verifying the displayed repository, conversion plan, remote, registry image, and confirmation behavior.

🚀Related Commands

Commands commonly used together with this command.

Local Tag Conversion

More persistent-checkout examples.

Remote Tag Conversion

More guarded remote replacement examples.

Release Recovery

Preview and authorize tag re-push recovery.

Dockerize

Preview tagged image publication.