tmux
Control interactive CLIs (python, gdb, etc.) via tmux sessions - send keystrokes and scrape output
How do I install this agent skill?
npx skills add https://github.com/connorads/dotfiles --skill tmuxIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
This skill provides capabilities to manage tmux sessions and interact with terminal applications, including remote execution via SSH. While these features are intended, they provide a powerful interface for arbitrary command execution and terminal output scraping, which can expose sensitive information if not used carefully.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
3/3 files flagged
What does this agent skill do?
tmux Skill
Use tmux to control interactive terminal applications by sending keystrokes and capturing output.
When to Use
- Running interactive REPLs (python, node, psql)
- Debugging with gdb/lldb
- Any CLI that requires TTY interaction
- Remote execution where you need to observe output
Core Pattern
# Create session
tmux new-session -d -s "$SESSION" -x 120 -y 40
# Send commands
tmux send-keys -t "$SESSION" "python3" Enter
# Capture output
tmux capture-pane -t "$SESSION" -p
# Wait for prompt (poll)
for i in {1..30}; do
output=$(tmux capture-pane -t "$SESSION" -p)
if echo "$output" | grep -q ">>>"; then break; fi
sleep 0.5
done
# Cleanup
tmux kill-session -t "$SESSION"
Remote Execution (Codespaces/SSH)
For mise-installed tools, wrap in zsh:
# Non-interactive (won't hang)
ssh host 'zsh -c "source ~/.zshrc; tmux new-session -d -s mysession; tmux send-keys -t mysession python Enter"'
# Interactive (for tmux attach) - needs TTY
ssh host -t 'zsh -ilc "tmux attach -t mysession"'
Critical: Use zsh -c "source ~/.zshrc; ..." not zsh -lc to avoid hangs.
User Notification
After starting a session, ALWAYS print:
To monitor: tmux attach -t $SESSION
To capture: tmux capture-pane -t $SESSION -p
Tips
- Use
-x 120 -y 40for consistent pane size - Poll with
capture-pane -prather thanwait-for - Send literal text with
-lflag to avoid shell expansion - Control keys:
C-c(interrupt),C-d(EOF),Escape - For Python REPL: set
PYTHON_BASIC_REPL=1to avoid fancy console interference
Helper Scripts
wait-for-text.sh
Poll tmux pane for a text pattern with timeout:
scripts/wait-for-text.sh -t session:0.0 -p '^>>>' -T 15
find-sessions.sh
List tmux sessions, optionally filtered:
scripts/find-sessions.sh -q claude # filter by name
scripts/find-sessions.sh --all # all sessions
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/connorads/dotfiles/tmux">View tmux on skillZs</a>