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. Также в проекте есть возможность пожертвовать средства на развитие, что положительно скажется на его поддержке и обновлениях.
Открыть на GitHub: grinev/opencode-telegram-bot →
