Codex Factory — плагин
Codex Factory ведет сложный проект в Codex как контролируемый процесс: планы, роли, память с источниками, независимая проверка
- 90 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Ставит хуки уровня проекта и запускает несколько субагентов Codex, которые пишут файлы и выполняют команды в проекте
- Хранит память проекта и ключ GLM-поиска в локальных файлах, при включении поиска запросы уходят внешнему сервису
Установка
- Работает в
Ручная установка
git clone https://github.com/yueheng-rgb/codex-factory.git C:\Codex_App_FactoryЗатем `packages/factory-cli/install.ps1` с `-ProjectRoot`. Нужны Node.js 24 и PowerShell.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ставит хуки уровня проекта и запускает несколько субагентов Codex, которые пишут файлы и выполняют команды в проекте
- Хранит память проекта и ключ GLM-поиска в локальных файлах, при включении поиска запросы уходят внешнему сервису
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Локальная плоскость управления для разработчиков, которые строят нетривиальное ПО в Codex или совместимых средах. Она превращает долгий хрупкий чат в процесс: маршрутизация задач, проверенный контекст, нативные субагенты и проверка результата независимыми доказательствами. По правилу авторов PASS без артефакта не засчитывается. Доказательством служат реальные файлы, коды завершения команд, хеши и квитанции. Версия V5 ставится на Windows скриптом `packages/factory-cli/install.ps1` с ключами `-MultiAgent`, `-Search` и `-MaxThreads`, а состояние проверяет `factoryctl doctor`. Многоагентный режим включается по желанию: главный агент Codex сам раскладывает работу, запускает постоянные роли и временных агентов и ведет волны проверки. Память отбирает по задаче и роли только актуальные записи с привязкой к источнику и хешу. Поиск GLM необязателен, ключ берется из `ZHIPUAI_API_KEY` или из игнорируемого `.codex-factory/secrets.env`. Хуки уровня проекта проверяют жизненный цикл субагентов.
Для кого. Разработчикам на Codex, у которых большие проекты теряют нить в длинных диалогах и которым нужны проверяемые доказательства завершения задач.
Подходит, если
- Проект идет несколько недель, и контекст надо хранить с привязкой к источнику вне истории чата
- Агент докладывает «готово», а завершение надо подтверждать файлами, хешами и кодами выхода команд
- Нужно запустить несколько субагентов с распределением ролей и волнами проверки
- Для проекта нужен офлайн-обзор сценариев командой `npm run demo:tour` без вызовов модели
Не подходит, если
- Нужна простая правка в одном файле: управляющий слой окажется избыточным
- Среда без Windows и PowerShell: установщик V5 написан под них
- Вам нужна защита на уровне ОС: `scope_guard` ловит выход за границы, но не заменяет права доступа или отдельное дерево git
Пример запроса к агенту
Подключи Codex Factory к проекту в C:\Projects\my-app с многоагентным режимом на четыре потока и проверь factoryctl doctorОграничения
- V5 описана как предварительная версия. Установщик рассчитан на Windows и PowerShell, нужны Node.js 24 или новее и Codex со средой, которая поддерживает настройку на уровне проекта.
- `scope_guard` находит пропущенные и выходящие за волну записи, но не показывает автора по каждому агенту и не заменяет права ОС.
- Хуки проекта при первом запуске или после изменения нужно просмотреть и подтвердить в `/hooks` по правилам безопасности Codex.
- Репозиторий большой и содержит множество исторических отчетов V4, последний коммит датирован сентябрем 2026 года.
Как отключить. Запустите деинсталляцию из `packages/factory-cli` по руководству `docs/CONTROL_PLANE_V5_GUIDE.zh-CN.md` либо удалите папки `.codex-factory` и добавленные хуки из проекта.
Частые вопросы
Как установить V5?
На Windows клонируйте репозиторий и выполните `packages/factory-cli/install.ps1` с `-ProjectRoot`, `-MultiAgent`, `-Search none` и `-MaxThreads 4`. После установки `factoryctl doctor --project <путь> --json` проверит готовность.
Что значит правило про артефакт и PASS?
Результат засчитывается только при независимом доказательстве: реальные файлы, код завершения команды, хеш или квитанция. Заявление агента о готовности доказательством не служит.
Нужен ли многоагентный режим?
Нет, он включается по желанию. Без него Factory работает с планами, ролевыми скиллами, памятью и проверкой на одном агенте.
Откуда берется ключ поиска GLM?
Из переменной `ZHIPUAI_API_KEY` или из игнорируемого файла `.codex-factory/secrets.env` в проекте. Поиск включается отдельным ключом `-Search`.
Как попробовать без модели?
В `packages/factory-cli` выполните `npm run demo:tour`: он офлайн показывает три сценария, сравнение результатов, повторное использование опыта и диагностику по гипотезам. Это обзор, реальной поставки проекта в нем нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Плагиныoh-my-codex
oh-my-codex (OMX)
Надстройка над Codex CLI: сквозной процесс от уточнения задачи до проверки, команды агентов, хуки, HUD и состояние в .omx/
Codex on Crack разделяет работу в Codex между моделями: ведущая планирует, рабочая реализует, ведущая принимает результат.
Агент OpenAI для программирования, который работает локально в терминале, с версиями для IDE и десктопа
Плагин Codex собирает для проекта команду из подагентов и скиллов: оркестратор раздает независимые задачи и сам проверяет итог.
CodexPotter гоняет Codex по кругу с чистым контекстом, пока код не совпадет с целью, и заменяет встроенную команду /goal.
Codex Astra + Luna Orchestrator
Codex Astra Orchestrator + Luna Subagents
Профили для Codex, где GPT-6 Astra оркеструет и проверяет, а GPT-5.6 Luna выполняет задачи в субагентах explorer, worker, tester и researcher
Коротко о README
README подает Codex Factory как слой инженерной надежности для кодинг-агентов. В нем краткое описание, предварительная версия V5 с установкой и границами, запуск быстрого старта, исторические проверки V4, архитектура и раздел ограничений. Основные руководства написаны на китайском языке.