Управление чатами
Команда chat управляет именованными идентификаторами чатов, групп и каналов —
по аналогии с git remote. Вместо того чтобы каждый раз указывать числовой ID вроде
-1001234567890, вы сохраняете его под понятным именем (alias) и используете это имя в --to.
Идентификаторы хранятся в базе SQLite ~/.config/tguser/tguser.db.
⚠️ Этот файл нельзя удалять. Вместе с ним пропадут все сохранённые имена чатов, а команды с
--to <имя>перестанут работать; Telegram ваши локальные имена не хранит, поэтому справочник придётся собирать заново вручную. Подробнее — в 03. Конфигурация.
Обзор подкоманд
| Команда | Назначение |
|---|---|
tguser chat add <name> <chat_id> | Добавить alias |
tguser chat list | Показать все сохранённые чаты |
tguser chat get-id <name> | Вывести ID по имени |
tguser chat replace-id <name> <new_id> | Заменить ID |
tguser chat rename <old> <new> | Переименовать alias |
tguser chat remove <name> | Удалить alias |
tguser chatбез подкоманды равнозначноtguser chat list.
Добавить чат
tguser chat add work -1001234567890╭────────────── ✓ Готово ──────────────╮
│ Добавлен чат work → -1001234567890 │
╰───────────────────────────────────────╯В качестве chat_id можно сохранить:
- числовой ID (для групп/каналов он отрицательный, например
-1001234567890); @username(например,@durov);me— Избранное (сохранённые сообщения).
Отрицательные ID указываются как есть — экранировать ничего не нужно.
Автоматический резолв @username и ссылок
Если передать @username или ссылку (t.me/…, инвайт-ссылку t.me/+…) при активной
сессии, tguser сам определит числовой ID и название и сохранит именно их:
tguser chat add news @somechannel
# Добавлен чат news → -1001234567890 (Some Channel)Чтобы отключить резолв и сохранить значение как есть, добавьте --no-resolve:
tguser chat add news @somechannel --no-resolveНе знаете ID или
@username? См. 08. Обнаружение чатов — командыdialogsиresolveпомогут найти ID, в том числе для закрытых чатов.
Список чатов
tguser chat list # или просто: tguser chat Сохранённые чаты
┏━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Имя ┃ ID чата ┃ Название ┃ Создан ┃
┡━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ work │ -1001234567890 │ — │ 2026-06-30 11:20 │
└──────┴────────────────┴──────────┴──────────────────┘Получить ID по имени
tguser chat get-id work
# -1001234567890Удобно для скриптов: команда печатает только сам ID.
Заменить ID
tguser chat replace-id work -100999Переименовать
tguser chat rename work teamУдалить
tguser chat remove teamДальше
Как использовать сохранённые имена при отправке — в 05. Отправка сообщений.