Команды

Все команды, параметры и коды завершения. Страница создаётся из самой программы, поэтому описывает только существующие возможности. Тот же список в JSON: tg commands --json.

Структура команды:

tg [profile] [options] <resource> <verb> [arguments]

Первое слово — профиль, если это не команда: tg work chats list показывает чаты профиля work, а tg chats list — профиля по умолчанию. TG_PROFILE задаёт профиль для оболочки; иначе используется default.

Общие параметры

Параметр	Назначение
`-V, --version`	показать номер версии.
`-v, --verbose`	подробности: -v — идентификаторы, -vv — все известные данные. По умолчанию: `0`.
`--json`	машиночитаемый вывод: единственное значение JSON в stdout.
`--jsonl`	машиночитаемый вывод: объект JSON на строку для потоковой обработки и jq.
`--quiet`	отключить диагностику; ошибки остаются.
`--trace`	журнал соединения в stderr, без содержимого сообщений.
`--timeout <duration>`	ограничить время всей команды: 30s, 2m, 500ms.
`--offline`	читать сохранённое без подключения; ошибка, если данных нет.
`--yes`	выполнить изменение без подтверждения уровня ask.
`--record`	сохранить запуск: идентификаторы и время, без текста сообщений.
`--no-record`	не сохранять независимо от настроек.

`tg session`

войти в Telegram или выйти для этого профиля

`tg session start`

войти по QR-коду (по умолчанию) или телефону, коду и паролю 2FA

tg session start [method] [options]

Аргумент		Описание
`method`	необязателен	способ входа: `qr`, `phone`. По умолчанию: `qr`.

Параметр	Назначение
`--app <how>`	только первый раз: способ получения приложения профиля с my.telegram.org: `browser`, `auto`. По умолчанию: `browser`.
`--qr-file <png>`	сохранить QR-код в PNG для передачи агентом вместо отображения.

`tg session end`

завершить сессию профиля в Telegram и удалить её локально

Изменяет данные Telegram.

tg session end

`tg setup`

настроить Telegram и подключить агента

Изменяет что-то в Telegram.

tg setup [options]

Параметр	Назначение
`--agent <agent>`	установить skill для агента; в терминале спрашивает выбор, иначе не устанавливает. Варианты: `none`, `codex`, `cursor`, `claude`, `gemini`, `all`.
`--app <how>`	как получить ключи приложения Telegram при первом входе. Варианты: `auto`, `browser`. По умолчанию: `auto`.
`--method <method>`	как войти, если сессии нет. Варианты: `qr`, `phone`. По умолчанию: `qr`.
`--qr-file <png>`	записать временное QR-изображение входа для агента; без терминала требуются сохранённые ключи приложения.

`tg account`

аккаунт текущей сессии

`tg account show`

под каким аккаунтом вошёл профиль; последние четыре цифры телефона

tg account show [options]

Параметр	Назначение
`--show-phone`	показать полный номер телефона.

`tg account update`

изменить видимые всем имя, описание или фото профиля

Изменяет данные Telegram.

tg account update [options]

Параметр	Назначение
`--first-name <name>`	ваше имя.
`--last-name <name>`	ваша фамилия.
`--description <text>`	описание профиля.
`--photo <file>`	новое фото профиля: файл изображения.

`tg account sessions`

другие сессии аккаунта; tg session управляет только входом этого инструмента

`tg account sessions list`

все подключённые устройства и приложения; ничего не завершается

tg account sessions list

`tg account sessions end`

завершить все другие сессии, включая телефон; текущая остаётся

Изменяет данные Telegram.

tg account sessions end [options]

Параметр	Назначение
`--others`	все сессии кроме текущей.

`tg chats`

чаты аккаунта

`tg chats list`

чаты от новых к старым, включая архив

tg chats list [options]

Параметр	Назначение
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.
`--search <text>`	название содержит текст; минимум 3 символа.
`--kind <kind>`	тип чата: dialog, group, channel, saved.
`--unread`	только чаты с непрочитанными сообщениями.

`tg chats events`

кто вступил, вышел, кого добавили или удалили и кем: по служебным сообщениям

tg chats events <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--since-time <time>`	ISO 8601 или 2h / 1d назад; по умолчанию 7 дней.
`--type <names>`	только указанные типы через запятую: join, leave, add, remove, create, title, pin.

`tg chats inspect`

куда ведёт публичная ссылка или приглашение, без вступления

tg chats inspect <link>

Аргумент		Описание
`link`	обязателен	приглашение или публичная ссылка.

`tg chats show`

один чат: тип, число непрочитанных, время последнего сообщения и участники

tg chats show <chat>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg chats members`

участники группы

`tg chats members list`

все участники постранично с ролями и временем последнего появления

tg chats members list <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.

`tg chats members add`

добавить участников; они получат уведомление

Изменяет данные Telegram.

tg chats members add <chat> <person>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`person`	обязателен	идентификатор или часть имени.

`tg chats members remove`

удалить участников; сообщения сохраняются

Изменяет данные Telegram.

tg chats members remove <chat> <person>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`person`	обязателен	идентификатор или часть имени.

`tg chats mark-read`

отметить чат прочитанным; собеседник видит прочтение

Изменяет данные Telegram.

tg chats mark-read <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--until <message>`	до указанного идентификатора сообщения; по умолчанию до последнего.

`tg chats create`

создать группу или канал; добавленные люди получают уведомление

Изменяет данные Telegram.

tg chats create <title> [person] [options]

Аргумент		Описание
`title`	обязателен	название группы.
`person`	необязателен	участники для добавления: идентификатор или часть имени.

Параметр	Назначение
`--channel`	приватный канал вместо группы; вступление по ссылке.

`tg chats join`

вступить в группу или канал по ссылке; участники видят вступление

Изменяет данные Telegram.

tg chats join <link>

Аргумент		Описание
`link`	обязателен	приглашение или публичная ссылка.

`tg chats leave`

выйти из группы или канала; участники видят выход

Изменяет данные Telegram.

tg chats leave <chat>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg chats update`

изменить название, описание или настройки группы либо канала

Изменяет данные Telegram.

tg chats update <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--title <title>`	новое название.
`--description <text>`	новое описание.
`--all-can-pin <on\|off>`	все участники могут закреплять сообщения.
`--only-admins-add <on\|off>`	только администраторы могут добавлять участников.

`tg chats link`

приглашение в группу

`tg chats link show`

ссылка-приглашение, если у вас есть право её видеть

tg chats link show <chat>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg chats link reset`

заменить приглашение; старая ссылка перестаёт работать

Изменяет данные Telegram.

