Визуальный пульт управления для OpenAI Codex

Разработчик под ником yynxxxxx выпустил на GitHub открытый проект Codex-X — кроссплатформенное десктопное приложение, которое собирает все рутинные операции с OpenAI Codex в единый графический интерфейс. Вместо ручной правки конфигурационных файлов пользователь управляет prompt-шаблонами, API-провайдерами, сессиями и Skills через визуальные переключатели. Проект написан на Rust и лицензирован под MIT; на момент публикации он набрал более 2 000 звёзд и 295 форков на GitHub.

ℹ Контекст
OpenAI Codex — это AI-агент для разработки ПО, выпущенный в апреле 2025 года. Он доступен через веб-приложение ChatGPT, Codex CLI, десктопное приложение для Windows и macOS, а также через интеграции с IDE. К марту 2026 года аудитория Codex превысила 2 миллиона активных пользователей в неделю.

Зачем нужен Codex-X

Когда разработчик одновременно работает с десктопным Codex, Codex CLI, несколькими сторонними API и набором prompt-шаблонов, конфигурация быстро «расползается» по разным файлам. Codex-X решает эту проблему: все высокочастотные операции собраны в одном окне, текущее состояние всегда видно, а большинство действий выполняются в один клик.

«Codex-X — уже не просто лаунчер с несколькими встроенными промптами, а визуальный инструмент инъекции и управления промптами.»

Ключевые возможности

1. Центр управления prompt-инъекциями

Приложение поставляется с 5 офлайн-шаблонами и после запуска автоматически синхронизирует ещё 6 шаблонов из репозитория на GitHub. Пользователь может импортировать собственные .md-файлы, создавать категории и включать/выключать любой шаблон как плагин.

Поддерживаются два режима применения:

РежимОписаниеКогда использовать
Сохранить оригиналCodex-X добавляет свой контент поверх существующего promptУже есть персональные правила
Заменить оригиналВыбранный шаблон полностью заменяет текущую инструкциюНужен «чистый» переключатель

Перед каждым изменением автоматически создаётся резервная копия.

💡 Встроенные шаблоны
Офлайн-пакет включает: gpt5.5-unrestricted.md, gpt5.4-unrestricted.md, gpt5.5-jeli.md, gpt-5.6-sol-unrestricted.md и 海鸥3.0破甲.md. После первого запуска онлайн синхронизируются шаблоны для разработки и технической документации.

2. Управление провайдерами и API

Можно сохранить несколько именованных конфигураций — как официальных логинов Codex, так и сторонних провайдеров. Прямо из интерфейса доступны:

  • проверка соединения перед переключением;
  • получение списка моделей и их тестирование;
  • редактирование Base URL, API Key, Model, Wire API и полного TOML;
  • импорт из cc-switch с автоматическим разрешением дублей.
💡 Без перезапуска
После активации нового стороннего провайдера достаточно открыть новую сессию Codex — перезапускать клиент не нужно.

3. Управление сессиями

Codex-X позволяет искать локальные сессии по заголовку, пути проекта, провайдеру или ID, группировать их по директориям и удалять — поштучно, группой или сразу весь проект.

⚠ Внимание
Удаление сессий необратимо. Перед операцией закройте все окна Codex, работающие с этими сессиями, и проверьте список в диалоге подтверждения.

4. Skills и MCP

MCP (Model Context Protocol) — протокол расширения контекста модели. Codex-X визуализирует установленные Skills и MCP-серверы, позволяет импортировать конфиги, устанавливать Skills из ZIP-архивов и включать/выключать их по отдельности.

5. TOML и Auth

Приложение читает ~/.codex/config.toml и ~/.codex/auth.json, отображает их с подсветкой синтаксиса и позволяет редактировать прямо в интерфейсе. Опция «1M контекстное окно» включается галочкой — при условии поддержки моделью.

6. Статистика токенов

Вкладка статистики показывает расход токенов по датам и моделям, суточные тренды, процент кэш-хитов и распределение по моделям. Токены суб-агентов засчитываются в родительскую сессию.

Архитектура


graph TD
    A[Пользователь] -->|GUI| B[Codex-X]
    B --> C[Prompt-менеджер]
    B --> D[Provider / API]
    B --> E[Менеджер сессий]
    B --> F[Skills / MCP]
    B --> G[TOML / Auth]
    C -->|Запись| H[~/.codex/config.toml]
    D -->|Переключение| H
    E -->|Синхронизация| I[Локальные сессии]
    F -->|Конфиг| H
    G -->|Чтение / запись| H
    G -->|Чтение / запись| J[~/.codex/auth.json]

Платформы и технологии

ПлатформаФормат
macOS Apple Silicon.dmg
macOS Intel.dmg
Windows.msi
Windows Portable.zip
Linux.deb / .rpm / .AppImage

Технический стек: Tauri 2 (фреймворк), React 18 / TypeScript / Vite (фронтенд), Rust (бэкенд), SQLite (локальные данные).

Для установки из исходников:

pnpm install
pnpm dev
# Сборка десктопного приложения:
pnpm --dir apps/desktop tauri build
📝 macOS: ошибка «Приложение повреждено»

Если macOS Gatekeeper показывает предупреждение о неподписанном DMG, для локального тестирования можно снять карантин вручную:

xattr -dr com.apple.quarantine /Applications/Codex-X.app

Значение для разработчиков

Codex CLI изначально был представлен как лёгкий агент для связи моделей OpenAI с исходным кодом и вычислительными задачами через терминал. Однако по мере роста экосистемы — появления Skills, MCP-серверов, сторонних провайдеров — управление конфигурацией стало нетривиальной задачей. Codex-X заполняет этот пробел: он превращает CLI-инструмент в управляемую визуальную среду, не требуя от пользователя знания структуры конфигурационных файлов.

Codex CLI работает локально, интегрируется с планом ChatGPT и поддерживает MCP-серверы с параллельными вызовами инструментов — без необходимости в IDE. Codex-X дополняет эту картину графическим слоем, делая инструмент доступным для более широкой аудитории.

Проект распространяется под лицензией MIT, исходный код и релизы доступны на GitHub.