review

Reviews committed changes before pushing across repositories.

Usage

git-wrangler review [--repo <path>] [--json] [--no-fetch] [--guided]

What it does

Discovers Git worktrees under the current directory, or targets exactly one worktree with --repo, and displays added, edited, and removed files from commits that are not present in any local remote-tracking ref. If an entire directory was deleted, it groups the changes and reports the directory deletion instead of listing every individual file.

review shows committed but unpushed changes. It does not report unstaged or uncommitted working tree changes; use git-wrangler status for that.

By default, review first runs git fetch --prune origin for each target repository so unpushed commit detection compares against fresh remote-tracking refs. Use --no-fetch for offline or local-only runs.

Options

FlagRequiredDescription
--repo <path>OptionalTarget exactly one repository instead of discovering recursively.
--jsonOptionalEmit one JSON document on stdout. Suppresses normal human summary, colors, and progress.
--no-fetchOptionalUse local remote-tracking refs without fetching origin first.
--guidedOptionalInteractively configure command options. Cannot be combined with --json.

Examples

# Review all unpushed changes
git-wrangler review

# Review unpushed changes for a single repository
git-wrangler review --repo /path/to/repo

# Output review in JSON format
git-wrangler review --json

# Use local remote-tracking refs without refreshing origin
git-wrangler review --no-fetch

Use Case

Run git-wrangler review before git-wrangler push to verify what committed work is absent from remotes without opening each repository individually.

Notes

  • Fetch failures are per-repository failures; JSON mode reports them in repositories[].