VKodex

VKodex — открытый бот для удалённого управления OpenAI Codex через сообщения и беседы ВКонтакте. Он позволяет продолжать существующие задачи Codex или создавать новые с телефона: выбирать проект в менеджерском диалоге, открывать связанную VK-беседу и отправлять уточнения и вложения в тот же контекст. Личный диалог с сообществом служит менеджером, а отдельная VK-беседа соответствует одной задаче Codex.

Статус проекта — экспериментальная интеграция с Codex на Windows. VKodex запускается на том же компьютере и под тем же пользователем Windows, что и десктопный Codex. Для каждого профиля с owner: "app-server" VKodex держит один долгоживущий App Server.

Desktop-мост автоматически ведёт отдельный приватный JSONL-журнал в BOT_DATA_DIR/diagnostics. Одна строка — одно событие vkodex.diagnostic.v1. События связывают очередь входящих сообщений, подготовку наблюдения, отказ обнаружения владельца, выбор маршрута, RPC-запись, подтверждение и сверку по истории. Параметры/ответы RPC, тексты сообщений, содержимое файлов, токены и тексты/стеки ошибок не записываются.

Для работы нужны Windows с запущенным десктопным Codex, Node.js, npm, Git и аккаунт VK с отдельным сообществом и ключом. Для типичного запуска из России нужна раздельная маршрутизация: VKodex обращается к VK API и Long Poll напрямую через российский IP, а Codex/OpenAI — через VPN. Публичный IP, домен, HTTPS-сертификат и входящий порт не нужны: VKodex сам получает события через Bots Long Poll.