This skill should be used when the user asks to "configure WezTerm", "wezterm config", "customize terminal", "set up wezterm", "wezterm lua", or mentions general WezTerm configuration questions. For specific topics, focused skills may be more appropriate.
From wezterm-devnpx claudepluginhub nthplusio/functional-claude --plugin wezterm-devThis skill uses the workspace's default tool permissions.
examples/wezterm-complete.luareferences/agent-deck.mdreferences/nerd-font-icons.mdreferences/status-bar.mdreferences/tab-formatting.mdDispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
Configure and customize WezTerm terminal emulator with Lua, focusing on Claude Code workflows.
Always create a dated backup before modifying the WezTerm config.
cp ~/.wezterm.lua ~/.wezterm.lua.bak.$(date +%Y-%m-%d)
Windows PowerShell:
Copy-Item "$env:USERPROFILE\.wezterm.lua" "$env:USERPROFILE\.wezterm.lua.bak.$(Get-Date -Format 'yyyy-MM-dd')"
~/.wezterm.lua (Windows: C:\Users\<username>\.wezterm.lua)
local wezterm = require 'wezterm'
local config = wezterm.config_builder()
-- Font and appearance
config.font = wezterm.font('FiraCode Nerd Font')
config.font_size = 10
config.color_scheme = 'Catppuccin Mocha'
-- Window settings
config.initial_cols = 120
config.initial_rows = 28
config.window_padding = { left = 4, right = 4, top = 4, bottom = 4 }
return config
For specific configuration topics, use these focused skills:
| Topic | Skill | Trigger Phrases |
|---|---|---|
| Keybindings | /wezterm-dev:wezterm-keybindings | "leader key", "tmux-style", "pane splitting" |
| Visual Customization | /wezterm-dev:wezterm-visual | "opacity", "blur", "cursor", "colors", "theme" |
| Tab Bar | /wezterm-dev:wezterm-tabs | "tab bar", "nerd font icons", "process icons" |
| Agent Deck | /wezterm-dev:wezterm-agent-deck | "agent deck", "claude monitoring", "agent status" |
For debugging issues, the wezterm-troubleshoot agent can autonomously diagnose and fix common problems.
Ctrl+Shift+Rwezterm.log_info('message') - view in debug overlay (Ctrl+Shift+L)references/tab-formatting.md - Complete tab title implementationreferences/status-bar.md - Right status bar with git branchreferences/nerd-font-icons.md - Comprehensive icon referencereferences/agent-deck.md - Agent Deck configuration detailsexamples/wezterm-complete.lua - Full working configuration