This skill should be used when the user asks about "terminal opacity", "terminal blur", "wezterm opacity", "acrylic", "background blur", "cursor style", "cursor blink", "terminal theme", "color scheme", "catppuccin", "wezterm colors", "inactive pane", "window padding", or mentions visual customization of WezTerm.
View on GitHubplugins/wezterm-dev/skills/wezterm-visual/SKILL.md
February 2, 2026
Select agents to install to:
npx add-skill https://github.com/nthplusio/functional-claude/blob/main/plugins/wezterm-dev/skills/wezterm-visual/SKILL.md -a claude-code --skill wezterm-visualInstallation paths:
.claude/skills/wezterm-visual/# WezTerm Visual Customization
Configure visual appearance: opacity, blur, cursor, colors, and themes.
## Background Opacity and Blur
### Windows 11 Acrylic Effect
```lua
config.window_background_opacity = 0.92
config.win32_system_backdrop = 'Acrylic' -- Windows 11 acrylic blur
```
### macOS Blur
```lua
config.window_background_opacity = 0.9
config.macos_window_background_blur = 20
```
### Values
- `window_background_opacity`: 0.0 (transparent) to 1.0 (opaque)
- `macos_window_background_blur`: 0 to 100+
## Inactive Pane Dimming
Dim inactive panes for visual focus:
```lua
config.inactive_pane_hsb = {
saturation = 0.8, -- 0.0 = grayscale, 1.0 = full color
brightness = 0.7, -- 0.0 = black, 1.0 = normal
}
```
## Cursor Styling
```lua
config.default_cursor_style = 'BlinkingBar' -- Bar, Block, Underline + Blinking variants
config.cursor_blink_rate = 500 -- milliseconds
config.cursor_blink_ease_in = 'Constant' -- or 'Linear', 'EaseIn', 'EaseOut'
config.cursor_blink_ease_out = 'Constant'
config.force_reverse_video_cursor = true -- cursor color inverts text
```
### Cursor Shapes
- `SteadyBlock` / `BlinkingBlock`
- `SteadyBar` / `BlinkingBar`
- `SteadyUnderline` / `BlinkingUnderline`
## Window Padding
```lua
config.window_padding = {
left = 4,
right = 4,
top = 4,
bottom = 4,
}
```
## Color Scheme
### Built-in Schemes
```lua
config.color_scheme = 'Catppuccin Mocha'
```
Popular options: `Catppuccin Mocha`, `Dracula`, `One Dark`, `Gruvbox Dark`, `Tokyo Night`
### Catppuccin Mocha Palette
```lua
local colors = {
base = '#1e1e2e',
surface0 = '#313244',
surface1 = '#45475a',
overlay0 = '#6c7086',
text = '#cdd6f4',
subtext0 = '#a6adc8',
green = '#a6e3a1',
yellow = '#f9e2af',
blue = '#89b4fa',
mauve = '#cba6f7',
peach = '#fab387',
red = '#f38ba8',
teal = '#94e2d5',
}
```
### Custom Colors
```lua
config.colors = {
foreground = '#cdd6f4',
background = '#1