Standard Usage

You can display a tree for your current directory just by running nd after cding into that directory.

cd some_directory/
nd

Alternatively, pass in the name of the directory you wish to target:

nd some_directory/

nomad will assign an icon to each file within the tree based on its respective filetype and search for Git repositories in the target directory. If Git repositories are detected, Git markers will show next to the item indicating its Git status.

Git markers are shown regardless of whether you are running nomad in a directory containing a Git repository. For example, let's say you have a directory named rust/ containing multiple Rust projects that are tracked by Git and are stored in sub-directories. Many of these projects contain changes that you have not committed. Running nomad on the rust/ directory will display the Git changes for all of these projects. This provides a convenient overview for which projects have changes that you need to commit/revisit.

See the Git Status Markers section for more details.

Flags

Here are the flags you can use in standard mode:

FLAGS:
    -L, --all-labels           Label both files and directories. Alias for `-n -l`
        --banner               Display the banner
        --dirs                 Only display directories
        --disrespect           Disrespect all ignore rules
    -h, --help                 Prints help information
        --hidden               Display hidden files
    -l, --label-directories    Label directories with characters
        --loc                  Display code statistics (lines of code, blanks, and comments) for each item
    -m, --metadata             Show item metadata such as file permissions, owner, group, file size, and last modified time 
        --no-colors            Do not display any colors
        --no-git               Do not display Git status markers
        --no-icons             Do not display icons
    -n, --numbered             Label directory items with numbers
        --plain                Mute icons, Git markers, and colors to display a plain tree
    -s, --stats                Display traversal statistics after the tree is displayed
    -V, --version              Prints version information

OPTIONS:
        --export <export>                Export the tree to a file. Optionally include a target filename
        --max-depth <max-depth>          Set the maximum depth to recurse
        --max-filesize <max-filesize>    Set the maximum filesize (in bytes) to include in the tree
    -p, --pattern <pattern>              Only display items matching this pattern. Supports regex expressions