tmux

Complete tmux terminal multiplexer management: sessions, windows, panes, layouts, scripting, and configuration. Auto-activates on: "tmux", "session", "window", "pane", "split", "attach", "detach", "multiplexer".

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "tmux" with this command: npx skills add bntvllnt/agent-skills/bntvllnt-agent-skills-tmux

tmux

Complete tmux management for terminal multiplexing.

Core Concepts

┌─────────────────────────────────────────────────────────────┐
│ SERVER (one per socket)                                     │
│  ┌───────────────────────────────────────────────────────┐  │
│  │ SESSION ($0, $1, ...)                                 │  │
│  │  ┌─────────────────┐  ┌─────────────────┐            │  │
│  │  │ WINDOW (@0)     │  │ WINDOW (@1)     │  ...       │  │
│  │  │  ┌────┬────┐   │  │  ┌────────────┐ │            │  │
│  │  │  │PANE│PANE│   │  │  │   PANE     │ │            │  │
│  │  │  │ %0 │ %1 │   │  │  │    %2      │ │            │  │
│  │  │  └────┴────┘   │  │  └────────────┘ │            │  │
│  │  └─────────────────┘  └─────────────────┘            │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
  • Server: Background process managing all state
  • Session ($id): Named container of windows, persists after detach
  • Window (@id): Tab-like container of panes within a session
  • Pane (%id): Individual terminal within a window
  • Client: Terminal attached to a session

Router

User saysLoad referenceDo
list sessions / statusreferences/session-management.mdinspect sessions
new session / create sessionreferences/session-management.mdcreate session
attach / detachreferences/session-management.mdattach/detach
kill sessionreferences/session-management.mdterminate session
new window / create windowreferences/window-management.mdcreate window
rename windowreferences/window-management.mdrename window
kill window / close windowreferences/window-management.mdclose window
switch windowreferences/window-management.mdnavigate windows
split / new panereferences/pane-management.mdsplit pane
resize panereferences/pane-management.mdresize pane
move pane / swap panereferences/pane-management.mdrearrange panes
kill pane / close panereferences/pane-management.mdclose pane
layoutreferences/layouts.mdapply/manage layouts
copy / paste / bufferreferences/copy-mode.mdcopy mode operations
config / tmux.conf / settingsreferences/configuration.mdconfigure tmux
keybind / bind / unbindreferences/keybindings.mdkey bindings
script / automate / send-keysreferences/scripting.mdscripting/automation
capture / log / outputreferences/scripting.mdcapture pane content
help / keys / cheatsheetinlineshow key reference

Default Key Bindings (Prefix: C-b)

Session

KeyAction
dDetach from session
sList/switch sessions
$Rename session
( / )Previous/next session

Window

KeyAction
cCreate window
&Kill window (confirm)
,Rename window
0-9Switch to window N
n / pNext/previous window
lLast window
wList windows
fFind window

Pane

KeyAction
%Split horizontally (left/right)
"Split vertically (top/bottom)
xKill pane (confirm)
oCycle panes
qShow pane numbers
zToggle zoom
{ / }Swap pane left/right
!Break pane to window
ArrowsNavigate panes
SpaceCycle layouts
C-oRotate panes

Copy Mode

KeyAction
[Enter copy mode
]Paste buffer
=Choose paste buffer
#List buffers

Quick Reference

# Session
tmux new -s name              # Create named session
tmux attach -t name           # Attach to session
tmux ls                       # List sessions
tmux kill-session -t name     # Kill session

# Window
tmux new-window -n name       # Create named window
tmux select-window -t :N      # Go to window N
tmux rename-window name       # Rename current window

# Pane
tmux split-window -h          # Split horizontal
tmux split-window -v          # Split vertical
tmux select-pane -t :.N       # Go to pane N
tmux resize-pane -D 5         # Resize down 5 lines

# Info
tmux list-keys                # All key bindings
tmux info                     # Server info

Safety Rules

  • Confirm before kill: Always confirm before kill-session, kill-window, kill-pane
  • Check attachments: Before killing, check if session has active clients
  • Preserve work: Warn if panes have running processes
  • Config backup: Before editing ~/.tmux.conf, suggest backup

Confirmation Policy

Read-only (always OK):

  • tmux ls, list-sessions, list-windows, list-panes
  • tmux info, show-options, display-message
  • tmux list-keys, list-buffers

Requires confirmation:

  • kill-session, kill-window, kill-pane
  • kill-server
  • Editing ~/.tmux.conf
  • send-keys to panes (can affect running processes)

Environment Variables

VariableDescription
TMUXSocket path (set inside tmux)
TMUX_PANECurrent pane ID

Check if inside tmux: [ -n "$TMUX" ]

Troubleshooting

IssueSolution
"no server running"Start with tmux or tmux new
"sessions should be nested"Unset $TMUX or use tmux -u
Detached session lostCheck tmux ls, attach with tmux attach
Colors not workingSet TERM=xterm-256color or set -g default-terminal "tmux-256color"
Mouse not workingset -g mouse on in config

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Automation

workflow

No summary provided by upstream source.

Repository SourceNeeds Review
44-bntvllnt
Automation

analyze

No summary provided by upstream source.

Repository SourceNeeds Review
41-bntvllnt
Automation

git

No summary provided by upstream source.

Repository SourceNeeds Review
38-bntvllnt
Automation

skill-builder

No summary provided by upstream source.

Repository SourceNeeds Review
28-bntvllnt