To run pls, type the command into any terminal.

$ pls

By default, pls lists the contents of the current working directory, but you can pass a different file or directory to pls as an argument.

If a directory path is passed, all the files and directories within that directory are listed. This is useful to see what's in the folder.

$ pls <directory>

If a file path is passed, only the file itself is listed. This is useful in conjunction with the --details flag to see more attributes about the file.

$ pls <file>


To get help, run pls with the --help/-h flag or read this documentation!

$ pls --help
$ pls -h