smux CLI
Настроенный tmux и CLI tmux-bridge: агенты читают соседние панели, вводят в них текст и обмениваются заданиями между собой.
- 1 532 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент вводит текст и клавиши в любую панель tmux, в том числе в открытую оболочку, и это равно запуску команд от вашего пользователя.
- Установщик запускается из сети через `curl | bash` и ставит пакеты в систему.
Установка
- Работает в
Ручная установка
curl -fsSL https://shawnpana.com/smux/install.sh | bashПервая команда Install из README: ставит tmux, конфигурацию, `tmux-bridge` и `smux-pane` в `~/.smux/`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент вводит текст и клавиши в любую панель tmux, в том числе в открытую оболочку, и это равно запуску команд от вашего пользователя.
- Установщик запускается из сети через `curl | bash` и ставит пакеты в систему.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
smux ставит одной командой настроенный tmux и два CLI. Клавиши работают на Option без префикса, мышь выделяет и копирует текст, у панелей есть подписи. `tmux-bridge` читает последние строки любой панели, вводит в нее текст и посылает клавиши, поэтому Claude Code поручает задачу Codex в соседней панели, а ответ приходит в его собственную. Перед вводом CLI требует прочитать панель, поэтому опрашивать чужую панель в цикле не нужно. Скилл `smux`, который ставит `npx skills add ShawnPana/smux`, объясняет агенту этот порядок и команды самого tmux. Второй CLI, `smux-pane`, запоминает закрытые панели и окна и возвращает их с рабочим каталогом и подписью. Панель с Claude Code воскресает вместе с той же беседой.
Для кого. Тем, кто ведет несколько агентов в соседних панелях tmux и хочет, чтобы они сами обменивались заданиями и ответами.
Подходит, если
- Claude Code просит Codex в соседней панели проверить изменения в `src/auth.ts`.
- Агенту надо прочитать вывод долгого процесса в другой панели и ответить на его запрос подтверждения.
- Панель с рабочей беседой Claude Code закрыли случайно, и ее нужно вернуть вместе с сессией.
- Вы работаете в tmux и хотите единые клавиши на Option без префикса и выделение мышью.
Не подходит, если
- Рабочая машина на Windows: установщик рассчитан на macOS и Linux.
- Агенты запущены в отдельных окнах приложений, а не в панелях tmux.
- В соседних панелях открыты оболочки с боевыми SSH-подключениями, куда агент не должен вводить команды.
Пример запроса к агенту
Подпиши эту панель как claude, прочитай панель codex, попроси ее проверить `src/auth.ts` и жди ответа в своей панели.Ограничения
Поддерживаются macOS с Homebrew и Linux. Tmux версии 3.2 и новее и jq установщик ставит сам, Windows в требованиях нет. Установка идет командой `curl ... | bash`: она запускает скрипт из сети и ставит пакеты менеджером системы, поэтому скрипт стоит прочитать заранее. При возврате закрытой панели заново запускается только Claude Code, остальные процессы возвращаются обычной оболочкой, а прокрутка не сохраняется. Хранятся последние 25 закрытий. Скилл по своим метаданным требует установленных `tmux` и `tmux-bridge`.
Как отключить. Команда `smux uninstall` удаляет установку. Скилл снимается командой `npx skills remove smux`.
Частые вопросы
Как поставить smux для Claude Code?
Выполните установочную команду `curl -fsSL https://shawnpana.com/smux/install.sh | bash`: она ставит tmux, конфигурацию и оба CLI в `~/.smux/`. Затем добавьте скилл командой `npx skills add ShawnPana/smux`, и Claude Code узнает про `tmux-bridge`.
Как один агент отправляет сообщение другому?
По цепочке чтение, сообщение, чтение, отправка: `tmux-bridge read codex 20`, затем `tmux-bridge message codex 'текст'`, повторное чтение и `tmux-bridge keys codex Enter`. Команда `message` добавляет в начало адрес отправителя, и получатель отвечает в панель, указанную в этой строке.
Почему `tmux-bridge type` отвечает ошибкой?
Панель не прочитана. Сначала выполните `tmux-bridge read <метка>`, после чего ввод проходит. После каждой успешной записи отметка сбрасывается, и перед следующей надо читать панель снова.
Как вернуть закрытую панель?
Нажмите `Option+Shift+n` или выполните `smux-pane revive`. Что можно вернуть, показывает `smux-pane list`, а `smux-pane peek <панель>` показывает запись заранее, без закрытия.
Как обновить или удалить smux?
Обновление идет командой `smux update`, удаление командой `smux uninstall`. Все файлы лежат в `~/.smux/`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и консольное приложение показывают, какие кодовые агенты в ваших сессиях tmux работают, ждут вашего решения или закончили
ccmux показывает все кодовые агенты в tmux: кто работает, кто ждет вас, запуск в worktree и передача ответа между сессиями.
TUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Терминальный мультиплексор на Go с тайловыми панелями: показывает состояние Claude Code, Codex и других агентов и собирает их запросы в одном списке
botmux связывает Lark и Feishu с Claude Code, Codex, Gemini CLI и OpenCode: каждое сообщение запускает отдельную сессию агента с живыми карточками
Терминальная рабочая область, где несколько CLI-агентов вроде Codex, Claude и Gemini обмениваются сообщениями и работают над одной задачей под наблюдением челов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| smux (эта карточка) | нет | 1 532 | ||
| Tmux MCP Server — доступ агента к сессиям tmux | нет | не нужна | 306 | дает агенту инструменты tmux через MCP; smux работает обычными командами bash и добавляет конфигурацию, скилл и возврат панелей |
| tmux-ide | да | 563 | показывает, какие агенты в сессиях tmux работают или ждут решения; smux передает сообщения между агентами | |
| CCB (Claude Codex Bridge) | нет | 3 609 | строит отдельную рабочую область для нескольких CLI-агентов; smux использует обычные панели tmux |
Коротко о README
Проект состоит из трех частей: настройка tmux для человека, CLI для агентов и возврат закрытых панелей. Для каждой части приведена таблица клавиш или команд.