Claude-skill-registry Iterm2

iTerm2 terminal emulator and tmux multiplexer expertise. USE WHEN user mentions iTerm2, tmux, terminal sessions, split panes, window management, OR terminal productivity on macOS.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/iterm2" ~/.claude/skills/majiayu000-claude-skill-registry-iterm2 && rm -rf "$T"

manifest: skills/data/iterm2/SKILL.md

source content

Iterm2

Complete reference for iTerm2 terminal emulator and tmux terminal multiplexer on macOS. Covers keyboard shortcuts, configuration, tmux integration, and productivity workflows.

Workflow Routing

When executing a workflow, do BOTH of these:

Call the notification script (for observability tracking):

~/.claude/Tools/SkillWorkflowNotification WORKFLOWNAME Iterm2

Output the text notification (for user visibility):

Running the **WorkflowName** workflow from the **Iterm2** skill...

Workflow	Trigger	File
SetupTmux	"setup tmux", "configure tmux"	`workflows/SetupTmux.md`
TmuxSession	"tmux session", "attach session", "detach"	`workflows/TmuxSession.md`
TroubleshootTmux	"tmux not working", "fix tmux"	`workflows/TroubleshootTmux.md`

Examples

Example 1: Split terminal into multiple panes

User: "How do I split my terminal in iTerm2?"
→ References Shortcuts.md
→ Explains Cmd+D (vertical) and Cmd+Shift+D (horizontal)
→ Shows navigation with Cmd+Option+Arrow

Example 2: Setup tmux with iTerm2 integration

User: "How do I use tmux with iTerm2?"
→ Invokes SetupTmux workflow
→ Explains tmux -CC control mode
→ Shows native window integration benefits

Example 3: Manage persistent sessions over SSH

User: "Keep my terminal running after disconnect"
→ Invokes TmuxSession workflow
→ Creates named session with tmux new -s
→ Shows how to reattach after disconnect

Quick Reference

iTerm2 Essentials

Action	Shortcut
Split Vertical	`Cmd+D`
Split Horizontal	`Cmd+Shift+D`
Navigate Panes	`Cmd+Option+Arrow`
Maximize Pane	`Cmd+Shift+Enter`
Next/Prev Tab	`Cmd+{` / `Cmd+}`
Find	`Cmd+F`
Autocomplete	`Cmd+;`
Paste History	`Cmd+Shift+H`
Instant Replay	`Cmd+Option+B`
Find Cursor	`Cmd+/`

tmux Essentials

Default prefix:

Ctrl+b

Action	Shortcut
New Session	`tmux new -s name`
List Sessions	`tmux ls` or `Ctrl+b s`
Attach Session	`tmux attach -t name`
Detach	`Ctrl+b d`
New Window	`Ctrl+b c`
Split Vertical	`Ctrl+b %`
Split Horizontal	`Ctrl+b "`
Navigate Panes	`Ctrl+b Arrow`
Zoom Pane	`Ctrl+b z`
Close Pane	`Ctrl+b x`
Copy Mode	`Ctrl+b [`

iTerm2 + tmux Integration

Run

tmux -CC

for native iTerm2 integration:

tmux windows appear as native iTerm2 windows
Use iTerm2 shortcuts instead of tmux prefix
Sessions persist through disconnects
Dashboard available via Shell > tmux > Dashboard

Documentation Index

Document	Purpose
`Shortcuts.md`	Complete keyboard shortcut reference
`TmuxConfig.md`	tmux configuration (.tmux.conf) guide
`TmuxCommands.md`	Full tmux command reference