ccmux CLI
ccmux показывает все кодовые агенты в tmux: кто работает, кто ждет вас, запуск в worktree и передача ответа между сессиями.
- 239 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- `ccmux setup` пишет хуки в конфигурацию агентов
- Кнопки Approve и Deny в уведомлениях разрешают действия агента, а ответы вводятся в чужую панель
- `ccmux invoke` запускает Copilot с флагом `--allow-all-tools`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ccmuxОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- `ccmux setup` пишет хуки в конфигурацию агентов
- Кнопки Approve и Deny в уведомлениях разрешают действия агента, а ответы вводятся в чужую панель
- `ccmux invoke` запускает Copilot с флагом `--allow-all-tools`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ccmux — фоновый демон и TUI-панель для сессий кодовых агентов в tmux. Он находит в панелях Claude Code, Codex, Cursor, OpenCode, Pi, Antigravity, Copilot и Gemini CLI, показывает состояние каждого (простой, работа, ожидание разрешения, плана или ответа) и по Enter переключает на нужную панель. Агентов запускают как обычно, перенастраивать их не нужно. Из панели создают и разветвляют сессии в новых git worktree, смотрят diff через hunk и выносят незакоммиченные изменения. `ccmux invoke` выполняет один ход агента для скриптов, `ccmux handoff` передает последний ответ другому агенту. В репозитории лежат два скилла: `dispatch` и `relay`.
Для кого. Разработчики, которые держат несколько агентов в панелях tmux и теряют, какой из них ждет разрешения.
Подходит, если
- Пять агентов работают в разных панелях, и надо быстро найти тот, что ждет подтверждения.
- Одну задачу пробуют на нескольких ветках: каждая сессия идет в своем git worktree.
- Ответ Codex передают Claude Code с заметкой командой `ccmux handoff codex claude`.
- Агент-оркестратор запускает рабочих через `ccmux invoke` и читает их результаты.
- Запрос разрешения подтверждают или отклоняют прямо из уведомления рабочего стола.
Не подходит, если
- Агентов запускают вне tmux.
- Хуки в конфигурации агентов менять нельзя, а `ccmux setup` их записывает.
- Нужен графический менеджер сессий без терминала.
Пример запроса к агенту
Покажи, какие мои агенты в tmux ждут разрешения, и передай последний ответ Codex в сессию Claude Code с заметкой.Ограничения
Работает только с агентами в tmux, для сведений о ветках и worktree нужен git 2.31 или новее. Команда `ccmux setup` ставит хуки в конфигурацию найденных агентов для точного сопоставления сессий. Без хуков ccmux работает, но менее точно. Уведомления с кнопками Approve и Deny выключены по умолчанию и дают решить за агента, не открывая панель. Ответ из уведомления на запрос разрешения поддержан только для Claude Code. Песочница без записи в `~/.config/ccmux` лишает хуки маркеров. Для сборки из исходников нужен Bun 1.3.14 или новее.
Как отключить. Выполните `brew uninstall ccmux` и завершите фоновый демон. Хуки, созданные `ccmux setup`, снимите в конфигурации агентов вручную, плагин уберите через `/plugin`.
Частые вопросы
Нужно ли запускать агентов особым образом?
Нет. ccmux находит их в панелях tmux и подхватывает уже идущие процессы.
Что ставит `ccmux setup`?
Хуки агентов для точного сопоставления сессий с панелями. Без них демон опирается на процессы и логи.
Как передать работу другому агенту?
Командой `ccmux handoff codex claude --note "..."`. Ответ приходит с заголовком об источнике и вставляется только в свободное поле ввода.
Какие агенты поддержаны?
Claude Code, Codex, Cursor, OpenCode, Pi, Antigravity, Copilot, Gemini CLI и собственные определения через конфиг.
Как включить уведомления?
Командой `ccmux config set notifications.enabled true`; `ccmux notify` отправляет тестовое уведомление и печатает диагностику. Кнопки Approve и Deny работают на macOS и Linux.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и консольное приложение показывают, какие кодовые агенты в ваших сессиях tmux работают, ждут вашего решения или закончили
TUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Настроенный tmux и CLI tmux-bridge: агенты читают соседние панели, вводят в них текст и обмениваются заданиями между собой.
Терминальный мультиплексор на Go с тайловыми панелями: показывает состояние Claude Code, Codex и других агентов и собирает их запросы в одном списке
Терминальная рабочая область, где несколько CLI-агентов вроде Codex, Claude и Gemini обмениваются сообщениями и работают над одной задачей под наблюдением челов
Панель управления для параллельных агентов Claude Code, Codex и Gemini CLI с общей доской задач и расписаниями
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ccmux (эта карточка) | нет | 239 | |
| tmux-ide | да | 563 | показывает, какие агенты в сессиях tmux работают, ждут решения или закончили; ccmux добавляет worktree, передачу ответов и `invoke` |
| CLI Agent Orchestrator | нет | 1 515 | координирует агентов через супервизора в сессиях tmux; ccmux следит за уже запущенными сессиями и передает работу между ними |
Коротко о README
Установка через Homebrew или из исходников, быстрый старт командой `ccmux`, панели, боковая полоса и уведомления. Подробно описаны worktree, форк сессий, `invoke`, `handoff`, хуки для сопоставления сессий и скиллы.