wezterm

Configure WezTerm terminal emulator behavior with Lua-based multiplexer and UI setup.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/bugabinga/pi-ext --skill wezterm-bugabinga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wezterm
Source: https://github.com/bugabinga/pi-ext/tree/main/skills/wezterm
Command: npx skills add https://github.com/bugabinga/pi-ext --skill wezterm-bugabinga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WezTerm users need a reliable way to plan, write, and validate their terminal multiplexer and keybinding setup without guessing at config placement or reload behavior.

Core Features & Use Cases

  • Lua config authoring and placement: Covers where WezTerm looks for ~/.wezterm.lua vs $XDG_CONFIG_HOME and how to override discovery with CLI flags or WEZTERM_CONFIG_FILE.
  • Multiplexer workflows (SSH/WSL/domains, workspaces): Supports domain-aware pane/window actions and workspace switching for recurring environments.
  • Operational ergonomics (key bindings and UI behavior): Provides common configuration patterns for appearance, copy mode, launcher prompts, and pane/tab/window actions you can directly encode in Lua.

Quick Start

Write your WezTerm setup into ~/.wezterm.lua, then run wezterm start using your intended config discovery path so your custom key bindings, tabs/panes, and appearance take effect immediately.

Frequently Asked Questions about wezterm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure WezTerm using Lua?

To configure WezTerm using Lua, write your setup into `~/.wezterm.lua` or `$XDG_CONFIG_HOME`, defining key bindings, panes, tabs, and appearance. WezTerm discovers this config automatically and applies changes upon reload.

What is the best way to manage SSH domains and workspaces in a terminal multiplexer?

Managing SSH domains and workspaces in a terminal multiplexer involves using domain-aware pane actions and workspace switching within your Lua config. This setup supports recurring environments and automates CLI actions across development contexts.

Where does WezTerm look for its configuration file?

WezTerm looks for its configuration file at `~/.wezterm.lua` or `$XDG_CONFIG_HOME`. You can override this discovery path using CLI flags or the `WEZTERM_CONFIG_FILE` environment variable to load a custom setup.

How do I set up custom key bindings for pane and tab actions in WezTerm?

Setting up custom key bindings for pane and tab actions in WezTerm requires encoding common configuration patterns directly in Lua. You define actions for panes, tabs, windows, copy mode, and launcher prompts within your config file.

Does WezTerm support automatic configuration reload when I edit my Lua file?

WezTerm supports automatic configuration reload when you edit your Lua file. After writing your setup to `~/.wezterm.lua`, running `wezterm start` applies your custom key bindings, tabs, and appearance immediately without restarting.

Can I use WezTerm for WSL domain routing and workspace automation?

WezTerm can be used for WSL domain routing and workspace automation by defining a Lua-based multiplexer setup. This config supports domain-aware workflows, allowing you to automate CLI and GUI actions across operating system boundaries.