Tmux Status Debug

What it does

This skill provides debugging capabilities for Tmux Status Detection, specifically related to integrations like tmux-opencode-integrated. It allows users to retrieve detailed status information from tmux server sessions, windows, and panes to diagnose issues with session state (e.g., incorrect status icons) and test pattern matching used for agent detection. The skill facilitates capturing pane content and checking for specific patterns within that content.

When to use it

This skill is useful in the following scenarios:

• When tmux status icons are displaying an incorrect state (e.g., showing ERROR when the agent is IDLE).
• When adding new detection patterns for agents running inside tmux panes.
• To test pattern matching against real pane content to ensure accurate agent status identification.
• For general debugging of tmux-opencode-integrated or similar integrations.

Key capabilities

• Retrieves detailed tmux server status information.
• Captures raw pane content for inspection.
• Allows viewing captured content with control characters visible.
• Checks if a specific pattern exists within the captured pane content.
• Provides a debug script (requires Nix Python with libtmux) to iterate through sessions, windows and panes to identify agent programs and their status.
• Includes example pattern testing using regular expressions against sample content.

Example prompts

While this skill doesn't directly respond to natural language prompts, here are some commands that can be executed via an AI agent equipped with it:

• tmux list-panes -a ... (to list all panes and their associated information)
• tmux capture-pane -t "main:1" ... | grep -o "pattern" (to check for a specific pattern in a pane's content)
• /path/to/python3 /tmp/debug_status.py (to execute the debugging script, requiring proper Python environment setup)

Tips & gotchas

• The debug script requires a Nix Python environment with libtmux installed and configured correctly. Refer to the provided instructions for building and running this script.
• The skill's functionality is specifically tailored for debugging integrations like tmux-opencode-integrated. General tmux management isn’t supported.
• Pattern matching relies on regular expressions; understanding regex syntax is helpful for effective use.