tmux — плагин для Claude Code: что делает и как установить
Подключает Claude Code к активным панелям терминала через tmux. Агент читает вывод тестов, следит за dev-сервером и шлёт команды в запущенный REPL.
MIT ★ 114 обновлён 2026-08-11
/plugin marketplace add nicknisi/claude-plugins
/plugin install tmux@nicknisiЧто делает 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