Overview

🚀Core Concepts

Read Before Mutation

Understand how Reflow selects a repository and where each command is allowed to make changes.

Commandreflow

📦Category

Concepts

🚀Quick Command

reflow [GLOBAL OPTIONS] COMMAND

---

repository targetsmutation scopesdry-run

---

Two Decisions Govern Every Workflow

✨Features

🌿Which repository?

CLI target options override configuration; configuration overrides the current working directory.

🔄Which mutation scope?

The command determines whether changes are local, remote, registry-facing, or initialization-only.

✅Preview or live mode?

Global --dry-run permits discovery and validation while suppressing persistent mutations.

🚀Interactive or automated?

Mutating tag and recovery commands prompt in live mode unless their documented --yes option is supplied.

⚠️A repository URL is a target, not permission

Selecting a Git URL allows Reflow to create a managed temporary clone. The remote changes only when the chosen command explicitly documents a remote mutation.

🚀Related Commands

Commands commonly used together with this command.

Repository Targeting

Follow target precedence and path/URL exclusivity.

Safety and Dry-run

Understand what a preview may read and what it must not change.