К основному содержанию
плагин

tmux — плагин для Claude Code: что делает и как установить

Подключает Claude Code к активным панелям терминала через tmux. Агент читает вывод тестов, следит за dev-сервером и шлёт команды в запущенный REPL.

MIT ★ 114 обновлён 2026-08-11

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add nicknisi/claude-plugins
/plugin install tmux@nicknisi
Открыть на GitHub

Что делает tmux

Плагин связывает агента с существующей сессией через хук hooks/tmux-awareness.sh. Если переменная $TMUX задана, при старте сессии Claude сразу видит снимок открытых сплитов и запущенных в них команд. Без хука ассистент не узнаёт о терминалах рядом, пока пользователь явно не напомнит о них.

Внутри заложены два режима работы. В режиме Mode A агент наблюдает за текущим окном, снимает текст через capture-pane и передаёт нажатия клавиш. Скрипт safe-send.sh защищает чужие панели и блокирует ввод в редакторы или пейджеры без принудительного флага. Режим Mode B запускает изолированные сессии на отдельном сокете с параметром -f /dev/null, не трогая рабочие сплиты разработчика.

В набор входят готовые скрипты для поиска панелей по портам, ожидания нужного текста в выводе и выполнения команд с возвратом кода завершения. Если хук изменили, сессию Claude Code придётся перезапустить.

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

  • читать логи серверов разработки прямо из соседних сплитов
  • передавать команды в запущенный Node REPL или отладчик
  • запускать изолированные фоновые процессы на отдельном сокете tmux
  • дожидаться появления нужной строки в терминале перед следующим шагом

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

  • Посмотри вывод dev-сервера в соседнем сплите и найди причину ошибки сборки
  • Запусти тесты через vitest во второй панели и дождись завершения прогона
  • Отправь команду в запущенный Node REPL и прочитай ответ

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

Через маркетплейс плагинов

/plugin marketplace add nicknisi/claude-plugins
/plugin install tmux@nicknisi

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

Вопросы о tmux

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

Выполните две команды по очереди: сначала добавьте источник /plugin marketplace add nicknisi/claude-plugins, затем установите плагин /plugin install tmux@nicknisi.

Зачем нужен плагин tmux для Claude Code?

Он даёт агенту доступ к терминалам, которые уже открыты у разработчика. Claude видит вывод серверов и REPL, вместо того чтобы запускать изолированные невидимые песочницы.

Чем различаются режимы Mode A и Mode B?

Режим Mode A управляет текущими сплитами разработчика и считывает вывод запущенных процессов. Режим Mode B создаёт временную сессию на изолированном сокете, не трогая открытые окна.

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

tmux · MIT
# tmux

Makes Claude aware of tmux — and able to use it. When Claude Code runs inside a
tmux pane, the terminals you're watching (dev servers, test watchers, REPLs,
logs, editors) live on _your_ tmux server. This plugin lets Claude see and drive
those surfaces, instead of only spawning sandbox sessions you can't see.

## Components

### SessionStart hook — `hooks/tmux-awareness.sh`

Fires when a session starts. If `$TMUX` is set, it injects a short note plus a
live snapshot of your visible panes (location + running command) into Claude's
context, and points it at the `tmux` skill for the full workflow. If you're not
in tmux, it stays silent. This is what gives Claude _awareness_ — a skill alone
only loads on demand, after Claude already suspects tmux is relevant.

### `tmux` skill — `skills/tmux/`

The how-to, in two modes:

- **Mode A — observe & control the user's tmux.** Detect the server from
  `$TMUX`, list panes, scrape output with `capture-pane`, and (carefully) send
  keystrokes into existing panes. Defaults to the current window — the splits
  for the project you're working on. Includes safety rules for writing into
  panes you didn't create.
- **Mode B — isolated sandbox.** Spawn throwaway sessions on a private socket,
  kept separate from your tmux (launched with `-f /dev/null` for predictable
  0-based indexing).

Examples lean toward TypeScript/Node workflows (Node REPL, `vite`/`next dev`,
`vitest`, `node inspect`), but the mechanics are language-agnostic.

### Bundled scripts — `skills/tmux/scripts/`

