pls

A cute, colourful ls written in Go with Charm libraries.

• Human sizes — 384B, 1.2K, 3.4M (binary units)
• Relative times — just now, 2 days ago, 3 months ago
• Icons & colour — file-type aware (lipgloss adaptive palette)
• Git status — porcelain letters when inside a repo
• Tree view — --tree / -T with optional --level
• Interactive — -i Bubble Tea browser (navigate, filter, pick a file)

Install

cd pls
make install   # → $(go env GOPATH)/bin/pls
# or
make build     # → ./bin/pls

Use a Nerd Font in your terminal for the best icons.

Usage

pls                  # pretty grid
pls -l               # long listing
pls -la              # long + hidden
pls --tree --level 2
pls -l --git=always
pls -i               # interactive browser
pls -t -r            # newest first
pls --dirs-first src/

Flags

Flag	Description
-l	long format (mode, owner, size, relative time, …)
-a / -A	all / almost-all hidden files
-1	one column
-T / --tree	tree view
--level N	depth limit for tree / -R
-R	recursive
-S -t -X / --sort=	sort by size, time, extension, or name
--dirs-first	directories first
--bytes	raw sizes
--time-style=	relative (default), absolute, iso
--icons= --color= --git= --hyperlink=	auto | always | never
-i	interactive TUI

Piped output disables colour/icons by default and uses one column.

Interactive keys

Key	Action
j / k or arrows	move
Enter / l	open directory or select file
h / Backspace	parent directory
/	filter
.	toggle hidden
q / Esc	quit

Selecting a file prints its absolute path and exits (handy as a path picker).

License

MIT