# Nat

> Use this skill when the user wants a beautiful file listing, list directory contents with icons and colors, or replace ls with a more visually appealing tool.

- Skill: `javimosch/nat` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/nat`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/nat/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/nat

---


# nat Plugin

nat - the 'ls' replacement you never knew you needed. A beautifully formatted file and directory listing tool with icons, colors, and git integration.

## Commands

### Directory Listing
- `nat dir list` — List directory contents beautifully

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

## Usage Examples
- "List files beautifully"
- "Pretty directory listing"
- "List with file icons"
- "Beautiful ls replacement"

## Installation

```bash
brew install nat
```

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

## Examples

```bash
# List current directory
nat dir list

# List specific directory
nat dir list ./my-project/

# Show hidden files
nat dir list --all

# Long format with icons
nat dir list --long --icons

# Any nat command with passthrough
nat _ _ .
nat _ _ --all --long
nat _ _ ~/Downloads --icons
```

## Key Features
- **Icons** - File type icons
- **Colors** - Syntax highlighting
- **Git** - Git integration
- **Pretty** - Beautiful output
- **Fast** - Fast performance
- **Permissions** - Permission colors
- **Sizes** - Human-readable sizes
- **Dates** - Relative dates
- **Symlinks** - Symlink display
- **Hidden** - Hidden file support

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