tmux-ide CLI
CLI и консольное приложение показывают, какие кодовые агенты в ваших сессиях tmux работают, ждут вашего решения или закончили
- 558 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Команда `tmux-ide send` набирает текст прямо в промпт чужой панели, а читаемый экран может содержать секреты
- Команда `tmux-ide integration install claude` прописывает хуки в `~/.claude/settings.json`, а `tmux-ide adopt` добавляет в tmux строку состояния, боковую панель и клавиши
- Фоновый демон следит за панелями всех сессий и по SSH подключается к удаленным машинам, локальный сокет управления лежит в `~/.tmux-ide`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tmux-ideОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команда `tmux-ide send` набирает текст прямо в промпт чужой панели, а читаемый экран может содержать секреты
- Команда `tmux-ide integration install claude` прописывает хуки в `~/.claude/settings.json`, а `tmux-ide adopt` добавляет в tmux строку состояния, боковую панель и клавиши
- Фоновый демон следит за панелями всех сессий и по SSH подключается к удаленным машинам, локальный сокет управления лежит в `~/.tmux-ide`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tmux-ide показывает все кодовые агенты, запущенные в ваших сессиях tmux, и состояние каждого: работает, заблокирован, готов или простаивает. Процессами и панелями по-прежнему владеет tmux, поэтому закрытие tmux-ide агентов не останавливает. Команда `tmux-ide app` открывает полноэкранный интерфейс с двумя разделами. Раздел Home перечисляет агентов на локальных и SSH-машинах с поиском и фильтрами по статусу, Terminals показывает текущую сессию с вкладками окон и заголовками панелей. Статус берется из двух слоев. Агент может сам сообщить его через опцию tmux `@agent_state`, а для Claude Code есть готовые хуки, с которыми новые сессии сообщают состояние точно. Если сообщения нет, tmux-ide определяет агента по дереву процессов и читает экран панели. Когда агент блокируется или завершает работу, приходят уведомления tmux, macOS и терминала со звуком. CLI рассчитан на скрипты и самих агентов. Команда `tmux-ide team --json` выводит состояние всех сессий, `tmux-ide send` набирает текст в промпт другой панели, а `tmux-ide wait` ждет нужного статуса или строки в выводе. Через MCP и SDK доступны ограниченное чтение и отправка в панели. После падения tmux одна команда пересобирает окна и возобновляет разговоры Claude Code, Codex, Cursor и opencode.
Для кого. Для разработчиков, которые держат несколько Claude Code, Codex и других агентов в панелях tmux, в том числе на удаленных машинах по SSH.
Подходит, если
- В панелях tmux идут три Claude Code и два Codex, и вам нужно сразу увидеть, какой из них заблокирован и ждет вашего решения
- Сервер перезагрузился или упал tmux, и надо вернуть окна и продолжить разговоры агентов без ручной сборки
- Агент-координатор раздает задачи другим агентам командой `tmux-ide send` и ждет их завершения командой `tmux-ide wait agent-status`
- Часть агентов работает на удаленной машине по SSH, и вы хотите видеть ее рядом с локальными в одном списке
- Для каждой ветки нужны отдельный git worktree и сессия, которые создает команда `tmux-ide worktree create`
Не подходит, если
- Вы не пользуетесь tmux: tmux-ide работает только поверх его сессий
- Нужен оркестратор, который сам распределяет задачи между агентами: tmux-ide показывает и соединяет агентов, но ими не управляет
- Вы на Windows без WSL: приложение собрано для macOS и glibc Linux
- Уже запущенный tmux-сервер старше версии 3.7: tmux-ide не заменяет работающие серверы
Пример запроса к агенту
Поставь tmux-ide, подключи хуки Claude Code и покажи по `tmux-ide team --json`, какие агенты сейчас работают и какой ждет моего ответаОграничения
- Сам tmux-ide агентами не управляет. Он показывает их и связывает, а координацию через `tmux-ide send` и `tmux-ide wait` строите вы или ваш ведущий агент.
- Приложение работает на macOS 26 и новее для ARM64, на macOS 15 и новее для x64 и на Linux с glibc для ARM64 и x64. На Windows используйте WSL. Релиз содержит tmux 3.7c, но уже запущенные серверы tmux должны быть версии 3.7 или новее.
- Точный статус Claude Code требует установки хуков. Для агентов без проверенной схемы возобновления, например Gemini, Aider и Copilot, идентификатор сессии они сообщают сами.
- В версии 2.9 в приложении нет представлений для файлов, диффов и миссий.
Как отключить. Команда `tmux-ide unadopt` с именем сессии снимает панель и статусную строку, сессия остается обычным tmux. Хуки Claude Code убирает `tmux-ide integration uninstall claude`. Сам пакет удаляется командой `npm uninstall -g tmux-ide` или удалением папки, куда поставил установщик.
Частые вопросы
Как следить за несколькими Claude Code и Codex в tmux?
Установите tmux-ide и запустите `tmux-ide app`. В разделе Home (клавиша F1) видны все агенты с состоянием и фильтрами «Working» и «Needs attention», клавиша F2 открывает текущую сессию. Агент, которому нужен ответ, помечается как заблокированный, и клавиша Enter переводит к его панели.
Как получить точный статус Claude Code в tmux-ide?
Выполните `tmux-ide integration install claude`. Команда добавляет в `~/.claude/settings.json` хуки, которые на каждое событие жизненного цикла помечают панель как работающую, заблокированную, готовую или простаивающую. Работает для новых сессий Claude Code, а убирает хуки команда `tmux-ide integration uninstall claude`.
Как восстановить сессии агентов после падения tmux?
Сначала посмотрите план командой `tmux-ide restore --dry-run --json`, затем запустите `tmux-ide restore --resume-agents`. Она пересобирает окна из последнего снимка и возобновляет разговоры Claude Code, Codex, Cursor и opencode, для которых известен идентификатор сессии.
Как агенту сообщить свой статус в tmux-ide?
Командой `tmux set-option -p @agent_state "working:1730000000"`, где число после двоеточия хранит время в секундах. Допустимы состояния «working», «blocked», «done» и «idle». Запись «working» или «blocked» старше примерно десяти минут считается устаревшей, и tmux-ide возвращается к чтению экрана.
Как установить tmux-ide без sudo?
Выполните `curl -fsSL https://tmux-ide.com/install.sh | sh`. Установщик приносит свой Node.js, а в оба способа установки входит tmux 3.7c, поэтому ни sudo, ни системный tmux не нужны. Если Node.js 20 или новее уже есть, подойдет `npm install -g tmux-ide`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыTUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Терминальный мультиплексор на Go с тайловыми панелями: показывает состояние Claude Code, Codex и других агентов и собирает их запросы в одном списке
Терминальный менеджер сессий для Claude Code, Codex, Gemini CLI, OpenCode и других агентов: общий список со статусами, git worktree и управление с телефона
Панель управления для параллельных агентов Claude Code, Codex и Gemini CLI с общей доской задач и расписаниями
Терминальное приложение для параллельной работы нескольких Claude Code, Codex, Gemini CLI и Aider в отдельных сессиях tmux и git worktree
botmux связывает Lark и Feishu с Claude Code, Codex, Gemini CLI и OpenCode: каждое сообщение запускает отдельную сессию агента с живыми карточками
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| tmux-ide (эта запись) | да | 558 | |
| Agent Deck | нет | 1 180 | терминальный менеджер сессий для ИИ-агентов |
| Claude Squad | нет | 8 694 | терминальное приложение, которое само запускает параллельных агентов |
| tmux-claude-hatch — Claude Code во всплывающем окне tmux | нет | 403 | плагин tmux запускает сессию Claude Code во всплывающем окне на |
Коротко о README
README начинается с установки и перечня возможностей, затем описывает работу команды агентов и таблицу горячих клавиш. Отдельные разделы посвящены хукам Claude Code, необязательной раскладке окон в `workspace.yml` и слоям архитектуры: tmux, демон на каждой машине и приложение. В конце собраны ссылки на документацию и руководство для самих агентов.