RepoRadar OpenCode Telegram Bot: управление AI-задачами программирования с телефона
OpenCode Telegram Bot — это клиент для Telegram, который позволяет запускать и контролировать AI-задачи программирования с твоего телефона, при этом всё выполняется локально на твоем компьютере. Проект особенно полезен для тех, кто использует OpenCode и хочет иметь возможность управлять кодингом удаленно, без открытия API или портов.
Бот поддерживает работу с OpenCode V2 и классической версией, предлагая функции управления сессиями и смены моделей. Все команды отправляются через Telegram, а результаты приходят в виде файлов. Работа обеспечивает высокий уровень безопасности за счет отсутствия открытых портов и прямого доступа к машинам.
Запуск проекта требует Node.js версии не ниже 22.14 и поддерживается на macOS, Windows и Linux. Проект находится на стадии разработки, поэтому могут быть баги и недоработки. Обрати внимание на подробности настройки в README.
Обзор проекта
OpenCode Telegram Bot — это защищённый клиент Telegram для OpenCode CLI, который работает на твоём локальном компьютере. С помощью этого бота ты можешь запускать задачи, связанные с программированием, отслеживать их выполнение, переключать модели и управлять сессиями прямо со своего телефона. Бот не открывает порты и не использует открытые API: он общается только с локальным сервером OpenCode и API Telegram Bot.
Проект работает на платформах macOS, Windows и Linux и поддерживает множество языков, включая русский.
Особенности
- Поддержка OpenCode V2 — работает как с новой версией OpenCode V2, так и с классической V1.
- Удалённое программирование — отправляй подсказки в OpenCode с любого устройства и получай результаты в виде файлов.
- Управление сессиями — создавай новые сессии или продолжай существующие.
- Оповещения о сессиях в фоновом режиме — получай уведомления о прекращении работы или получении ответов от откреплённых сессий.
- Смена моделей — выбирай модели из избранного или недавних прямо в чате.
- Пользовательские команды — запускай пользовательские команды OpenCode через встроенное меню с подтверждением.
- Поддержка Docker — запускай бота в контейнере, пока OpenCode работает на хосте.
Установка и запуск
Для работы бота требуется Node.js версии 22.14 и выше, установленный OpenCode и созданный бот в Telegram через @BotFather. После этого запускай сервер OpenCode на той же машине, где работает бот:
opencode serveЧтобы установить и запустить бота, используйте следующую команду:
npx @grinev/opencode-telegram-bot@latestЕсли требуется выполнить дополнительные настройки, интерактивный мастер настройки подскажет, что делать. После завершения настройки ты сможешь открыть бота в Telegram и начать отправлять команды.
Ограничения
Бот может работать только с текстовыми командами и файлами, размер которых не превышает 100 КБ. Если используется OpenCode V1, необходимо помнить, что сессии не совместимы с V2. Также стоит учесть, что в режиме Docker некоторые команды, как, например, управление файлами и проектами, могут быть недоступны из-за ограничений контейнера.
Вопросы и поддержка
Если у тебя возникли вопросы или идеи для улучшения, ты можешь присоединиться к Telegram-группе или обсудить свои идеи на странице проекта в GitHub. Также в проекте есть возможность пожертвовать средства на развитие, что положительно скажется на его поддержке и обновлениях.
Радар проекта: 73 из 100 — крепкий проект
- Импульс 29 ≈ 4 звезды в день
- Темп разработки 87 145 коммитов за 12 недель
- Зрелость 82 проекту 9 месяцев, 69 релизов
- Сообщество 68 43 участника, 249 форков
- Свежесть 96 последний коммит — 6 дней назад
- Быстрый старт 75 есть: команда установки, Docker
- Готовность к продакшену 75 релиз v0.27.0, автосборка, тесты
- Безопасность и доверие 55 лицензия MIT
- Документация 100 README 43.6 тыс. знаков, 35 разделов, папка docs
- Экосистема 64 10 подписчиков на обновления, 11 тем
Как считаем
Только открытые данные GitHub на 07.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: grinev/opencode-telegram-bot →
