tmux · mitsuhiko — скилл для Claude Code: что делает и как установить
Управляет интерактивными CLI-сессиями через tmux с изолированным сокетом. Пригодится, когда агенту нужно запускать Python или lldb и читать их вывод.
npx skills add mitsuhiko/agent-stuff --skill tmux -a claude-codeЧто делает tmux
Скилл позволяет агенту открывать терминальные сессии в фоне, отправлять нажатия клавиш и считывать буфер экрана. Для изоляции агент держит отдельный сокет в каталоге под CLAUDE_TMUX_SOCKET_DIR (по умолчанию в ${TMPDIR:-/tmp}/claude-tmux-sockets). Личные сессии пользователя при этом не задеваются. Инструмент работает на Linux и macOS со стандартным tmux.
Внутри предусмотрены вспомогательные bash-скрипты: find-sessions.sh для поиска запущенных процессов и wait-for-text.sh для ожидания нужного текста или приглашения по тайм-ауту. При отладке скилл выбирает lldb, а для интерактивного Python обязательно выставляет переменную окружения PYTHON_BASIC_REPL=1. Без этой переменной расширенный REPL ломает приём команд из send-keys.
При каждом запуске сессии агент обязан вывести команду для ручного подключения через tmux attach или разового снятия вывода. По завершении работы все фоновые процессы гасятся вызовом kill-session или очисткой сокета.
Какие задачи решает
- Управлять интерактивными консольными программами вроде Python REPL или bash
- Запускать отладку в lldb или gdb и перехватывать стек вызовов
- Изолировать сессии агента от пользовательских настроек через отдельный сокет
- Дожидаться вывода нужного текста в терминале перед отправкой следующей команды
Примеры запросов агенту
- Запусти скрипт в tmux-сессии и проверь, дошёл ли он до вывода ошибки
- Открой Python REPL в изолированном tmux и посчитай хеш строки
- Запусти lldb для бинарника ./a.out и сними бэктрейс при падении
Как установить tmux
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill tmux -a claude-code2Вручную: положить файлы
~/.claude/skills/tmux/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tmux/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill tmux -a codex2Вручную: положить файлы
.agents/skills/tmux/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill tmux -a cursor2Вручную: положить файлы
.cursor/skills/tmux/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mitsuhiko/agent-stuff tmux2Вручную: положить файлы
.github/skills/tmux/SKILL.md1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill tmux -a gemini-cli2Командой платформы
gemini skills install https://github.com/mitsuhiko/agent-stuff --path skills/tmuxВручную: положить файлы
.devin/skills/tmux/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill tmux -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tmux
Как установить tmux в Claude Code?
Выполните в терминале команду npx skills add mitsuhiko/agent-stuff --skill tmux -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/tmux/SKILL.md.
Зачем скиллу отдельный сокет для tmux?
Скилл использует путь из переменной CLAUDE_TMUX_SOCKET_DIR, чтобы не смешивать процессы агента с вашей личной конфигурацией tmux.
Зачем выставляется переменная PYTHON_BASIC_REPL=1?
Стандартная консоль современных версий Python мешает корректной отправке клавиш через send-keys. Установка PYTHON_BASIC_REPL=1 возвращает базовый REPL, с которым агент может надёжно взаимодействовать.
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — tmux от других авторов.
