Home

sravioli/wezterm

A modular WezTerm configuration written in Lua. It adds a Vim-style key layer, responsive status bars, Lantern selectors, and a small plugin stack around WezTerm's Lua config.

Requires WezTerm nightly

Features

Feature	Description
Responsive status bar	Battery, clock, hostname, cwd, mode, and key hints adapt to available width
6 modal modes	Copy, Search, Font, Window, Lantern, and Help modes with tab bar hints
11 Lantern selectors	Colorschemes, fonts, GPU, opacity, padding, cursor, ligatures, tab style
Vim-style keybindings	<C-Space> leader key with Chord translating Vim notation to WezTerm keys
Plugin-backed UI	Ribbon formats segments, Sigil provides icons, Warp/Memo/Log handle helpers
Override system	Local changes live in overrides/ instead of core files
Cross-platform defaults	Windows, Linux, macOS, WSL, GPU, and font-aware defaults
Smart tab bar	Process/directory detection, Neovim integration, shell-aware formatting

Quick start

After installing the configuration, press Ctrl+Space then h to enter Help mode and see the available keybindings.

Common leader combos:

Keys	Mode
<C-Space> h	Help - shows default keybindings
<C-Space> w	Window - pane management
<C-Space> p	Lantern - colorscheme, font, GPU, appearance
<C-Space> f	Font - adjust font size
<C-Space> c	Copy - Vim-style text selection
<C-Space> s	Search - pattern matching

Navigate the wiki

Using the config Keybindings - All keymaps, modal tables, defaults Customization - Overrides, custom wicks, themes, status bar Recipes - Practical examples and tips

Reference and help Architecture - Project structure, load order, patterns Platform Setup - Windows, Linux, macOS specifics Troubleshooting - FAQ and common issues Contributing - How to contribute