- **find-panes.sh** — list panes with command, cwd, and listening ports (`-p`);
  scoped to the current window by default.
- **run-in-pane.sh** — run a command in a shell pane, wait for it to finish, and
  return only that command's output (with its exit code).
- **wait-for-text.sh** — poll a pane for a success pattern, an error pattern
  (fail fast), or an idle period.
- **safe-send.sh** — guarded `send-keys` that refuses editors/pagers/TUIs unless
  forced.
- **find-sessions.sh** — enumerate sessions on a socket (Mode B).

## Notes

- Reading panes (`capture-pane`) is always safe. Sending keys into a pane you
  didn't create can disrupt the user's work — the skill documents when to
  confirm first and when to use a dedicated window instead.
- Hooks load at session start; after editing the hook, restart Claude Code for
  changes to take effect (`claude --debug` to inspect).

© Nick Nisi · MIT · nicknisi/claude-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
tmux-status haxybaxy Плагин tmux-status выводит текущее состояние Claude Code иконкой в заголовке окна tmux. Вы сразу видите, ждёт ли агент подтверждения или выполняет задачу, не переключаясь на вкладку. ★ 6звёзд репо tmux-terminal mikeyobrien Скилл tmux-terminal для Claude Code управляет интерактивными терминальными сессиями через tmux: отправляет клавиши, считывает вывод и оставляет процессы работать между шагами. Работает с TUI и долгими CLI-задачами. CX Codex +1 ★ 3 206звёзд репо cmux-terminal-multiplexer reason-machines Скилл cmux-terminal-multiplexer организует сплиты терминала и запускает встроенный Chromium для Claude Code и других кодинг-агентов через CLI с адресацией по поверхностям. CX Codex +1 1 500установок cmux-ref manaflow-ai Скилл cmux-ref разбирает скопированные идентификаторы сессий cmux и направляет команды агента в нужный терминал или окно. Пригодится при параллельной работе с несколькими панелями. CX Codex +1 762установок herdr herdrdev Скилл даёт агенту доступ к Herdr — терминальному мультиплексору для кодинг-агентов: панели, вкладки, воркспейсы и запуск команд. CX Codex +1 87 100установок tmux-fleet larcane97 Скилл tmux-fleet для Claude Code и Codex. Разворачивает несколько кодинг-агентов в окнах tmux, каждый под своим профилем clausona, и следит за их работой через статусную строку сессии. CX Codex +1 ★ 62звёзд репо

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

Весь набор →
blog-post-writer Скилл blog-post-writer превращает разрозненные заметки, логи и коммиты в сухой черновик статьи с подтверждёнными фактами и заглушками для личных мыслей автора. CX Codex +1 ★ 114звёзд репо conference-talk-builder Скилл conference-talk-builder для Claude Code собирает из заметок, расшифровки или идеи сценарий технического доклада с планом слайдов. Выстраивает материал в связный рассказ. CX Codex +1 ★ 114звёзд репо youtube-notes Скилл youtube-notes для Claude Code превращает субтитры YouTube в заметки по главам со ссылками на таймкоды. Подключается к ссылке на YouTube или просьбе разобрать видео. CX Codex +1 ★ 114звёзд репо security-auditor Субагент security-auditor ищет критические уязвимости в кодовой базе через анализ связей между доверием, доступом и ресурсами. Запускается для явного аудита безопасности. CX Codex ★ 114звёзд репо sources Плагин sources для Claude Code читает посты в X и Reddit и разбирает YouTube-видео по субтитрам. Создаёт выжимки, ответы по видео и заметки. ★ 114звёзд репо image-gen Скилл image-gen внутри плагина рисует и правит изображения через Gemini или gpt-image-2: диаграммы, иллюстрации, заливка области по маске. ★ 114звёзд репо essentials Плагин essentials для Claude Code объединяет специализированных агентов и скиллы для повседневной разработки: от семантических коммитов до многоуровневого ревью кода. ★ 114звёзд репо content Плагин content для Claude Code превращает заметки в посты для блога и планы докладов, а также редактирует текст. Собирает связный рассказ из разрозненных идей. ★ 114звёзд репо

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

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