Перейти к содержимому
Лицензия MIT · Python 3.13 · MTProto

Сообщения в Telegram 
от вашего имени, а не от бота

tguser — CLI, говорящий по MTProto от вашего аккаунта, 
чтобы ИИ-агент писал в личные чаты, группы и каналы как человек.

uv tool install git+https://github.com/yerza06/tguser-cli.git
tguser login                           # один интерактивный вход, его делает человек
tguser chat add work -1001234567890    # сохранить чат под именем «work»
tguser send "Сборка готова" --to work

Пользователь, а не бот

Бот не может начать переписку первым, не может вступить в произвольную группу и всегда видно, что он бот. tguser работает по MTProto от вашего аккаунта — сообщения приходят от вас.

Создан для ИИ-агентов

Изначально рассчитан на Claude Code, Codex CLI, OpenClaw, Hermes-Agent и подобных. Агент выполняет одну обычную команду оболочки — и сообщение уходит.

Алиасы чатов как `git remote`

Назовите чат один раз и забудьте про числовой ID: --to work вместо -1001234567890. Алиасы хранятся в локальной базе SQLite.

Работает из любой директории

После uv tool install команда tguser доступна в PATH — без uv run и без корня проекта. Рабочая директория агента заранее неизвестна.

Skill для агента одной командой

npx skills add https://github.com/yerza06/tguser-cli --skills tguser обучает агента всему CLI — по открытой спецификации Agent Skills.

Десять типов сообщений

Текст, документы, фото, видео, аудио, голосовые, кружки, стикеры и контакты — с альбомами, подписями и стабильными кодами выхода 0 / 1 / 130.

Как это устроено

Человек входит в аккаунт один раз — tguser login интерактивен и спрашивает номер телефона, код и, если включена, пароль двухфакторной аутентификации. Дальше сессия сохраняется в ~/.config/tguser/, и каждая последующая отправка проходит без участия человека. Агент не работает с вашими учётными данными — он лишь вызывает tguser send.

Всё остаётся на вашей машине: файл сессии, база алиасов и учётные данные API лежат в ~/.config/tguser/, причём .env — с правами 600. Серверной части нет.