tlgr CLI
CLI управляет аккаунтом Telegram из терминала: демон, вывод JSON для агентов, события по вебхукам и готовый скилл для Claude Code.
- 199 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает полный доступ к аккаунту Telegram: чтение, отправка и удаление сообщений от вашего имени.
- Файл сессии открывает аккаунт, а два процесса на нем могут привести к отзыву авторизации.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tlgrОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает полный доступ к аккаунту Telegram: чтение, отправка и удаление сообщений от вашего имени.
- Файл сессии открывает аккаунт, а два процесса на нем могут привести к отзыву авторизации.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tlgr дает полный доступ к аккаунту Telegram из командной строки. Каждая операция есть отдельной командой: отправка и поиск сообщений, чаты, контакты, загрузка и выгрузка медиа, пересылка, реакции и планирование. Три режима вывода: таблицы для человека, JSON (`--json`) для агентов и TSV (`--plain`) для конвейеров. Демон `tlgr daemon start` держит сессию и принимает команды через IPC-сокет, а события можно отправлять на вебхук. Вход состоит из обычных команд `tlgr auth send-code` и `tlgr auth verify-code`, поэтому человеку нужно только прочитать код. Секреты передаются через `--x-env`, `--x-stdin` или `--x-file`, не через аргументы. В репозитории лежит скилл `tlgr` для Claude Code, Codex, Cursor и OpenClaw и плагин Claude Code.
Для кого. Разработчикам и администраторам каналов, которые хотят управлять своим аккаунтом Telegram из скриптов и через агента.
Подходит, если
- Агент должен отправить сообщение или файл в чат от вашего имени по команде.
- Нужен поиск по истории чатов с выводом в JSON для дальнейшей обработки.
- Входящие сообщения должны уходить на вебхук как события.
- Сообщения надо планировать на время и пересылать между чатами по заданию из YAML.
Не подходит, если
- Нужен бот с токеном BotFather: tlgr работает как вы, под учетной записью пользователя.
- Аккаунт нельзя отдавать агенту: он получает полное управление перепиской.
- Нужно массово писать незнакомым людям: это нарушает правила Telegram.
Пример запроса к агенту
Найди через tlgr в моих чатах последние сообщения про релиз и покажи результат в JSON.Ограничения
Агент получает полное управление вашим аккаунтом: чтение, отправку и удаление сообщений, поэтому оставляйте подтверждения и давайте доступ только доверенному клиенту. Два процесса на одном файле сессии могут привести к отзыву авторизации, перед обновлением с версии 1.x остановите демон. Сессия хранится в локальном файле, защитите его. Для входа нужен код из Telegram, который читает человек. Пакет на PyPI называется `tlgr-cli`. Последний коммит сделан в октябре 2026 года.
Как отключить. Остановите демон, выполните `tlgr logout` для выхода из аккаунта, затем `pipx uninstall tlgr-cli`. Сеанс завершите и в настройках Telegram.
Частые вопросы
Как установить tlgr?
Выполните `pipx install tlgr-cli`. Команда называется `tlgr`, а пакет на PyPI `tlgr-cli`, потому что короткое имя занято.
Как подключить скилл?
Командой `npx skills add tlgrcli/tlgr`. Для Claude Code есть плагин: `claude plugin marketplace add tlgrcli/tlgr`, затем `claude plugin install tlgr@tlgr`.
Как войти в аккаунт?
Выполните `tlgr config init`, затем `tlgr login +15551234567` и `tlgr daemon start`. Код из Telegram читает человек.
Как передавать секреты?
Через `--x-env`, `--x-stdin` или `--x-file`, но не через аргументы командной строки.
Что делать при обновлении с версии 1.x?
Сначала остановите работающий демон: два процесса на одном файле сессии могут привести к отзыву авторизации. Порядок описан в `docs/UPGRADING.md`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыUntether связывает Claude Code, Codex и OpenCode с Telegram: задачи голосом и текстом, прогресс в чате, подтверждения кнопками.
Telegram-бот управляет Claude Code на вашем компьютере: пишете в чат, а агент правит проект и стримит ответ.
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Расширение официального плагина Telegram для Claude Code: голосовые сообщения, живой прогресс, кнопки, память и доска агентов
Плагин превращает Claude Code в фонового ассистента: расписание задач, ответы в Telegram, Discord и Slack, веб-панель.
CLI держит агентов Claude Code круглосуточно в сессиях PTY, а управлять ими можно из Telegram, панели и по расписанию.
Коротко о README
README начинается с установки через pipx и памятки для агентов, затем показывает быстрый старт и схему CLI с демоном. Дальше перечислены команды по сообщениям и другим операциям Telegram.