cskwork

Wezterm Skill — Development skill for Claude Code

Development community

Claude Code skill for configuring and driving the WezTerm terminal emulator (Lua config, CLI, keybindings, multi-pane workflows, agent send-text/get-text loop).

How to install Wezterm Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cskwork/wezterm-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Wezterm Skill does

Claude Code skill for configuring and driving the WezTerm terminal emulator (Lua config, CLI, keybindings, multi-pane workflows, agent send-text/get-text loop).

Alternatives in Development

Lua Lsp — Lua /plugin install lua-lsp@claude-plugins-official 14k ★
Herdr Reviewr — Review your coding agent's diff in a terminal pane and send line comments back to Claude Code, Codex, OpenCode 823 ★
Pi Reserved Keybindings — Extensions cannot override these shortcuts — they are silently skipped by registerShortcut() 526 ★

README

wezterm-skill

A Claude Code skill for configuring and driving the [WezTerm](https://wezterm.org) terminal emulator. Bash + PowerShell helpers and an opinionated default config ship in the box.

Install once, then ask Claude things like:

"set up wezterm with Catppuccin Mocha and tmux-style splits"
"split my wezterm.lua into modules and add a workspace switcher binding"
"scaffold a new SSH host called prod and add it as an ssh_domain"
"drive the pane on the right with wezterm cli send-text to run my tests"
"switch my color scheme to Tokyo Night Storm and bump font size to 13"
"install resurrect.wezterm and wire up auto-save every 5 minutes"
"fix CWD inheritance — new panes start in ~ instead of my project"

What it covers

Default wezterm.lua (Catppuccin Mocha, tmux-style leader, copy/paste, pane splits) plus minimal and Claude-Code-multi-pane variants
WezTerm CLI surface: list, spawn, split-pane, send-text, get-text, connect, ssh
Default + custom keybindings, leader-key patterns, key_tables (resize/copy mode)
Pane splitting recipes, BSP layout helper
Driving a pane from an AI agent (send-text / get-text loop)
SSH: wezterm ssh vs persistent ssh_domains, helper scripts for both bash and PowerShell
Shell integration (OSC 7) for CWD inheritance on split, bash/zsh/fish/PowerShell
Modular wezterm.lua layout (M.apply(config) pattern, helpers/theme/keys/events)
IDE type completion via lua-language-server + community type stubs
Plugin system (wezterm.plugin.require) + curated community plugin list
Named workspaces, switching, persistence via unix multiplexer or resurrect.wezterm
Polish: inactive-pane dimming, WebGpu front-end, Zen mode toggle, OS-aware config

What's inside

wezterm-skill/
  SKILL.md                       — entry point Claude loads
  assets/
    wezterm.lua                  — opinionated default config (copy this in)
    wezterm-minimal.lua          — minim