wezterm-control

Controls WezTerm panes, tabs, and windows via the wezterm cli command interface.

1|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/mjun0812/skills --skill wezterm-control-mjun0812
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wezterm-control
Source: https://github.com/mjun0812/skills/tree/main/skills/tools/wezterm-control
Command: npx skills add https://github.com/mjun0812/skills --skill wezterm-control-mjun0812

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Operating WezTerm panes and tabs manually while running an AI agent is error-prone: commands can land in the wrong pane, destructive actions can hit unintended targets, and command results go unverified. This Skill provides a safe, ID-explicit workflow for controlling WezTerm through wezterm cli. ## Core Features & Use Cases - Pane and tab management: Split, spawn, move, resize, zoom, focus, and close panes and tabs using explicit --pane-id and --tab-id targeting. - Remote command execution with verification: Send commands to other panes with send-text --no-paste, then confirm results via get-text or marker-based polling for long-running tasks. - Safety guardrails: Always inspects the current layout with wezterm cli list --format json first, restricts kill-pane to self-created panes, and requires confirmation before destructive commands. - Use Case: Ask the agent to split a pane, run a build in it, and report the exit status—it will resolve the target pane ID, send the command with a completion marker, poll the output, and report the result. ## Quick Start Ask the agent to split the current WezTerm pane to the right and run your test suite in the new pane, then report the results.

Frequently Asked Questions about wezterm-control

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

FAQPage Schema
How do I run a command in another WezTerm pane?

Use wezterm cli send-text with an explicit --pane-id and the --no-paste flag, appending a newline so the command executes. Then verify the result with wezterm cli get-text on the same pane ID.

How to split a WezTerm pane from the command line?

Run wezterm cli split-pane with --pane-id and a direction flag such as --right or --bottom, optionally with --percent or --cells for sizing. The command prints the new pane ID to stdout for follow-up operations.

Why does send-text not execute my command in WezTerm?

Panes with bracketed paste mode treat sent newlines as paste content, so the command never runs. Always pass --no-paste and include a trailing newline in the text to force execution.

How can I detect when a long-running command finishes in a WezTerm pane?

Append a marker like echo __WEZTERM_DONE_$?__ to the command, then poll wezterm cli get-text every few seconds until the marker appears. The embedded exit code also reveals success or failure.

When should I not use this WezTerm control skill?

Do not use it for tmux operations, generic pane requests that do not explicitly mention WezTerm, or editing WezTerm configuration files like wezterm.lua and keybindings. It only covers runtime control via wezterm cli.