OS Manuals

/usr/bin/eza

A modern, maintained replacement for ls

From eza 0.23.5-r6 (os), captured 2026-11-05 by running eza --help (exit 0). permalink

A modern replacement for ls

Usage: eza [OPTIONS] [FILE]...

META OPTIONS:
      --stdin    read file names from stdin
  -?, --help     Print help
  -v, --version  Print help

LAYOUT OPTIONS:
  -1, --oneline          display one entry per line
  -l, --long             display extended file metadata as a table
  -G, --grid             display entries as a grid (default)
  -x, --across           sort the grid across, rather than downwards
  -R, --recurse          recurse into directories
  -T, --tree             recurse into directories as a tree
  -L, --level <DEPTH>    limit the depth of recursion
      --code[=<MODE>]    summarise lines of code by language, recursing the tree or git repo
      --follow-symlinks  drill down into symbolic links that point to directories
  -w, --width <COLS>     set screen width in columns

DISPLAY OPTIONS:
  -F, --classify [<WHEN>]          display type indicator by file names [possible values: always, auto, never]
  -X, --dereference                dereference symbolic links when displaying information
      --absolute [<absolute>]      display entries with their absolute path [possible values: on, off, follow]
      --color [<WHEN>]             When to use colours. [default: auto] [possible values: always, auto, never]
      --color-scale [<FIELDS>...]  highlight value of FIELDS distinctly [possible values: all, age, size]
      --color-scale-mode <MODE>    mode for --color-scale [default: gradient] [possible values: fixed, gradient]
      --icons [<WHEN>]             when to display icons [possible values: always, auto, never]
      --hyperlink [<WHEN>]         when to display entries as hyperlinks [possible values: always, auto, never]
      --no-quotes                  don't quote file names with spaces
      --short-nix                  abbreviate Nix store hashes in file names and paths

FILTERING OPTIONS:
  -a, --all...               show hidden files. Use this twice to also show the '.' and '..' directories
  -A, --almost-all           equivalent to --all; included for compatibility with `ls -A`
  -d, --treat-dirs-as-files  treat directories as files; don't list their contents
  -D, --only-dirs            list only directories
  -f, --only-files           list only files
      --show-symlinks        explicitly show symbolic links (with --only-dirs and --only-files)
      --no-symlinks          do not show symbolic links
  -I, --ignore-glob <GLOBS>  glob patterns (pipe-separated) of files to ignore
      --git-ignore           ignore files mentioned in '.gitignore'

SORTING OPTIONS:
      --group-directories-first  list directories before other files
      --group-directories-last   list directories after other files
  -s, --sort <FIELD>             which field to sort by [default: name] [possible values:
                                   name, Name, .name, .Name, ext, ext, created,
                                   date, age, accessed, changed,
                                   size, inode, type, none]
  -r, --reverse                  reverse the sort order

LONG VIEW OPTIONS:
  -h, --header               add a header row to each column
  -i, --inode                list each file's inode number
      --loc[=<MODE>]         add lines-of-code and language columns [modes: lines, percent, both]
  -o, --octal-permissions    list each file's permission in octal format
  -H, --links                list each file's number of hard links
  -b, --binary               show file sizes with binary prefixes
  -B, --bytes                show file sizes in bytes, without any prefixes
      --total-size           show the size of a directory as the one of its content (unix only)
  -S, --blocksize            list size of allocated file system blocks
  -g, --group                list each file's group
      --smart-group          only show group if it has a different name from owner
  -n, --numeric              show user and group as their numeric IDs
  -t, --time <FIELD>         which timestamp field to show [possible values:
                               mod|modified, acc|accessed, ch|changed, cr|created]
  -m, --modified             show the modified timestamp field (replace default field, combinable)
  -u, --accessed             show the accessed timestamp field (replace default field, combinable)
      --changed              show the changed timestamp field (replace default field, combinable)
  -U, --created              show the created timestamp field (replace default field, combinable)
      --time-style <STYLE>   how to format timestamps [possible values:
                               default, iso, long-iso, full-iso, relative, "+<CUSTOM_FORMAT>"]
  -O, --flags                list file flags (Mac, BSD, and Windows only)
  -Z, --context              list each file's security context
      --git                  list each file's Git status, if tracked or ignored
      --git-repos            list root of git-tree status
      --git-repos-no-status  list each git-repos branch name (much faster)
  -M, --mounts               show mount details (Linux and macOS only)
  -@, --extended             list each file's extended attributes and sizes
      --no-permissions       suppress the permissions field
      --no-filesize          suppress the filesize field
      --no-user              suppress the user field
      --no-time              suppress the time field
      --no-git               suppress Git fields (overrides --git, --git-repos, --git-repos-no-status)
