tmux-sidecarlisted

Create and interact with secondary tmux panes or windows for bidirectional command execution. This skill should be used when "tmux sidecar" is mentioned, or when needing to run interactive sessions (REPLs, rails console, database clients, log tailing) in a separate pane or window while maintaining control from the main session.
matthull/my-skills · ★ 0 · AI & Automation · score 72

Install: claude install-skill matthull/my-skills

# Tmux Sidecar > **Note:** For Claude-to-Claude orchestration, prefer **agent-teams** (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`). Agent-teams provides built-in mailbox, shared task list, and tmux split-pane coordination that is more reliable than the polling-based patterns below. This skill remains the right tool for **non-Claude processes** (REPLs, databases, log tailing, build watchers). See `research/findings/agent-teams-egregore-impact.md`. Create secondary tmux pane or window for bidirectional command execution. ## Pane vs Window Decision **If the user does not specify pane or window, ALWAYS ask before creating the sidecar:** > "Should I create this sidecar as a **new pane** (split in current window) or a **new window** (separate tab)?" **When to suggest each:** - **Pane** (split): Good for monitoring alongside current work, short-lived tasks, seeing output side-by-side - **Window** (tab): Good for long-running processes, full-screen REPLs, when pane space is tight, Claude Code sidecars **Creating a new window:** ```bash LOCATION=$(tmux display-message -p '#S') tmux new-window -t $LOCATION -n sidecar-name # New window becomes SESSION:NEW_INDEX # Reference as SESSION:WINDOW_NAME or SESSION:WINDOW_INDEX ``` **Creating a new pane:** ```bash LOCATION=$(tmux display-message -p '#S:#I') tmux split-window -v -t $LOCATION # vertical (below) tmux split-window -h -t $LOCATION # horizontal (beside) ``` ## Helper Scripts Helper scripts are installed at `~/.local/bin/`