Skip to main content

atomic unrecord

Remove the last change from the current view.

Synopsis​

atomic unrecord [CHANGE] [-n]

Description​

atomic unrecord removes a change from the current view's change log. It is the local, view-level counterpart to atomic record — undo the last commit-like step without touching the working copy content.

Because changes are content-addressed and edges live in the canonical graph, unrecord removes the change's membership in the view; the change data itself remains recoverable until garbage-collected.

caution

Unrecording a change that other changes depend on can leave the view inconsistent. Prefer atomic view split (with --cascade) when you want to move changes — including their dependents — elsewhere rather than discard them.

Choosing the Change​

[CHANGE] — Hash or prefix of the change to unrecord. Find change hashes with atomic log; the most recent change in the view is the default target when no hash is given.

Options​

OptionDescription
-n, --dry-runPreview what would be unrecorded without doing it

Examples​

Undo the last change​

atomic log --format short     # see the recent changes
atomic unrecord # remove the most recent one

Remove a specific change​

atomic log                    # find the hash
atomic unrecord 3f9c2ab1

Preview first​

atomic unrecord --dry-run

Differences from Git​

AspectGitAtomic
ScopeRewrites branch history (git reset)Removes view membership; graph edges persist
DepthOne commit (without rebase gymnastics)Any change in the view by hash
SafetyForce-push needed after rewriteLocal metadata operation

See Also​

  • record — Recording changes
  • revise — Revise a change in-place (edit rather than remove)
  • view split — Move changes (with dependents) into another view
  • log — Find change hashes