mise dotfiles history

• Usage: mise dotfiles history [FLAGS] [SUBCOMMAND]
• Effect: read-only
• Source code: src/cli/dotfiles/history/mod.rs

Browse saved versions of your tracked files

A checkpoint is a saved version of every [dotfiles] entry with mode = "track". mise dot save, the watcher, and every command that changes tracked files (such as mise bootstrap, mise dot apply, rollback, pull, and undo) record one. Checkpoints hold file contents only, not packages or services. Files deployed in other modes are saved only if you also track them. With no subcommand, lists checkpoints newest first.

See https://mise.jdx.dev/dotfiles/history.html

Flags

• -J --json — Output in JSON format

• -n --limit <LIMIT> — Show at most this many checkpoints (0 for all)

  Default: 20

• --path <PATH> — Only checkpoints where this path (or something under it) changed

• --trigger <TRIGGER> — Only checkpoints with this trigger, such as edit, save, agent, bootstrap, apply, rollback, or undo

  bootstrap covers mise bootstrap, its packages commands, and mise dot add, apply, edit, and unapply. apply covers incoming changes written by mise dot pull or the watcher.

• --label <LABEL> — Only checkpoints with this label

• --pending — Only checkpoints recorded by operations that did not finish

• -h --help — Print help

Examples

List recent checkpoints

mise dot history

List checkpoints that changed one file

mise dot history --path ~/.config/hypr/bindings.lua

List the last five checkpoints from mise bootstrap or mise dot apply

mise dot history --trigger bootstrap -n 5

Show the newest checkpoint

mise dot history show latest

Show unsaved changes

mise dot history diff

Subcommands

• mise dotfiles history describe <REF> <TEXT>
• mise dotfiles history diff [FLAGS] [A] [B]
• mise dotfiles history ls [FLAGS]
• mise dotfiles history show [FLAGS] [REF]

Related documentation

• Dotfiles history.
• mise dotfiles [--local] <SUBCOMMAND>.
• Global flags and argument syntax.