Кратко: ключевые факты
- Проект coding-agent-monitor — открытый инструмент для автоматического отслеживания обновлений AI-инструментов через GitHub Actions
- Ежедневная проверка новых версий в 01:00 UTC с отправкой уведомлений в Discord
- Поддерживает мониторинг 4+ популярных CLI инструментов включая Gemini CLI и Qwen Code
- Бесплатный сервис без необходимости развёртывания дополнительных серверов
- Ведёт историю последних 5 версий каждого инструмента в файле RELEASES.md
- Интерактивная панель мониторинга с мобильной версией для удобного просмотра
Что такое coding-agent-monitor?
Проект coding-agent-monitor — это автоматизированное решение для отслеживания обновлений AI-инструментов, используемых в разработке. Инструмент работает как GitHub Actions workflow, что исключает необходимость настройки отдельного сервера. Основная задача — своевременно уведомлять разработчиков о выходе новых версий CLI-утилит через Discord.
Архитектура решения
Система состоит из нескольких ключевых компонентов:
- Python-скрипт monitor.py для проверки репозиториев
- Файл конфигурации watchlist.json с перечнем отслеживаемых инструментов
- Автоматически обновляемый файл версий versions.json
- Интерактивная панель dashboard/index.html для визуализации данных
Технические требования
Для корректной работы системы необходимы:
- GitHub-репозиторий с активированными Actions
- Python 3.10+ для локальной разработки
- Discord-сервер для получения уведомлений
- Около 5 МБ свободного места для хранения истории версий
Как работает система мониторинга?
Процесс обновления запускается ежедневно в 01:00 UTC через GitHub Actions. Система последовательно проверяет каждый репозиторий из watchlist.json на наличие новых релизов. При обнаружении изменений:
- Формируется сообщение для Discord с деталями обновления
- Обновляется файл versions.json (сохраняется до 5 предыдущих версий)
- Добавляется запись в RELEASES.md и CHANGELOG.md
- Перестраивается интерактивная панель мониторинга
Процесс проверки обновлений
Алгоритм работы монитора включает:
- Получение списка репозиториев из watchlist.json
- Запрос к GitHub API для каждого репозитория
- Сравнение последнего известного релиза с текущим
- Обработку изменений (при наличии)
- Сохранение обновлённых данных
- Отправку уведомлений
Настройка расписания проверок
Пользователи могут изменить расписание проверок, отредактировав cron-выражение в файле .github/workflows/monitor.yml. По умолчанию используется значение '0 1 * * *' (ежедневно в 01:00 UTC). Для интенсивных проектов рекомендуем установить проверку каждые 6 часов: '0 */6 * * *'.
Поддерживаемые инструменты
По умолчанию система отслеживает 4 ключевых AI-инструмента:
- Gemini CLI от Google (google-gemini/gemini-cli)
- Qwen Code CLI от QwenLM (QwenLM/qwen-code)
- OpenCode от anomalyco (anomalyco/opencode)
- Oh-My-OpenCode от code-yeongyu (code-yeongyu/oh-my-opencode)
Критерии выбора инструментов
Система оптимально работает с репозиториями, которые:
- Используют стандартный GitHub-релиз с тегами версий
- Имеют стабильный график обновлений
- Опубликованы как открытые проекты
- Имеют чёткую семантику версионирования
Добавление своих инструментов
Для мониторинга дополнительных репозиториев необходимо добавить запись в watchlist.json:
{
"id": "your-tool",
"owner": "owner-name",
"repo": "repo-name",
"emoji": "🚀"
}
Настройка уведомлений в Discord
Для получения оповещений необходимо создать вебхук в Discord и добавить его URL как секрет в GitHub:
- Перейдите в "Настройки сервера" → "Интеграции" → "Вебхуки"
- Создайте новый вебхук и выберите канал для уведомлений
- Скопируйте URL вебхука
- Добавьте его как секрет DISCORD_WEBHOOK в настройках GitHub-репозитория
Формат уведомлений
Сообщения в Discord содержат:
- Название обновлённого инструмента
- Номер новой версии
- Дату публикации
- Ссылку на релиз
- Краткое описание изменений
- Эмодзи для визуального выделения
Интерактивная панель мониторинга
Проект включает веб-панель с визуализацией данных:
- Карточки инструментов с текущей версией и датой релиза
- Таймлайн последних 5 обновлений
- Таблица изменений из CHANGELOG.md
- Адаптивный дизайн для просмотра с мобильных устройств
Возможности панели
Пользователи могут:
- Фильтровать инструменты по статусу обновления
- Сравнивать версии разных продуктов
- Просматривать полную историю изменений
- Экспортировать данные в CSV
Локальный запуск панели
Для тестирования панели выполните команды:
cd dashboard python -m http.server 8080
После этого откройте http://localhost:8080 в браузере.
Преимущества использования
- Бесплатный сервис — работает в рамках GitHub Free tier
- Автоматическое ведение истории — все изменения фиксируются в RELEASES.md
- Простота настройки — не требует знаний DevOps
- Расширяемость — возможность добавления любых GitHub-репозиториев
- Открытый код — MIT лицензия позволяет модифицировать проект
Сравнение с аналогами
| Характеристика | coding-agent-monitor | Аналоги |
|---|---|---|
| Стоимость | Бесплатно | Часто платные |
| Настройка | 5 минут | Требует сервер |
| Гибкость | Полная | Ограниченная |
Как начать использовать?
- Склонируйте или форкните репозиторий SkyEagle888/coding-agent-monitor
- Настройте вебхук Discord и добавьте его в секреты GitHub
- Активируйте workflow в разделе Actions репозитория
- При необходимости добавьте свои инструменты в watchlist.json
Проверка работоспособности
После настройки:
- Запустите workflow вручную
- Проверьте лог выполнения
- Убедитесь в получении тестового уведомления
- Проверьте обновление RELEASES.md
Вопросы и ответы
Как часто проверяются обновления в coding-agent-monitor?
По умолчанию система запускает проверку ежедневно в 01:00 UTC. Это расписание можно изменить через редактирование файла .github/workflows/monitor.yml.
Можно ли добавить свой собственный инструмент для мониторинга?
Да, для этого нужно добавить запись в файл watchlist.json с указанием владельца и названия репозитория. Система поддерживает мониторинг любых открытых GitHub-проектов.
Где хранится история версий отслеживаемых инструментов?
История сохраняется в двух форматах: структурированном (versions.json) и человекочитаемом (RELEASES.md). В файле versions.json хранятся данные о последних 5 версиях каждого инструмента.
Нужно ли платить за использование coding-agent-monitor?
Нет, проект полностью бесплатный и работает в рамках GitHub Free tier. Ограничение — 2000 минут выполнения workflow в месяц.
Как просмотреть историю обновлений в удобном формате?
Для этого предназначена интерактивная панель в папке dashboard. Она отображает текущие версии инструментов, таймлайн изменений и подробный changelog.
Можно ли изменить время проверки обновлений?
Да, для этого отредактируйте cron-выражение в файле .github/workflows/monitor.yml. Используйте сервис crontab.guru для генерации правильного формата расписания.
Как обрабатываются ошибки подключения?
Система автоматически повторяет попытку через 30 минут при ошибках сети или API GitHub. После 3 неудачных попыток отправляется уведомление в Discord.
Поддерживаются ли приватные репозитории?
Да, но требуется настройка personal access token с правами repo в GitHub Secrets.