lu -hut (Listing Utility) - is a powerful modern alternative to the Unix ls command that delivers directory listings with beautiful box-drawn tables, stunning tree format, intelligent colors, multiple sorting strategies, advanced filtering, and seamless git integration. Transform your file exploration from mundane to magnificent.

• Beautiful Box-Drawn Tables - Clean, box-drawn tables with colored borders for excellent readability.
• Hierarchical Directory Priority - Folders are prioritized at the top of the list for structured navigation.
• Stunning Tree View Display (-T) - Display directory structure in a beautiful tree format with all features supported. Tree view can be cancelled with Ctrl+C
• Dynamic Git Monitoring (-g) - Real-time tracking of file states (Untracked, Modified, Added) directly in the table.
• Time-Aware Color Grading (-t) - Intelligent color schemes based on file age to quickly identify recent changes.
• Exact Time Display (--exact-time) - Show precise modification timestamps instead of relative time.
• Size-Based Sorting (-S) - Sort files by size with directories prioritized.
• Extension-Based Sorting (-X) - Group files by their extensions for better organization.
• Transparent Object Visibility (-h) - Explicit monitoring of hidden files (internal metadata) for complete oversight.
• Unit Coordination Visibility (-u) - Detailed User and Group identification to maintain accountability.
• Advanced Filtering Capability - Strict inclusion and exclusion logic using glob patterns (-i, -x).
• Responsive Terminal Scaling - Adaptive output that maintains data integrity across different terminal widths.
• Safe Recursive Listing - Recursive directory traversal with depth limits and cancellation support.
• Octal Mode Display - Option to display file modes in octal format.
• Symlink Target Display - Symlink targets are shown inline as name -> target. Long targets are intelligently truncated and the tail is preserved.

"Ingin menjadi Lord sang 'penguasa' terminal? pakailah lu-hut"

Install:

brew tap ipanardian/tap
brew install lu-hut

Upgrade to latest version:

brew update
brew upgrade lu-hut

macOS and Linux:

curl -sSL https://raw.githubusercontent.com/ipanardian/lu-hut/main/install.sh | sudo bash

$ git clone https://github.com/ipanardian/lu-hut.git
$ cd lu-hut
$ make install

Ensure ~/bin is included in your system PATH for seamless execution.

Self-Update (Recommended):

# Check current version and available updates
$ lu version --check

# Update to the latest version
$ lu update

# Rollback to the previous version if needed
$ lu rollback

The update command will:

• Check GitHub releases for the latest version
• Download the appropriate binary for your system
• Automatically replace the current binary
• Create a backup of the previous version
• Verify the installation

Rollback:

If you encounter issues after updating, you can easily rollback to the previous version:

$ lu rollback

The rollback command will:

• Restore the previous version from backup
• Verify the rollback was successful

Update Notifications:

lu-hut checks for updates in the background when you run any lu command (once every 24 hours) and displays a notification if a new version is available. Simply run lu update to upgrade.

Execute the lu command to begin comprehensive directory monitoring.

# Standard listing
$ lu

# Git status
$ lu -g

# Sort by modification time (newest first)
$ lu -t

# Sort by size (largest first)
$ lu -S

# Sort by extension
$ lu -X

# Reverse sort order (size)
$ lu -Sr

# Show exact modification time
$ lu --exact-time

# Show octal permissions
$ lu -o

# Combine exact time with git status
$ lu --exact-time -g

# Tree view display
$ lu -T

# Tree view with git status
$ lu -Tg

# Tree view with max depth
$ lu -T -L 3

# Tree view with sorting
$ lu -T -S

# List recursive
$ lu -R

# List recursive with max depth
$ lu -R -L 10

# Filtered selection
$ lu -i "*.go" -x "*_test.go"

# Lord mode (Hidden, User, Time Sort)
$ lu -hut

When multiple sorting flags are specified, the priority order is:

1. Size (-S) - Highest priority
2. Extension (-X)
3. Modified Time (-t)
4. Name (default) - Lowest priority

Only one sorting mode is active at a time.

• Use --octal to show octal permissions instead of rwx.
• Use --exact-time for precise timestamps when auditing file changes
• Combine -S with -r to find smallest files first
• Use -X to group files by type for better organization
• Tree view supports all flags including git status, sorting, and filtering
• Recursive listing respects all filters and sorting options
• Symlink targets are shown inline as name -> target. When targets are long they will be truncated smartly to preserve the trailing path (the tail is usually the most informative).
• Press Ctrl+C during recursive listing to cancel safely

This software is an independent, open-source technical utility designed for directory management and data visualization. It does not represent the views of the author, nor do they imply any affiliation with, endorsement by, or intent to disparage any public figures. This tool is 100% functional and is provided as-is for professional use. Users are responsible for their own interpretation and application of this software.

GNU General Public License v3.0 - Copyright protected by Lord.

Key Points of GPL v3:

• Freedom to Use: You are free to use, run, and modify this software for any purpose.
• Freedom to Distribute: You are free to redistribute this software in its original or modified form.
• Copyleft Requirement: Any fork or derivative of this repository MUST use the same GPL v3 license.
• Author Attribution: You MUST NOT remove the author name from credits or copyright statements.
• Source Access: If you distribute this software (in modified form), you must provide access to the source code.
• License Compatibility: This software can only be combined with software that has a GPL v3-compatible license.