Skip to content

mise bootstrap dotfiles history

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

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
MIT LicenseCopyright © 2026jdx.dev