Skill

using-tmux-for-interactive-commands

Use when you need to run interactive CLI tools (vim, git rebase -i, Python REPL, etc.) that require real-time input/output - provides tmux-based approach for controlling interactive sessions through detached sessions and send-keys

From clavain

Install

Run in your terminal

npx claudepluginhub mistakeknot/interagency-marketplace --plugin clavain

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets

View in Repository

SKILL-compact.md

tmux-wrapper.sh

Skill Content

Similar Skills

skill-lookup

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

prompts.chat

157.6k

prompt-lookup

Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.

prompts.chat

157.6k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

137.7k

Stats

Stars2

Forks0

Last CommitMar 16, 2026

Actions

View Source View Plugin View on GitHub View README

Task

Command

Start

tmux new-session -d -s <name> <cmd>

Send input

tmux send-keys -t <name> 'text' Enter

Capture

tmux capture-pane -t <name> -p

Stop

tmux kill-session -t <name>

Common Patterns

Python REPL:

tmux new-session -d -s py python3 -i tmux send-keys -t py 'import math' Enter tmux send-keys -t py 'print(math.pi)' Enter tmux capture-pane -t py -p tmux kill-session -t py

Interactive git rebase:

tmux new-session -d -s rebase -c /repo git rebase -i HEAD~3 sleep 0.5 tmux capture-pane -t rebase -p tmux send-keys -t rebase ':wq' Enter

Using tmux for Interactive Commands

Interactive CLI tools (vim, REPLs, interactive git, etc.) require a real terminal — use tmux detached sessions controlled via send-keys/capture-pane.

When to use

Use: vim/nano, REPLs (Python, Node), git rebase -i, git add -p, full-screen TUIs, readline-dependent commands. Don't use: non-interactive commands, commands accepting stdin redirection.

Quick Reference

Task	Command
Start	`tmux new-session -d -s <name> <cmd>`
Send input	`tmux send-keys -t <name> 'text' Enter`
Capture	`tmux capture-pane -t <name> -p`
Stop	`tmux kill-session -t <name>`

Core Pattern

tmux new-session -d -s edit vim file.txt
sleep 0.3  # wait for init
tmux send-keys -t edit 'i' 'Hello World' Escape ':wq' Enter
tmux capture-pane -t edit -p
tmux kill-session -t edit

Special Keys

Enter, Escape, C-c, C-x, Up, Down, Left, Right, Space, BSpace

With working directory

tmux new-session -d -s rebase -c /repo/path git rebase -i HEAD~3

Common Patterns

Python REPL:

tmux new-session -d -s py python3 -i
tmux send-keys -t py 'import math' Enter
tmux send-keys -t py 'print(math.pi)' Enter
tmux capture-pane -t py -p
tmux kill-session -t py

Interactive git rebase:

tmux new-session -d -s rebase -c /repo git rebase -i HEAD~3
sleep 0.5
tmux capture-pane -t rebase -p
tmux send-keys -t rebase ':wq' Enter

Gotchas

Blank capture: Add sleep 0.3 after new-session before first capture
Command not executed: Must send Enter explicitly as a separate argument
Wrong key names: Use Enter not \n; Escape not \e
Orphaned sessions: Always tmux kill-session -t <name> when done