Using Tmux For Interactive Commands

Using tmux for Interactive Commands

Overview

Interactive CLI tools that need real terminals cannot work through standard bash. tmux provides detached sessions that can be controlled programmatically via send-keys and capture-pane.

Core principle: Use tmux sessions for any command requiring terminal interaction - editors, REPLs, interactive git, full-screen apps.

When to Use

Use tmux when:

• Running vim, nano, or other text editors programmatically
• Controlling interactive REPLs (Python, Node, etc.)
• Handling interactive git commands (git rebase -i, git add -p)
• Working with full-screen terminal apps (htop, etc.)
• Commands that require terminal control codes or readline

Don't use for:

• Simple non-interactive commands (use regular Bash tool)
• Commands that accept input via stdin redirection
• One-shot commands that don't need interaction

Quick Reference

The Process

1. Create Detached Session

# Start interactive command in background
tmux new-session -d -s my-session -c /path/to/repo 'vim file.txt'

2. Wait for Initialization

# Commands need time to start (100-500ms)
sleep 0.3

3. Send Input

# Send keystrokes
tmux send-keys -t my-session 'iHello World'
tmux send-keys -t my-session Escape
tmux send-keys -t my-session ':wq' Enter

4. Capture Output

# See current screen state
tmux capture-pane -t my-session -p

5. Terminate Session

# Always clean up when done
tmux kill-session -t my-session

Special Keys Reference

Common Patterns

Python REPL

# Start Python
tmux new-session -d -s python-repl 'python3'
sleep 0.2

# Execute code
tmux send-keys -t python-repl 'x = 42' Enter
tmux send-keys -t python-repl 'print(x * 2)' Enter
sleep 0.1

# Capture result
tmux capture-pane -t python-repl -p

# Exit
tmux send-keys -t python-repl 'exit()' Enter
tmux kill-session -t python-repl

Vim Editing

# Open file
tmux new-session -d -s vim-edit -c /project 'vim src/file.py'
sleep 0.3

# Navigate and edit
tmux send-keys -t vim-edit '/function_name' Enter  # Search
tmux send-keys -t vim-edit 'n'                      # Next match
tmux send-keys -t vim-edit 'ciw'                    # Change word
tmux send-keys -t vim-edit 'new_name' Escape        # Type and exit insert

# Save and quit
tmux send-keys -t vim-edit ':wq' Enter
tmux kill-session -t vim-edit

Interactive Git Rebase

# Start rebase
tmux new-session -d -s git-rebase -c /repo 'git rebase -i HEAD~3'
sleep 0.5

# Change 'pick' to 'squash' on line 2
tmux send-keys -t git-rebase 'j'           # Move down
tmux send-keys -t git-rebase 'ciw'         # Change word
tmux send-keys -t git-rebase 'squash' Escape

# Save and continue
tmux send-keys -t git-rebase ':wq' Enter

# Capture any conflicts or prompts
sleep 0.3
tmux capture-pane -t git-rebase -p

tmux kill-session -t git-rebase

Common Mistakes

Session Management Best Practices

1. Use unique, descriptive session names
2. Always check if session exists before creating
3. Set appropriate working directory
4. Wait for command initialization
5. Capture output to verify state
6. Always terminate sessions when done
7. Use try/finally pattern for cleanup

Checking Session State

# List all sessions
tmux list-sessions

# Check if session exists
tmux has-session -t my-session 2>/dev/null && echo "exists"

# Get session info
tmux display-message -t my-session -p '#{session_name}: #{pane_current_command}'

Real-World Impact

• Enables programmatic control of vim/nano for file editing
• Automates interactive git workflows (rebase, add -p, commit --amend)
• Supports REPL-based testing and debugging
• Removes need for custom PTY management code
• Works where standard bash input redirection fails

Limitations

• Requires tmux installed on the system
• Timing-sensitive (may need adjustment for slow systems)
• Screen capture is text-only (no graphics)
• Session names must be unique

Converted and distributed by TomeVault — claim your Tome and manage your conversions.