mise bootstrap dotfiles history

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

Browse the checkpoints of your dotfiles

Every save, every mutating bootstrap command, and the watcher record a checkpoint of explicitly enrolled [dotfiles] entries with mode = "track". Configuration and deployment sources are not implicitly enrolled. A checkpoint holds files, never package or service state: restoring one restores files. Without a subcommand this lists them, newest first.

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 (edit, save, bootstrap, …)

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

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

• -h --help — Print help

Subcommands

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

Examples:

mise bootstrap dotfiles history
mise bootstrap dotfiles history --path ~/.config/hypr/bindings.lua
mise bootstrap dotfiles history show latest
mise bootstrap dotfiles history diff          # the working tree against the latest checkpoint
mise bootstrap dotfiles history diff 11 12 --patch
mise bootstrap dotfiles save --description "before the theme change"
mise bootstrap dotfiles rollback ~/.config/hypr/bindings.lua
mise bootstrap dotfiles undo

Related documentation

• Dotfile ownership and modes.
• mise bootstrap dotfiles <SUBCOMMAND>.
• Global flags and argument syntax.