tmux-interaction

Send commands to tmux panes and poll for text output.

5|Updated Apr 9, 2018
One-click install
npx skills add https://github.com/angusjfw/hbz --skill tmux-interaction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-interaction
Source: https://github.com/angusjfw/hbz/tree/main/claude/skills/tmux-interaction
Command: npx skills add https://github.com/angusjfw/hbz --skill tmux-interaction

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, and includes scripts (resource) components.

What problem does it solve?

This skill addresses the need for efficient and effective communication with non-focus panes in tmux, ensuring a more fluid workflow when running complex operations and scripts.

Core Features & Use Cases

  • Input and Output Operations: Interact with tmux panes outside the focus pane for sending commands and receiving outputs.
  • Vim Mode Interaction: Supports submission and error prevention within Vim-based editors or REPLs.
  • Output Reading: Captures and analyzes output from the tmux panes to assist with debugging and development.
  • Polling Mechanisms: Includes polling functions to wait for a specific response from the pane.

Quick Start

To execute a command in the pane of the tmux server with ID :0.0 and then poll for a regex pattern with a 30-second timeout and a 0.5-second interval, run: scripts/wait-for-text.sh -t ':0.0' -p '^>' -T 30 -i 0.5.

Frequently Asked Questions about tmux-interaction

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

FAQPage Schema
How do I send commands to a non-focus tmux pane and read its output?

To interact with non-focus tmux panes, you can use scripts to send commands and capture outputs, streamlining complex development workflows without leaving your current focus pane.

Can I automate command execution in tmux panes and poll for a specific response?

Yes, you can execute commands in specific panes and use polling functions to wait for a regex pattern match, allowing you to synchronize scripts with long-running process outputs.

What's the best way to handle Vim mode submission when sending keystrokes to tmux panes?

The skill implements specific Vim-mode submission handling to safely send commands to Vim-based editors or REPLs, preventing input errors during automated pane interaction.

Does this tmux interaction approach work for capturing output from long-running processes?

Yes, it is specifically intended for managing non-focus panes running development operations, allowing you to capture and analyze output from long-running processes or REPLs for debugging.

Do I need tmux installed to manage panes and run development operations with this tool?

Yes, tmux is a required dependency. You need an active tmux server running to target specific panes by ID, send data, and receive outputs using the provided scripts.