Язык: English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย

Everything OpenAI Codex

Бейджи GitHub и npm выше являются источником истины. ecc — MIT-licensed система workflow для OpenAI Codex с проверяемым каталогом и публичной веткой rc.1.

Операционная система для серьёзной работы с OpenAI Codex.

Не просто конфиги. Это полноценная система: навыки, инстинкты, оптимизация памяти, непрерывное обучение, сканирование безопасности и разработка с приоритетом исследований. Готовые к рабочему использованию агенты, навыки, хуки, правила, конфигурации MCP и устаревшие совместимые заглушки команд, отточенные за 10+ месяцев интенсивного ежедневного использования при создании реальных продуктов.

Работает в OpenAI Codex, Codex, Cursor, OpenCode, Gemini и других средах агентного ИИ.

ecc v2.0.0-rc.1 добавляет публичную историю оператора Hermes поверх этого переиспользуемого слоя: начните с руководства по настройке Hermes, затем прочитайте примечания к выпуску rc.1 и архитектуру для разных сред.

Основная документация

Эта страница является вводным переводом. Для актуальных рабочих деталей используйте поддерживаемые документы в репозитории, а не внешние видео или треды.

Что нового

v2.0.0-rc.1 — Обновление публичного контура, операторские рабочие процессы и ecc 2.0 Alpha (апрель 2026)

• Dashboard GUI — новое настольное приложение на Tkinter (ecc_dashboard.py или npm run dashboard) с переключателем тёмной/светлой темы, настройкой шрифта и логотипом проекта в заголовке и панели задач.
• Публичный контур синхронизирован с текущим репозиторием — метаданные, счётчики каталога, манифесты плагинов и документация для установки теперь соответствуют реальному OSS-набору: 50 агентов, 185 навыков и 68 устаревших совместимых заглушек команд.
• Расширение операторских и outbound-рабочих процессов — brand-voice, social-graph-ranker, connections-optimizer, customer-billing-ops, google-workspace-ops, project-flow-ops и workspace-surface-audit закрывают операторское направление.
• Медиа и инструменты запуска — manim-video, remotion-video-creation и обновлённые интерфейсы публикации в соцсетях делают технические объяснения и launch-контент частью той же системы.
• Рост поддержки фреймворков и продуктов — nestjs-patterns, более развитые пути установки для Codex/OpenCode и расширенная упаковка для разных сред сохраняют полезность репозитория не только для OpenAI Codex.
• ecc 2.0 alpha находится в дереве репозитория — прототип control plane на Rust в ecc2/ теперь собирается локально и предоставляет команды dashboard, start, sessions, status, stop, resume и daemon. Это пригодная к использованию alpha-версия, но ещё не общий релиз.

v1.9.0 — Выборочная установка и расширение языковой поддержки (март 2026)

• Архитектура выборочной установки — установка на основе манифестов через install-plan.js и install-apply.js для точечной установки компонентов. Хранилище состояния отслеживает установленные компоненты и поддерживает инкрементальные обновления.
• 6 новых агентов — typescript-reviewer, pytorch-build-resolver, java-build-resolver, java-reviewer, kotlin-reviewer, kotlin-build-resolver расширяют языковое покрытие до 10 языков.
• Новые навыки — pytorch-patterns для рабочих процессов глубокого обучения, documentation-lookup для исследования API-справочников, bun-runtime и nextjs-turbopack для современных JS-инструментов, а также 8 операционных предметных навыков и mcp-server-patterns.
• Инфраструктура сессий и состояния — SQLite-хранилище состояния с CLI для запросов, адаптеры сессий для структурированной записи, фундамент эволюции навыков для самоулучшающихся skills.
• Переработка оркестрации — оценка аудита среды стала детерминированной, статус оркестрации и совместимость launcher укреплены, предотвращение observer loops реализовано 5-уровневой защитой.
• Надёжность observer — исправление взрывного роста памяти через throttling и tail sampling, исправление доступа к песочнице, lazy-start логика и защита от повторного входа.
• 12 языковых экосистем — новые правила для Java, PHP, Perl, Kotlin/Android/KMP, C++ и Rust добавлены к существующим правилам TypeScript, Python, Go и общим правилам.
• Вклад сообщества — переводы на корейский и китайский, оптимизация biome hook, навыки обработки видео, операционные навыки, PowerShell-установщик, поддержка Antigravity IDE.
• Укрепление CI — исправлены 19 падений тестов, добавлена принудительная проверка счётчиков каталога, валидация установочного манифеста, полный набор тестов проходит.

v1.8.0 — Система повышения эффективности сред агентного ИИ (март 2026)

• Релиз с фокусом на средах агентного ИИ — ecc теперь явно позиционируется как система повышения эффективности таких сред, а не просто набор конфигов.
• Переработка надёжности хуков — fallback корня для SessionStart, сводки сессий в фазе Stop и скриптовые хуки вместо хрупких inline-однострочников.
• Управление хуками во время выполнения — ecc_HOOK_PROFILE=minimal|standard|strict и ecc_DISABLED_HOOKS=... для runtime-ограничений без редактирования файлов хуков.
• Новые команды для сред — /harness-audit, /loop-start, /loop-status, /quality-gate, /model-route.
• NanoClaw v2 — маршрутизация моделей, горячая загрузка навыков, ветвление/поиск/экспорт/компактификация/метрики сессий.
• Паритет между средами — поведение ужесточено для OpenAI Codex, Cursor, OpenCode и Codex app/CLI.
• 997 внутренних тестов проходят — весь набор зелёный после рефакторинга hooks/runtime и обновлений совместимости.

v1.7.0 — Расширение на другие платформы и конструктор презентаций (февраль 2026)

• Поддержка Codex app + CLI — прямая поддержка Codex через AGENTS.md, выбор цели установщика и документация по Codex
• Навык frontend-slides — HTML-конструктор презентаций без зависимостей, с рекомендациями по конвертации PPTX и строгими правилами подгонки под viewport
• 5 новых общих бизнес- и контент-навыков — article-writing, content-engine, market-research, investor-materials, investor-outreach
• Более широкое покрытие инструментов — поддержка Cursor, Codex и OpenCode усилена так, чтобы один репозиторий аккуратно поставлялся во все основные среды
• 992 внутренних теста — расширенная валидация и регрессионное покрытие для плагина, хуков, навыков и упаковки

v1.4.1 — Исправление ошибки (февраль 2026)

• Исправлена потеря содержимого при импорте инстинктов — parse_instinct_file() незаметно отбрасывал всё содержимое после frontmatter (разделы Action, Evidence, Examples) во время /instinct-import. (#148, #161)

v1.4.0 — Многоязычные правила, мастер установки и PM2 (февраль 2026)

• Интерактивный мастер установки — новый навык configure-ecc предоставляет пошаговую настройку с обнаружением merge/overwrite
• PM2 и многоагентная оркестрация — 6 новых команд (/pm2, /multi-plan, /multi-execute, /multi-backend, /multi-frontend, /multi-workflow) для управления сложными многоcервисными рабочими процессами
• Архитектура многоязычных правил — правила реструктурированы из плоских файлов в директории common/ + typescript/ + python/ + golang/. Устанавливайте только нужные языки
• Переводы на китайский (zh-CN) — полный перевод всех агентов, команд, навыков и правил (80+ файлов)
• Улучшенный CONTRIBUTING.md — подробные шаблоны PR для каждого типа вклада

v1.3.0 — Поддержка плагина OpenCode (февраль 2026)

• Полная интеграция OpenCode — 12 агентов, 24 команды, 16 навыков с поддержкой хуков через систему плагинов OpenCode (20+ типов событий)
• 3 нативных custom tools — run-tests, check-coverage, security-audit
• LLM-документация — llms.txt с полной документацией OpenCode

v1.2.0 — Унифицированные команды и навыки (февраль 2026)

• Поддержка Python/Django — паттерны Django, безопасность, TDD и навыки верификации
• Навыки Java Spring Boot — паттерны, безопасность, TDD и верификация для Spring Boot
• Управление сессиями — команда /sessions для истории сессий
• Непрерывное обучение v2 — обучение на основе инстинктов с оценкой уверенности, импортом/экспортом и эволюцией

Полный журнал изменений смотрите в Releases.

Быстрый старт

Запустите всё менее чем за 2 минуты:

Выберите только один путь

Большинству пользователей OpenAI Codex нужен ровно один путь установки:

• Рекомендуемый вариант по умолчанию: установите плагин OpenAI Codex, затем скопируйте только те папки правил, которые вам действительно нужны.
• Используйте ручной установщик только если вам нужен более тонкий контроль, вы хотите полностью избежать пути через плагин или ваша сборка OpenAI Codex не может разрешить self-hosted запись в marketplace.
• Не накладывайте методы установки друг на друга. Самая частая сломанная конфигурация: сначала /plugin install, затем install.sh --profile full или npx eoc-install --profile full.

Если вы уже наложили несколько установок и видите дублирование, сразу переходите к разделу Сброс / удаление ecc.

Путь с малым контекстом / без хуков

Если хуки кажутся слишком глобальными или вам нужны только правила, агенты, команды и основные навыки рабочих процессов ecc, пропустите плагин и используйте минимальный ручной профиль:

./install.sh --profile minimal --target codex

.\install.ps1 --profile minimal --target codex
# или
npx eoc-install --profile minimal --target codex

Этот профиль намеренно исключает hooks-runtime.

Если вам нужен обычный core-профиль, но без хуков, используйте:

./install.sh --profile core --without baseline:hooks --target codex

Добавляйте хуки позже только если вам нужно runtime-принуждение:

./install.sh --target codex --modules hooks-runtime

Сначала найдите нужные компоненты

Если вы не уверены, какой профиль ecc или компонент установить, спросите упакованный advisor из любого проекта:

npx eoc consult "security reviews" --target codex

Он вернёт подходящие компоненты, связанные профили и команды предпросмотра/установки. Используйте команду предпросмотра перед установкой, если хотите посмотреть точный план файлов.

Шаг 1: Установите плагин (рекомендуется)

ПРИМЕЧАНИЕ: Плагин удобен, но OSS-установщик ниже всё ещё остаётся самым надёжным путём, если ваша сборка OpenAI Codex не может разрешить self-hosted записи marketplace.

# Добавьте marketplace
/plugin marketplace add https://github.com/mturac/everything-openai-codex

# Установите плагин
/plugin install eoc@eoc

Примечание об именовании и миграции

У ecc теперь три публичных идентификатора, и они не взаимозаменяемы:

• исходный репозиторий GitHub: mturac/everything-openai-codex
• идентификатор Codex marketplace/plugin: eoc@eoc
• npm-пакет: @mturac/eoc

Это сделано намеренно. Установки OpenAI marketplace/plugin ключуются каноническим идентификатором плагина, поэтому ecc использует eoc@eoc, чтобы имена инструментов и пространства имен slash-команд оставались достаточно короткими для строгих валидаторов Desktop/API. Старые публикации могут всё ещё показывать прежний длинный marketplace-идентификатор; считайте его только устаревшим alias. Отдельно npm-пакет остался @mturac/eoc, поэтому npm-установки и marketplace-установки намеренно используют разные имена.

Шаг 2: Установите правила (обязательно)

ПРЕДУПРЕЖДЕНИЕ: Важно: плагины OpenAI Codex не могут автоматически распространять rules.

Если вы уже установили ecc через /plugin install, не запускайте после этого ./install.sh --profile full, .\install.ps1 --profile full или npx eoc-install --profile full. Плагин уже загружает навыки, команды и хуки ecc. Запуск полного установщика после установки плагина скопирует те же компоненты в пользовательские директории и может создать дублирующиеся навыки и дублирующееся runtime-поведение.

Для установки через плагин вручную скопируйте только нужные директории rules/ в ~/.codex/rules/ecc/. Начните с rules/common плюс один языковой или framework-пакет, который вы действительно используете. Не копируйте все директории правил, если явно не хотите весь этот контекст в Codex.

Используйте полный установщик только если делаете полностью ручную установку ecc вместо пути через плагин.

# Сначала клонируйте репозиторий
git clone https://github.com/mturac/everything-openai-codex.git
cd Everything OpenAI Codex

# Установите зависимости (выберите пакетный менеджер)
npm install        # или: pnpm install | yarn install | bun install

# Путь установки через плагин: скопируйте только правила ecc в пространство имён ecc
mkdir -p ~/.codex/rules/ecc
cp -R rules/common ~/.codex/rules/ecc/
cp -R rules/typescript ~/.codex/rules/ecc/

# Полностью ручной путь установки ecc (используйте вместо /plugin install)
# ./install.sh --profile full

# Windows PowerShell

# Путь установки через плагин: скопируйте только правила ecc в пространство имён ecc
New-Item -ItemType Directory -Force -Path "$HOME/.codex/rules/ecc" | Out-Null
Copy-Item -Recurse rules/common "$HOME/.codex/rules/ecc/"
Copy-Item -Recurse rules/typescript "$HOME/.codex/rules/ecc/"

# Полностью ручной путь установки ecc (используйте вместо /plugin install)
# .\install.ps1 --profile full
# npx eoc-install --profile full

Инструкции по ручной установке смотрите в README в папке rules/. При ручном копировании правил копируйте всю языковую директорию целиком (например, rules/common или rules/golang), а не файлы внутри неё, чтобы относительные ссылки продолжали работать и имена файлов не конфликтовали.

Полностью ручная установка (fallback)

Используйте это только если вы намеренно пропускаете путь через плагин:

./install.sh --profile full

.\install.ps1 --profile full
# или
npx eoc-install --profile full

Если выбираете этот путь, на нём и остановитесь. Не запускайте дополнительно /plugin install.

Сброс / удаление ecc

Если ecc кажется дублированным, навязчивым или сломанным, не переустанавливайте его снова поверх самого себя.

• Путь через плагин: удалите плагин из OpenAI Codex, затем удалите конкретные папки правил, которые вы вручную скопировали в ~/.codex/rules/ecc/.
• Ручной установщик / CLI-путь: из корня репозитория сначала посмотрите preview удаления:

node scripts/uninstall.js --dry-run

Затем удалите файлы, управляемые ecc:

node scripts/uninstall.js

Также можно использовать lifecycle-wrapper:

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run

ecc удаляет только файлы, записанные в его install-state. Он не удалит посторонние файлы, которые сам не устанавливал.

Если вы смешали методы, очищайте в таком порядке:

1. Удалите установку плагина OpenAI Codex.
2. Запустите команду удаления ecc из корня репозитория, чтобы удалить файлы, управляемые install-state.
3. Удалите любые дополнительные папки правил, которые вы скопировали вручную и больше не хотите использовать.
4. Переустановите один раз, используя один путь.

Шаг 3: Начните использовать

# Навыки — основной рабочий интерфейс.
# Существующие slash-style имена команд продолжают работать, пока ecc мигрирует с commands/.

# Установка через плагин использует каноническую форму с namespace
/eoc:plan "Добавить аутентификацию пользователей"

# Ручная установка сохраняет более короткую slash-форму:
# /plan "Добавить аутентификацию пользователей"

# Проверить доступные команды
/plugin list eoc@eoc

Готово. Теперь у вас есть доступ к 50 агентам, 185 навыкам и 68 устаревшим совместимым заглушкам команд.

Dashboard GUI

Запустите настольную панель управления, чтобы визуально изучить компоненты ecc:

npm run dashboard
# или
python3 ./ecc_dashboard.py

Возможности:

• интерфейс с вкладками: Agents, Skills, Commands, Rules, Settings
• переключение тёмной/светлой темы
• настройка шрифта (семейство и размер)
• логотип проекта в заголовке и панели задач
• поиск и фильтрация по всем компонентам

Мультимодельные команды требуют дополнительной настройки

ПРЕДУПРЕЖДЕНИЕ: команды multi-* не покрываются базовой установкой плагина/правил выше.

Чтобы использовать /multi-plan, /multi-execute, /multi-backend, /multi-frontend и /multi-workflow, нужно также установить runtime ccg-workflow.

Инициализируйте его через npx ccg-workflow.

Этот runtime предоставляет внешние зависимости, которых ожидают эти команды, включая:

• ~/.codex/bin/codeagent-wrapper
• ~/.codex/.ccg/prompts/*

Без ccg-workflow эти multi-* команды не будут работать корректно.

Кроссплатформенная поддержка

Плагин теперь полностью поддерживает Windows, macOS и Linux, а также плотно интегрирован с основными IDE (Cursor, OpenCode, Antigravity) и CLI-средами. Все хуки и скрипты переписаны на Node.js для максимальной совместимости.

Определение пакетного менеджера

Плагин автоматически определяет предпочитаемый пакетный менеджер (npm, pnpm, yarn или bun) в таком порядке приоритета:

1. Переменная окружения: CODEX_PACKAGE_MANAGER
2. Конфиг проекта: .codex/package-manager.json
3. package.json: поле packageManager
4. Lock-файл: определение по package-lock.json, yarn.lock, pnpm-lock.yaml или bun.lockb
5. Глобальный конфиг: ~/.codex/package-manager.json
6. Fallback: первый доступный пакетный менеджер

Чтобы задать предпочитаемый пакетный менеджер:

# Через переменную окружения
export CODEX_PACKAGE_MANAGER=pnpm

# Через глобальный конфиг
node scripts/setup-package-manager.js --global pnpm

# Через конфиг проекта
node scripts/setup-package-manager.js --project bun

# Определить текущую настройку
node scripts/setup-package-manager.js --detect

Или используйте команду /setup-pm в OpenAI Codex.

Управление хуками во время выполнения

Используйте флаги времени выполнения, чтобы настроить строгость или временно отключить отдельные хуки:

# Профиль строгости хуков (по умолчанию: standard)
export ecc_HOOK_PROFILE=standard

# ID хуков для отключения, перечисленные через запятую
export ecc_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

# Ограничить дополнительный контекст SessionStart (по умолчанию: 8000 символов)
export ecc_SESSION_START_MAX_CHARS=4000

# Полностью отключить дополнительный контекст SessionStart для local-model/low-context настроек
export ecc_SESSION_START_CONTEXT=off

Что внутри

Этот репозиторий — плагин OpenAI Codex: установите его напрямую или скопируйте компоненты вручную.

Everything OpenAI Codex/
|-- .codex-plugin/   # Манифесты плагина и marketplace
|   |-- plugin.json         # Метаданные плагина и пути компонентов
|   |-- marketplace.json    # Каталог marketplace для /plugin marketplace add
|
|-- agents/           # 50 специализированных субагентов для делегирования
|   |-- planner.md           # Планирование реализации функций
|   |-- architect.md         # Решения по системному дизайну
|   |-- tdd-guide.md         # Разработка через тестирование
|   |-- code-reviewer.md     # Проверка качества и безопасности
|   |-- security-reviewer.md # Анализ уязвимостей
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # E2E-тестирование Playwright
|   |-- refactor-cleaner.md  # Очистка мёртвого кода
|   |-- doc-updater.md       # Синхронизация документации
|   |-- docs-lookup.md       # Поиск документации/API
|   |-- chief-of-staff.md    # Триаж коммуникаций и черновики
|   |-- loop-operator.md     # Выполнение автономных циклов
|   |-- harness-optimizer.md # Тюнинг конфигурации среды агентного ИИ
|   |-- cpp-reviewer.md      # Ревью C++ кода
|   |-- cpp-build-resolver.md # Исправление ошибок сборки C++
|   |-- go-reviewer.md       # Ревью Go-кода
|   |-- go-build-resolver.md # Исправление ошибок сборки Go
|   |-- python-reviewer.md   # Ревью Python-кода
|   |-- database-reviewer.md # Ревью Database/Supabase
|   |-- typescript-reviewer.md # Ревью TypeScript/JavaScript кода
|   |-- java-reviewer.md     # Ревью Java/Spring Boot кода
|   |-- java-build-resolver.md # Ошибки Java/Maven/Gradle сборки
|   |-- kotlin-reviewer.md   # Ревью Kotlin/Android/KMP кода
|   |-- kotlin-build-resolver.md # Ошибки Kotlin/Gradle сборки
|   |-- rust-reviewer.md     # Ревью Rust-кода
|   |-- rust-build-resolver.md # Исправление ошибок сборки Rust
|   |-- pytorch-build-resolver.md # Ошибки PyTorch/CUDA/training
|
|-- skills/           # Определения рабочих процессов и предметные знания
|   |-- coding-standards/           # Лучшие практики языков
|   |-- clickhouse-io/              # ClickHouse analytics, queries, data engineering
|   |-- backend-patterns/           # Паттерны API, БД, кеширования
|   |-- frontend-patterns/          # Паттерны React, Next.js
|   |-- frontend-slides/            # HTML-слайды и PPTX-to-web workflow презентаций (НОВОЕ)
|   |-- article-writing/            # Длинные тексты в заданном голосе без generic AI tone (НОВОЕ)
|   |-- content-engine/             # Мультиплатформенный social content и переупаковка материалов (НОВОЕ)
|   |-- market-research/            # Market/competitor/investor research с атрибуцией источников (НОВОЕ)
|   |-- investor-materials/         # Pitch decks, one-pagers, memos и финансовые модели (НОВОЕ)
|   |-- investor-outreach/          # Персонализированный fundraising outreach и follow-up (НОВОЕ)
|   |-- continuous-learning/        # Legacy v1 Stop-hook extraction паттернов
|   |-- continuous-learning-v2/     # Обучение на основе инстинктов с confidence scoring
|   |-- iterative-retrieval/        # Прогрессивное уточнение контекста для субагентов
|   |-- strategic-compact/          # Рекомендации по ручной компактификации (Longform Guide)
|   |-- tdd-workflow/               # Методология TDD
|   |-- security-review/            # Чеклист безопасности
|   |-- eval-harness/               # Оценка verification loop (Longform Guide)
|   |-- verification-loop/          # Непрерывная верификация (Longform Guide)
|   |-- videodb/                   # Видео и аудио: ingest, search, edit, generate, stream (НОВОЕ)
|   |-- golang-patterns/            # Go idioms и лучшие практики
|   |-- golang-testing/             # Паттерны тестирования Go, TDD, benchmarks
|   |-- cpp-coding-standards/         # C++ coding standards из C++ Core Guidelines (НОВОЕ)
|   |-- cpp-testing/                # C++ тестирование с GoogleTest, CMake/CTest (НОВОЕ)
|   |-- django-patterns/            # Django patterns, models, views (НОВОЕ)
|   |-- django-security/            # Лучшие практики безопасности Django (НОВОЕ)
|   |-- django-tdd/                 # Django TDD workflow (НОВОЕ)
|   |-- django-verification/        # Django verification loops (НОВОЕ)
|   |-- laravel-patterns/           # Архитектурные паттерны Laravel (НОВОЕ)
|   |-- laravel-security/           # Лучшие практики безопасности Laravel (НОВОЕ)
|   |-- laravel-tdd/                # Laravel TDD workflow (НОВОЕ)
|   |-- laravel-verification/       # Laravel verification loops (НОВОЕ)
|   |-- python-patterns/            # Python idioms и лучшие практики (НОВОЕ)
|   |-- python-testing/             # Тестирование Python с pytest (НОВОЕ)
|   |-- springboot-patterns/        # Паттерны Java Spring Boot (НОВОЕ)
|   |-- springboot-security/        # Безопасность Spring Boot (НОВОЕ)
|   |-- springboot-tdd/             # Spring Boot TDD (НОВОЕ)
|   |-- springboot-verification/    # Spring Boot verification (НОВОЕ)
|   |-- configure-ecc/              # Интерактивный мастер установки (НОВОЕ)
|   |-- java-coding-standards/     # Стандарты кодирования Java (НОВОЕ)
|   |-- jpa-patterns/              # Паттерны JPA/Hibernate (НОВОЕ)
|   |-- postgres-patterns/         # Паттерны оптимизации PostgreSQL (НОВОЕ)
|   |-- nutrient-document-processing/ # Обработка документов через Nutrient API (НОВОЕ)
|   |-- docs/examples/project-guidelines-template.md  # Шаблон проектных skills
|   |-- database-migrations/         # Паттерны миграций (Prisma, Drizzle, Django, Go) (НОВОЕ)
|   |-- api-design/                  # REST API design, pagination, error responses (НОВОЕ)
|   |-- deployment-patterns/         # CI/CD, Docker, health checks, rollbacks (НОВОЕ)
|   |-- docker-patterns/            # Docker Compose, networking, volumes, container security (НОВОЕ)
|   |-- e2e-testing/                 # Playwright E2E patterns и Page Object Model (НОВОЕ)
|   |-- content-hash-cache-pattern/  # Кеширование по SHA-256 content hash для обработки файлов (НОВОЕ)
|   |-- cost-aware-llm-pipeline/     # Оптимизация LLM-затрат, model routing, budget tracking (НОВОЕ)
|   |-- regex-vs-llm-structured-text/ # Decision framework: regex vs LLM для разбора текста (НОВОЕ)
|   |-- swift-actor-persistence/     # Thread-safe Swift data persistence через actors (НОВОЕ)
|   |-- swift-protocol-di-testing/   # Protocol-based DI для тестируемого Swift-кода (НОВОЕ)
|   |-- search-first/               # Workflow research-before-coding (НОВОЕ)
|   |-- skill-stocktake/            # Аудит навыков и команд на качество (НОВОЕ)
|   |-- liquid-glass-design/         # iOS 26 Liquid Glass design system (НОВОЕ)
|   |-- foundation-models-on-device/ # Apple on-device LLM с FoundationModels (НОВОЕ)
|   |-- swift-concurrency-6-2/       # Swift 6.2 Approachable Concurrency (НОВОЕ)
|   |-- perl-patterns/             # Современные Perl 5.36+ idioms и лучшие практики (НОВОЕ)
|   |-- perl-security/             # Perl security patterns, taint mode, safe I/O (НОВОЕ)
|   |-- perl-testing/              # Perl TDD с Test2::V0, prove, Devel::Cover (НОВОЕ)
|   |-- autonomous-loops/           # Паттерны автономных циклов: sequential pipelines, PR loops, DAG orchestration (НОВОЕ)
|   |-- plankton-code-quality/      # Write-time code quality enforcement через Plankton hooks (НОВОЕ)
|
|-- commands/         # Поддерживаемая совместимость slash entries; предпочитайте skills/
|   |-- plan.md             # /plan - Планирование реализации
|   |-- code-review.md      # /code-review - Ревью качества
|   |-- build-fix.md        # /build-fix - Исправление ошибок сборки
|   |-- refactor-clean.md   # /refactor-clean - Удаление мёртвого кода
|   |-- quality-gate.md     # /quality-gate - Verification gate
|   |-- learn.md            # /learn - Извлечение паттернов в середине сессии (Longform Guide)
|   |-- learn-eval.md       # /learn-eval - Извлечь, оценить и сохранить паттерны (НОВОЕ)
|   |-- checkpoint.md       # /checkpoint - Сохранить состояние верификации (Longform Guide)
|   |-- setup-pm.md         # /setup-pm - Настроить пакетный менеджер
|   |-- go-review.md        # /go-review - Ревью Go-кода (НОВОЕ)
|   |-- go-test.md          # /go-test - Go TDD workflow (НОВОЕ)
|   |-- go-build.md         # /go-build - Исправить ошибки сборки Go (НОВОЕ)
|   |-- skill-create.md     # /skill-create - Генерировать skills из истории Git (НОВОЕ)
|   |-- instinct-status.md  # /instinct-status - Посмотреть изученные инстинкты (НОВОЕ)
|   |-- instinct-import.md  # /instinct-import - Импортировать инстинкты (НОВОЕ)
|   |-- instinct-export.md  # /instinct-export - Экспортировать инстинкты (НОВОЕ)
|   |-- evolve.md           # /evolve - Кластеризовать инстинкты в skills
|   |-- prune.md            # /prune - Удалить истёкшие pending-инстинкты (НОВОЕ)
|   |-- pm2.md              # /pm2 - Управление lifecycle сервисов PM2 (НОВОЕ)
|   |-- multi-plan.md       # /multi-plan - Многоагентная декомпозиция задач (НОВОЕ)
|   |-- multi-execute.md    # /multi-execute - Оркестрированные многоагентные workflow (НОВОЕ)
|   |-- multi-backend.md    # /multi-backend - Backend multi-service orchestration (НОВОЕ)
|   |-- multi-frontend.md   # /multi-frontend - Frontend multi-service orchestration (НОВОЕ)
|   |-- multi-workflow.md   # /multi-workflow - General multi-service workflows (НОВОЕ)
|   |-- sessions.md         # /sessions - Управление историей сессий
|   |-- test-coverage.md    # /test-coverage - Анализ покрытия тестами
|   |-- update-docs.md      # /update-docs - Обновление документации
|   |-- update-codemaps.md  # /update-codemaps - Обновление codemaps
|   |-- python-review.md    # /python-review - Ревью Python-кода (НОВОЕ)
|-- legacy-command-shims/   # Opt-in архив retired shims вроде /tdd и /eval
|   |-- tdd.md              # /tdd - Предпочитайте skill tdd-workflow
|   |-- e2e.md              # /e2e - Предпочитайте skill e2e-testing
|   |-- eval.md             # /eval - Предпочитайте skill eval-harness
|   |-- verify.md           # /verify - Предпочитайте skill verification-loop
|   |-- orchestrate.md      # /orchestrate - Предпочитайте dmux-workflows или multi-workflow
|
|-- rules/            # Always-follow guidelines (копируйте в ~/.codex/rules/ecc/)
|   |-- README.md            # Обзор структуры и руководство по установке
|   |-- common/              # Языконезависимые принципы
|   |   |-- coding-style.md    # Иммутабельность, организация файлов
|   |   |-- git-workflow.md    # Формат коммитов, PR-процесс
|   |   |-- testing.md         # TDD, требование 80% покрытия
|   |   |-- performance.md     # Выбор моделей, управление контекстом
|   |   |-- patterns.md        # Design patterns, skeleton projects
|   |   |-- hooks.md           # Архитектура хуков, TodoWrite
|   |   |-- agents.md          # Когда делегировать субагентам
|   |   |-- security.md        # Обязательные проверки безопасности
|   |-- typescript/          # Специфика TypeScript/JavaScript
|   |-- python/              # Специфика Python
|   |-- golang/              # Специфика Go
|   |-- swift/               # Специфика Swift
|   |-- php/                 # Специфика PHP (НОВОЕ)
|
|-- hooks/            # Автоматизации на основе триггеров
|   |-- README.md                 # Документация хуков, рецепты и руководство по кастомизации
|   |-- hooks.json                # Конфиг всех хуков (PreToolUse, PostToolUse, Stop и т.д.)
|   |-- memory-persistence/       # Хуки lifecycle сессии (Longform Guide)
|   |-- strategic-compact/        # Предложения компактификации (Longform Guide)
|
|-- scripts/          # Кроссплатформенные Node.js скрипты (НОВОЕ)
|   |-- lib/                     # Общие утилиты
|   |   |-- utils.js             # Кроссплатформенные утилиты для файлов, путей и системы
|   |   |-- package-manager.js   # Определение и выбор пакетного менеджера
|   |-- hooks/                   # Реализации хуков
|   |   |-- session-start.js     # Загрузить контекст при старте сессии
|   |   |-- session-end.js       # Сохранить состояние при завершении сессии
|   |   |-- pre-compact.js       # Сохранение состояния перед compaction
|   |   |-- suggest-compact.js   # Предложения стратегической compaction
|   |   |-- evaluate-session.js  # Извлечение паттернов из сессий
|   |-- setup-package-manager.js # Интерактивная настройка PM
|
|-- tests/            # Набор тестов (НОВОЕ)
|   |-- lib/                     # Тесты библиотек
|   |-- hooks/                   # Тесты хуков
|   |-- run-all.js               # Запустить все тесты
|
|-- contexts/         # Контексты динамической инъекции системного промпта (Longform Guide)
|   |-- dev.md              # Контекст режима разработки
|   |-- review.md           # Контекст режима code review
|   |-- research.md         # Контекст режима research/exploration
|
|-- examples/         # Примеры конфигураций и сессий
|   |-- CODEX.md             # Пример project-level конфига
|   |-- user-CODEX.md        # Пример user-level конфига
|   |-- saas-nextjs-CODEX.md   # Реальный SaaS (Next.js + Supabase + Stripe)
|   |-- go-microservice-CODEX.md # Реальный Go microservice (gRPC + PostgreSQL)
|   |-- django-api-CODEX.md      # Реальный Django REST API (DRF + Celery)
|   |-- laravel-api-CODEX.md     # Реальный Laravel API (PostgreSQL + Redis) (НОВОЕ)
|   |-- rust-api-CODEX.md        # Реальный Rust API (Axum + SQLx + PostgreSQL) (НОВОЕ)
|
|-- mcp-configs/      # Конфигурации MCP-серверов
|   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway и т.д.
|
|-- ecc_dashboard.py  # Настольная GUI-панель управления (Tkinter)
|
|-- assets/           # Assets для dashboard
|   |-- images/
|       |-- ecc-logo.png
|
|-- marketplace.json  # Self-hosted marketplace config (для /plugin marketplace add)

Инструменты экосистемы

Skill Creator

Два способа генерировать навыки OpenAI Codex из вашего репозитория:

Вариант A: локальный анализ (встроенный)

Используйте команду /skill-create для локального анализа без внешних сервисов:

/skill-create                    # Анализировать текущий репозиторий
/skill-create --instincts        # Также генерировать инстинкты для continuous-learning-v2

Это локально анализирует вашу историю Git и генерирует файлы SKILL.md.

Непрерывное обучение v2

Система обучения на основе инстинктов автоматически изучает ваши паттерны:

/instinct-status        # Показать изученные инстинкты с уверенностью
/instinct-import <file> # Импортировать инстинкты от других
/instinct-export        # Экспортировать ваши инстинкты для обмена
/evolve                 # Кластеризовать связанные инстинкты в skills

Полную документацию смотрите в skills/continuous-learning-v2/. Оставляйте continuous-learning/ только если вам явно нужен legacy v1 Stop-hook поток learned-skill.

Требования

Версия OpenAI Codex CLI

Минимальная версия: v2.1.0 или новее

Этот плагин требует OpenAI Codex CLI v2.1.0+ из-за изменений в том, как система плагинов обрабатывает хуки.

Проверьте версию:

codex --version

Важно: поведение автозагрузки хуков

ПРЕДУПРЕЖДЕНИЕ: Для контрибьюторов: НЕ добавляйте поле "hooks" в .codex-plugin/plugin.json. Это закреплено регрессионным тестом.

OpenAI Codex v2.1+ автоматически загружает hooks/hooks.json из любого установленного плагина по соглашению. Явное объявление в plugin.json вызывает ошибку обнаружения дубликата:

Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file

История: это уже приводило к повторяющимся циклам fix/revert в репозитории (#29, #52, #103). Поведение менялось между версиями OpenAI Codex, что вызывало путаницу. Теперь есть регрессионный тест, который не даёт вернуть эту ошибку.

Установка

Вариант 1: установить как плагин (рекомендуется)

Самый простой способ использовать этот репозиторий — установить его как плагин OpenAI Codex:

# Добавить этот репозиторий как marketplace
/plugin marketplace add https://github.com/mturac/everything-openai-codex

# Установить плагин
/plugin install eoc@eoc

Или добавьте напрямую в ~/.codex/settings.json:

{
  "extraKnownMarketplaces": {
    "ecc": {
      "source": {
        "source": "github",
        "repo": "mturac/everything-openai-codex"
      }
    }
  },
  "enabledPlugins": {
    "eoc@eoc": true
  }
}

Это сразу даёт доступ ко всем командам, агентам, навыкам и хукам.

Примечание: система плагинов OpenAI Codex не поддерживает распространение rules через плагины (ограничение upstream). Правила нужно установить вручную:

# Сначала клонируйте репозиторий
git clone https://github.com/mturac/everything-openai-codex.git

# Вариант A: правила user-level (применяются ко всем проектам)
mkdir -p ~/.codex/rules/ecc
cp -r Everything OpenAI Codex/rules/common ~/.codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/typescript ~/.codex/rules/ecc/   # выберите свой стек
cp -r Everything OpenAI Codex/rules/python ~/.codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/golang ~/.codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/php ~/.codex/rules/ecc/

# Вариант B: правила project-level (применяются только к текущему проекту)
mkdir -p .codex/rules/ecc
cp -r Everything OpenAI Codex/rules/common .codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/typescript .codex/rules/ecc/     # выберите свой стек

Вариант 2: ручная установка

Если вам нужен ручной контроль над тем, что устанавливается:

# Клонировать репозиторий
git clone https://github.com/mturac/everything-openai-codex.git

# Скопировать агентов в ваш конфиг Codex
cp Everything OpenAI Codex/agents/*.md ~/.codex/agents/

# Скопировать директории правил (common + language-specific)
mkdir -p ~/.codex/rules/ecc
cp -r Everything OpenAI Codex/rules/common ~/.codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/typescript ~/.codex/rules/ecc/   # выберите свой стек
cp -r Everything OpenAI Codex/rules/python ~/.codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/golang ~/.codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/php ~/.codex/rules/ecc/

# Сначала скопировать навыки (основной рабочий интерфейс)
# Рекомендуется для новых пользователей: только core/general skills
mkdir -p ~/.codex/skills/ecc
cp -r Everything OpenAI Codex/.agents/skills/* ~/.codex/skills/ecc/
cp -r Everything OpenAI Codex/skills/search-first ~/.codex/skills/ecc/

# Опционально: добавляйте нишевые/framework-specific skills только при необходимости
# for s in django-patterns django-tdd laravel-patterns springboot-patterns; do
# cp -r Everything OpenAI Codex/skills/$s ~/.codex/skills/ecc/
# done

# Опционально: сохранить поддерживаемую slash-command совместимость во время миграции
mkdir -p ~/.codex/commands
cp Everything OpenAI Codex/commands/*.md ~/.codex/commands/

# Retired shims находятся в legacy-command-shims/commands/.
# Копируйте отдельные файлы оттуда только если вам всё ещё нужны старые имена вроде /tdd.

Установить хуки

Не копируйте сырой repo-файл hooks/hooks.json в ~/.codex/settings.json или ~/.codex/hooks/hooks.json. Этот файл ориентирован на плагин/репозиторий и должен устанавливаться через установщик ecc или загружаться как плагин, поэтому прямое копирование не является поддерживаемым ручным способом установки.

Используйте установщик, чтобы установить только Codex hook runtime и корректно переписать пути команд:

# macOS / Linux
bash ./install.sh --target codex --modules hooks-runtime

# Windows PowerShell
pwsh -File .\install.ps1 --target codex --modules hooks-runtime

Это записывает разрешённые хуки в ~/.codex/hooks/hooks.json и не трогает существующий ~/.codex/settings.json.

Если вы установили ecc через /plugin install, не копируйте эти хуки в settings.json. OpenAI Codex v2.1+ уже автоматически загружает plugin hooks/hooks.json, а дублирование в settings.json вызывает двойное выполнение и кроссплатформенные конфликты хуков.

Примечание для Windows: директория конфигурации Codex — %USERPROFILE%\\.codex, а не ~/codex.

Настроить MCP

Установки Codex plugin намеренно не включают автоматически bundled MCP server definitions ecc. Это предотвращает слишком длинные имена plugin MCP tools на строгих сторонних gateway, но оставляет доступной ручную настройку MCP.

Для live-изменений серверов OpenAI Codex используйте команду OpenAI Codex /mcp или CLI-managed MCP setup. Используйте /mcp для отключений во время выполнения OpenAI Codex; OpenAI Codex сохраняет эти решения в ~/.codex.json.

Для repo-local MCP-доступа скопируйте нужные определения MCP-серверов из mcp-configs/mcp-servers.json в project-scoped .mcp.json.

Если у вас уже запущены собственные копии MCP, bundled в ecc, задайте:

export ecc_DISABLED_MCPS="github,context7,exa,playwright,sequential-thinking,memory"

ecc-managed install и Codex sync flows будут пропускать или удалять эти bundled servers вместо повторного добавления дубликатов. ecc_DISABLED_MCPS — это фильтр установки/синхронизации ecc, а не live-переключатель OpenAI Codex.

Важно: замените placeholders YOUR_*_HERE на реальные API keys.

Ключевые концепции

Агенты

Субагенты выполняют делегированные задачи с ограниченной областью. Пример:

---
name: code-reviewer
description: Проверяет код на качество, безопасность и сопровождаемость
tools: ["Read", "Grep", "Glob", "Bash"]
model: deep
---

Вы — senior code reviewer...

Навыки

Навыки — основной рабочий интерфейс. Их можно вызывать напрямую, предлагать автоматически и переиспользовать агентами. ecc всё ещё поставляет поддерживаемые commands/ во время миграции, а retired short-name shims живут в legacy-command-shims/ только для явного opt-in. Новая разработка рабочих процессов должна сначала попадать в skills/.

# TDD Workflow

1. Сначала определите интерфейсы
2. Напишите падающие тесты (RED)
3. Реализуйте минимальный код (GREEN)
4. Выполните рефакторинг (IMPROVE)
5. Проверьте покрытие 80%+

Хуки

Хуки срабатывают на события инструментов. Пример — предупреждение о console.log:

{
  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
  "hooks": [{
    "type": "command",
    "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
  }]
}

Правила

Правила — always-follow guidelines, организованные в common/ (языконезависимые) и language-specific директории:

rules/
  common/          # Универсальные принципы (устанавливайте всегда)
  typescript/      # TS/JS-specific patterns and tools
  python/          # Python-specific patterns and tools
  golang/          # Go-specific patterns and tools
  swift/           # Swift-specific patterns and tools
  php/             # PHP-specific patterns and tools

Детали установки и структуры смотрите в rules/README.md.

Какого агента использовать?

Не знаете, с чего начать? Используйте эту краткую справку. Skills — канонический рабочий интерфейс; поддерживаемые slash entries остаются доступными для command-first workflows.

Типовые рабочие процессы

Slash-формы ниже показаны там, где они остаются частью поддерживаемого командного интерфейса. Retired short-name shims вроде /tdd и /eval живут в legacy-command-shims/ только для явного opt-in.

Начало новой функции:

/eoc:plan "Добавить OAuth-аутентификацию пользователей"
                                              → planner создаёт blueprint реализации
tdd-workflow skill                            → tdd-guide принуждает писать тесты сначала
/code-review                                  → code-reviewer проверяет работу

Исправление ошибки:

tdd-workflow skill                            → tdd-guide: написать падающий тест, который воспроизводит ошибку
                                              → реализовать исправление, убедиться, что тест проходит
/code-review                                  → code-reviewer: поймать регрессии

Подготовка к продакшену:

/security-scan                                → security-reviewer: аудит OWASP Top 10
e2e-testing skill                             → e2e-runner: тесты критических пользовательских потоков
/test-coverage                                → проверить покрытие 80%+

FAQ

/plugin list eoc@eoc

export OPENAI_BASE_URL=https://your-gateway.example.com
export OPENAI_AUTH_TOKEN=your-token
codex

# Только агенты
cp Everything OpenAI Codex/agents/*.md ~/.codex/agents/

# Только правила
mkdir -p ~/.codex/rules/ecc/
cp -r Everything OpenAI Codex/rules/common ~/.codex/rules/ecc/

Запуск тестов

Плагин включает комплексный набор тестов:

# Запустить все тесты
node tests/run-all.js

# Запустить отдельные файлы тестов
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

Вклад в проект

Вклад приветствуется и поощряется.

Этот репозиторий задуман как ресурс сообщества. Если у вас есть:

• полезные агенты или навыки
• умные хуки
• более удачные MCP-конфигурации
• улучшенные правила

Пожалуйста, внесите вклад. См. CONTRIBUTING.md для рекомендаций.

Идеи для вклада

• Language-specific skills (Rust, C#, Kotlin, Java) — Go, Python, Perl, Swift и TypeScript уже включены
• Framework-specific configs (Rails, FastAPI) — Django, NestJS, Spring Boot и Laravel уже включены
• DevOps-агенты (Kubernetes, Terraform, AWS, Docker)
• Стратегии тестирования (разные фреймворки, визуальная регрессия)
• Предметные знания (ML, data engineering, mobile)

Заметки об экосистеме сообщества

Они не поставляются вместе с ecc и не аудируются этим репозиторием, но о них стоит знать, если вы изучаете более широкую экосистему OpenAI Codex skills:

• codex-seo — SEO-focused коллекция skills и agents
• codex-ads — коллекция ad-audit и paid-growth workflows
• codex-cybersecurity — security-oriented коллекция skills и agents

Поддержка Cursor IDE

ecc предоставляет поддержку Cursor IDE с хуками, правилами, агентами, навыками, командами и MCP-конфигами, адаптированными под layout проекта Cursor.

Быстрый старт (Cursor)

# macOS/Linux
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php

# Windows PowerShell
.\install.ps1 --target cursor typescript
.\install.ps1 --target cursor python golang swift php

Что включено

Заметки о загрузке Cursor

ecc не устанавливает root AGENTS.md в .cursor/. Cursor воспринимает вложенные AGENTS.md как directory context, поэтому копирование identity ecc-репозитория в host project загрязняло бы этот проект.

Cursor-native loading behavior может различаться между сборками Cursor. ecc устанавливает агентов как .cursor/agents/ecc-*.md; если ваша сборка Cursor не показывает project agents, эти файлы всё равно работают как явные reference definitions, а не скрытый global prompt context.

Архитектура хуков (DRY adapter pattern)

В Cursor больше hook events, чем в OpenAI Codex (20 против 8). Модуль .cursor/hooks/adapter.js преобразует stdin JSON Cursor в формат OpenAI Codex, позволяя переиспользовать существующие scripts/hooks/*.js без дублирования.

Cursor stdin JSON → adapter.js → transforms → scripts/hooks/*.js
                                              (shared with OpenAI Codex)

Ключевые хуки:

• beforeShellExecution — блокирует dev servers вне tmux (exit 2), review перед git push
• afterFileEdit — auto-format + TypeScript check + предупреждение о console.log
• beforeSubmitPrompt — обнаруживает секреты (паттерны sk-, ghp_, AKIA) в prompts
• beforeTabFileRead — блокирует чтение Tab файлов .env, .key, .pem (exit 2)
• beforeMCPExecution / afterMCPExecution — MCP audit logging

Формат правил

Правила Cursor используют YAML frontmatter с description, globs и alwaysApply:

---
description: "TypeScript coding style extending common rules"
globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
alwaysApply: false
---

Поддержка Codex macOS App + CLI

ecc предоставляет первоклассную поддержку Codex как для macOS app, так и для CLI: reference configuration, Codex-specific supplement AGENTS.md и общие skills.

Быстрый старт (Codex App + CLI)

# Запустить Codex CLI в репозитории — AGENTS.md и .codex/ определяются автоматически
codex

# Автоматическая настройка: синхронизировать assets ecc (AGENTS.md, skills, MCP servers) в ~/.codex
npm install && bash scripts/sync-ecc-to-codex.sh
# или: pnpm install && bash scripts/sync-ecc-to-codex.sh
# или: yarn install && bash scripts/sync-ecc-to-codex.sh
# или: bun install && bash scripts/sync-ecc-to-codex.sh

# Или вручную: скопировать reference config в домашнюю директорию
cp .codex/config.toml ~/.codex/config.toml

Sync script безопасно сливает MCP-серверы ecc в существующий ~/.codex/config.toml через стратегию add-only: он никогда не удаляет и не изменяет ваши существующие серверы. Запускайте с --dry-run, чтобы посмотреть изменения, или с --update-mcp, чтобы принудительно обновить ecc-серверы до последнего рекомендуемого конфига.

Для Context7 ecc использует каноническое имя секции Codex [mcp_servers.context7], но всё ещё запускает пакет @upstash/context7-mcp. Если у вас уже есть legacy-запись [mcp_servers.context7-mcp], --update-mcp мигрирует её на каноническое имя секции.

Codex macOS app:

• Откройте этот репозиторий как workspace.
• Root AGENTS.md определяется автоматически.
• .codex/config.toml и .codex/agents/*.toml лучше всего работают, когда остаются project-local.
• Reference .codex/config.toml намеренно не фиксирует model или model_provider, поэтому Codex использует свой текущий default, если вы его не переопределили.
• Опционально: скопируйте .codex/config.toml в ~/.codex/config.toml для global defaults; multi-agent role files оставляйте project-local, если также не копируете .codex/agents/.

Что включено

Skills

Skills в .agents/skills/ автоматически загружаются Codex:

Канонические OpenAI skills вроде codex-api, frontend-design и skill-creator намеренно не переупакованы здесь. Устанавливайте их из openais/skills, когда нужны официальные версии.

Ключевое ограничение

Codex пока не предоставляет parity с Codex-style hook execution. Принуждение ecc там instruction-based через AGENTS.md, опциональные overrides model_instructions_file и настройки sandbox/approval.

Поддержка multi-agent

Текущие сборки Codex поддерживают стабильные multi-agent workflows.

• Включите features.multi_agent = true в .codex/config.toml
• Определите роли в [agents.<name>]
• Направьте каждую роль на файл в .codex/agents/
• Используйте /agent в CLI, чтобы inspect или steer child agents

ecc поставляет три sample role configs:

Поддержка OpenCode

ecc предоставляет полную поддержку OpenCode, включая плагины и хуки.

Быстрый старт

# Установить OpenCode
npm install -g opencode

# Запустить в корне репозитория
opencode

Конфигурация автоматически определяется из .opencode/opencode.json.

Паритет возможностей

Поддержка хуков через плагины

Система плагинов OpenCode БОЛЕЕ продвинута, чем OpenAI Codex, и имеет 20+ типов событий:

Дополнительные события OpenCode: file.edited, file.watcher.updated, message.updated, lsp.client.diagnostics, tui.toast.show и другие.

Поддерживаемые slash-записи

Установка плагина

Вариант 1: использовать напрямую

cd Everything OpenAI Codex
opencode

Вариант 2: установить как npm package

npm install @mturac/eoc

Затем добавьте в opencode.json:

{
  "plugin": ["@mturac/eoc"]
}

Эта npm plugin entry включает опубликованный OpenCode plugin module ecc (hooks/events и plugin tools). Она не добавляет автоматически полный catalog команд/агентов/instructions ecc в конфиг вашего проекта.

Для полной настройки ecc OpenCode:

• запустите OpenCode внутри этого репозитория, или
• скопируйте bundled .opencode/ config assets в ваш проект и подключите entries instructions, agent и command в opencode.json

Документация

• Migration Guide: .opencode/MIGRATION.md
• OpenCode Plugin README: .opencode/README.md
• Consolidated Rules: .opencode/instructions/INSTRUCTIONS.md
• LLM Documentation: llms.txt (полная документация OpenCode для LLM)

Паритет возможностей между инструментами

ecc — первый плагин, который помогает максимально использовать каждый крупный инструмент AI-кодинга. Вот как сравниваются среды:

Ключевые архитектурные решения:

• AGENTS.md в корне — универсальный cross-tool файл (читается всеми 4 инструментами)
• DRY adapter pattern позволяет Cursor переиспользовать hook scripts OpenAI Codex без дублирования
• Формат Skills (SKILL.md с YAML frontmatter) работает в OpenAI Codex, Codex и OpenCode
• Отсутствие хуков в Codex компенсируется AGENTS.md, опциональными overrides model_instructions_file и sandbox permissions

Предыстория

ecc основан на ежедневном использовании OpenAI Codex и превращает повторяющиеся production workflow в переиспользуемые skills, hooks, rules и install profiles.

Эти конфиги проверены в бою на нескольких production-приложениях.

Оптимизация токенов

Использование OpenAI Codex может быть дорогим, если не управлять потреблением токенов. Эти настройки заметно снижают затраты без потери качества.

Рекомендуемые настройки

Добавьте в ~/.codex/settings.json:

{
  "model": "standard",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CODEX_AUTOCOMPACT_PCT_OVERRIDE": "50"
  }
}

Переключайтесь на Deep только когда нужно глубокое архитектурное рассуждение:

/model deep

Команды ежедневного workflow

Стратегическая компактификация

Навык strategic-compact (включён в этот плагин) предлагает /compact в логических точках, а не полагается на auto-compaction при 95% контекста. Полный decision guide смотрите в skills/strategic-compact/SKILL.md.

Когда compact:

• после research/exploration, перед implementation
• после завершения milestone, перед началом следующего
• после debugging, перед продолжением работы над feature
• после неудачного подхода, перед пробой нового

Когда НЕ compact:

• в середине implementation (потеряете имена переменных, пути файлов, partial state)

Управление контекстным окном

Критично: не включайте все MCP сразу. Каждое описание MCP tool потребляет токены из вашего окна 200k, потенциально сокращая его до ~70k.

• Держите включёнными менее 10 MCP на проект
• Держите активными менее 80 tools
• Используйте /mcp, чтобы отключать неиспользуемые OpenAI Codex MCP servers; эти runtime-решения сохраняются в ~/.codex.json
• Используйте ecc_DISABLED_MCPS только для фильтрации MCP-конфигов, генерируемых ecc, во время install/sync flows

Предупреждение о стоимости Agent Teams

Agent Teams создаёт несколько context windows. Каждый участник команды потребляет токены независимо. Используйте это только для задач, где параллелизм даёт явную пользу (multi-module work, parallel reviews). Для простых последовательных задач subagents эффективнее по токенам.

Важные предупреждения

Оптимизация токенов

Упираетесь в дневные лимиты? Смотрите Руководство по оптимизации токенов с рекомендуемыми настройками и workflow-советами.

Быстрые выигрыши:

// ~/.codex/settings.json
{
  "model": "standard",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CODEX_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CODEX_CODE_SUBAGENT_MODEL": "fast"
  }
}

Используйте /clear между несвязанными задачами, /compact в логических breakpoints и /cost для мониторинга расходов.

Кастомизация

Эти конфиги работают для моего workflow. Вам стоит:

1. Начать с того, что резонирует
2. Адаптировать под ваш стек
3. Удалить то, чем не пользуетесь
4. Добавить собственные паттерны

Проекты сообщества

Проекты, построенные на Everything OpenAI Codex или вдохновлённые им:

Построили что-то с ecc? Откройте PR, чтобы добавить это сюда.

Спонсоры

Этот проект бесплатный и open source. Спонсоры помогают поддерживать и развивать его.

Стать спонсором | Уровни спонсорства | Программа спонсорства

История звёзд

Ссылки

• Hermes setup: ../HERMES-SETUP.md
• Release notes: ../releases/2.0.0-rc.1/release-notes.md
• Security guide: ../../the-security-guide.md
• Source acknowledgement: ../../NOTICE.md

Лицензия

MIT — используйте свободно, изменяйте по необходимости, вносите вклад, если можете.

Поставьте звезду этому репозиторию, если он помогает. Прочитайте оба руководства. Создавайте сильные продукты.