# athityakumar/colorls

A Ruby gem that beautifies the terminal's ls command, with color and font-awesome icons. :tada:

Repository: https://github.com/athityakumar/colorls
Canonical: https://ross.abutalabs.com/products/colorls
Language: Ruby
License: MIT
License Family: permissive
Topics: color, icons, ls, terminal, ruby, cli, gem, eye-candy
Last push: 2026-07-27T11:41:05+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 94, release rhythm 8, longevity 100
- inputs: {"age_days": 3352, "days_push": 37, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5134, forks 396 (observed 2026-08-28T04:09:11.064019+00:00)

## What it is
A Ruby gem that replaces the standard ls command with a colorized version that adds font-awesome icons to file and directory listings. It supports familiar ls flags plus extras like tree view, git status, and sorting options.

## Use cases
- beautify terminal ls output with colors and icons
- show file type icons in directory listings
- list files in a tree view from the command line
- show git status alongside ls output
- group directories before files when listing

## When to choose
- you want a prettier, icon-rich alternative to ls
- you already use Ruby and want an easy gem install
- you want ls-compatible flags plus tree and git-status views

## When to avoid
- you need maximum performance for huge directory listings
- you cannot install a Nerd Font for icon support
- you want a non-Ruby dependency-free tool

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, developer-tools
- domain: developer-tools
- platform: cli, windows
- tags: ls, color, icons, ruby-gem, terminal, eye-candy, command-line, macos, linux

## Member repositories
- athityakumar/colorls (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:11.064019+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:02:01.654904+00:00, confidence not recorded.
  - readme: https://github.com/athityakumar/colorls (fetched 2026-08-28T04:09:11.064019+00:00, sha b3cbf7b166db)
- Data as of 2026-08-30T08:39:29.467469+00:00.