Skip to content

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.

Examples

Terminal window
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
Terminal window
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.