terminal

Slatewave for tmux

A status bar and pane styling for tmux, with powerline pill transitions.

Latest release
0.0.2 · 2 months ago
Last commit
3 weeks ago
# ~/.tmux.conf
source-file ~/.config/tmux/slatewave/slatewave.tmux.conf

# Layout: [session]  1:editor  2:server  [3:logs]    PREFIX  Wed Apr 22  3:04 PM
# - Session pill: teal on slate
# - Active window: teal text on chrome-light
# - Prefix indicator: rose, only while prefix key is held
# - Right side: prefix → date → 12-hour clock

set -g @plugin 'tmux-plugins/tmux-sensible'
set -g prefix C-a
bind-key r source-file ~/.tmux.conf \; display-message "reloaded"

About this theme

A complete tmux theme — status bar, window list, pane borders, copy mode, command prompt, menus, popups, and the built-in clock — all tuned to the Slatewave palette. Works as a drop-in config or a TPM plugin.

Slatewave for tmux covers every surface the multiplexer exposes — status bar, window list pills, pane borders, copy mode, the command prompt, menus, popups, and even the built-in clock. Session name and active window get the teal signature; inactive windows sit in muted slate; the prefix indicator lights up rose while the key is held.

Works on top of any Slatewave terminal (Ghostty, iTerm2, Alacritty, Kitty, WezTerm) for an edge-to-edge palette match — or standalone on any truecolor terminal. Requires tmux 3.2+ for copy-mode-match-style, popup-style, and modern #{?} formatting.

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 tmux
  • TPM

    With tmux plugin manager, add the plugin and fetch with prefix + I. Requires tmux ≥ 3.2 and a Nerd Font for the powerline pill transitions.

    1. Add to ~/.tmux.conf — `set -g @plugin 'kevinlangleyjr/tmux-slatewave'`
    2. Reload tmux, then press prefix + I to install
  • Clone

    Clone the repo for sourcing from your main tmux config. slatewave.tmux.conf is a plain set of `set -g` lines, each commented with the palette values it uses — so partial adoption is safe if you only want some blocks.

    git clone https://github.com/kevinlangleyjr/tmux-slatewave.git ~/.config/tmux/slatewave
  • Activate

    After Clone — add the source-file line and reload.

    1. Add to ~/.tmux.conf — `source-file ~/.config/tmux/slatewave/slatewave.tmux.conf`
    2. Reload — `tmux source-file ~/.tmux.conf` (or prefix + r if bound)