Wezterm

What it does

This skill allows an AI agent to control and interact with WezTerm, a terminal emulator available on Linux across platforms. It provides access to WezTerm's command-line interface (CLI), enabling actions like listing panes and clients, managing tabs and workspaces, sending commands to running terminals, and launching new instances. This facilitates seamless remote access and development workflows within the WezTerm environment.

When to use it

• Automating terminal tasks such as splitting panes and activating specific ones.
• Managing multiple SSH connections or terminal sessions through Wezterm.
• Launching applications or commands within a WezTerm tab or pane.
• Listing available workspaces or domains (like SSH servers) configured in WezTerm.
• Sending pre-defined commands to running terminals for scripting and automation.

Key capabilities

• Pane Management: List, split, activate, and get the direction of panes.
• Tab Management: Create new tabs, activate existing ones by index or relative position.
• Command Sending: Send text (commands) to specific panes or the current pane.
• Workspace & Domain Listing: Retrieve lists of configured workspaces and domains.
• Zoom Control: Toggle and control pane zoom levels.
• Launching WezTerm: Start new windows, connect to running mux servers, and launch with specified commands or directories.

Example prompts

• "List all active panes in Wezterm."
• "Split the current Wezterm pane horizontally and run htop in it."
• "Activate the tab at index 0."
• "Send 'ls -la' to the pane with ID <pane-id>."

Tips & gotchas

• The CLI is located at /Applications/WezTerm.app/Contents/MacOS/wezterm or can be accessed by adding it to your system’s PATH.
• Commands often require a pane-id, which needs to be obtained first using the "list" commands.
• Newline characters (\n) are required at the end of text sent via send-text for commands to execute properly.