# Lsd

> Use this skill when the user wants a modern ls replacement with icons, colors, tree view, or git-integrated directory listings.

- Skill: `javimosch/lsd` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/lsd`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/lsd/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/lsd

---


# lsd Plugin

The next gen ls command. Modern ls with colors, icons, tree view, and git integration for a more visually appealing directory listing.

## Commands

### Directory Listing
- `lsd dir list` — List directory with icons and colors

### Utility
- `lsd _ _` — Passthrough to lsd CLI

## Usage Examples
- "List files with icons"
- "Modern ls with colors"
- "Tree view listing"
- "Git-aware directory list"

## Installation

```bash
brew install lsd
```

Or via Cargo:
```bash
cargo install lsd
```

Requires Nerd Font for icons.

## Examples

```bash
# List current directory
lsd dir list

# List with icons
lsd dir list --icons

# Long format
lsd dir list --long

# Tree view
lsd dir list --tree

# Show hidden files
lsd dir list --all

# Any lsd command with passthrough
lsd _ _ ~/Downloads --long --icons
lsd _ _ --tree --depth 3
lsd _ _ --all --long --git
```

## Key Features
- **Icons** - File type icons
- **Colors** - Syntax highlighting
- **Tree** - Tree view
- **Git** - Git integration
- **Permissions** - Permission colors
- **Sizes** - Human-readable sizes
- **Dates** - Relative dates
- **Symlinks** - Symlink display
- **Hidden** - Hidden file support
- **Themes** - Theme support

## Notes
- Requires Nerd Font for icons
- Drop-in ls replacement
- Great for terminal productivity
- Configurable display options