botmux CLI
botmux связывает Lark и Feishu с Claude Code, Codex, Gemini CLI и OpenCode: каждое сообщение запускает отдельную сессию агента с живыми карточками
- 1 729 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Каждое сообщение в чате запускает консольного агента с доступом к вашему рабочему каталогу и командам оболочки
- Веб-терминал дает запись в живую сессию агента с телефона или из браузера
- Мастер сам создает приложение Lark, выдает ему права и публикует версию, а фоновая программа может стартовать вместе с системой
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/botmuxОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Каждое сообщение в чате запускает консольного агента с доступом к вашему рабочему каталогу и командам оболочки
- Веб-терминал дает запись в живую сессию агента с телефона или из браузера
- Мастер сам создает приложение Lark, выдает ему права и публикует версию, а фоновая программа может стартовать вместе с системой
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
botmux управляет Claude Code, Codex, Gemini CLI, OpenCode и другими консольными агентами из мессенджера Lark (Feishu). Фоновая программа слушает сообщения бота и на каждый новый диалог, группу или тему запускает отдельный процесс выбранного агента в вашем рабочем каталоге. Ответ агента приходит в чат живой карточкой, которая обновляется по ходу работы. Карточка показывает экран терминала снимком, а кнопки позволяют свернуть вывод, пролистать его, перезапустить сессию или закрыть ее. botmux подключает сам процесс консоли со всеми его хуками, памятью и командами через `/` и не переписывает возможности агента заново. Поэтому в сессии работают те же MCP-серверы, что и в обычном терминале. Адаптеров больше двадцати, конкретный агент задается полем `cliId` в `bots.json`, а для одной сессии его меняет команда `/cli codex`. Пока сессия идет, к тому же процессу можно подключиться через `tmux attach` или открыть веб-терминал, в котором доступны Esc, Ctrl+C и стрелки с телефона. Дальше сценарии расширяются. Команда `/adopt` забирает в чат сессию, уже запущенную в локальном tmux, а `/relay` переносит ее в другую группу вместе с контекстом. В одной группе можно держать несколько ботов на разных агентах: каждого вызывают упоминанием, например для совместной проверки одного merge request. Есть периодические задачи на естественном языке, запуск по webhook, режим дежурной группы и голосовая сводка к карточкам при настроенной озвучке.
Для кого. Для разработчиков и команд, которые работают в Lark или Feishu и хотят запускать консольных ИИ-агентов с телефона или из рабочих групп, не заходя на машину по SSH.
Подходит, если
- Агент работает на рабочем компьютере или сервере, а вы вдали от него и хотите видеть ход работы, задавать вопросы и прерывать его с телефона
- Команда сидит в Lark или Feishu, и разбор инцидента или код-ревью удобнее начинать упоминанием бота в дежурной группе
- Нужно сравнить мнения двух агентов, например Claude Code и Codex, в одной группе по одному и тому же merge request
- Сессия началась в терминале, и ее нужно передать коллегам командой `/relay`, не теряя контекста
- Периодическую задачу, вроде сводки по оповещениям, проще описать словами в чате, чем писать cron-скрипт
Не подходит, если
- Вы используете Telegram, Slack или другой мессенджер: адаптеры в проекте есть только для Lark и Feishu
- У вас Windows без WSL2: фоновой программе нужны PTY, tmux и сигналы Unix, поэтому на чистой Windows она не запустится
- Вам нужно просто получать уведомления и одобрять действия агента без запуска сессий из чата: такую задачу решает tlive
- Нужен доступ к агенту с телефона через собственные мобильные приложения, а не через мессенджер: для этого есть HAPI
Пример запроса к агенту
Поставь botmux на этот сервер, подключи его к Claude Code и покажи, как запустить сессию из рабочей группы в LarkОграничения
- Работает на Linux и macOS (x64 и arm64). На Windows ставить нужно внутри WSL2, потому что фоновой программе нужны PTY, tmux и сигналы Unix.
- Бот создает приложение Lark через сканирование QR-кода и сам настраивает права и публикует версию. Флаг `--no-open-platform-auto` оставляет права и публикацию вам.
- Старые версии до v3.18.0 нельзя обновлять через npm: переход от исходников на Node к бинарному виду не даст демону перезапуститься. Обновляйте повторным запуском команды установки.
- Нулевая инъекция промптов не работает с удаленными бэкендами и с рабочим процессом версии 3. Для Cursor и Antigravity она включает отдельный сбор ответов из транскриптов, а в изоляции `scratch` эти два агента не поддерживаются.
- Режим прокси модели помечен как экспериментальный. В файле `bots.json` держите только несекретные настройки и пути к файлам с ключами.
- Лицензия MIT.
Как отключить. Остановите фоновую программу командой `botmux stop`, а автозапуск отключите командой `botmux autostart disable`. Бинарник лежит в `~/.botmux/bin`: удалите этот каталог и строку с PATH, которую установщик дописал в файл запуска оболочки.
Частые вопросы
Как управлять Claude Code из Lark или Feishu?
Поставьте botmux, выполните `botmux setup` и отсканируйте QR-код: мастер создаст приложение Lark и предложит выбрать агента, например Claude Code, и рабочий каталог. После `botmux start` напишите боту в личные сообщения или в группу, и каждое сообщение запустит отдельную сессию агента в этом каталоге.
Нужен ли Node.js для установки botmux?
Нет, если ставить командой `curl` с `install.sh`: botmux поставляется одним самодостаточным бинарником, его контрольная сумма SHA-256 проверяется при установке, а сам файл попадает в `~/.botmux/bin`. Для установки через `npm install -g botmux` нужен Node 22 или новее, но внутри лежит тот же бинарник.
Как перенять сессию, которая уже идет в терминале, и отдать ее команде?
Для локального tmux команда `/adopt` забирает сессию в чат. Команда `/relay` переносит ее в другую группу вместе с процессом и памятью, поэтому контекст не теряется.
Можно ли запустить в одной группе Claude Code и Codex?
Да, для этого в группу добавляют ботов, каждый из которых настроен на свой агент через `cliId`, и вызывают нужного упоминанием. По описанию проекта они могут независимо проверять один и тот же merge request и спорить, если мнения расходятся.
Как запускать агента по расписанию или по webhook?
Расписание задается обычными словами в чате, например для сводки по оповещениям. Для запуска из внешних систем есть webhook и API запуска задач, описанные в документации проекта.
Работает ли botmux на Windows?
Только внутри WSL2. Фоновая программа использует PTY, tmux и сигналы Unix и на Windows без WSL2 не запустится. Установщик в неподдерживаемой среде сообщает об ошибке и оставляет прежнюю версию на месте.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI, через который агенты в разных терминалах переписываются, следят друг за другом и запускают друг друга
Скилл для обмена сообщениями между Claude Code, Codex, Gemini CLI и другими консольными агентами через общую локальную базу SQLite на bash
Десять ИИ-агентов в панелях tmux: менеджер раздает задачи семи исполнителям, ход работы виден на панели, поддержаны Claude Code, Codex, Cursor и OpenCode
Локальная панель для управления множеством агентов на разных машинах: память, граф кода и обмен сообщениями между агентами
Терминальная рабочая область, где несколько CLI-агентов вроде Codex, Claude и Gemini обмениваются сообщениями и работают над одной задачей под наблюдением челов
Доска задач на Rust для терминала: каждая задача идет в своем git worktree и окне tmux, а Claude Code, Codex, Gemini CLI и другие агенты работают вместе
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| botmux (эта запись) | нет | 1 729 | |
| tlive | нет | 215 | наблюдение и одобрение действий Claude Code и Codex из Telegram или Feishu, запуск сессий из чата не основная задача |
| HAPI | нет | 5 279 | удаленный доступ к сессиям через мобильные приложения и Web, а не через мессенджер |
| Lark CLI | да | 17 789 | официальный CLI Lark и Feishu, который дает агенту команды для сообщений и документов, а не управляет самим агентом из чата |
Коротко о README
В репозитории есть двуязычная документация на китайском и английском, пошаговое подключение за пять минут, описание основных сценариев и таблица поддерживаемых агентов. Отдельные разделы посвящены безопасному хранению ключей в `bots.json`, нулевой инъекции промптов, обратной связи по ответам и сессиям Codex с несколькими каталогами входа. Рядом лежат пример `bots.json.example`, каталог `docs` с описанием песочницы файлов, режима прокси модели и вебхуков, а также тесты и скрипты сборки бинарника.