tg chats link reset <chat>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg chats admins`

назначить или снять права администратора

`tg chats admins add`

назначить участника администратором с заданными правами

Изменяет данные Telegram.

tg chats admins add <chat> <person> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`person`	обязателен	идентификатор или часть имени.

Параметр	Назначение
`--can <rights>`	разрешённые действия через запятую: members, admins, info, pin, link, post, edit, delete.

`tg chats admins remove`

снять права администратора; человек остаётся участником

Изменяет данные Telegram.

tg chats admins remove <chat> <person>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`person`	обязателен	идентификатор или часть имени.

`tg chats folders`

ваши папки чатов

`tg chats folders list`

папки в порядке отображения в приложении

tg chats folders list

`tg chats folders create`

создать папку чатов

Изменяет данные Telegram.

tg chats folders create <title> [options]

Аргумент		Описание
`title`	обязателен	название папки; приложение может отклонить слишком длинное.

Параметр	Назначение
`--chat <chat>`	чат для добавления по идентификатору или названию; повторите для нескольких.

`tg chats folders update`

переименовать папку или изменить её чаты

Изменяет данные Telegram.

tg chats folders update <folder> [options]

Аргумент		Описание
`folder`	обязателен	идентификатор папки или точное название.

Параметр	Назначение
`--title <title>`	новое название.
`--add <chat>`	добавить чат; повторите для нескольких.
`--remove <chat>`	убрать чат; повторите для нескольких.

`tg chats folders delete`

удалить папку; чаты сохраняются

Изменяет данные Telegram.

tg chats folders delete <folder>

Аргумент		Описание
`folder`	обязателен	идентификатор папки или точное название.

`tg chats rules`

правила chats moderate для группы, хранящиеся в файле профиля

`tg chats rules show`

правила группы; если не сохранены, значения по умолчанию с отметкой

tg chats rules show <chat>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg chats rules set`

изменить правило; первое изменение сохраняет все правила с исходными значениями

Изменяет данные только на этом компьютере.

tg chats rules set <chat> <key> <value>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`key`	обязателен	одно из: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove.
`value`	обязателен	новое значение; элементы списка через запятую.

`tg chats rules unset`

вернуть правило к значению по умолчанию

Изменяет данные только на этом компьютере.

tg chats rules unset <chat> <key>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`key`	обязателен	одно из: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove.

`tg chats moderate`

проверить новые сообщения и участников по правилам группы и выполнить разрешённые действия

Изменяет данные Telegram.

tg chats moderate <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--since-time <time>`	проверить после времени ISO 8601 или 2h / 1d назад; сохранённая позиция не меняется.
`--dry-run`	проверить и составить план без действий.
`--allow-dangerous`	подтвердить все действия с уровнем ask в правилах группы.
`--max-actions <n>`	максимум действий за запуск; по умолчанию 10.

`tg contacts`

люди с личными чатами у этого аккаунта

`tg contacts list`

люди, с которыми у вас есть личный чат

tg contacts list [options]

Параметр	Назначение
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.
`--order <recent\|name>`	сначала недавние переписки или по алфавиту. По умолчанию: `recent`.
`--search <text>`	имя или @username содержит текст.

`tg contacts show`

человек и общие с ним чаты

tg contacts show <person>

Аргумент		Описание
`person`	обязателен	идентификатор, @username или часть имени.

`tg contacts lookup`

владелец номера телефона: запрос или stdin, никогда аргумент

tg contacts lookup

`tg contacts sync`

сохранить полную адресную книгу мессенджера в локальной базе

tg contacts sync

`tg contacts add`

добавить контакт; contacts list по-прежнему показывает только личные чаты

Изменяет данные Telegram.

tg contacts add <person>

Аргумент		Описание
`person`	обязателен	идентификатор из `contacts lookup` или часть известного имени.

`tg contacts remove`

удалить контакт; чат остаётся, заданное вами имя может исчезнуть

Изменяет данные Telegram.

tg contacts remove <person>

Аргумент		Описание
`person`	обязателен	идентификатор из `contacts lookup` или часть известного имени.

`tg contacts block`

запретить человеку писать вам; контакт необязателен

Изменяет данные Telegram.

tg contacts block <person>

Аргумент		Описание
`person`	обязателен	идентификатор из `contacts lookup` или часть известного имени.

`tg contacts unblock`

разрешить заблокированному человеку снова писать вам

Изменяет данные Telegram.

tg contacts unblock <person>

Аргумент		Описание
`person`	обязателен	идентификатор из `contacts lookup` или часть известного имени.

`tg contacts rename`

задать своё имя контакта, которое он не видит

Изменяет данные Telegram.

tg contacts rename <person> <first-name> [last-name]

Аргумент		Описание
`person`	обязателен	идентификатор из `contacts lookup` или часть известного имени.
`first-name`	обязателен	имя, под которым вы хотите видеть человека.
`last-name`	необязателен

`tg contacts import`

загрузить телефоны и добавить найденных мессенджером людей

Изменяет данные Telegram.

tg contacts import <file>

Аргумент		Описание
`file`	обязателен	один человек на строку: номер, запятая, табуляция или точка с запятой, затем имя.

`tg messages`

чтение и отправка сообщений

`tg messages evidence`

ограниченный пакет исходных сообщений базы, от новых к старым

tg messages evidence <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--limit <n>`	количество, 1–100.
`--before-id <id>`	старше указанного идентификатора сообщения.

`tg messages list`

сообщения чата от старых к новым

