peek is a modern, customizable, and extensible ls replacement written in Rust. It supports file listing, tree view, size formatting, filtering, and more — with beautiful color output.

• 📁 Basic file listing (like ls)
• 🎨 Colored output with custom folder color (hex)
• 📦 File size display (--size or -s)
• 🧾 Long format listing (--long or -l) with permissions, size, UID, GID, and modified time
• 🌲 Tree view (--tree or -t) with optional --depth N
• 👻 Show hidden files (--all or -a)
• 🔍 Glob pattern filtering (--pattern or -p)
• 🧠 Persistent color configuration saved in ~/.peekconfig

peek

peek --size
peek -s

peek --long
peek -l

peek --tree
peek -t

peek -t --depth 2

peek --all
peek -a

peek --dir-color FF00FF
peek --dir-color "#00FFFF"

(This is saved persistently in ~/.peekconfig)

peek -p "*.rs"           # match all .rs files in current dir
peek -t -p "**/*.rs"     # match recursively all .rs files
peek -a -p "*lib*"       # match files with 'lib' in the name

1. Make sure you have Rust installed:

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Clone and build:

   git clone https://github.com/yourname/peek.git
   cd peek
   cargo build --release

3. Optionally copy the binary to your bin directory:

   cp target/release/peek ~/.local/bin/

Configuration is stored in a JSON file at:

~/.peekconfig

Example content:

{
  "dir_color": "FF00FF"
}

• Recursive search (--recursive)
• Output to JSON format
• Sort by size/date/name

MIT