Сообщения в 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. Серверной части нет.