tg messages list <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--limit <n>`	количество.
`--before-id <id>`	старше указанного идентификатора сообщения.
`--before-time <time>`	раньше времени ISO 8601 или 2h / 1d назад.
`--after-id <id>`	новее указанного идентификатора сообщения.
`--after-time <time>`	после времени ISO 8601 или 2h / 1d назад.
`--transcribe`	распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты.
`--model <id>`	скачанная модель для --transcribe; список в `models audio list`.
`--mark-read`	также отметить чат прочитанным до последнего показанного сообщения; собеседник видит это.

`tg messages search`

поиск сохранённого чтением, загрузкой или serve; без запросов мессенджера

tg messages search <query> [options]

Аргумент		Описание
`query`	обязательно	строгий запрос Lucene: слова, «фразы», AND/OR/NOT, группы полей и диапазоны дат; --language legacy сохраняет неточный поиск.

Параметр	Назначение
`--chat <chat>`	только чат, как chat: в запросе: название или часть, идентификатор, @username или `me` для «Избранного».
`--source <messenger>`	все аккаунты мессенджера в базе: personal, bots, all, как in: в запросе.
`--limit <n>`	количество.
`--newest`	сначала новые вместо наиболее подходящих.
`--context <n>`	контекст до и после результата: 2 сообщения в терминале, иначе 0.
`--language <lucene\|legacy>`	язык запроса: строгий Lucene или прежний неточный поиск.
`--timezone <zone>`	часовой пояс IANA для границ календарных дат.
`--regex`	слова считаются одним регулярным выражением без учёта регистра для всех сохранённых текстов.

`tg messages send`

отправить текст; без [text] читается из stdin

Изменяет данные Telegram.

tg messages send <chat> [text] [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`text`	необязателен	текст сообщения.

Параметр	Назначение
`--topic <id>`	отправить в эту тему форума; не поддерживается мессенджерами без тем.
`--reply-to <message>`	ответить на сообщение по идентификатору в том же чате.
`--send-id <id>`	повторить отправку с неизвестным результатом без риска дубликата.
`--silent`	отправить без уведомления.
`--no-preview`	отключить карточку предпросмотра ссылки.
`--md`	использовать Markdown этого мессенджера; поддерживаемый синтаксис описан в руководстве по форматированию.
`--file <file>`	прикрепить файл; текст становится подписью.
`--photo <file>`	прикрепить .jpg, .png или .webp как фото; текст становится подписью.
`--as-file`	отправить --file как скачиваемый файл, включая видео.
`--voice <file>`	отправить Ogg Opus как голосовое без текста и других вложений.
`--allow-any-file`	разрешить файл из скрытого каталога, ~/.ssh или каталогов CLI.
`--at-time <time>`	отложить отправку в мессенджере даже при выключенном компьютере: 2026-09-25T09:00 (местное время) или через 30m, 2h, 1d.

`tg messages show`

одно сообщение по чату и идентификатору или указателю msg:

tg messages show <chat> [message]

Аргумент		Описание
`chat`	обязателен	чат: название или часть, идентификатор, @username, `me` для «Избранного»; либо указатель msg: без следующего идентификатора.
`message`	необязателен	идентификатор сообщения.

`tg messages context`

сообщение и соседние от старых к новым

tg messages context <chat> [message] [options]

Аргумент		Описание
`chat`	обязателен	чат: название или часть, идентификатор, @username, `me` для «Избранного»; либо указатель msg: без следующего идентификатора.
`message`	необязателен	идентификатор сообщения.

Параметр	Назначение
`--before-n <n>`	количество до него. По умолчанию: `5`.
`--after-n <n>`	количество после него. По умолчанию: `5`.

`tg messages download`

сохранить фото, файлы, видео и голосовые сообщения или все вложения чата с --all

tg messages download <chat> [message] [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	необязателен	идентификатор сообщения; не нужен с --all.

Параметр	Назначение
`--output-dir <dir>`	каталог сохранения; создаётся при отсутствии. По умолчанию: `.`.
`--all`	все файлы чата от новых к старым; повтор продолжает загрузку.
`--pause <duration>`	с --all пауза между страницами для соблюдения лимитов. По умолчанию: `1s`.

`tg messages transcribe`

голосовое в текст через Telegram, если доступно, иначе локальной моделью

tg messages transcribe <chat> <message> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор голосового сообщения.

Параметр	Назначение
`--local`	только локальная модель, без мессенджера.
`--model <id>`	скачанная модель; подразумевает --local (`models audio list`).

`tg messages edit`

изменить своё сообщение; собеседник мог уже прочитать старый текст

Изменяет данные Telegram.

tg messages edit <chat> <message> [text] [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор своего сообщения.
`text`	необязателен	новый текст; без аргумента читается из stdin.

Параметр	Назначение
`--md`	использовать Markdown этого мессенджера; поддерживаемый синтаксис описан в руководстве по форматированию.

`tg messages delete`

удалить сообщения у себя; с --for-everyone — у всех

Изменяет данные Telegram.

tg messages delete <chat> <messages> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`messages`	обязателен	идентификаторы сообщений, максимум 10.

Параметр	Назначение
`--for-everyone`	удалить у всех участников чата; восстановить нельзя.
`--allow-dangerous`	выполнить удаление без подтверждения уровня ask.

`tg messages forward`

переслать сообщение в другой чат

Изменяет данные Telegram.

tg messages forward <chat> <message> [options]

Аргумент		Описание
`chat`	обязателен	исходный чат: название или часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения.

Параметр	Назначение
`--to <chat>`	чат назначения: название или часть, идентификатор, @username или `me` для «Избранного».
`--silent`	отправить без уведомления.
`--send-id <id>`	повторить пересылку с неизвестным результатом без риска дубликата.

`tg messages pin`

закрепить сообщение тихо, если нет --notify

Изменяет данные Telegram.

tg messages pin <chat> <message> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения.

Параметр	Назначение
`--notify`	уведомить участников о закреплении.

`tg messages unpin`

открепить сообщение

Изменяет данные Telegram.

tg messages unpin <chat> <message>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения.

`tg messages scheduled`

отложенные сообщения от ближайших к поздним; отмена в приложении

tg messages scheduled <chat>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg messages links`

причина отнесения сообщения к разговору: связи и цепочка ответов к началу

tg messages links <chat> <message>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения.

`tg reactions`

реакции на сообщения

`tg reactions add`

поставить реакцию, заменив предыдущую

Изменяет данные Telegram.

tg reactions add <chat> <message> <emoji>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения.
`emoji`	обязателен	один эмодзи, например 👍.

`tg reactions remove`

убрать свою реакцию

Изменяет данные Telegram.

tg reactions remove <chat> <message>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения.

`tg polls`

прочитать опрос, проголосовать, закрыть свой или создать

`tg polls show`

опрос и идентификаторы ответов из текущего сообщения

tg polls show <chat> <message>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения с опросом.

`tg polls vote`

проголосовать или отозвать голос; виден другим, если опрос не анонимный

Изменяет данные Telegram.

