tmux-debug
Capture and analyze tmux pane content for debugging other sessions or background processes
When & Why to Use This Skill
The tmux-debug skill empowers Claude to capture, inspect, and analyze content from tmux panes across different sessions. It is specifically designed to help developers and system administrators debug background processes, monitor terminal output in real-time, and retrieve scrollback history to diagnose complex execution errors within a terminal multiplexer environment.
Use Cases
- 1. Background Process Monitoring: Capture output from detached tmux panes to check the status of long-running scripts or services without manually switching windows.
- 2. Remote Session Debugging: Analyze terminal logs and error messages from different sessions to identify the root cause of application crashes or environment issues.
- 3. Scrollback History Analysis: Retrieve and inspect large buffers of command output to trace the sequence of events leading up to a specific system state.
- 4. Multi-pane Context Integration: Provide the AI agent with a comprehensive view of multiple terminal windows to coordinate complex debugging tasks across different services.
| name | tmux-debug |
|---|---|
| description | | |
| Triggers | "debug tmux", "capture tmux output", "check other session", "tmux pane content", |
Tmux Debug
Capture screen content from tmux panes to debug other terminal sessions, monitor background processes, or inspect command output.
Commands
List all panes
tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_title}'
Capture current pane
tmux capture-pane -p
# With ANSI colors
tmux capture-pane -p -e
Capture specific pane
tmux capture-pane -t 'session:window.pane' -p
Capture with scrollback history
# Last 100 lines of scrollback
tmux capture-pane -p -S -100
# Entire scrollback buffer
tmux capture-pane -p -S - -E -
Usage
- First list panes to find the target:
tmux list-panes -a -F '...' - Capture the pane content:
tmux capture-pane -t 'target' -p - Analyze the output for errors, status, or relevant information
$ARGUMENTS