+1
Daily
16,290
stars
616
forks
72
watchers
554
prs
649
issues
31
releases
README
Special thanks to:
Maintained with ❤️ + 🤖 by Pochi
Pochi is an AI agent designed for software development.
It operates within your IDE, using a toolkit of commands to write and refactor code autonomously across your entire project.
---
[!IMPORTANT]
This is the documentation for the development version of lsd.
Please consult the documentation on the Tags page if you are looking for the documentation of individual releases.
The current newest release is: v1.2.0
LSD (LSDeluxe)
!lsd sample output
This project is a rewrite of GNU ls with lots of added features like colors, icons, tree-view, more formatting options etc.
The project is heavily inspired by the super colorls project.
Installation
Prerequisites
[!TIP]
Have a look at the Nerd Font README for help with installing Nerd Fonts
1. In order for icons to work you need to have a patched font like nerd-font or font-awesome installed on your machine and your terminal needs to be configured to use the patched font of your choosing.
2. If you intend to install lsd from source you need to have a working Rust toolchain (obviously) on your machine.
Installing with a package manager
Packaging status
Please consult the table below for the installation command associated with your package manager.
| OS/Distro | Command |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------|
| Archlinux | pacman -S lsd |
| Fedora | dnf install lsd |
| Gentoo | sudo emerge sys-apps/lsd |
| macOS | brew install lsd or sudo port install lsd |
| Nix (non NixOS) | nix-env -iA nixpkgs.lsd |
| NixOS | Add [environment.systemPackages = [ pkgs.lsd ];](https://search.nixos.org/packages?show=lsd) to your system config |
| FreeBSD | pkg install lsd |
| NetBSD or any pkgsrc platform | pkgin install lsd or cd /usr/pkgsrc/sysutils/lsd && make install |
| OpenBSD | pkg_add lsd |
| Windows | scoopTop issues
#609Don't convert from 16 to 256 colors in `LS_COLORS`34 comments · 2022-01-17#751Treat items starting with '_' the same as files starting with '.' and ignore them.15 comments · 2022-10-12#602Enchancement: Create a theme wiki15 comments · 2021-12-25#334"cannot access '.'" error on Windows14 comments · 2020-03-08#793User/Group: display only if different from default (or allow substitution filter)13 comments · 2023-01-15#498Unable to list the contents of a symbolic directory12 comments · 2021-03-10#533thousands separator for the --size=bytes option would be very useful11 comments · 2021-06-28#1107Unicode icons issue10 comments · 2024-11-19
Discussions
#1218custom fields: choice and order0 comments · 2026-06-15#1216ccline — AI help at your zsh prompt, for lsd users0 comments · 2026-06-10#1191Is there any plan to make it compatible with more of the `ls` parameters0 comments · 2026-03-03#1170Is there a way to change a single extiontion to a certian color?1 comments · 2025-11-20#1149Customization for improved visibility of dir output0 comments · 2025-07-24#1145Pager with --tree0 comments · 2025-07-06#1124How can I make ls only display files?1 comments · 2025-03-29#1119Is a new release coming soon?0 comments · 2025-02-03
Latest release
v1.2.0 v1.2.0 2025-10-12What's Changed Fixes and Improvements :bug: fix total size loop when using with -a by @zwpaper in https://github.com/lsd-rs/lsd/pull/1097 allow directroy-only + depth, fix 747 by @nim65s in https://github.com/lsd-rs/lsd/pull/864 Add space for executable construction icon by @Mersid in https://github.com/lsd-rs/lsd/pull/1068 Bump idna to 1.0 via url 2.5.4 due to vulnerability by @msrd0 in https://github.com/lsd-rs/lsd/pull/1114 Update lsd to Rust version 2024/1.85 and update certain associated crate's versions by @wbeebe in https://github.com/lsd-rs/lsd/pull/1153 :art: :hamme