mediagit reset

Reset the current branch to a specified commit.

Synopsis

mediagit reset [--soft | --mixed | --hard] [<COMMIT>]
mediagit reset <COMMIT> [--] <PATHS>...

Description

Moves the current branch pointer to the specified commit. How the working tree and staging area are affected depends on the reset mode.

When paths are specified, only those files are affected (path-specific reset does not move the branch pointer).

Arguments

[COMMIT]

Target commit (default: HEAD). Accepts full 64-char OIDs, short hashes (e.g., abc1234), branch names, or HEAD~N notation.

[PATHS]

Specific files to reset. Cannot be combined with --soft or --hard.

Options

--soft

Move the branch pointer to <COMMIT>. Working tree and staging area are unchanged — changes from undone commits appear as staged.

--mixed (default)

Move the branch pointer and reset the staging area to match <COMMIT>. Working tree files are unchanged — changes appear as unstaged.

--hard

Move the branch pointer, reset staging area, and discard all working tree changes. Destructive — cannot be undone without the reflog.

-q, --quiet

Suppress output.

Examples

Undo last commit, keep changes staged

$ mediagit reset --soft HEAD~1

Undo last commit, unstage changes (default)

$ mediagit reset HEAD~1
# same as:
$ mediagit reset --mixed HEAD~1

Discard last commit and all changes

$ mediagit reset --hard HEAD~1

Reset to a specific commit

$ mediagit reset --hard abc1234def
HEAD is now at abc1234d Previous stable state

Unstage specific files

$ mediagit reset -- textures/hero.psd
Unstaged: textures/hero.psd

Recover from accidental –hard reset

# Find the lost commit in the reflog
$ mediagit reflog --count 10
HEAD@{0}: reset: moving to HEAD~1
HEAD@{1}: commit: Add hero texture

# Restore the lost commit
$ mediagit reset --hard HEAD@{1}

Reset Modes Comparison

Exit Status

• 0: Success
• 1: Commit not found or invalid options

See Also

• mediagit revert - Undo a commit by creating an inverse commit
• mediagit reflog - Recover from accidental resets
• mediagit stash - Stash changes without committing