Remote SSH via tmux

Overview

The claude-tmux plugin manages SSH connections via tmux panes. This skill documents patterns for interacting with those connections. Each remote connection lives in a dedicated tmux pane, tagged with a custom @remote option set to the connection name (e.g., mac-mini, prod-web). The /remote command handles establishing connections; this skill covers the patterns for interacting with those connections once established.

All remote interaction follows a consistent model: find the target pane by its @remote tag, send commands using tmux send-keys, and read output using tmux capture-pane.

Proactive Remote Execution

When you determine that a command needs to run on a remote host -- instead of telling the user to SSH in and run it manually -- check for an active remote pane first.

Detection

Before suggesting manual SSH commands, check if a remote pane is connected to the target host: