FableCodex — плагин
Плагин для Codex: журнал целей с доказательствами и шлюз замечаний, чтобы агент не объявлял работу готовой без проверки
- 439 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Скрипты на Python пишут журналы в папку .codex-fable5/ внутри вашего проекта
- Команда codex-fable5 update обновляет копию плагина до последнего стабильного тега из репозитория автора
Установка
- Работает в
Ручная установка
codex plugin marketplace add baskduf/FableCodex --ref v0.5.1Первый шаг: добавить каталог плагина со стабильным тегом.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипты на Python пишут журналы в папку .codex-fable5/ внутри вашего проекта
- Команда codex-fable5 update обновляет копию плагина до последнего стабильного тега из репозитория автора
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
FableCodex ставит в Codex плагин codex-fable5, который вызывается в запросе словом @codex-fable5 и включает более строгие правила работы. Сначала агент классифицирует задачу, затем осматривает проект и инструменты, пользуется родными инструментами Codex, а в конце проверяет результат тестами, линтером, скриншотом или выводом команды. Правила автор пересказал из файла CLAUDE-FABLE-5.md в репозитории CL4R1T4S: осмотреть до действия, вести цели, записывать доказательства, закрывать замечания ревью и проверять до заявления о готовности. Для долгой работы вспомогательная команда codex-fable5 ведет журнал целей в файле .codex-fable5/goals.json. Каждая цель закрывается записью с доказательством, а последняя требует еще и команду проверки с ее результатом. Для ревью есть второй журнал, findings.json: принятое замечание нельзя потерять, пока оно не закрыто описанием исправления и проверкой. Команда codex-fable5 findings gate завершается ошибкой, если остались открытые или заблокированные замечания, и тогда последняя цель тоже не закрывается. Состояние лежит в папке .codex-fable5/ вместе с ledger.jsonl, куда события дописываются построчно. Отдельный документ описывает необязательный мост к модели через шлюз с интерфейсом OpenAI, например LiteLLM.
Для кого. Для разработчиков, которые ведут в Codex многошаговую работу, где дорогая ошибка опаснее лишнего процесса: рефакторинг, релизы, миграции, задачи с ревью.
Подходит, если
- Многошаговый рефакторинг или миграция, где каждый шаг должен закрываться доказательством
- Отладка с неочевидной причиной: агент сначала воспроизводит ошибку, держит несколько гипотез и ищет факты, которые их опровергают
- Сбой CI, подготовка релиза или правка, связанная с безопасностью
- Ревью, после которого нерешенные замечания должны блокировать финальный ответ
- Вы переводите промпты в стиле Claude или Fable в руководство для Codex
Не подходит, если
- Короткий ответ или правка одного файла: журнал целей займет больше времени, чем сама работа
- Мозговой штурм, где проверка результата не предполагается
- Вы ждете от плагина возможностей модели Fable 5: он их не добавляет
- Нужно ограничить действия агента: запрет на commit и push вы формулируете в самом запросе, плагин границ за вас не ставит
Пример запроса к агенту
@codex-fable5 Почини падающий импорт CSV: заведи журнал целей, запиши замечания ревью и не завершай работу, пока тесты и шлюз замечаний не пройдутОграничения
Плагин работает только внутри Codex и управляется запросом: строгость, область и условия остановки вы формулируете сами. Скрипты написаны на Python, и запускают их через python3. Журналы лежат в рабочей папке проекта, и коммитить их стоит только когда нужен протокол задачи. Лицензия AGPL-3.0-or-later: проверьте, подходит ли она вашему проекту. Плагин опирается на Codex, а API OpenAI из России недоступны. Мост к модели требует собственного доступа к Anthropic и шлюза вроде LiteLLM, которых репозиторий не предоставляет.
Как отключить. Отдельной команды удаления в документации нет. Уберите плагин через менеджер плагинов Codex, а папку .codex-fable5/ в проекте удалите вручную, если журналы больше не нужны.
Частые вопросы
Как поставить FableCodex в Codex?
Нужны две команды: добавление каталога плагина со стабильным тегом и установка codex-fable5 из него. После этого перезапустите Codex и вызовите плагин словом @codex-fable5 в запросе. Для ветки разработки вместо тега указывают --ref main.
Дает ли FableCodex возможности модели Fable 5?
Нет. Плагин не копирует, не разблокирует и не заменяет модель. Он добавляет подсказки по организации работы, локальные журналы, примеры и необязательные документы о подключении другой модели через шлюз.
Что делает команда codex-fable5 findings gate?
Она завершается ошибкой, пока остаются замечания со статусом open или blocked. Закрытие финальной цели при блокирующих замечаниях тоже не проходит, поэтому агент не может объявить работу готовой над неразобранным ревью.
Где хранится состояние и нужно ли его коммитить?
В папке .codex-fable5/ внутри проекта лежат goals.json с планом и доказательствами, findings.json с замечаниями и ledger.jsonl с историей событий. Это рабочее состояние, коммитить его нужно только если вы сознательно храните протокол задачи.
Как обновить плагин?
Команда codex-fable5 update переводит копию плагина на последний стабильный тег v*. Ключ --ref main нужен, только если вы намеренно хотите ветку разработки. Обновление меняет сам плагин и не трогает доступ к моделям и учетные данные провайдеров.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Codex для Claude Code
Codex plugin for Claude Code
Официальный плагин OpenAI: ревью изменений силами Codex и передача задач в Codex прямо из сессии Claude Code
Надстройка над OpenAI Codex, которая добавляет память проекта, планирование и проверку завершения задач перед тем, как считать их готовыми
Плагин Claude Code: Claude выполняет задачу, затем хук остановки запускает независимое ревью в Codex, и Claude правит замечания в той же сессии
Скилл для Claude Code, который передает задачи в командную строку Codex от OpenAI для анализа, ревью и правок кода
Скилл для Codex, который ведет цикл измеримых экспериментов над репозиторием к числовой цели: правка, проверка, откат неудач, повтор
Плагин Codex для измеряемых экспериментов в репозитории: базовая метрика, проверка мелких правок и патч с доказательствами
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| FableCodex (эта запись) | нет | 439 | |
| Pilot Shell | нет | 2 103 | готовая обвязка для Claude Code и Codex со спецификациями, TDD и памятью между сессиями |
| oh-my-openagent | нет | 70 440 | оркестратор нескольких агентов для OpenCode и Codex CLI с хуками и встроенными MCP |
Коротко о README
Страница начинается с быстрой установки и примеров запросов в строгом и легком режимах, затем описывает журнал целей, шлюз замечаний и таблицу команд. В конце идут варианты установки, скрипт, который сверяет локальную копию описания Fable и записывает решение по каждому разделу, и список источников, которые автор пересказал: CL4R1T4S, fablize и value-for-fable.