Iterm2

Manage iTerm2 and tmux workflows with native -CC integration.

7|1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill iterm2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Iterm2
Source: https://github.com/julianobarbosa/claude-code-skills/tree/main/skills/iterm2-skill
Command: npx skills add https://github.com/julianobarbosa/claude-code-skills --skill iterm2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill consolidates iTerm2 and tmux workflows to boost terminal productivity for developers.

Core Features & Use Cases

  • Keyboard Shortcuts: iTerm2 and tmux shortcuts list.
  • Tmux Integration: tmux -CC mode for native integration.
  • Workflow Automation: Workflow mappings to run common tasks.
  • Use Case: Split panes quickly using Cmd+D and Cmd+Shift+D while SSHing.

Quick Start

Open iTerm2 with tmux integration and test a split.

Frequently Asked Questions about Iterm2

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up tmux with iTerm2 for native integration?

TMux native integration with iTerm2 uses tmux -CC mode, which enables iTerm2 to manage tmux windows and panes natively. Enable this by launching tmux with the -CC flag or configuring it in your tmux config. This eliminates the need for manual pane management and syncs iTerm2 shortcuts with tmux workflows.

What's the fastest way to split panes in iTerm2 while SSH'd into a remote server?

Use iTerm2 keyboard shortcuts Cmd+D for vertical splits and Cmd+Shift+D for horizontal splits. When running tmux -CC, these shortcuts work seamlessly over SSH, allowing rapid pane splitting without typing tmux commands or losing connection state.

Can I keep tmux sessions alive after disconnecting SSH?

Yes, tmux sessions persist on the remote server independently of your SSH connection. When you disconnect, sessions remain active in the background. Reconnect and reattach with tmux attach-session to restore your panes, windows, and running processes exactly as you left them.

How do I automate common terminal workflows in iTerm2 and tmux?

Use workflow mappings to bind frequent tasks—like creating sessions, splitting panes, or running commands—to keyboard shortcuts or automated sequences. Combined with iTerm2 profiles and tmux config, workflows reduce repetitive manual steps and accelerate productivity across multiple panes and sessions.

What iTerm2 and tmux keyboard shortcuts boost productivity?

Key shortcuts include Cmd+D and Cmd+Shift+D for iTerm2 splits, Ctrl+B for tmux prefix, and tmux commands like new-window and select-pane. Learning these shortcuts eliminates mouse use and menu navigation, enabling rapid pane and window management in terminal workflows.

How do I manage tmux plugins and extensions?

Use TPM (Tmux Plugin Manager) to install, update, and manage tmux plugins. TPM integrates with your tmux config file, allowing declarative plugin setup and automatic loading. This extends tmux functionality without manual compilation or complex configuration.