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 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 --det=std --header=false # or -H=false

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

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.