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

Section titled “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

Section titled “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 runner          2026-Mar-25 07:45pm   dir/
    1 l rwx rwx rwx runner runner 10.0   B 2026-Mar-25 07:45pm 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner runner  9.0   B 2026-Mar-25 07:45pm 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner runner  0.0   B 2026-Mar-25 07:45pm 󰟥  fifo|
    1 f rw- r-- r-- runner runner  1.0 MiB 2026-Mar-25 07:45pm    file
    1 s rwx r-x r-x runner runner  0.0   B 2026-Mar-25 07:45pm 󰟨  socket=
    1 l rwx rwx rwx runner runner  5.0   B 2026-Mar-25 07:45pm 󰌹  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 runner          2026-Mar-25 07:45pm  dir/
    1 l rwx rwx rwx runner runner 10.0   B 2026-Mar-25 07:45pm 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner runner  9.0   B 2026-Mar-25 07:45pm 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner runner  0.0   B 2026-Mar-25 07:45pm 󰟥  fifo|
    1 f rw- r-- r-- runner runner  1.0 MiB 2026-Mar-25 07:45pm    file
    1 s rwx r-x r-x runner runner  0.0   B 2026-Mar-25 07:45pm 󰟨  socket=
    1 l rwx rwx rwx runner runner  5.0   B 2026-Mar-25 07:45pm 󰌹  sym@ 󰁔 ./dir