terminal

Slatewave for LSD

A Slatewave palette for LSD — the next-gen ls, tinted slate and teal.

Latest release
0.0.2 · last month
Last commit
2 weeks ago
~/Development/getslatewave ⎇ main lsd -la --git --tree --depth=2
. d rwxr-xr-x kevin.langleyjr staff 512 B Mon Apr 27 00:09:29 2026 ── .
. - rw-r--r-- kevin.langleyjr staff 347 B Mon Apr 27 00:09:29 2026 ├── .env.example
. d rwxr-xr-x kevin.langleyjr staff 384 B Mon Apr 27 00:09:29 2026 ├── .git
! - rw-r--r-- kevin.langleyjr staff 316 B Mon Apr 27 00:09:29 2026 │ ├── config
! - rw-r--r-- kevin.langleyjr staff 73 B Mon Apr 27 00:09:26 2026 │ ├── description
! - rw-r--r-- kevin.langleyjr staff 21 B Mon Apr 27 00:09:26 2026 │ ├── HEAD
! d rwxr-xr-x kevin.langleyjr staff 512 B Mon Apr 27 00:09:29 2026 │ ├── hooks
! - rw-r--r-- kevin.langleyjr staff 8.8 KB Mon Apr 27 00:09:29 2026 │ ├── index
! d rwxr-xr-x kevin.langleyjr staff 96 B Mon Apr 27 00:09:26 2026 │ ├── info
! d rwxr-xr-x kevin.langleyjr staff 128 B Mon Apr 27 00:09:29 2026 │ ├── logs
! d rwxr-xr-x kevin.langleyjr staff 128 B Mon Apr 27 00:09:26 2026 │ ├── objects
! - rw-r--r-- kevin.langleyjr staff 112 B Mon Apr 27 00:09:29 2026 │ ├── packed-refs
! d rwxr-xr-x kevin.langleyjr staff 160 B Mon Apr 27 00:09:26 2026 │ └── refs
. d rwxr-xr-x kevin.langleyjr staff 96 B Mon Apr 27 00:09:29 2026 ├── .github
. d rwxr-xr-x kevin.langleyjr staff 96 B Mon Apr 27 00:09:29 2026 │ └── workflows
. - rw-r--r-- kevin.langleyjr staff 264 B Mon Apr 27 00:09:29 2026 ├── .gitignore
. d rwxr-xr-x kevin.langleyjr staff 128 B Mon Apr 27 00:09:29 2026 ├── .vscode
. - rw-r--r-- kevin.langleyjr staff 87 B Mon Apr 27 00:09:29 2026 │ ├── {} extensions.json
. - rw-r--r-- kevin.langleyjr staff 207 B Mon Apr 27 00:09:29 2026 │ └── {} launch.json
. - rw-r--r-- kevin.langleyjr staff 626 B Mon Apr 27 00:09:29 2026 ├── JS astro.config.mjs
. d rwxr-xr-x kevin.langleyjr staff 96 B Mon Apr 27 00:09:29 2026 ├── docs
. d rwxr-xr-x kevin.langleyjr staff 96 B Mon Apr 27 00:09:29 2026 │ └── roadmap
. - rw-r--r-- kevin.langleyjr staff 479 B Mon Apr 27 00:09:29 2026 ├── LICENSE
. - rw-r--r-- kevin.langleyjr staff 871 B Mon Apr 27 00:09:29 2026 ├── {} package.json
! - rw-r--r-- kevin.langleyjr staff 139 KB Mon Apr 27 00:09:29 2026 ├── YML pnpm-lock.yaml
. d rwxr-xr-x kevin.langleyjr staff 256 B Mon Apr 27 00:09:29 2026 ├── public
. - rw-r--r-- kevin.langleyjr staff 16 KB Mon Apr 27 00:09:29 2026 │ ├── apple-touch-icon.png
. d rwxr-xr-x kevin.langleyjr staff 192 B Mon Apr 27 00:09:29 2026 │ ├── brand
. - rw-r--r-- kevin.langleyjr staff 2.4 KB Mon Apr 27 00:09:29 2026 │ ├── favicon-32.png
. - rw-r--r-- kevin.langleyjr staff 24 KB Mon Apr 27 00:09:29 2026 │ ├── favicon.png
. - rw-r--r-- kevin.langleyjr staff 20 KB Mon Apr 27 00:09:29 2026 │ ├── icon-192.png
. - rw-r--r-- kevin.langleyjr staff 552 B Mon Apr 27 00:09:29 2026 │ └── site.webmanifest
. - rw-r--r-- kevin.langleyjr staff 2.7 KB Mon Apr 27 00:09:29 2026 ├── README.md
. d rwxr-xr-x kevin.langleyjr staff 288 B Mon Apr 27 00:09:29 2026 ├── src
. d rwxr-xr-x kevin.langleyjr staff 224 B Mon Apr 27 00:09:29 2026 │ ├── components
. d rwxr-xr-x kevin.langleyjr staff 128 B Mon Apr 27 00:09:29 2026 │ ├── content
. - rw-r--r-- kevin.langleyjr staff 2.7 KB Mon Apr 27 00:09:29 2026 │ ├── TS content.config.ts
. d rwxr-xr-x kevin.langleyjr staff 128 B Mon Apr 27 00:09:29 2026 │ ├── layouts
. d rwxr-xr-x kevin.langleyjr staff 288 B Mon Apr 27 00:09:29 2026 │ ├── lib
. d rwxr-xr-x kevin.langleyjr staff 320 B Mon Apr 27 00:09:29 2026 │ ├── pages
. d rwxr-xr-x kevin.langleyjr staff 192 B Mon Apr 27 00:09:29 2026 │ └── styles
. - rw-r--r-- kevin.langleyjr staff 201 B Mon Apr 27 00:09:29 2026 └── {} tsconfig.json
~/Development/getslatewave ⎇ main

