CLI Reference
Quick CLI, path, option, and safety reference.
Quick CLI, path, option, and safety reference.
Choose a Reflow command by repository target, persistent effect, confirmation behavior, and dry-run boundary.
Diagnose configuration, target, environment, and workflow failures.
Configuration: reflow dockerize
Configuration: reflow init
Configuration: reflow releases recover
Configuration: reflow tags convert local
Configuration: reflow tags convert remote
Reference every active Reflow configuration table, its default, command consumers, and safety implications.
Prepare a focused, tested, documented, and safe contribution to Reflow.
Prepare Python 3.14+, install Reflow in editable mode, and configure contributor quality tools.
Pull Reflow production images with immutable or moving stable tags and run the CLI in a container.
Examples: reflow dockerize
Examples: reflow init
Examples: reflow releases recover
Examples: reflow tags convert local
Examples: reflow tags convert remote
Understand responsibilities and execution flow.
FAQ: reflow dockerize
FAQ: reflow init
FAQ: reflow releases recover
FAQ: reflow tags convert local
FAQ: reflow tags convert remote
Install the CLI, initialize project configuration, and run a safe first workflow.
Options: reflow dockerize
Reference for the supported initialization mode, overwrite behavior, prompting, and global dry-run option.
Options: reflow releases recover
Options: reflow tags convert local
Options: reflow tags convert remote
Output: reflow dockerize
Output: reflow init
Output: reflow releases recover
Output: reflow tags convert local
Output: reflow tags convert remote
Understand responsibilities and execution flow.
Build an image for every repository tag and publish it to configured GitHub and/or GitLab registries.
Create project-owned Reflow configuration in a persistent local target without changing Git history or remote state.
Find version tags without corresponding GitHub releases and re-push them to retrigger tag-based CI/CD.
Replace convertible tag names in one persistent local checkout while preserving tag type and annotated metadata when possible.
Replace tag names on a selected Git remote through one guarded atomic push.
Understand Reflow's repository targeting, mutation scopes, confirmation rules, and dry-run boundary before running a workflow.
Understand the project configuration file, precedence, and active sections.
Understand Reflow's contributor workflow, safety boundaries, and validation tools.
Install Reflow, select the intended repository, initialize local configuration, and preview the first workflow safely.
Quick CLI, path, option, and safety reference.
Diagnose configuration, target, environment, and workflow failures.
Choose a workflow by its target and side effects.
Choose a workflow by its target and side effects.
Convert version tags, recover tag-driven GitHub releases, and publish tagged container images from a repository-aware CLI.
Recover tag-triggered GitHub release automation.
Docker engine running. Valid Dockerfile/build context. Registry authentication and image permission. At least one Git tag.
A writable target project directory. Reflow installed with Python 3.14 or newer. Review existing .config/reflow content before using --force.
Authenticated GitHub release discovery. A push-capable remote. A tag-triggered workflow safe to retrigger.
A persistent local Git checkout. Convertible PEP 440 or SemVer tags. No destination collision or signed tag.
A URL or checkout with a push-capable remote. Permission to create and delete tag refs. No collision, signed tag, or unsupported conversion.
Syntax: reflow dockerize
Syntax: reflow init
Syntax: reflow releases recover
Syntax: reflow tags convert local
Syntax: reflow tags convert remote
Choose explicit local or remote tag-conversion scope.
Replace tag names between SemVer and PEP 440.
Compatibility alias for releases recover.
Validate Reflow's CLI, repository targeting, dry-run boundaries, and release workflows.
Troubleshooting: reflow dockerize
Troubleshooting: reflow init
Troubleshooting: reflow releases recover
Troubleshooting: reflow tags convert local
Troubleshooting: reflow tags convert remote
Workflow: reflow dockerize
Workflow: reflow init
Workflow: reflow releases recover
Workflow: reflow tags convert local
Workflow: reflow tags convert remote