К основному содержанию
скилл CX Codex

iterm2 — скилл для Claude Code: справка по iTerm2 и tmux

Скилл для Claude Code настраивает iTerm2 и tmux, управляет панелями и сессиями и разбирает неполадки. Помогает работать с терминалом на macOS.

MIT 115 установок ★ 17 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add julianobarbosa/claude-code-skills --skill iterm2 -a claude-code
Открыть на GitHub

Что делает iterm2

Скилл объясняет сочетания клавиш iTerm2, настройку tmux и совместный режим через tmux -CC. С ним можно разделить терминал на панели, подключиться к сессии после обрыва SSH или настроить окна tmux как окна iTerm2. Есть справочники по горячим клавишам, конфигурации и командам tmux.

Для типовых задач предусмотрены рабочие сценарии настройки, управления сессиями и устранения неполадок. При запуске сценария скилл вызывает скрипт уведомлений и сообщает пользователю, какой сценарий выполняется. Режим tmux -CC требует установленного и запущенного tmux-сервера; для удалённого хоста подключение должно быть запущено из самого iTerm2.

Некоторые сочетания зависят от профиля и текущей панели. Например, новые панели через Cmd+D наследуют профиль текущей панели, а не настройки окна. Это может неожиданно передать в новую панель изменённые переменные среды или PATH.

Какие задачи решает

  • разделить окно iTerm2 на вертикальные или горизонтальные панели
  • настроить интеграцию tmux с окнами iTerm2
  • создать именованную tmux-сессию и подключиться к ней после обрыва
  • найти сочетание клавиш или команду tmux
  • разобраться, почему tmux или оболочка работают не так, как ожидалось

Примеры запросов агенту

  • Как разделить терминал iTerm2 на панели и переключаться между ними?
  • Настрой tmux -CC, чтобы окна tmux открывались как окна iTerm2.
  • Создай именованную tmux-сессию, которая переживёт отключение SSH, и объясни, как к ней подключиться снова.

Как установить iterm2

1Через Skills CLI (Vercel)

npx skills add julianobarbosa/claude-code-skills --skill iterm2 -a claude-code

2Вручную: положить файлы

~/.claude/skills/iterm2/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/iterm2/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об iterm2

Как установить iterm2 в Claude Code?

Выполните npx skills add julianobarbosa/claude-code-skills --skill iterm2 -a claude-code. Файл скилла находится по пути ~/.claude/skills/iterm2/SKILL.md.

Что делает скилл iterm2?

Он даёт агенту справочные материалы и сценарии для работы с iTerm2 и tmux: от сочетаний клавиш и панелей до настройки и восстановления сессий.

Что нужно для режима tmux -CC?

На хосте должен быть установлен и запущен tmux-сервер. Для подключения к tmux на удалённой машине SSH нужно запускать из iTerm2, а не из скрипта, который создаёт вложенную оболочку.

Исходный текст

SKILL.md · MIT
---
name: iterm2
description: iTerm2 terminal emulator and tmux multiplexer expertise. USE WHEN user mentions iTerm2, tmux, terminal sessions, split panes, window management, OR terminal productivity on macOS.
---

# 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):
   ```bash
   ~/.claude/Tools/SkillWorkflowNotification WORKFLOWNAME Iterm2
   ```

2. **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 |

---

## Gotchas

- **"Reuse previous session's directory" is per-profile and per-context:** New windows from Cmd-N use the profile's window setting; new tabs from Cmd-T use the tab setting. They differ — confusing when prompts open in unexpected directories.
- **`tmux -CC` requires the tmux server to be installed and started:** If tmux is on a remote host but iTerm2 is local, `tmux -CC attach` works over SSH only when SSH was started from iTerm2 itself — not from a script that spawns a subshell.
- **Cmd-D split uses the current pane's profile, NOT the window default:** Once a profile changes mid-session (via shell integration), new splits inherit the modified profile and can carry unwanted env or PATH.
- **`Ctrl+b` prefix conflicts with readline `transpose-words`:** Vi-mode users who rebind it (`set -g prefix C-a`) must remember `Ctrl+a` also conflicts with screen and shell line-start — pick a free combo like `C-Space`.
- **Shell integration injects OSC 1337 escape codes:** Pipelines that capture terminal output (script, asciinema) end up with garbled control sequences unless integration is disabled per-pane via `Edit Session > Disable Shell Integration`.
- **Status bar updates run on the main thread:** Heavy custom status bar scripts (long `git status`, slow cloud CLIs) freeze the entire terminal — keep status callbacks under 100ms or run them async.

