Header

pls shows headers above columns to help understand the output better. If not set, these headers intelligently appear when they are needed.

Arguments

--header/-H can be used to turn headers on or off. It is turned on by default if the details view is enabled.

Caution

This flag has no effect unless the detail view is enabled with --det/-d.

Examples

pls --det=std # or --header=true or -H=true

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

pls --det=std --header=false # or -H=false

2 d rwx r-x r-x runner docker          2025-Apr-15 05:15pm   dir/
1 l rwx rwx rwx runner docker 10.0   B 2025-Apr-15 05:15pm 󰌹  block_dev@ 󱞣 /dev/disk0
1 l rwx rwx rwx runner docker  9.0   B 2025-Apr-15 05:15pm 󰌹  char_dev@ 󰁔 /dev/null
1 p rw- r-- r-- runner docker  0.0   B 2025-Apr-15 05:15pm 󰟥  fifo|
1 f rw- r-- r-- runner docker  1.0 MiB 2025-Apr-15 05:15pm    file
1 s rwx r-x r-x runner docker  0.0   B 2025-Apr-15 05:15pm 󰟨  socket=
1 l rwx rwx rwx runner docker  5.0   B 2025-Apr-15 05:15pm 󰌹  sym@ 󰁔 ./dir

Configuration

Using the configuration system, you can modify the column headers and change their appearance using styling rules.

See the detail view configuration for an example.