Skip to main content

Reflow

Runtime
Python 3.14+
Targets
Local checkout or Git URL
Safety
Preview, confirmation, and dry-run
Documentation
Reflow 1.0.2

Reflow at a Glance

Reflow terminal banner and repository workflow output
A representative Reflow repository workflow. The final release screenshot can be added without changing this page.

Overview​

Reflow is a repository-aware release-maintenance CLI. It keeps target selection visible, separates local and remote tag replacement, and applies dry-run and confirmation boundaries before consequential operations.

What Reflow Helps You Manage

Choose the smallest command whose documented mutation scope matches your task.

Core Capabilities

Convert Local Tags

Replace supported PEP 440 or SemVer tag names in one persistent checkout without pushing.

Convert Remote Tags

Replace validated remote tag refs through one guarded atomic push.

Recover Release Automation

Re-push tags missing GitHub releases so tag-triggered CI/CD can run again.

Publish Tagged Images

Build and push images for repository tags to GHCR, GitLab Container Registry, or both.

Resolve Repository Targets

Use the current checkout, an explicit local checkout, or a supported Git URL materialized temporarily.

Preview Safely

Run discovery and validation while persistent local, remote, and registry mutations remain simulated.

Start with the Target and a Preview

Safe starting points
bash
# Inspect the command tree
reflow --help

# Preview a local-only tag replacement

reflow --dry-run -C ../project tags convert local --to semver

# Preview a remote replacement from a Git URL

reflow --dry-run --repository-url https://github.com/acme/project.git tags convert remote --to semver

Continue with Getting Started, then use the command overview to choose a workflow by its persistent effect.