git-replace

git replace [-f] object replacementgit replace [-f] --edit objectgit replace [-f] --graft commit [parent...]git replace [-f] --convert-graft-filegit replace -d object...git replace [--format=format] -l [pattern]

git replace creates, lists, or deletes refs in the `refs/replace/` namespace that substitute one object for another. This allows changing how objects are viewed without modifying the original objects themselves.Replacements are used by default in all Git commands except reachability traversal (prune, pack transfer, fsck). To bypass replacements, use `git --no-replace-objects` or set the `GITNOREPLACE_OBJECTS` environment variable.Common use cases include fixing published history, grafting histories together, or replacing large blobs. The `--graft` option simplifies rewriting commit parentage, replacing the legacy `$GIT_DIR/info/grafts` mechanism.

-l [pattern], --list [pattern]

List replacement refs. If a pattern is given via glob(7), only matching replacements are listed.

Delete existing replacement refs for the given objects.

Overwrite an existing replace ref for the same object instead of failing.

Create a graft commit. A new commit is created with the same content as the given commit but with the specified parents, then a replacement ref is created to replace the original commit.

Convert all entries in `$GIT_DIR/info/grafts` to replace refs and delete the grafts file. This is a one-time migration from the legacy grafts mechanism.

Edit an object's content interactively. The existing content is pretty-printed into a temporary file, an editor is launched, and the result is used to create a replacement object.

When used with `--edit`, provide the raw object contents rather than pretty-printed ones. Useful for editing corrupted objects.

Format for `--list` output: `short` (replaced SHA only), `medium` (replaced -> replacement), or `long` (includes object types). Default: `short`.

git-commit(1), git-tag(1), git-filter-branch(1), git-fsck(1)