© julianobarbosa · MIT · julianobarbosa/claude-code-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
cli-anything-iterm2 HKUDS Скилл cli-anything-iterm2 для Claude Code подключает агента к живым сессиям iTerm2 через Python API: отправляет команды, читает вывод и scrollback, создаёт и помечает панели. CX Codex +1 559установок iterm2-layout terrylica Скилл iterm2-layout настраивает рабочие вкладки и панели iTerm2 через TOML-конфиг. Помогает агенту прописать пути проектов и включить автопоиск git worktree. CX Codex +1 126установок asciinema-player terrylica Скилл asciinema-player для Claude Code и пяти других платформ воспроизводит .cast записи терминала в iTerm2 через отдельное чистое окно. Файлы больше 100 МБ браузерный плеер не тянет — этот скилл открывает их потоком с диска. CX Codex +1 126установок tmux openclaw Даёт агенту доступ к живым tmux-сессиям: читать вывод панели, отправлять клавиши и текст, ждать появления строки в промпте. CX Codex +1 8 500установок tmux-status haxybaxy Плагин tmux-status выводит текущее состояние Claude Code иконкой в заголовке окна tmux. Вы сразу видите, ждёт ли агент подтверждения или выполняет задачу, не переключаясь на вкладку. ★ 6звёзд репо cmux-keyboard-shortcuts manaflow-ai Скилл cmux-keyboard-shortcuts для Claude Code настраивает горячие клавиши cmux в ~/.config/cmux/cmux.json. Позволяет перейти на стиль tmux и быстро проверить конфиг. CX Codex +1 6 500установок

Из того же набора37

Весь набор →
mimir Скилл объясняет агенту, как развернуть Grafana Mimir в Kubernetes и подключить S3, GCS или Azure Blob для долгого хранения метрик Prometheus. CX Codex +1 118установок obsidian-nvim Помогает настроить плагин obsidian.nvim в Neovim: подключить хранилища Obsidian, ежедневные заметки, поиск через ripgrep и автодополнение. CX Codex +1 116установок repomix Скилл repomix упаковывает репозиторий в один файл, который читает LLM: отбор файлов, сжатие до сигнатур, подсчёт токенов. Пригодится перед ревью и когда код надо втиснуть в контекст. CX Codex +1 115установок managing-infra Скилл managing-infra помогает выбрать между Helm и Kustomize, настроить модули Terraform и применить базовые стандарты безопасности в Kubernetes. CX Codex +1 115установок context7 Скилл ищет документацию и примеры кода для конкретной версии библиотеки через Context7. Пригодится перед написанием кода по API, в котором вы не уверены. CX Codex +1 114установок git-worktree Управляет параллельными рабочими деревьями git worktree с созданием окон tmux и вкладок iTerm2. Помогает работать над ветками без stash. CX Codex +1 111установок writing-typescript Скилл writing-typescript задаёт идиоматичный стиль TypeScript для сервисов Node.js, React-приложений и обсуждения TS-паттернов. Поддерживает строгую типизацию и современный toolchain. CX Codex +1 111установок az-aks-agent Скилл az-aks-agent для Claude Code разбирает состояние и настройки кластера Azure Kubernetes Service по запросам на обычном языке. Ищет проблемы с подами, сетью, хранилищем и RBAC. CX Codex +1 110установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой