codex-notify

codex-notify отправляет сообщение в Telegram, когда Codex завершает очередной ход. Отдельный фоновый процесс не используется: Codex сам запускает уведомитель через пользовательский параметр notify.

Уведомление содержит название проекта, запрос пользователя и последний ответ Codex. Старые сообщения, отправленные ботом, по умолчанию удаляются через 24 часа.

Требования

• Node.js 18 или новее.
• Установленный Codex CLI.
• Telegram-бот, созданный через @BotFather.

Установка

Сначала отправьте своему новому Telegram-боту любое сообщение. Затем установите пакет и запустите мастер настройки:

npm install -g @bazilio-san/codex-notify
codex-notify install

Установщик сохранит Telegram-настройки в ~/.codex/codex-notify.config.json, добавит команду в пользовательский ~/.codex/config.toml и отправит пробное сообщение. Если Codex уже открыт, после установки его следует перезапустить.

Проверить доставку отдельно можно командой:

codex-notify test

Настройка

Файл ~/.codex/codex-notify.config.json имеет следующий формат:

{
  "telegram": {
    "enabled": true,
    "token": "123456789:ABC...",
    "chatId": "123456789",
    "deleteAfterHours": 24,
    "includeLastMessage": true
  },
  "debug": false
}

Переменные окружения имеют приоритет над файлом настроек:

• CODEX_NOTIFY_TELEGRAM_TOKEN задаёт токен бота.
• CODEX_NOTIFY_TELEGRAM_CHAT_ID задаёт идентификатор личного чата или группы.
• CODEX_NOTIFY_TELEGRAM=0 временно отключает отправку сообщений.
• CODEX_NOTIFY_INCLUDE_LAST_MESSAGE=0 скрывает последний ответ Codex.
• CODEX_NOTIFY_DEBUG=1 добавляет идентификатор диалога и выводит диагностические сообщения.

Значение deleteAfterHours: 0 отключает автоматическое удаление старых сообщений.

Удаление

codex-notify uninstall
npm uninstall -g codex-notify

Первая команда удаляет только созданную пакетом строку notify из конфигурации Codex. Telegram-настройки сохраняются, чтобы повторная установка не требовала вводить их заново.

Ограничения Codex

Внешний параметр notify сейчас вызывается для события agent-turn-complete, то есть после завершения хода агента. Запрос разрешения или ожидание дополнительного ответа обрабатываются встроенными уведомлениями интерфейса Codex и не передаются этому уведомителю.

Лицензия

MIT

Публикация

Выпуск выполняется из чистой ветки master. Сценарий повышает номер исправления, запускает проверки, создаёт коммит и тег, отправляет ветку в GitHub, а затем публикует пакет с открытым доступом:

npm run release

Чтобы выпустить уже указанную в package.json версию без повышения номера, используется команда npm run release:current.