CCManager CLI

Установка

Работает в

• Claude Code
• Gemini CLI
• Codex
• Cursor
• GitHub Copilot
• Cline
• OpenCode

npx skillfoxx add cli/ccmanager

Что делает

CCManager — терминальное приложение, которое запускает несколько сессий кодовых агентов параллельно, каждую в отдельном рабочем дереве Git. Ставится командой `npm install -g ccmanager`, запускается командой `ccmanager` или через `npx ccmanager`, работает без tmux. Список поддерживаемых агентов: Claude Code, Gemini CLI, Codex CLI, Cursor Agent, Copilot CLI, Cline CLI, OpenCode, Kimi CLI, MiniMax Code и Grok Build. Для каждого есть свой способ определять состояние, поэтому в меню видно, какая сессия занята, ждет вашего ответа или свободна. Возврат из сессии в меню по умолчанию на Ctrl+E. Из меню создаются, сливаются и удаляются рабочие деревья, а несколько репозиториев ведутся из одного интерфейса. При создании дерева CCManager может скопировать данные сессии Claude Code из `~/.claude/projects` в каталог нового дерева, чтобы разговор продолжился с тем же контекстом. Если в корне репозитория лежит файл `.worktreeinclude`, в новое дерево переносятся игнорируемые Git файлы вроде `.env`, и только те, что подходят под шаблон и действительно игнорируются. Настройки лежат в `~/.config/ccmanager/config.json` и в файле `.ccmanager.json` в корне репозитория, проектные значения важнее глобальных. Через них задаются наборы команд с запасными аргументами, горячие клавиши, шаблон путей для новых деревьев по имени ветки, хуки на смену статуса сессии и на создание дерева. Репозиторий также служит маркетплейсом с плагином `ccmanager-config`: скилл учит Claude Code или Codex схеме настроек и прогоняет проверку файла после правки.

Для кого. Для разработчиков, которые гоняют несколько кодовых агентов по ветвям одного или нескольких репозиториев и хотят видеть их состояния в одном меню без tmux.

Пример запроса к агенту

Настрой ccmanager в этом репозитории: запускай codex по умолчанию и присылай уведомление, когда сессия ждет моего ответа

Ограничения

• Закрытие CCManager завершает процессы запущенных им агентов. При следующем старте он предложит восстановить сессии из `~/.config/ccmanager/sessions.json`, но команда запускается заново: прежний вывод терминала и разговор внутри агента не возвращаются.
• Неверный файл настроек не вызывает ошибок: JSON с ошибкой отбрасывается целиком, неизвестные ключи игнорируются, поэтому опечатка выглядит как неработающая функция. После правки файла вне приложения выберите пункт перезагрузки настроек с диска.
• Для сессий `claude` с режимом определения состояния по умолчанию CCManager сам добавляет аргумент `--teammate-mode in-process`, пока вы не задали свое значение.
• Автоодобрение помечено экспериментальным: разбор запросов поручен Claude (Haiku) или вашей команде, при ошибке и тайм-ауте остается ручное подтверждение.
• Для Gemini CLI есть отдельная инструкция по настройке в `docs/gemini-support.md`. Лицензия MIT, версия пакета 4.4.9.

Как отключить. Удалите пакет командой `npm uninstall -g ccmanager`. Файлы настроек лежат в `~/.config/ccmanager` и в `.ccmanager.json` репозитория. Плагин `ccmanager-config` снимается через менеджер плагинов Claude Code или Codex.

Коротко о README

В репозитории лежат исходники приложения на TypeScript, каталог `docs` с отдельными руководствами и плагин `ccmanager-config` с проверочным скриптом. Главная страница начинается со списка возможностей и сравнения с Claude Squad, дальше идут установка, горячие клавиши, настройки на уровне проекта, таблица поддерживаемых агентов и разделы про наборы команд, копирование данных сессии, файл `.worktreeinclude`, восстановление сессий, хуки, автоодобрение и devcontainer.