Skip to content

mise dotfiles history show ​

Show a checkpoint: its trigger, changes, and operation journal

Prints the checkpoint's trigger, description, time, and machine, the files that changed since the previous checkpoint, and the tracked entries it covers. For a checkpoint that an operation recorded, also prints the operation's journal of the files it wrote.

Arguments ​

  • [REF] — Numeric checkpoint ID, latest (the default), latest~N, or commit:<sha>

Flags ​

  • -J --json — Output in JSON format
  • --files — List every file in the snapshot
  • --path <PATH> — Resolve latest~N among the checkpoints where this path changed
  • -h --help — Print help

Examples ​

Show the newest checkpoint

mise dot history show

List every file in an older checkpoint

mise dot history show latest~2 --files
MIT LicenseCopyright © 2026jdx.dev