About this theme

LSD splits its output into column roles — owner, permissions, size, date, git status, tree edges — and Slatewave recolors each so the row reads at a glance. Teal for read, amber for write, rose for exec; teal for fresh dates, slate for old; tree edges recede and filenames lead.

Slatewave for LSD recolors the column roles LSD already exposes — owner, group, permissions, size, date, git status, tree edges — so the row reads spatially: teal for read, amber for write, rose for exec; teal-300 for hour-old dates fading to slate-400 for older ones; slate for small files warming to amber for large.

File-type colors (directories, symlinks, archives, media) are driven by LS_COLORS, so Slatewave composes with whatever LS_COLORS generator you already use — vivid, trapd00r/LS_COLORS, or the default. The theme tunes against LSD 1.0+, which accepts #rrggbb hex alongside the legacy named colors and ANSI 256 indices.

Pair with a Nerd Font

Optional — set icons.theme to fancy in ~/.config/lsd/config.yaml for the icon glyphs. Falls back to unicode cleanly when no Nerd Font is installed.

Pair with LS_COLORS

Slatewave handles the column roles; LS_COLORS handles file-type colors. A common combination:

export LS_COLORS="$(vivid generate molokai)"

Install

Don't have the CLI yet? Install the Slatewave CLI →

  • Slatewave CLI

    Install with the Slatewave family CLI — one command, every theme.

    slatewave install lsd
  • curl

    Drop colors.yaml into ~/.config/lsd/ without cloning. Requires LSD ≥ 1.0 (hex color support in colors.yaml).

    mkdir -p ~/.config/lsd && curl -fsSL https://raw.githubusercontent.com/kevinlangleyjr/lsd-slatewave/main/colors.yaml -o ~/.config/lsd/colors.yaml
  • Clone

    Clone the repo and symlink colors.yaml into LSD's config directory.

    1. git clone https://github.com/kevinlangleyjr/lsd-slatewave.git ~/.config/lsd-slatewave
    2. mkdir -p ~/.config/lsd
    3. ln -sf ~/.config/lsd-slatewave/colors.yaml ~/.config/lsd/colors.yaml
  • Activate

    LSD only consults colors.yaml when told to use a custom theme — edit ~/.config/lsd/config.yaml.

    1. Open or create ~/.config/lsd/config.yaml
    2. Add: color.when set to auto
    3. Add: color.theme set to custom
    4. Run lsd -la --git --tree --depth 2 to verify