CluxMate — кодовый агент на Python для любых моделей
CluxMate
Кодовый агент с ядром на Python и тремя интерфейсами: CLI для скриптов, TUI и приложение Electron, для моделей с API OpenAI
- 140 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент выполняет команды оболочки и правит файлы, а в режиме `yolo` песочница выключена
- Конфигурация репозитория (хуки, MCP, LSP) может запускать подпроцессы, если каталог признан доверенным
Установка
Ручная установка
pip install .Из папки клонированного репозитория r1c7/CluxMate. Нужен Python 3.12+. Затем cluxmate.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет команды оболочки и правит файлы, а в режиме `yolo` песочница выключена
- Конфигурация репозитория (хуки, MCP, LSP) может запускать подпроцессы, если каталог признан доверенным
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CluxMate — кодовый агент, который читает кодовую базу, планирует изменения, правит файлы, запускает команды и отвечает на вопросы. Одно ядро на Python питает три интерфейса: безголовый CLI для скриптов и CI (`cluxmate -p "..."`), интерактивный TUI на Textual (`cluxmate`) и настольное приложение Electron, которое говорит с ядром по JSON-RPC. Агент работает с любой моделью по API, совместимому с OpenAI: DeepSeek, Qwen, GLM, OpenAI, OpenRouter, Ollama или своя конечная точка достаточно указать в `base_url`. Каждая сессия хранится как журнал событий, поэтому любой запрос к модели можно воспроизвести дословно. Инструменты делятся на четыре уровня опасности (`safe`, `write`, `dangerous`, `critical`) и четыре режима разрешений: `plan`, `default`, `acceptEdits`, `yolo`. Запись файлов защищает WriteFence, команды оболочки идут в песочнице на уровне ОС, а сетевые запросы проходят защиту от SSRF. Есть скиллы, память проекта в `AGENTS.md`, серверы MCP с OAuth, хуки жизненного цикла, подагенты, LSP и рабочие деревья git.
Для кого. Разработчикам, которым нужен кодовый агент с выбором модели и жесткой изоляцией: DeepSeek, Qwen, GLM или своя модель вместо привязки к одному вендору.
Подходит, если
- Нужен агент для скриптов и CI с разовым запросом из командной строки
- Модель выбирается между DeepSeek, Qwen, GLM, OpenRouter и локальным Ollama без смены инструмента
- Каждый запрос к модели надо воспроизвести дословно по журналу событий
- Команды оболочки должны идти в песочнице, а секреты вроде `.env` и `~/.ssh` скрываться от модели
- Для репозитория требуется отдельное рабочее дерево git на ветке агента
Не подходит, если
- Нужна фронтирная модель с готовыми подписками: CluxMate работает через ключ API и `base_url`
- Нужен готовый бинарник без Python: для установки требуется Python 3.12 и новее
- Хочется режим yolo без последствий: он отключает песочницу
- Проект ранний: версия 0.1.0, интерфейсы и формат конфигурации могут меняться
Пример запроса к агенту
Выполни cluxmate -p с запросом «объясни устройство журнала сессий» в этом репозитории и покажи, какие инструменты агент использовал.Ограничения
Нужен Python 3.12 и новее, а для настольного приложения еще Node.js 18 и npm. Агенту нужны ключ API и `base_url` совместимой с OpenAI модели. Версия 0.1.0 ранняя, поэтому интерфейсы и формат конфигурации могут меняться.
Режим `yolo` отключает песочницу, а остальные режимы запрашивают подтверждение опасных команд. Конфигурация внутри `.cluxmate/` репозитория считается частью репозитория и читается только после явного доверия к каталогу. Защита чтения секретов включается отдельно, по умолчанию модель видит файлы, не закрытые запретом.
Как отключить. Удалите пакет командой `pip uninstall cluxmate`. Настройки лежат в `~/.cluxmate/`, а проектные в `.cluxmate/` репозитория: удалите их вручную. Рабочие деревья снимает команда `cluxmate worktree remove`.
Частые вопросы
Как поставить CluxMate?
Склонируйте репозиторий и выполните `pip install .` в нем: команда `cluxmate` появится в `PATH`. Для настольного приложения дополнительно зайдите в `desktop` и выполните `npm install`.
Какие модели поддерживаются?
Любые с API, совместимым с OpenAI: DeepSeek, Qwen, GLM, OpenAI, OpenRouter, Ollama или своя конечная точка через `base_url`. Можно настроить несколько и переключаться на лету.
Чем отличаются режимы разрешений?
`plan` только читает. `default` спрашивает о каждой записи и опасной команде, `acceptEdits` принимает правки без вопросов, а `yolo` снимает вопросы и отключает песочницу.
Что такое доверие к каталогу?
Конфигурация в `.cluxmate/` репозитория (хуки, `mcp.json`, скиллы) может запускать команды, поэтому читается только после вашего согласия. Состоянием управляют команды `cluxmate trust status`, `trust add` и `trust deny`.
Как подключить MCP-сервер с OAuth?
Укажите адрес в `mcp.json` и блок `oauth` либо пройдите вход командой `cluxmate mcp auth linear`. Состояние покажет `cluxmate mcp status`, а `cluxmate mcp logout` удалит сохраненные учетные данные.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
Агент для программирования на Rust с графическим окном, терминалом, режимом ACP для Zed и MCP-сервером
Kode CLI — терминальный кодинг-агент, который читает AGENTS.md и CLAUDE.md, подключает MCP и работает с разными моделями.
Терминальный кодовый агент, который сам выбирает модель под каждый запрос и показывает расход в реальном времени
Кодовый агент для терминала на Go: модели GLM, DeepSeek и локальный Ollama, 59 встроенных инструментов и MCP
Терминальный кодинг-агент в одном бинарнике Go для DeepSeek и других OpenAI-совместимых моделей, с графом кода и локальным OCR
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| CluxMate — кодовый агент на Python для любых моделей (эта карточка) | нет | 140 | |
| Kode CLI | нет | 5 238 | кодовый агент из каталога, а у CluxMate журнал событий и песочница в два слоя |
| Aider | нет | 50 089 | парный программист в терминале, без рабочих деревьев и песочницы на уровне ОС |
Коротко о README
README рассказывает об архитектуре одного ядра и трех интерфейсов, воспроизводимых сессиях, проверке завершения, песочнице в два слоя, защите от SSRF и ограничении исходящего трафика. Затем описаны доверие к проекту, рабочие деревья, подагенты, LSP, скиллы, MCP с OAuth, хуки, установка, использование и настройка.