tg polls vote <chat> <message> [answers] [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор сообщения с опросом.
`answers`	необязателен	идентификаторы ответов из `polls show`.

Параметр	Назначение
`--retract`	отозвать голос.

`tg polls close`

закрыть свой опрос; больше нельзя голосовать или открыть его снова

Изменяет данные Telegram.

tg polls close <chat> <message>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`message`	обязателен	идентификатор своего сообщения с опросом.

`tg polls create`

отправить опрос отдельным сообщением; публичный без --anonymous

Изменяет данные Telegram.

tg polls create <chat> <question> <answers> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`question`	обязателен	вопрос.
`answers`	обязателен	минимум два ответа.

Параметр	Назначение
`--topic <id>`	отправить в эту тему форума; не поддерживается мессенджерами без тем.
`--multiple`	разрешить несколько вариантов.
`--anonymous`	скрыть, кто как голосовал.
`--revote`	разрешить менять голос.
`--silent`	отправить без уведомления.
`--send-id <id>`	повторить создание с неизвестным результатом без второго опроса.

`tg models`

модели, работающие на компьютере

`tg models audio`

модели распознавания голосовых сообщений

`tg models audio list`

модели от наиболее подходящих, наличие загрузки и выбор по умолчанию

tg models audio list

`tg models audio download`

однократно скачать модель с проверкой ожидаемого sha256

tg models audio download <model>

Аргумент		Описание
`model`	обязателен	идентификатор модели из `models audio list`.

`tg models text`

модели векторизации для поиска разговоров по смыслу

`tg models text list`

модели от наиболее подходящих, наличие загрузки и выбор по умолчанию

tg models text list

`tg models text download`

однократно скачать модель с проверкой ожидаемого sha256

tg models text download <model> [options]

Аргумент		Описание
`model`	обязателен	идентификатор из `models text list`.

Параметр	Назначение
`--accept-terms`	принять собственные лицензионные условия модели.

`tg models text key`

ключ сервиса векторизации для conversations embed --provider

`tg models text key set`

сохранить ключ через скрытый ввод или stdin, никогда аргументом

tg models text key set <provider>

Аргумент		Описание
`provider`	обязателен	openai или хост сервера --base-url, требующего ключ.

`tg models text key remove`

удалить сохранённый ключ

tg models text key remove <provider>

Аргумент		Описание
`provider`	обязателен	openai или хост сервера.

`tg inbox`

чужие непрочитанные во всех чатах; --new — после последней проверки

tg inbox [options]

Параметр	Назначение
`--new`	новые после проверки, каждое один раз; для расписания.
`--since-time <time>`	после времени ISO 8601 или 2h / 1d назад; позиция не меняется.
`--limit <n>`	максимум на чат, самые новые.
`--all`	включить чаты без уведомлений и архив; иначе только упоминания и ответы вам.
`--transcribe`	распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты.
`--model <id>`	скачанная модель для --transcribe; список в `models audio list`.

`tg review`

все сообщения, включая ваши, в чатах с изменениями после границы; для анализа обязательств

tg review [options]

Параметр	Назначение
`--since-time <time>`	конец прошлой проверки: ISO 8601 или 2h / 1d назад; по умолчанию три дня.
`--chat <chat>`	только этот чат: название или часть, идентификатор, @username или `me` для «Избранного».
`--unanswered [duration]`	вопросы вам или администраторам без ответа старше срока: 4h, 1d; по умолчанию 24h.
`--all`	включить чаты без уведомлений и архив; иначе только упоминания и ответы вам.
`--transcribe`	распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты.
`--model <id>`	скачанная модель для --transcribe; список в `models audio list`.

`tg topics`

темы группы-форума

`tg topics list`

темы форума по времени последней активности

tg topics list <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.

`tg topics search`

темы форума с подходящим названием

tg topics search <chat> <text> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`text`	обязателен	слова из названия темы.

Параметр	Назначение
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.

`tg topics enable`

включить темы форума; доступно только владельцу, обычная группа требует явного преобразования

Изменяет что-то в Telegram.

tg topics enable <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--upgrade`	сначала преобразовать обычную группу в супергруппу; идентификатор чата изменится.

`tg topics create`

создать тему с названием в существующем форуме; не включает темы и не преобразует группу автоматически

Изменяет что-то в Telegram.

tg topics create <chat> <title> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`title`	обязательно	название темы, максимум 128 байт UTF-8.

Параметр	Назначение
`--send-id <id>`	идентификатор попытки создания; использованный идентификатор или идентификатор с неизвестным результатом отклоняется.

`tg watch`

выводить новые сообщения до Ctrl-C или --timeout; оба завершают штатно

tg watch [options]

Параметр	Назначение
`--events`	также правки, удаления и реакции; строка содержит тип события.

`tg serve`

поддерживать базу актуальной до остановки; запускается systemd или launchd

tg serve

`tg server`

tg serve в фоне: запуск, остановка, перезапуск, состояние, журнал; install добавляет systemd или launchd

`tg server start`

запустить serve в фоне, через установленную службу, и ответить после подключения

tg server start

`tg server stop`

остановить serve профиля, через службу, если используется

tg server stop

`tg server restart`

остановить и запустить снова

tg server restart

`tg server status`

работает ли serve, с какого времени, кто запустил и какая служба используется

tg server status

`tg server logs`

последние строки serve из журнала systemd или файла

tg server logs [options]

Параметр	Назначение
`-n, --lines <n>`	количество строк. По умолчанию: `50`.

`tg server install`

создать службу systemd или агент launchd профиля; ничего не запускает

tg server install

`tg server uninstall`

удалить службу профиля; сначала остановите

tg server uninstall

`tg store`

локальная база сообщений

`tg store status`

по чатам: число сообщений, крайние даты, полностью сохранённые участки

tg store status [chat]

Аргумент		Описание
`chat`	необязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg store fetch`

загрузить историю от новых к старым; повтор продолжает загрузку

tg store fetch <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--limit <n>`	максимум сообщений за запуск; по умолчанию 1000.
`--page-size <n>`	сообщений за запрос; по умолчанию 100.
`--pause <duration>`	пауза между страницами для соблюдения лимитов. По умолчанию: `1s`.
`--since-time <time>`	остановиться у сообщений старше ISO 8601 или 2h / 1d назад.
`--last <n>`	остановиться, когда сохранены последние n сообщений.
`--background`	фоновое задание после завершения команды; следить через `store jobs show`.
`--estimate`	только оценить оставшиеся сообщения, запросы и минуты полной загрузки; по базе, без запросов.

`tg store jobs`

фоновые задания загрузки

`tg store jobs list`

задания от новых к старым

tg store jobs list

`tg store jobs show`

задание (по умолчанию последнее) и сохранённые данные его чата

tg store jobs show [job]

Аргумент		Описание
`job`	необязателен	идентификатор задания из `store fetch --background`.

`tg store jobs cancel`

остановить после текущей страницы; следующая загрузка продолжит

tg store jobs cancel <job>

Аргумент		Описание
`job`	обязателен	идентификатор задания.

`tg store export`

сохранённые сообщения чата в JSON по строкам, от старых к новым; без запросов

tg store export <chat> [options]

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

Параметр	Назначение
`--format <format>`	jsonl (по умолчанию): сообщение на строку; markdown: переписка с дневными заголовками и цитатами ответов и пересылок.
`--since-time <time>`	после времени ISO 8601 или 30m / 2h / 1d назад.
`--output <file>`	записать JSON по строкам или переписку в новый закрытый файл.

`tg store clear`

удалить покинутые чаты из базы вместе с сообщениями

tg store clear [options]

Параметр	Назначение
`--left`	только покинутые этим аккаунтом чаты.
`--allow-dangerous`	подтвердить необратимое удаление; историю покинутого чата нельзя загрузить снова.

`tg store info`

файл базы: путь, размер, структура, количество строк; без изменений

tg store info

`tg store check`

проверка целостности, поисковых индексов, диска и отстающих чатов

tg store check

`tg store migrate`

обновить структуру до текущей версии и нормализовать старые сообщения

tg store migrate

`tg store reindex`

перестроить словесный индекс и словарь опечаток из базы без потери сообщений

tg store reindex

`tg store backup`

скопировать работающую базу в новый файл без перезаписи

tg store backup <file>

Аргумент		Описание
`file`	обязателен	новый файл.

`tg store restore`

восстановить копию вместо базы; заменяемая база сохраняется рядом

tg store restore <file>

Аргумент		Описание
`file`	обязателен	файл, созданный `store backup`.

`tg conversations`

разговоры в чате по сохранённым ответам, упоминаниям и очередности авторов

`tg conversations build`

построить разговоры из базы вместо прошлого результата; без запросов

tg conversations build [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg conversations list`

разговоры от новых к старым: время, количество сообщений и участников

tg conversations list [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`--since-time <time>`	начавшиеся после ISO 8601 или 30m / 2h / 1d назад.
`--limit <n>`	количество.

`tg conversations show`

сообщения разговора от старых к новым по его идентификатору или сообщению

tg conversations show <conversation> [message]

Аргумент		Описание
`conversation`	обязателен	идентификатор из `conversations list` либо чат по названию, части, идентификатору, @username или `me` и сообщение.
`message`	необязателен	идентификатор сообщения чата для выбора разговора.

`tg conversations search`

ближайшие разговоры по смыслу и словам, лучшие первыми, один или все чаты; смысл после conversations embed; локальное выполнение

tg conversations search <query> [options]

Аргумент		Описание
`query`	обязателен	запрос своими словами на поддерживаемом моделью языке.

Параметр	Назначение
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.
`--chat <chat>`	только этот чат: название или часть, идентификатор, @username или `me` для «Избранного».
`--since-time <time>`	разговоры, продолжавшиеся после ISO 8601 или 30m / 2h / 1d назад.
`--limit <n>`	количество.

`tg conversations batches`

пакеты переписки для вашего AI-агента: на какое раннее сообщение отвечает каждое

`tg conversations batches status`

число ожидающих обработки сообщений, пакетов и объём текста

tg conversations batches status [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`--size <n>`	сообщений на пакет: 10–200, по умолчанию 50.

`tg conversations batches next`

следующий пакет с предыдущим контекстом; текст только в stdout

tg conversations batches next [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`--size <n>`	сообщений на пакет: 10–200, по умолчанию 50.

`tg conversations links`

связи агента: на какое раннее сообщение отвечает каждое сообщение пакета

`tg conversations links add`

сохранить ответы агента из stdin JSON: { "model", "answers": [{ "message", "parent", "confidence" }] }; атомарно

tg conversations links add [options]

Параметр	Назначение
`--batch <id>`	идентификатор пакета из `conversations batches next`.

`tg conversations links clear`

удалить связи агента для чата или модели без изменения сообщений

tg conversations links clear [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`--model <model>`	только ответы данной модели.

`tg conversations embed`

векторизовать фрагменты разговоров локально или через --provider со своим ключом; повтор продолжает работу

tg conversations embed [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.
`--workers <n>`	локально: параллельные сессии с отдельной моделью (~0.7 ГБ каждая).
`--threads <n>`	локально: общее число потоков (по умолчанию min(8, cores)).
`--concurrency <n>`	удалённо: параллельные запросы (по умолчанию 4).
`--max-tokens <n>`	удалённо: не запускать задачу, превышающую лимит токенов.

`tg conversations embed status`

число готовых и оставшихся векторов модели и стоимость остатка

tg conversations embed status [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.

`tg conversations embed clear`

удалить векторы чата или модели без изменения сообщений и разговоров

tg conversations embed clear [options]

Параметр	Назначение
`--chat <chat>`	чат: название или его часть, идентификатор, @username или `me` для «Избранного».
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.

`tg recipients`

чаты, куда профилю разрешено отправлять при включённом списке

`tg recipients list`

разрешённые чаты; пусто и отключено до первого добавления

tg recipients list

`tg recipients add`

разрешить отправку в чат; первое добавление включает ограничения

Изменяет данные только на этом компьютере.

tg recipients add <chat>

Аргумент		Описание
`chat`	обязателен	чат: название или его часть, идентификатор, @username или `me` для «Избранного».

`tg recipients remove`

запретить чат; список остаётся включённым

Изменяет данные только на этом компьютере.

tg recipients remove <chat>

Аргумент		Описание
`chat`	обязателен	идентификатор или название из списка.

`tg recipients clear`

удалить список и ограничения: снова разрешены все чаты

Изменяет данные только на этом компьютере.

tg recipients clear

`tg sends`

все попытки отправки профиля, без текста

`tg sends list`

попытки от новых к старым: отправлено, отклонено, ошибка, неизвестно

tg sends list [options]

Параметр	Назначение
`--limit <n>`	количество результатов.

`tg runs`

записи запусков: действия инструмента и время

`tg runs list`

записи от новых к старым

tg runs list [options]

Параметр	Назначение
`--limit <n>`	количество результатов. По умолчанию: `20`.

`tg runs show`

запуск: сведения и строка на операцию

tg runs show <run-id>

Аргумент		Описание
`run-id`	обязателен	идентификатор из `tg runs list`.

`tg runs path`

каталог запуска

tg runs path <run-id>

Аргумент		Описание
`run-id`	обязателен	идентификатор из `tg runs list`.

`tg config`

действующие настройки и источники значений

`tg config show`

профиль, существующие профили, настройки и их источники

tg config show [options]

Параметр	Назначение
`--bot`	настройки бота этого профиля вместо личного аккаунта.

`tg config set`

сохранить настройку в файл

Изменяет данные только на этом компьютере.

tg config set <setting> <value> [options]

Аргумент		Описание
`setting`	обязателен	одно из: limit, timeoutMs, color, senderColors, record, keepRunsForDays, readOnly, allow, permissions, sendsPerHour, transcribeWith, speechModel, readOtherBots, updateCheck, skillHint.
`value`	обязателен	число, true, false или список allow, например send,reaction.

Параметр	Назначение
`--defaults`	общая настройка всех профилей вместо текущего.
`--personal`	только личные аккаунты: соответствующий раздел файла.
`--bot`	только боты: раздел bot файла.

`tg config unset`

удалить настройку из файла

Изменяет данные только на этом компьютере.

tg config unset <setting> [options]

Аргумент		Описание
`setting`	обязателен	одно из: limit, timeoutMs, color, senderColors, record, keepRunsForDays, readOnly, allow, permissions, sendsPerHour, transcribeWith, speechModel, readOtherBots, updateCheck, skillHint.

Параметр	Назначение
`--defaults`	общая настройка всех профилей вместо текущего.
`--personal`	только личные аккаунты: соответствующий раздел файла.
`--bot`	только боты: раздел bot файла.

`tg doctor`

состояние установки без подключения, кроме --online

tg doctor [options]

Параметр	Назначение
`--online`	подключиться один раз и прочитать аккаунт; без отправки.

`tg doctor report`

содержимое отчёта без записи

`tg doctor report create`

записать отчёт в файл и показать, куда отправить

tg doctor report create [options]

Параметр	Назначение
`--run <id>`	запуск для отчёта; по умолчанию последний неудачный.
`--output <file>`	путь записи; по умолчанию новый файл здесь.

`tg commands`

команды, параметры и коды JSON для агента вместо --help

tg commands

`tg complete`

автодополнение: tg complete zsh выводит подключаемый скрипт

tg complete [words]

Аргумент		Описание
`words`	необязателен

`tg upgrade`

обновить tg установившим его менеджером пакетов; --check только проверяет

tg upgrade [options]

Параметр	Назначение
`--check`	проверить новую версию без установки.

`tg mcp`

доступ агента к профилю через MCP по stdin/stdout: claude mcp add tg -- tg mcp

tg mcp [options]

Параметр	Назначение
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-mark-read`	устарел: решение принимает профиль.
`--allow-delete`	устарел: решение принимает профиль.

`tg mcp config`

вывести mcpServers для Claude Desktop, Cursor и других с полными путями; без записи

tg mcp config [options]

Параметр	Назначение
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-mark-read`	устарел: решение принимает профиль.
`--allow-delete`	устарел: решение принимает профиль.

`tg mcp setup`

добавить локальный MCP-сервер этого профиля в Codex или Claude Code

Изменяет что-то только на этом компьютере.

tg mcp setup <client> [options]

Аргумент		Описание
`client`	обязательно	codex или claude-code.

Параметр	Назначение
`--allow-writes`	подтвердить, что профиль предоставляет инструменты изменения данных.
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-mark-read`	устарел: решение принимает профиль.
`--allow-delete`	устарел: решение принимает профиль.

`tg mcp doctor`

проверить локальное подключение MCP и список инструментов этого профиля

tg mcp doctor [options]

Параметр	Назначение
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-mark-read`	устарел: решение принимает профиль.
`--allow-delete`	устарел: решение принимает профиль.

`tg bot`

бот Telegram через официальный Bot API и токен, отдельно от личного аккаунта

`tg bot auth`

токен бота профиля

`tg bot auth set`

проверить токен в Telegram и сохранить: скрытый ввод или stdin

Изменяет данные только на этом компьютере.

tg bot auth set

`tg bot auth show`

источник токена и сведения о боте

tg bot auth show

`tg bot auth remove`

удалить токен профиля

Изменяет данные только на этом компьютере.

tg bot auth remove

`tg bot list`

имена ботов на компьютере; --check запрашивает сведения Telegram

tg bot list [options]

Параметр	Назначение
`--check`	запросить сведения о каждом боте в мессенджере с его токеном.

`tg bot chats`

чаты бота; Telegram не предоставляет список, поэтому list показывает увиденные

`tg bot chats list`

чаты, увиденные на компьютере; список Telegram может быть неполным

tg bot chats list

`tg bot chats show`

получить чат Telegram и запомнить

tg bot chats show <chat>

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.

`tg bot chats leave`

вывести бота из чата; вернуть сможет только администратор

Изменяет данные Telegram.

tg bot chats leave <chat>

Аргумент		Описание
`chat`	обязателен	идентификатор или название увиденного чата.

`tg bot chats action`

показать действие бота на несколько секунд: печатает, отправляет фото

Изменяет данные Telegram.

tg bot chats action <chat> <action>

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.
`action`	обязателен	действие: `typing`, `photo`, `video`, `voice`, `file`.

`tg bot chats admins`

администраторы чата, где бот администратор

`tg bot chats admins list`

администраторы и их права

tg bot chats admins list <chat>

Аргумент		Описание
`chat`	обязателен	идентификатор или название увиденного чата.

`tg bot chats admins add`

назначить участника администратором с заданными правами

Изменяет данные Telegram.

tg bot chats admins add <chat> <person> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор или название увиденного чата.
`person`	обязателен	идентификатор пользователя.

Параметр	Назначение
`--can <rights>`	разрешённые действия через запятую: members, admins, info, pin, link, post, edit, delete.
`--title <title>`	титул рядом с именем.

`tg bot chats admins remove`

снять права администратора; человек остаётся участником

Изменяет данные Telegram.

tg bot chats admins remove <chat> <person>

Аргумент		Описание
`chat`	обязателен	идентификатор или название увиденного чата.
`person`	обязателен	идентификатор пользователя.

`tg bot chats members`

участники чата, где бот администратор

`tg bot chats members remove`

удалить участника; сообщения сохраняются

Изменяет данные Telegram.

tg bot chats members remove <chat> <person> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор или название увиденного чата.
`person`	обязателен	идентификатор пользователя.

Параметр	Назначение
`--block`	также запретить возвращение по ссылке.

`tg bot chats rules`

локальные правила модерации чата для бота

`tg bot chats rules show`

правила чата; если не сохранены, исходные значения с отметкой

tg bot chats rules show <chat>

Аргумент		Описание
`chat`	обязателен	идентификатор группы или название увиденной группы.

`tg bot chats rules set`

изменить правило: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove

Изменяет данные только на этом компьютере.

tg bot chats rules set <chat> <key> <value>

Аргумент		Описание
`chat`	обязателен	идентификатор группы или название увиденной группы.
`key`	обязателен	правило.
`value`	обязателен	новое значение.

`tg bot chats rules unset`

вернуть правило к значению по умолчанию

Изменяет данные только на этом компьютере.

tg bot chats rules unset <chat> <key>

Аргумент		Описание
`chat`	обязателен	идентификатор группы или название увиденной группы.
`key`	обязателен	правило.

`tg bot chats moderate`

проверить новые сообщения по правилам группы и выполнить разрешённое от бота; вступления не проверяются

Изменяет данные Telegram.

tg bot chats moderate <chat> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор группы или название увиденной группы.

Параметр	Назначение
`--since-time <time>`	проверить после времени ISO 8601 или 2h / 1d назад; сохранённая позиция не меняется.
`--dry-run`	проверить и составить план без действий.
`--allow-dangerous`	подтвердить все действия с уровнем ask в правилах группы.
`--no-ban`	удалить без блокировки; по умолчанию возвращение по ссылке запрещено.
`--max-actions <n>`	максимум действий за запуск; по умолчанию 10.

`tg bot messages`

сообщения в чатах бота

`tg bot messages send`

отправить от бота; без [text] — stdin

Изменяет данные Telegram.

tg bot messages send <chat> [text] [options]

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.
`text`	необязателен	текст сообщения.

Параметр	Назначение
`--reply-to <message>`	ответить на сообщение по идентификатору в том же чате.
`--silent`	отправить без уведомления.
`--md`	использовать Markdown этого мессенджера; поддерживаемый синтаксис описан в руководстве по форматированию.
`--html`	HTML-текст: , , , .
`--file <file>`	прикрепить файл; текст становится подписью.
`--photo <file>`	прикрепить .jpg, .png или .webp как фото; текст становится подписью.
`--as-file`	отправить --file как скачиваемый файл, включая видео.
`--voice <file>`	отправить Ogg Opus как голосовое без текста и других вложений.
`--allow-any-file`	разрешить файл из скрытого каталога, ~/.ssh или каталогов CLI.

`tg bot messages list`

последние сообщения; без истории Telegram или с --offline — увиденное ботом на компьютере

tg bot messages list <chat> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.

Параметр	Назначение
`--limit <n>`	количество последних.

`tg bot messages show`

одно сообщение по идентификатору в чате

tg bot messages show <chat> <message>

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.
`message`	обязателен	идентификатор сообщения.

`tg bot messages edit`

заменить текст сообщения бота

Изменяет данные Telegram.

tg bot messages edit <chat> <message> <text> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.
`message`	обязателен	идентификатор сообщения.
`text`	обязателен	новый текст.

Параметр	Назначение
`--md`	использовать Markdown этого мессенджера; поддерживаемый синтаксис описан в руководстве по форматированию.
`--html`	HTML-текст: , , , .

`tg bot messages delete`

удалить сообщения в доступном боту чате; необратимо

Изменяет данные Telegram.

tg bot messages delete <chat> <messages> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.
`messages`	обязателен	идентификаторы сообщений.

Параметр	Назначение
`--allow-dangerous`	удалить без подтверждения.

`tg bot messages pin`

закрепить тихо, если нет --notify

Изменяет данные Telegram.

tg bot messages pin <chat> <message> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.
`message`	обязателен	идентификатор сообщения.

Параметр	Назначение
`--notify`	уведомить участников.

`tg bot messages unpin`

открепить сообщение

Изменяет данные Telegram.

tg bot messages unpin <chat> <message>

Аргумент		Описание
`chat`	обязателен	идентификатор чата, user: или название увиденного чата.
`message`	обязателен	идентификатор сообщения.

`tg bot messages search`

поиск локально прочитанного, отправленного и полученного ботом; лучшие совпадения первыми, все слова; "фраза", -слово, a OR b, from: chat: after: before: has:; текст, --from или оба

tg bot messages search [query] [options]

Аргумент		Описание
`query`	необязателен	искомые слова.

Параметр	Назначение
`--all-bots`	также копии всех других ботов, разрешённые readOtherBots.
`--bots <profiles>`	также копии указанных через запятую ботов с разрешением readOtherBots.
`--limit <n>`	количество.
`--newest`	сначала новые вместо наиболее подходящих.
`--from <who>`	только автор: идентификатор, @username или часть имени; повторите для нескольких.

`tg bot messages between`

сообщения двух и более людей в чатах, где писали все, из локальной базы по чатам от старых к новым; --limit для каждого чата. Общие чаты определяются по сообщениям, а не списку участников Telegram

tg bot messages between <people> [options]

Аргумент		Описание
`people`	обязателен	два или более человека по идентификатору, @username или части имени.

Параметр	Назначение
`--all-bots`	также копии всех других ботов, разрешённые readOtherBots.
`--bots <profiles>`	также копии указанных через запятую ботов с разрешением readOtherBots.
`--limit <n>`	число последних сообщений каждого чата.

`tg bot recipients`

разрешённые чаты бота; без списка — все; clear удаляет список

`tg bot recipients list`

разрешённые чаты или пусто без списка

tg bot recipients list

`tg bot recipients add`

разрешить чат: идентификатор, user:<id> или название увиденного чата

Изменяет данные только на этом компьютере.

tg bot recipients add <chat>

Аргумент		Описание
`chat`	обязателен

`tg bot recipients remove`

убрать чат из списка

Изменяет данные только на этом компьютере.

tg bot recipients remove <chat>

Аргумент		Описание
`chat`	обязателен

`tg bot recipients clear`

удалить список: снова разрешены все чаты

Изменяет данные только на этом компьютере.

tg bot recipients clear

`tg bot sends`

отправки, правки и удаления бота с компьютера: идентификаторы и результат, без текста

`tg bot sends list`

tg bot sends list

`tg bot watch`

выводить и сохранять новые сообщения до Ctrl-C или --timeout; оба завершают штатно

tg bot watch [options]

Параметр	Назначение
`--events`	также правки, удаления, нажатия кнопок, вступления и выходы; строки имеют тип события.
`--types <types>`	типы обновлений через запятую в обозначениях мессенджера.

`tg bot callbacks`

ответы на нажатия кнопок под сообщениями бота

`tg bot callbacks answer`

ответить по callback: --notification — разовое уведомление человеку, --text — замена сообщения кнопки

Изменяет данные Telegram.

tg bot callbacks answer <callback> [options]

Аргумент		Описание
`callback`	обязателен	идентификатор callback из `bot watch`.

Параметр	Назначение
`--text <text>`	новый текст сообщения.
`--notification <text>`	уведомление только нажавшему кнопку.

`tg bot commands`

меню команд бота после /

`tg bot commands list`

текущие команды меню

tg bot commands list

`tg bot commands set`

заменить меню: команда как name=description, например start=Begin

Изменяет данные Telegram.

tg bot commands set <commands>

Аргумент		Описание
`commands`	обязателен	name=description для каждой команды.

`tg bot commands clear`

очистить меню

Изменяет данные Telegram.

tg bot commands clear

`tg bot webhooks`

адрес обновлений бота; пока задан, bot watch ничего не получает

`tg bot webhooks list`

вебхуки бота

tg bot webhooks list

`tg bot webhooks set`

передавать обновления на HTTPS-адрес; запрещено при другом вебхуке

Изменяет данные Telegram.

tg bot webhooks set <url> [options]

Аргумент		Описание
`url`	обязателен	HTTPS-адрес.

Параметр	Назначение
`--types <types>`	типы обновлений через запятую в обозначениях мессенджера.
`--secret-stdin`	секрет для каждого обновления; ввод по запросу или stdin.

`tg bot webhooks delete`

отключить адрес; без вебхуков bot watch снова работает

Изменяет данные Telegram.

tg bot webhooks delete <url>

Аргумент		Описание
`url`	обязателен	адрес.

`tg bot contacts`

увиденные ботом авторы из локальной базы; Telegram запрашивается только явно

`tg bot contacts show`

человек: чаты, где писал, последнее сообщение там, недавние сообщения личного чата с ботом

tg bot contacts show <who> [options]

Аргумент		Описание
`who`	обязателен	идентификатор, @username или часть имени.

Параметр	Назначение
`--all-bots`	также копии всех других ботов, разрешённые readOtherBots.
`--bots <profiles>`	также копии указанных через запятую ботов с разрешением readOtherBots.
`--limit <n>`	количество сообщений личного чата.
`--refresh`	сначала перечитать личный чат через мессенджер одним запросом.

`tg bot me`

бот, которому принадлежит токен профиля: идентификатор, имя и имя пользователя

tg bot me

`tg bot store`

локальная копия бота на этом компьютере

`tg bot store fetch`

загрузить историю чата в локальную копию бота, начиная с новых сообщений; повторите запуск для продолжения

tg bot store fetch <chat> [options]

Аргумент		Описание
`chat`	обязателен	идентификатор или название увиденного чата.

Параметр	Назначение
`--limit <n>`	максимум сообщений за запуск; по умолчанию 1000.
`--page-size <n>`	число сообщений в одном запросе; по умолчанию 100.
`--pause <duration>`	пауза между страницами для соблюдения лимитов мессенджера. По умолчанию: `1s`.
`--since-time <time>`	остановиться у сообщений старше ISO 8601 или 2h / 1d назад.
`--last <n>`	остановиться, когда сохранены последние n сообщений.
`--from <link>`	начать с сообщения по ссылке включительно; иначе использовать самое новое известное сообщение.

`tg bot mcp`

доступ агента к боту через MCP по stdin/stdout: claude mcp add sales-bot -- tg sales bot mcp

tg bot mcp [options]

Параметр	Назначение
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-delete`	устарел: решение принимает профиль.
`--allow-moderate`	устарел: решение принимает профиль.

`tg bot mcp config`

вывести mcpServers для Claude Desktop, Cursor и других с полными путями; без записи

tg bot mcp config [options]

Параметр	Назначение
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-delete`	устарел: решение принимает профиль.
`--allow-moderate`	устарел: решение принимает профиль.

`tg skill`

инструкции агенту по инструменту

`tg skill show`

вывести SKILL.md; tg skill install устанавливает для Claude Code, Codex и Gemini CLI

tg skill show [name]

Аргумент		Описание
`name`	необязателен	встроенный skill для задачи: link-conversations.

`tg skill install`

записать SKILL.md в ~/.claude/skills/tg-cli/ (Claude Code) и ~/.agents/skills/tg-cli/ (Codex, Gemini CLI)

tg skill install [options]

Параметр	Назначение
`--for <agents>`	агенты: `claude`, `agents`, `all`. По умолчанию: `all`.

Коды завершения

Проверяйте код, а не текст: текст может меняться, код стабилен.

Код	Когда
`0`	успех
`2`	`validation_error`
`3`	`configuration_error`
`4`	`authentication_error`
`5`	`permission_error`
`6`	`not_found`
`7`	`confirmation_required`
`8`	`rate_limited`
`9`	`timeout`
`10`	`network_error`
`11`	`provider_error`
`12`	`provider_unavailable`
`13`	`invalid_response`
`14`	`outcome_unknown`
`130`	`cancelled`
`1`	остальные случаи

Только 0 означает выполненную операцию. 14 (outcome_unknown) означает, что сообщение могло уйти; повторяйте с тем же --send-id, исключающим дубликат в Telegram.

Общие параметрыCopy Anchor Link

tg sessionCopy Anchor Link

tg session startCopy Anchor Link

tg session endCopy Anchor Link

tg setupCopy Anchor Link

tg accountCopy Anchor Link

tg account showCopy Anchor Link

tg account updateCopy Anchor Link

tg account sessionsCopy Anchor Link

tg account sessions listCopy Anchor Link

tg account sessions endCopy Anchor Link

tg chatsCopy Anchor Link

tg chats listCopy Anchor Link

tg chats eventsCopy Anchor Link

tg chats inspectCopy Anchor Link

tg chats showCopy Anchor Link

tg chats membersCopy Anchor Link

tg chats members listCopy Anchor Link

tg chats members addCopy Anchor Link

tg chats members removeCopy Anchor Link

tg chats mark-readCopy Anchor Link

tg chats createCopy Anchor Link

tg chats joinCopy Anchor Link

tg chats leaveCopy Anchor Link

tg chats updateCopy Anchor Link

tg chats linkCopy Anchor Link

tg chats link showCopy Anchor Link

tg chats link resetCopy Anchor Link

tg chats adminsCopy Anchor Link

tg chats admins addCopy Anchor Link

tg chats admins removeCopy Anchor Link

tg chats foldersCopy Anchor Link

tg chats folders listCopy Anchor Link

tg chats folders createCopy Anchor Link

tg chats folders updateCopy Anchor Link

tg chats folders deleteCopy Anchor Link

tg chats rulesCopy Anchor Link

tg chats rules showCopy Anchor Link

tg chats rules setCopy Anchor Link

tg chats rules unsetCopy Anchor Link

tg chats moderateCopy Anchor Link

tg contactsCopy Anchor Link

tg contacts listCopy Anchor Link

tg contacts showCopy Anchor Link

tg contacts lookupCopy Anchor Link

tg contacts syncCopy Anchor Link

tg contacts addCopy Anchor Link

tg contacts removeCopy Anchor Link

tg contacts blockCopy Anchor Link

tg contacts unblockCopy Anchor Link

tg contacts renameCopy Anchor Link

tg contacts importCopy Anchor Link

tg messagesCopy Anchor Link

tg messages evidenceCopy Anchor Link

tg messages listCopy Anchor Link

tg messages searchCopy Anchor Link

tg messages sendCopy Anchor Link

tg messages showCopy Anchor Link

tg messages contextCopy Anchor Link

tg messages downloadCopy Anchor Link

tg messages transcribeCopy Anchor Link

tg messages editCopy Anchor Link

tg messages deleteCopy Anchor Link

tg messages forwardCopy Anchor Link

tg messages pinCopy Anchor Link

tg messages unpinCopy Anchor Link

tg messages scheduledCopy Anchor Link

tg messages linksCopy Anchor Link

tg reactionsCopy Anchor Link

tg reactions addCopy Anchor Link

tg reactions removeCopy Anchor Link

tg pollsCopy Anchor Link

tg polls showCopy Anchor Link

tg polls voteCopy Anchor Link

tg polls closeCopy Anchor Link

tg polls createCopy Anchor Link

tg modelsCopy Anchor Link

tg models audioCopy Anchor Link

tg models audio listCopy Anchor Link

Общие параметры

`tg session`

`tg session start`

`tg session end`

`tg setup`

`tg account`

`tg account show`

`tg account update`

`tg account sessions`

`tg account sessions list`

`tg account sessions end`

`tg chats`

`tg chats list`

`tg chats events`

`tg chats inspect`

`tg chats show`

`tg chats members`

`tg chats members list`

`tg chats members add`

`tg chats members remove`

`tg chats mark-read`

`tg chats create`

`tg chats join`

`tg chats leave`

`tg chats update`

`tg chats link`

`tg chats link show`

`tg chats link reset`

`tg chats admins`

`tg chats admins add`

`tg chats admins remove`

`tg chats folders`

`tg chats folders list`

`tg chats folders create`

`tg chats folders update`

`tg chats folders delete`

`tg chats rules`

`tg chats rules show`

`tg chats rules set`

`tg chats rules unset`

`tg chats moderate`

`tg contacts`

`tg contacts list`

`tg contacts show`

`tg contacts lookup`

`tg contacts sync`

`tg contacts add`

`tg contacts remove`

`tg contacts block`

`tg contacts unblock`

`tg contacts rename`

`tg contacts import`

`tg messages`

`tg messages evidence`

`tg messages list`

`tg messages search`

`tg messages send`

`tg messages show`

`tg messages context`

`tg messages download`

`tg messages transcribe`

`tg messages edit`

`tg messages delete`

`tg messages forward`

`tg messages pin`

`tg messages unpin`

`tg messages scheduled`

`tg messages links`

`tg reactions`

`tg reactions add`

`tg reactions remove`

`tg polls`

`tg polls show`

`tg polls vote`

`tg polls close`

`tg polls create`

`tg models`

`tg models audio`

`tg models audio list`

`tg models audio download`