Tmux

Collection of AI agent skills - reusable capabilities for any domain via skills.sh

Install

npx -y skills add bntvllnt/agent-skills --skill tmux

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

6.8 KB, as published. Nobody here has run it

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 says	Load reference	Do
list sessions / status	`references/session-management.md`	inspect sessions
new session / create session	`references/session-management.md`	create session
attach / detach	`references/session-management.md`	attach/detach
kill session	`references/session-management.md`	terminate session
new window / create window	`references/window-management.md`	create window
rename window	`references/window-management.md`	rename window
kill window / close window	`references/window-management.md`	close window
switch window	`references/window-management.md`	navigate windows
split / new pane	`references/pane-management.md`	split pane
resize pane	`references/pane-management.md`	resize pane
move pane / swap pane	`references/pane-management.md`	rearrange panes
kill pane / close pane	`references/pane-management.md`	close pane
layout	`references/layouts.md`	apply/manage layouts
copy / paste / buffer	`references/copy-mode.md`	copy mode operations
config / tmux.conf / settings	`references/configuration.md`	configure tmux
keybind / bind / unbind	`references/keybindings.md`	key bindings
script / automate / send-keys	`references/scripting.md`	scripting/automation
capture / log / output	`references/scripting.md`	capture pane content
help / keys / cheatsheet	inline	show key reference

Default Key Bindings (Prefix: `C-b`)

Session

Key	Action
`d`	Detach from session
`s`	List/switch sessions
`$`	Rename session
`(` / `)`	Previous/next session

Window

Key	Action
`c`	Create window
`&`	Kill window (confirm)
`,`	Rename window
`0-9`	Switch to window N
`n` / `p`	Next/previous window
`l`	Last window
`w`	List windows
`f`	Find window

Pane

Key	Action
`%`	Split horizontally (left/right)
`"`	Split vertically (top/bottom)
`x`	Kill pane (confirm)
`o`	Cycle panes
`q`	Show pane numbers
`z`	Toggle zoom
`{` / `}`	Swap pane left/right
`!`	Break pane to window
Arrows	Navigate panes
`Space`	Cycle layouts
`C-o`	Rotate panes

Copy Mode

Key	Action
`[`	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

Variable	Description
`TMUX`	Socket path (set inside tmux)
`TMUX_PANE`	Current pane ID

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

Troubleshooting

Issue	Solution
"no server running"	Start with `tmux` or `tmux new`
"sessions should be nested"	Unset `$TMUX` or use `tmux -u`
Detached session lost	Check `tmux ls`, attach with `tmux attach`
Colors not working	Set `TERM=xterm-256color` or `set -g default-terminal "tmux-256color"`
Mouse not working	`set -g mouse on` in config