tlgrcli/tlgr

tlgr — консольный инструмент, который даёт полный контроль над аккаунтом Telegram через команды. Рассчитан на разработчиков и AI-агентов, которым нужен стабильный машинный интерфейс, а не ручное приложение.

Ключевые возможности

• Все операции Telegram доступны одной командой из терминала
• Три режима вывода: таблицы для человека, JSON для агентов, TSV для конвейера
• Фоновый демон с IPC-сокетом и webhook-событиями
• Секреты передаются через —x-env, —x-stdin или —x-file, не через argv
• Стабильные коды выхода и предсказуемые форматы ответов
• Готовый Agent Skill для Claude Code, Codex, Cursor и OpenClaw

Для каких задач подходит

• Автоматизация отправки и чтения сообщений Telegram из скриптов и пайплайнов
• Подключение Telegram к AI-агенту через JSON-вывод и webhook-события
• Мониторинг чатов и событий с передачей данных во внешние системы
• Управление аккаунтом Telegram с машины без графического клиента
• Встраивание Telegram-действий в CI/CD и серверные задачи

Подробнее

tlgr построен вокруг долгоживущего демона: CLI общается с ним через IPC-сокет, а демон держит соединение с Telegram API. Такой подход отделяет авторизацию и сессию от отдельных вызовов команд — можно запускать сколько угодно команд, не поднимая каждый раз новое подключение. Для агентов это важно, потому что сессия остаётся стабильной, а события приходят через webhook, а не через опрос.

Интерфейс рассчитан на машинное использование: по умолчанию вывод — человекочитаемые таблицы, но флаг —json даёт структурированный ответ, а —plain — TSV для конвейеров. Коды выхода стабильны, секреты не попадают в argv — их можно передать через переменные окружения, stdin или файл. Авторизация разбита на отдельные команды отправки и проверки кода, поэтому агенту не нужно читать код самому — это делает человек.

Стоит учитывать, что tlgr работает с полноценным аккаунтом Telegram, а не с ботом, поэтому при обновлении с версии 1.x нужно сначала остановить старый демон: два процесса на одном файле сессии могут привести к отзыву авторизации. Установка рекомендуется через pipx, потому что демону нужно собственное окружение. Лицензия MIT.