mise dotfiles files

• Usage: mise dotfiles files [FLAGS] [PATH]
• Effect: read-only
• Source code: src/cli/dotfiles/files.rs

List a directory's files and whether each one is tracked

Shows each file and subdirectory with its tracking state: tracked (with the entry that covers it), excluded (with the rule that leaves it out), omitted (covered, but a capture skips it, such as a credential-like file), or untracked. A subdirectory shows how many tracked files it holds, and is partial when it is not tracked itself, or is excluded, but holds tracked files. A path kept in local-only history is one local row, listed in full by mise dot --local files PATH. --tracked and --untracked split the rows: partial and local rows are listed by --tracked. Relative paths are read from the current directory.

Arguments

• [PATH] — The directory or file to list; defaults to the current directory

Flags

• -r --recursive — List files in subdirectories too, instead of one row per subdirectory
• --tracked — Only show what is tracked
• --untracked — Only show what holds nothing tracked
• -J --json — Output in JSON format
• -h --help — Print help

Examples

Show what is tracked in the current directory

mise dot files

Show what is tracked in ~/.config/hypr

mise dot files ~/.config/hypr

List every file under ~/.config/nvim that history does not save

mise dot files -r --untracked ~/.config/nvim

Related documentation

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