Skip to content
Iterm2 logo

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.

SKILL.md

Full skill instructions

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:

  1. Call the notification script (for observability tracking):

    ~/​.claude/​Tools/​SkillWorkflowNotification WORKFLOWNAME Iterm2
    
  2. Output the text notification (for user visibility):

    Running the **WorkflowName** workflow from the **Iterm2** skill...
    
WorkflowTriggerFile
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

ActionShortcut
Split VerticalCmd+D
Split HorizontalCmd+Shift+D
Navigate PanesCmd+Option+Arrow
Maximize PaneCmd+Shift+Enter
Next/​Prev TabCmd+{ / Cmd+}
FindCmd+F
AutocompleteCmd+;
Paste HistoryCmd+Shift+H
Instant ReplayCmd+Option+B
Find CursorCmd+/

tmux Essentials

Default prefix: Ctrl+b

ActionShortcut
New Sessiontmux new -s name
List Sessionstmux ls or Ctrl+b s
Attach Sessiontmux attach -t name
DetachCtrl+b d
New WindowCtrl+b c
Split VerticalCtrl+b %
Split HorizontalCtrl+b "
Navigate PanesCtrl+b Arrow
Zoom PaneCtrl+b z
Close PaneCtrl+b x
Copy ModeCtrl+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

DocumentPurpose
Shortcuts.mdComplete keyboard shortcut reference
TmuxConfig.mdtmux configuration (.tmux.conf) guide
TmuxCommands.mdFull tmux command reference

More Productivity & Planning skills

brainstorming logo
Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K
View
ui-ux-pro-max logo
Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K
View
writing-plans logo
Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K
View
using-superpowers logo
Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K
View
executing-plans logo
Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K
View
dispatching-parallel-agents logo
Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K
View
using-git-worktrees logo
Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K
View
webapp-testing logo
Productivity & Planning

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K
View
content-strategy logo
Productivity & Planning

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View
repo-intake-and-plan logo
Productivity & Planning

repo-intake-and-plan

README-first repository scanner that extracts commands and classifies reproduction candidates without executing them.

497 139.6K
View
marketing-ideas logo
Productivity & Planning

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
site-architecture logo
Productivity & Planning

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View

Productivity AI tools

Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View
SaveDay logo
Productivity

SaveDay

Capture, organize, and utilize your knowledge effortlessly.

Free
View
A
Productivity

Any Summary

Instant Summaries of Audio & Video Interviews with AnySummary

Freemium
View
M
Productivity

Map This

Transform PDFs into engaging mind maps.

Freemium
View
ChatPDF logo
Productivity

ChatPDF

Chat with any PDF instantly

Free
View
I
Productivity

intellisay

Create an optimal daily plan using your voice

Paid
View
A
Productivity

Aurora AI

A productivity platform to centralize organizational knowledge and workflows with contextual AI assistance.

Paid
View
AskYourPDF logo
Productivity

AskYourPDF

AskYourPDF Pricing Plans: Tailored to Your Needs

Free
View