Skip to content
pls

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.

Examples

Terminal window
env NO_COLOR=true pls # or pls | cat
​Link# T Permissions User   Group      Size Modified            Name
    2 d rwx r-x r-x runner docker          2024-Nov-06 09:01pm   dir/
    1 l rwx rwx rwx runner docker 10.0   B 2024-Nov-06 09:01pm 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner docker  9.0   B 2024-Nov-06 09:01pm 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner docker  0.0   B 2024-Nov-06 09:01pm 󰟥  fifo|
    1 f rw- r-- r-- runner docker  1.0 MiB 2024-Nov-06 09:01pm    file
    1 s rwx r-x r-x runner docker  0.0   B 2024-Nov-06 09:01pm 󰟨  socket=
    1 l rwx rwx rwx runner docker  5.0   B 2024-Nov-06 09:01pm 󰌹  sym@ 󰁔 ./dir
Terminal window
pls # or env CLICOLOR_FORCE=true pls | cat
​Link# T Permissions User   Group      Size Modified            Name
    2 d rwx r-x r-x runner docker          2024-Nov-06 09:01pm  dir/
    1 l rwx rwx rwx runner docker 10.0   B 2024-Nov-06 09:01pm 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner docker  9.0   B 2024-Nov-06 09:01pm 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner docker  0.0   B 2024-Nov-06 09:01pm 󰟥  fifo|
    1 f rw- r-- r-- runner docker  1.0 MiB 2024-Nov-06 09:01pm    file
    1 s rwx r-x r-x runner docker  0.0   B 2024-Nov-06 09:01pm 󰟨  socket=
    1 l rwx rwx rwx runner docker  5.0   B 2024-Nov-06 09:01pm 󰌹  sym@ 󰁔 ./dir