List files with colors by file type and optional icons.
Good to know
Icons need a Nerd Font.
eza
A modern replacement for ls
Unclaimed
Built by @eza-community on GitHub. This page was written by @iluxav from public sources, last updated for v0.23.5 (2026-07-09), and may lag behind new releases.
Maintain eza? Claim itList files with colors, icons, Git status and a tree view, with a long view of extended details and themes set in a theme.yml file.
What you can do with it
See each file's Git status, or each directory's repository status, in the long view.
Show directories recursively as a tree with `-T`/`--tree`.
Show extended details such as permissions, sizes, dates, owners and extended attributes with `-l`.
Display entries as clickable hyperlinks with `--hyperlink`.
Set colors and icons in a `theme.yml` file, or use a pre-made theme.
List file names read from standard input with `--stdin`.
Count lines of code, comments and blanks by language with `--code`, or show them per file in the long view with `--loc`.
Good to know
Supports over 50 languages.
Before you upgrade
Newest firstv0.23.02025-07-18
Data piped into eza is no longer ignored: it is read as file names. Stop piping into eza in scripts that expected it to list the current directory.
v0.23.02025-07-18
`--grid` now prints a grid when output is piped instead of one entry per line; drop `--grid` from scripts that parse the output.
v0.22.02025-07-03
Use `--treat-dirs-as-files` instead of `--list-dirs`; the old name still works as an alias but will be removed.
Read the evidence
v0.22.02025-07-03
`-d` behavior was refined to be more consistent with `ls`.
Read the evidence
Release history 4
v0.23.52026-07-09
Count lines of code by language with `eza --code`.
Details
`--code` prints a summary of code, comment and blank lines by language; `--loc` adds lines-of-code and language columns to the long view, with `lines`, `percent` or `both` modes. `--hyperlink=auto` adds links only when output is a terminal.
v0.23.5.
Added: Count lines of code, comments and blanks by languag…Improved: Display entries as clickable hyperlinks with `--hyp…
Seeded by @iluxav with Claude Code (canido)
v0.23.02025-07-18
Pipe file names into eza and have them listed without extra flags.
Details
Data piped into eza is now read as file names automatically, and `eza --stdin` reads standard input; `--grid` now prints a grid even when output is not a terminal. Groups v0.22.1 and v0.23.0; the icon set was refreshed.
v0.23.0.
Action required: List file names read from standard input with `--st…Action required: List files with colors by file type and optional ic…
Seeded by @iluxav with Claude Code (canido)
v0.22.02025-07-03
List directories themselves instead of their contents, with `-d` working like ls.
Details
The `-d` flag now behaves more like `ls`, and its long name is `--treat-dirs-as-files`; `--list-dirs` stays as an alias that is to be removed in a future release.
v0.22.0.
Action required: List files with colors by file type and optional ic…Behavior changed: List files with colors by file type and optional ic…
Seeded by @iluxav with Claude Code (canido)
Read the evidence
v0.21.42025-05-30
Starting point
Starting point
List files with colors, icons and Git status in place of ls.
Details
State before the covered window: `eza` lists files with colors and icons (`--icons`), a long view (`-l`) with Git status (`--git`), a tree view (`-T`), hyperlinks (`--hyperlink`), reading file names from stdin (`--stdin`) and a `theme.yml` file for colors and icons.
v0.21.4 and earlier; packaged by most distributions.
Added: List files with colors by file type and optional ic…Added: See each file's Git status, or each directory's rep…Added: Show directories recursively as a tree with `-T`/`-…Added: Show extended details such as permissions, sizes, d…Added: Display entries as clickable hyperlinks with `--hyp…Added: Set colors and icons in a `theme.yml` file, or use…Added: List file names read from standard input with `--st…
Seeded by @iluxav with Claude Code (canido)