lstr
Fast minimalist directory tree viewer
TLDR
Display directory tree
$ lstr
Display tree for a specific path$ lstr [path/to/directory]
Launch interactive TUI mode$ lstr interactive
Show tree with Git status and respect .gitignore$ lstr -G -g
Show sizes, permissions and icons$ lstr -s -p --icons
Limit recursion depth$ lstr -L [2]
Sort by size, directories first$ lstr --sort size --dirs-first
SYNOPSIS
lstr [options] [path]lstr interactive [options] [path]
DESCRIPTION
lstr is a fast, minimalist directory tree viewer written in Rust. It scans directories in parallel and brings modern features to the classic tree command: `.gitignore` support, Git status indicators, Nerd Font icons, clickable hyperlinks, and multiple sort modes.The interactive subcommand launches a keyboard-driven TUI (built with ratatui) for browsing the tree. Non-interactive output is designed to pipe cleanly into tools like fzf.
PARAMETERS
-a, --all
List all files and directories, including hidden ones.-d, --dirs-only
Show directories only.-g, --gitignore
Respect `.gitignore` and other standard ignore files.-G, --git-status
Show Git status indicators for files and directories.--icons
Display file-specific icons (requires a Nerd Font).--hyperlinks
Render paths as clickable hyperlinks in supported terminals.-L, --level DEPTH
Limit the depth of the tree.-p, --permissions
Show file permissions (Unix-like systems).-s, --size
Show file sizes.--sort TYPE
Sort by name, size, modified, or extension.--dirs-first
List directories before files.--case-sensitive
Use case-sensitive sorting.--natural-sort
Use version-aware ("natural") sort ordering.-r, --reverse
Reverse the sort order.--dotfiles-first
Sort hidden files and folders first.--color WHEN
Colorize output (always, auto, never).--expand-level LEVEL
Initial expansion depth (interactive mode only).
INSTALL
brew install lstr
nix profile install nixpkgs#lstr
CAVEATS
Icon display requires a Nerd Font installed in the terminal.
HISTORY
lstr was created by bgreenwell and is written in Rust.
