Colors

pls makes a lot of use of colors throughout the output. This makes it very easy to grok the output and also makes it look pretty.

Environment

By default pls will display colors if the terminal supports it and will disable colors if the output is being piped to another command.

pls also respects the NO_COLOR and CLICOLOR_FORCE environment variables that can be used forcefully disable or enable colors respectively.

Caution

Turning off colors also turns off other ANSI-based styling such as bold, italic underlines etc.

Examples

env NO_COLOR=true pls # or pls | cat

Link# T Permissions User   Group      Size Modified            Name
    2 d rwx r-x r-x runner runner          2026-Feb-06 08:26am   dir/
    1 l rwx rwx rwx runner runner 10.0   B 2026-Feb-06 08:26am 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner runner  9.0   B 2026-Feb-06 08:26am 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner runner  0.0   B 2026-Feb-06 08:26am 󰟥  fifo|
    1 f rw- r-- r-- runner runner  1.0 MiB 2026-Feb-06 08:26am    file
    1 s rwx r-x r-x runner runner  0.0   B 2026-Feb-06 08:26am 󰟨  socket=
    1 l rwx rwx rwx runner runner  5.0   B 2026-Feb-06 08:26am 󰌹  sym@ 󰁔 ./dir

pls # or env CLICOLOR_FORCE=true pls | cat

Link# T Permissions User   Group      Size Modified            Name
    2 d rwx r-x r-x runner runner          2026-Feb-06 08:26am   dir/
    1 l rwx rwx rwx runner runner 10.0   B 2026-Feb-06 08:26am 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner runner  9.0   B 2026-Feb-06 08:26am 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner runner  0.0   B 2026-Feb-06 08:26am 󰟥  fifo|
    1 f rw- r-- r-- runner runner  1.0 MiB 2026-Feb-06 08:26am    file
    1 s rwx r-x r-x runner runner  0.0   B 2026-Feb-06 08:26am 󰟨  socket=
    1 l rwx rwx rwx runner runner  5.0   B 2026-Feb-06 08:26am 󰌹  sym@ 󰁔 ./dir