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 NOCOLOR and CLICOLOR_FORCE environment variables that can be used forcefully disable or enable colors respectively.

Examples

Terminal window
env NOCOLOR=true pls # or pls | cat
​Link# T Permissions User   Group      Size Modified            Name
    2 d rwx r-x r-x runner docker          2024-Sep-07 07:33am   dir/
    1 l rwx rwx rwx runner docker 10.0   B 2024-Sep-07 07:33am 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner docker  9.0   B 2024-Sep-07 07:33am 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner docker  0.0   B 2024-Sep-07 07:33am    fifo|
    1 f rw- r-- r-- runner docker  1.0 MiB 2024-Sep-07 07:33am    file
    1 s rwx r-x r-x runner docker  0.0   B 2024-Sep-07 07:33am    socket=
    1 l rwx rwx rwx runner docker  5.0   B 2024-Sep-07 07:33am 󰌹  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-Sep-07 07:33am   dir/
    1 l rwx rwx rwx runner docker 10.0   B 2024-Sep-07 07:33am 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner docker  9.0   B 2024-Sep-07 07:33am 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner docker  0.0   B 2024-Sep-07 07:33am    fifo|
    1 f rw- r-- r-- runner docker  1.0 MiB 2024-Sep-07 07:33am    file
    1 s rwx r-x r-x runner docker  0.0   B 2024-Sep-07 07:33am    socket=
    1 l rwx rwx rwx runner docker  5.0   B 2024-Sep-07 07:33am 󰌹  sym@ 󰁔 ./dir