Options (66)
OptionDescriptionSource
--stdinread file names from stdinhelp
-?, --helpPrint helphelp
-v, --versionPrint helphelp
-1, --onelinedisplay one entry per linehelp
-l, --longdisplay extended file metadata as a tablehelp
-G, --griddisplay entries as a grid (default)help
-x, --acrosssort the grid across, rather than downwardshelp
-R, --recurserecurse into directorieshelp
-T, --treerecurse into directories as a treehelp
-L, --level DEPTHlimit the depth of recursionhelp
--code MODEsummarise lines of code by language, recursing the tree or git repohelp
--follow-symlinksdrill down into symbolic links that point to directorieshelp
-w, --width COLSset screen width in columnshelp
-F, --classify WHENdisplay type indicator by file names [possible values: always, auto, never]help
-X, --dereferencedereference symbolic links when displaying informationhelp
--absolute absolutedisplay entries with their absolute path [possible values: on, off, follow]help
--color WHENWhen to use colours.help
--color-scale FIELDS>...highlight value of FIELDS distinctly [possible values: all, age, size]help
--color-scale-mode MODEmode for --color-scale [default: gradient] [possible values: fixed, gradient]help
--icons WHENwhen to display icons [possible values: always, auto, never]help
--hyperlink WHENwhen to display entries as hyperlinks [possible values: always, auto, never]help
--no-quotesdon't quote file names with spaceshelp
--short-nixabbreviate Nix store hashes in file names and pathshelp
-a, --allshow hidden files.help
-A, --almost-allequivalent to --all;help
-d, --treat-dirs-as-filestreat directories as files;help
-D, --only-dirslist only directorieshelp
-f, --only-fileslist only fileshelp
--show-symlinksexplicitly show symbolic links (with --only-dirs and --only-files)help
--no-symlinksdo not show symbolic linkshelp
-I, --ignore-glob GLOBSglob patterns (pipe-separated) of files to ignorehelp
--git-ignoreignore files mentioned in '.gitignore'help
--group-directories-firstlist directories before other fileshelp
--group-directories-lastlist directories after other fileshelp
-s, --sort FIELDwhich field to sort by [default: name] [possible values: name, Name, .name, .Name, ext, ext, created, date, age, accessed, changed, size, inode, type, none]help
-r, --reversereverse the sort orderhelp
-h, --headeradd a header row to each columnhelp
-i, --inodelist each file's inode numberhelp
--loc MODEadd lines-of-code and language columns [modes: lines, percent, both]help
-o, --octal-permissionslist each file's permission in octal formathelp
-H, --linkslist each file's number of hard linkshelp
-b, --binaryshow file sizes with binary prefixeshelp
-B, --bytesshow file sizes in bytes, without any prefixeshelp
--total-sizeshow the size of a directory as the one of its content (unix only)help
-S, --blocksizelist size of allocated file system blockshelp
-g, --grouplist each file's grouphelp
--smart-grouponly show group if it has a different name from ownerhelp
-n, --numericshow user and group as their numeric IDshelp
-t, --time FIELDwhich timestamp field to show [possible values: mod|modified, acc|accessed, ch|changed, cr|created]help
-m, --modifiedshow the modified timestamp field (replace default field, combinable)help
-u, --accessedshow the accessed timestamp field (replace default field, combinable)help
--changedshow the changed timestamp field (replace default field, combinable)help
-U, --createdshow the created timestamp field (replace default field, combinable)help
--time-style STYLEhow to format timestamps [possible values: default, iso, long-iso, full-iso, relative, "+<CUSTOM_FORMAT>"]help
-O, --flagslist file flags (Mac, BSD, and Windows only)help
-Z, --contextlist each file's security contexthelp
--gitlist each file's Git status, if tracked or ignoredhelp
--git-reposlist root of git-tree statushelp
--git-repos-no-statuslist each git-repos branch name (much faster)help
-M, --mountsshow mount details (Linux and macOS only)help
-@, --extendedlist each file's extended attributes and sizeshelp
--no-permissionssuppress the permissions fieldhelp
--no-filesizesuppress the filesize fieldhelp
--no-usersuppress the user fieldhelp
--no-timesuppress the time fieldhelp
--no-gitsuppress Git fields (overrides --git, --git-repos, --git-repos-no-status)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.