Личный аккаунт
Вход, чтение, поиск, файлы, отправка, архив и настройки своего аккаунта.
Здесь собраны команды личного аккаунта. Вы найдёте точную команду, аргументы и параметры для входа, чтения, поиска, файлов и отправки.
Вход, чтение, поиск, файлы, отправка, архив и настройки своего аккаунта.
Общие параметры
| Параметр | Назначение |
|---|---|
-V, --version | показать номер версии. |
-v, --verbose | подробности: -v — идентификаторы, -vv — все известные данные. По умолчанию: 0. |
--json | машиночитаемый вывод: единственное значение JSON в stdout. |
--jsonl | машиночитаемый вывод: объект JSON на строку для потоковой обработки и jq. |
--quiet | отключить диагностику; ошибки остаются. |
--trace | журнал соединения в stderr, без содержимого сообщений. |
--timeout <duration> | ограничить время всей команды: 30s, 2m, 500ms. |
--offline | читать сохранённое без подключения; ошибка, если данных нет. |
--no-input | не запрашивать ввод и не открывать интерактивный вход; ввод через канал остаётся доступным. |
--max-input-bytes <bytes> | максимальный размер буферизованного ввода в байтах (по умолчанию: 16777216). |
--max-output-bytes <bytes> | максимальный размер машинного вывода в байтах (по умолчанию: 4194304; 0 отключает ограничение). |
--fields <paths> | поля элементов или объекта через запятую: id,text; сохранять пагинацию и идентификаторы операций. |
--dry-run | предварительно показать разобранные аргументы и разрешения перед выполнением действия. |
--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 для передачи агентом вместо отображения. |
--sms | вход по телефону: попросить код по SMS; Telegram всё равно может отказать. |
tg session end
завершить сессию профиля в Telegram и удалить её локально
Changes something in Telegram.
tg session endtg setup
настроить Telegram и подключить агента
Changes something in 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 list
все профили на этом компьютере и аккаунт каждого; не обращается к мессенджеру
tg account listtg account show
под каким аккаунтом вошёл профиль; последние четыре цифры телефона
tg account show [options]| Параметр | Назначение |
|---|---|
--show-phone | показать полный номер телефона. |
tg account update
изменить видимые всем имя, описание или фото профиля
Changes something in 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 listtg account sessions end
завершить все другие сессии, включая телефон; текущая остаётся
Changes something in 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 send-as
от чьего имени этот аккаунт может публиковать в чате; сохранённый выбор не меняется
tg chats send-as <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg chats mark-read
отметить чат прочитанным; собеседник видит прочтение
Changes something in Telegram.
tg chats mark-read <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--until <message> | до указанного идентификатора сообщения; по умолчанию до последнего. |
--topic <id> | отметить прочитанной только эту тему форума; в мессенджерах без тем не поддерживается. |
tg chats tracking
чаты, списки участников которых serve ежедневно загружает в локальное хранилище — chats members fetch --track добавляет чат
tg chats tracking list
все отслеживаемые чаты: с какого момента и последнее число участников
tg chats tracking listtg chats tracking show
один чат: отслеживается ли он и число участников за каждый день последних 30 дней
tg chats tracking show <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg chats tracking add
ежедневно загружать список участников этого чата, пока работает serve, начиная со следующего запуска
tg chats tracking add <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg chats tracking remove
прекратить ежедневную загрузку; уже сохранённая история остаётся
tg chats tracking remove <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg chats join
вступить в группу или канал по ссылке; участники видят вступление
Changes something in Telegram.
tg chats join <link>| Аргумент | Обязательность | Описание |
|---|---|---|
link | обязателен | приглашение или публичная ссылка. |
tg chats leave
выйти из группы или канала; участники видят выход
Changes something in Telegram.
tg chats leave <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg chats folders
ваши папки чатов
tg chats folders list
папки в порядке отображения в приложении
tg chats folders listtg chats folders show
одна папка с названиями её чатов
tg chats folders show <folder>| Аргумент | Обязательность | Описание |
|---|---|---|
folder | обязателен | идентификатор папки или её точное название. |
tg chats folders create
создать папку чатов
Changes something in Telegram.
tg chats folders create <title> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
title | обязателен | название папки; приложение может отклонить слишком длинное. |
| Параметр | Назначение |
|---|---|
--chat <chat> | чат для добавления по идентификатору или названию; повторите для нескольких. |
--include <kinds> | все чаты этих типов: contacts, non-contacts, groups, channels, bots. |
--skip <which> | исключить чаты muted, read, archived. |
--exclude-chat <chat> | никогда не показывать этот чат в папке; для нескольких повторить. |
--pin <chat> | закрепить чат вверху папки; для нескольких повторить. |
--emoji <emoji> | значок папки. |
tg chats folders update
переименовать папку или изменить её чаты
Changes something in Telegram.
tg chats folders update <folder> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
folder | обязателен | идентификатор папки или точное название. |
| Параметр | Назначение |
|---|---|
--title <title> | новое название. |
--add <chat> | добавить чат; повторите для нескольких. |
--remove <chat> | убрать чат из неё, а также из списков исключённых и закреплённых; повторите для нескольких чатов. |
--include <kinds> | все чаты типов contacts, non-contacts, groups, channels, bots; заменяет прежнее правило, none очищает. |
--skip <which> | исключить чаты muted, read, archived; заменяет прежнее правило, none очищает. |
--exclude-chat <chat> | никогда не показывать этот чат в папке; для нескольких повторить. |
--pin <chat> | закрепить чат вверху папки; для нескольких повторить. |
--emoji <emoji> | значок папки. |
tg chats folders delete
удалить папку; чаты сохраняются
Changes something in Telegram.
tg chats folders delete <folder>| Аргумент | Обязательность | Описание |
|---|---|---|
folder | обязателен | идентификатор папки или точное название. |
tg chats folders order
расположить папки в этом порядке; неуказанные папки сохранят свой порядок после них
Changes something in Telegram.
tg chats folders order <folders>| Аргумент | Обязательность | Описание |
|---|---|---|
folders | обязательный | идентификаторы папок или точные названия, первая идёт первой. |
tg chats folders join
добавить папку, которой поделились по ссылке; вступает в каждый чат в ней, и другие участники видят ваше вступление
Changes something in Telegram.
tg chats folders join <link>| Аргумент | Обязательность | Описание |
|---|---|---|
link | обязательный | ссылка папки вида t.me/addlist/…. |
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 contacts
люди с личными чатами у этого аккаунта
tg contacts list
люди, с которыми у вас есть личный чат
tg contacts list [options]| Параметр | Назначение |
|---|---|
--limit <n> | количество результатов. |
--page <n> | номер страницы, начиная с 1. |
--all | все строки без страниц. |
--order <recent|name> | сначала недавние переписки или по алфавиту. По умолчанию: recent. |
--search <text> | только люди, у которых имя, локальный псевдоним или @username содержит этот текст. |
--search-notes <text> | только люди, в личных заметках о которых есть этот текст. |
tg contacts show
человек и общие с ним чаты
tg contacts show <person> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор, @username или часть имени. |
| Параметр | Назначение |
|---|---|
--with-notes | включить ваши личные заметки при наличии разрешения contacts.notes.list. |
tg contacts profile
всё, что мессенджер сообщает о человеке: имена пользователей, флаги, последний визит, дата регистрации; число его сообщений в хранилище для каждого вашего общего чата, первое и последнее сообщение, а также прежние имена и имена пользователей, зафиксированные хранилищем
tg contacts profile <person> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор, @username или часть имени. |
| Параметр | Назначение |
|---|---|
--show-phone | показать полный номер телефона. |
tg contacts context
сведения о человеке в локальном хранилище; --chat --refresh сначала явно обращается к Telegram
tg contacts context <person> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор, @username или часть имени. |
| Параметр | Назначение |
|---|---|
--limit <n> | не больше этого числа сообщений в каждом списке; по умолчанию 10. |
--since-time <time> | не старше времени ISO 8601 или 2h / 1d назад. |
--chat <chat> | чат по идентификатору или имени; повторите для нескольких — затем последние сообщения человека в каждом, 20, если не задан --limit, сокращённо, если не задан -v. |
--refresh | с --chat сначала прочитать последние сообщения человека в каждом чате из мессенджера. |
tg contacts check
похож ли человек на бота, фальшивый аккаунт или спамера: профиль, его сообщения в хранилище и публичные списки блокировок (Combot Anti-Spam (CAS), lols.bot), в которые отправляется его идентификатор — подсказка, а не окончательный вывод
tg contacts check <person> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор, @username или часть имени. |
| Параметр | Назначение |
|---|---|
--no-registries | пропустить публичные списки блокировок; профиль и фотографии всё равно запрашиваются у Telegram, если не задан --offline. |
tg contacts link
записать, что два человека в базе — один человек; одинакового имени для этого недостаточно
tg contacts link <person> <other>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор, @username или часть имени. |
other | обязателен | тот же человек в другом мессенджере базы, в виде : — max:Ana. |
tg contacts unlink
отменить contacts link для одной учётной записи: она снова считается отдельным человеком
tg contacts unlink <person>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор, @username или часть имени; : для другого мессенджера. |
tg contacts lookup
владелец номера телефона: запрос или stdin, никогда аргумент
tg contacts lookuptg contacts sync
сохранить полную адресную книгу мессенджера в локальной базе
tg contacts synctg contacts alias
личное локальное отображаемое имя в выбранном аккаунте
tg contacts alias set
Изменяет данные только на этом компьютере.
tg contacts alias set <person> <alias>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | |
alias | обязателен |
tg contacts alias rm
Изменяет данные только на этом компьютере.
tg contacts alias rm <person>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен |
tg contacts notes
ваши личные заметки о сохранённом контакте, общие для всех аккаунтов, где он виден
tg contacts notes list
tg contacts notes list <person>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен |
tg contacts notes show
tg contacts notes show <person> <id>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | |
id | обязателен |
tg contacts notes add
Изменяет данные только на этом компьютере.
tg contacts notes add <person> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен |
| Параметр | Назначение |
|---|---|
--file <path> | читать текст заметки из файла; без параметра или с - читать stdin. |
tg contacts notes edit
Изменяет данные только на этом компьютере.
tg contacts notes edit <person> <id> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | |
id | обязателен |
| Параметр | Назначение |
|---|---|
--file <path> | читать текст заметки из файла; без параметра или с - читать stdin. |
--revision <number> | номер ревизии, которую вы прочитали перед редактированием. |
tg contacts notes remove
Изменяет данные только на этом компьютере.
tg contacts notes remove <person> <id>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | |
id | обязателен |
tg contacts add
добавить контакт; contacts list по-прежнему показывает только личные чаты
Changes something in Telegram.
tg contacts add <person>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор из contacts lookup или часть известного имени. |
tg contacts remove
удалить контакт; чат остаётся, заданное вами имя может исчезнуть
Changes something in Telegram.
tg contacts remove <person>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор из contacts lookup или часть известного имени. |
tg contacts block
запретить человеку писать вам; контакт необязателен
Changes something in Telegram.
tg contacts block <person>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор из contacts lookup или часть известного имени. |
tg contacts unblock
разрешить заблокированному человеку снова писать вам
Changes something in Telegram.
tg contacts unblock <person>| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор из contacts lookup или часть известного имени. |
tg contacts rename
переименовать контакт в адресной книге мессенджера; для личного локального имени используйте contacts alias
Changes something in Telegram.
tg contacts rename <person> <first-name> [last-name]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязателен | идентификатор из contacts lookup или часть известного имени. |
first-name | обязателен | имя, под которым вы хотите видеть человека. |
last-name | необязателен |
tg contacts import
загрузить телефоны и добавить найденных мессенджером людей
Changes something in 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 назад. |
--topic <id> | только эта тема форума; читать назад от последнего сообщения или --before-id. |
--transcribe | распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты. |
--model <id> | скачанная модель для --transcribe; список в models audio list. |
--mark-read | также отметить чат прочитанным до последнего показанного сообщения; собеседник видит это. |
tg messages send
отправить текст; без [text] читается из stdin
Changes something in Telegram.
tg messages send <chat> [text] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
text | необязателен | текст сообщения. |
| Параметр | Назначение |
|---|---|
--topic <id> | отправить в эту тему форума; не поддерживается мессенджерами без тем. |
--reply-to <message> | ответить на сообщение по идентификатору в том же чате. |
--comment-to <post> | комментарий к этой публикации канала; отправляется в группу обсуждения публикации. |
--send-as <id> | публиковать от имени одной из сущностей в списке chats send-as; обязательно, если чат по умолчанию публикует от другого имени. |
--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. |
--spoiler | скрыть --photo или видео под спойлером до нажатия. |
--caption-above | показать текст над --photo или --file, а не под ним. |
--filename <name> | имя --file, видимое другим, вместо имени файла на диске. |
--html | HTML-текст: , , , . |
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 | необязателен | идентификатор сообщения. |
| Параметр | Назначение |
|---|---|
--thread | сохранённая цепочка ответов и ответы на сообщение вместо соседей по времени; без графа — соседи по времени. |
--thread-hops <n> | не больше этого числа связей от найденного сообщения (по умолчанию 8). |
--thread-messages <n> | не больше этого числа сообщений в контексте каждой ветки (по умолчанию 50). |
--thread-bytes <n> | не больше этого числа байтов целых сообщений и связей в каждом контексте (по умолчанию 65536). |
--thread-within <duration> | сообщения в пределах этого времени по обе стороны от найденного (по умолчанию 1d). |
--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. |
--extract | прочитать текстовые слои файлов, которые эта загрузка сопоставляет с локальным индексом содержимого. |
tg messages transcribe
голосовое в текст через Telegram, если доступно, иначе локальной моделью
tg messages transcribe <chat> <message> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор голосового сообщения. |
| Параметр | Назначение |
|---|---|
--local | только локальная модель, без мессенджера. |
--model <id> | скачанная модель; подразумевает --local (models audio list). |
tg messages edit
изменить своё сообщение; собеседник мог уже прочитать старый текст
Changes something in Telegram.
tg messages edit <chat> <message> [text] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор своего сообщения. |
text | необязателен | новый текст; без аргумента читается из stdin. |
| Параметр | Назначение |
|---|---|
--md | использовать Markdown этого мессенджера; поддерживаемый синтаксис описан в руководстве по форматированию. |
--html | HTML-текст: , , , . |
tg messages delete
удалить сообщения у себя; с --for-everyone — у всех
Changes something in Telegram.
tg messages delete <chat> <messages> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
messages | обязателен | идентификаторы сообщений, максимум 10. |
| Параметр | Назначение |
|---|---|
--for-everyone | удалить у всех участников чата; восстановить нельзя. |
--allow-dangerous | выполнить удаление без подтверждения уровня ask. |
tg messages forward
переслать сообщение в другой чат
Changes something in Telegram.
tg messages forward <chat> <message> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | исходный чат: название или часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения. |
| Параметр | Назначение |
|---|---|
--to <chat> | чат назначения: название или часть, идентификатор, @username или me для «Избранного». |
--silent | отправить без уведомления. |
--send-as <id> | публиковать от имени одной из сущностей в списке chats send-as для чата --to; обязательно, если чат по умолчанию публикует от другого имени. |
--send-id <id> | повторить пересылку с неизвестным результатом без риска дубликата. |
--topic <id> | переслать в эту тему форума чата --to. |
tg messages pin
закрепить сообщение тихо, если нет --notify
Changes something in Telegram.
tg messages pin <chat> <message> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения. |
| Параметр | Назначение |
|---|---|
--notify | уведомить участников о закреплении. |
tg messages unpin
открепить сообщение
Changes something in Telegram.
tg messages unpin <chat> <message>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения. |
tg messages scheduled
отложенные сообщения от ближайших к поздним; отмена в приложении
tg messages scheduled <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg messages link
постоянная ссылка на сообщение, если она поддерживается, и локатор, привязанный к аккаунту
tg messages link <chat> [message]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или часть, идентификатор, @username, me для «Избранного»; либо указатель msg: без следующего идентификатора. |
message | необязателен | идентификатор сообщения. |
tg messages comments
комментарии под публикацией канала, от старых к новым; находятся в её группе обсуждения
tg messages comments <chat> <post> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязательный | канал: чат по названию или его части, идентификатору, @username либо me для Избранного. |
post | обязательный | идентификатор сообщения публикации в канале. |
| Параметр | Назначение |
|---|---|
--limit <n> | количество. |
--before-id <id> | только комментарии старше комментария с этим идентификатором. |
tg messages links
причина отнесения сообщения к разговору: связи и цепочка ответов к началу
tg messages links <chat> <message>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения. |
tg reactions
реакции на сообщения
tg reactions add
поставить реакцию, заменив предыдущую
Changes something in Telegram.
tg reactions add <chat> <message> <emoji>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения. |
emoji | обязателен | один эмодзи, например 👍. |
tg reactions remove
убрать свою реакцию
Changes something in 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 voters
кто за что проголосовал, новое сверху; для неанонимного опроса
tg polls voters <chat> <message> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения с опросом. |
| Параметр | Назначение |
|---|---|
--answer <id> | только выбравшие этот ответ, с ID, как его показывает polls show. |
--limit <n> | количество. |
tg polls vote
проголосовать или отозвать голос; виден другим, если опрос не анонимный
Changes something in Telegram.
tg polls vote <chat> <message> [answers] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения с опросом. |
answers | необязателен | идентификаторы ответов из polls show. |
| Параметр | Назначение |
|---|---|
--retract | отозвать голос. |
tg polls close
закрыть свой опрос; больше нельзя голосовать или открыть его снова
Changes something in Telegram.
tg polls close <chat> <message>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор своего сообщения с опросом. |
tg polls create
отправить опрос отдельным сообщением; публичный без --anonymous
Changes something in Telegram.
tg polls create <chat> <question> <answers> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
question | обязателен | вопрос. |
answers | обязателен | минимум два ответа. |
| Параметр | Назначение |
|---|---|
--topic <id> | отправить в эту тему форума; не поддерживается мессенджерами без тем. |
--multiple | разрешить несколько вариантов. |
--anonymous | скрыть, кто как голосовал. |
--revote | разрешить менять голос. |
--silent | отправить без уведомления. |
--send-as <id> | публиковать от имени одной из сущностей в списке chats send-as; обязательно, если чат по умолчанию публикует от другого имени. |
--send-id <id> | повторить создание с неизвестным результатом без второго опроса. |
--quiz | викторина: один правильный ответ, голос окончательный. |
--correct <n> | с --quiz: позиция правильного ответа, от 1. |
--solution <text> | с --quiz: пояснение, которое люди видят после ответа. |
--close-time <delay> | опрос закроется сам через это время после отправки: от 5s до 10m, например 90s или 5m. |
tg models
модели, работающие на компьютере
tg models audio
модели распознавания голосовых сообщений
tg models audio list
модели от наиболее подходящих, наличие загрузки и выбор по умолчанию
tg models audio listtg models audio download
однократно скачать модель с проверкой ожидаемого sha256
tg models audio download <model>| Аргумент | Обязательность | Описание |
|---|---|---|
model | обязателен | идентификатор модели из models audio list. |
tg models text
модели векторизации для поиска разговоров по смыслу
tg models text list
модели от наиболее подходящих, наличие загрузки и выбор по умолчанию
tg models text listtg models text download
однократно скачать модель с проверкой ожидаемого sha256
tg models text download <model> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
model | обязателен | идентификатор из models text list. |
| Параметр | Назначение |
|---|---|
--accept-terms | принять собственные лицензионные условия модели. |
tg models text key
ключи API сервисов векторов и анализа
tg models text key set
сохранить ключ через скрытый ввод или stdin, никогда аргументом
tg models text key set <provider>| Аргумент | Обязательность | Описание |
|---|---|---|
provider | обязателен | openai, anthropic или хост сервера --base-url, требующего ключ. |
tg models text key remove
удалить сохранённый ключ
tg models text key remove <provider>| Аргумент | Обязательность | Описание |
|---|---|---|
provider | обязателен | openai, anthropic или хост сервера. |
tg inbox
чужие непрочитанные во всех чатах; --new — после последней проверки
tg inbox [options]| Параметр | Назначение |
|---|---|
--new | новые после проверки, каждое один раз; для расписания. |
--since-time <time> | после времени ISO 8601 или 2h / 1d назад; позиция не меняется. |
--limit <n> | максимум на чат, самые новые. |
--all | включить чаты без уведомлений и архив; иначе только упоминания и ответы вам. |
--kind <kinds> | только чаты этих типов через запятую: dialog, group, channel, saved. |
--transcribe | распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты. |
--model <id> | скачанная модель для --transcribe; список в models audio list. |
--mark-read | также отметить каждый показанный чат прочитанным до последнего показанного сообщения; собеседник это видит. |
--no-mark-read | не отмечать, независимо от настройки catchUpMarksRead. |
tg review
все сообщения, включая ваши, в чатах с изменениями после границы; для анализа обязательств
tg review [options]| Параметр | Назначение |
|---|---|
--since-time <time> | конец прошлой проверки: ISO 8601 или 2h / 1d назад; по умолчанию три дня. |
--chat <chat> | только этот чат: название или часть, идентификатор, @username или me для «Избранного». |
--kind <kinds> | только чаты этих типов через запятую: dialog, group, channel, saved. |
--unanswered [duration] | вопросы вам или администраторам без ответа старше срока: 4h, 1d; по умолчанию 24h. |
--all | включить чаты без уведомлений и архив; иначе только упоминания и ответы вам. |
--transcribe | распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты. |
--model <id> | скачанная модель для --transcribe; список в models audio list. |
--new | изменения после прошлого review --new, с позицией для каждого чата; для запусков по расписанию. |
--mark-read | также отметить каждый показанный чат прочитанным до последнего показанного сообщения; собеседник это видит. |
--no-mark-read | не отмечать, независимо от настройки catchUpMarksRead. |
tg topics
темы группы-форума
tg topics list
темы форума по времени последней активности
tg topics list <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--limit <n> | количество результатов. |
--page <n> | номер страницы, начиная с 1. |
--all | все строки без страниц. |
tg topics show
одна тема форума: название, состояние и последняя активность
tg topics show <chat> <topic>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
topic | обязателен | идентификатор темы из topics list. |
tg topics enable
включить темы форума; доступно только владельцу, обычная группа требует явного преобразования
Changes something in Telegram.
tg topics enable <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--upgrade | сначала преобразовать обычную группу в супергруппу; идентификатор чата изменится. |
tg topics create
создать тему с названием в существующем форуме; не включает темы и не преобразует группу автоматически
Changes something in Telegram.
tg topics create <chat> <title> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
title | обязательно | название темы, максимум 128 байт UTF-8. |
| Параметр | Назначение |
|---|---|
--send-id <id> | идентификатор попытки создания; использованный идентификатор или идентификатор с неизвестным результатом отклоняется. |
tg topics edit
переименовать, закрыть или снова открыть тему форума
Changes something in Telegram.
tg topics edit <chat> <topic> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
topic | обязательный | идентификатор темы из topics list. |
| Параметр | Назначение |
|---|---|
--title <title> | новое название, не более 128 байт UTF-8. |
--closed <on|off> | on закрывает тему для новых сообщений, off снова открывает её. |
--pinned <on|off> | on закрепляет тему вверху списка, off открепляет её. |
--hidden <on|off> | on скрывает тему General из списка тем, off показывает её. |
tg topics delete
удалить тему форума и все её сообщения у всех; действие необратимо
Changes something in Telegram.
tg topics delete <chat> <topic> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
topic | обязательный | идентификатор темы из topics list. |
| Параметр | Назначение |
|---|---|
--allow-dangerous | выполнить удаление без подтверждения уровня ask. |
tg topics order
расположить закреплённые темы в этом порядке; ничего не закрепляет и не открепляет
Changes something in Telegram.
tg topics order <chat> <topic>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
topic | обязательный | идентификаторы закреплённых тем, от первой к последней. |
tg watch
выводить новые сообщения до Ctrl-C или --timeout; оба завершают штатно
tg watch [options]| Параметр | Назначение |
|---|---|
--events | также правки, удаления и реакции; строка содержит тип события. |
tg serve
поддерживать базу актуальной до остановки; запускается systemd или launchd
tg servetg server
tg serve в фоне: запуск, остановка, перезапуск, состояние, журнал; install добавляет systemd или launchd
tg server start
запустить serve в фоне, через установленную службу, и ответить после подключения
tg server starttg server stop
остановить serve профиля, через службу, если используется
tg server stoptg server restart
остановить и запустить снова
tg server restarttg server status
работает ли serve, с какого времени, кто запустил и какая служба используется
tg server statustg server logs
последние строки serve из журнала systemd или файла
tg server logs [options]| Параметр | Назначение |
|---|---|
-n, --lines <n> | количество строк. По умолчанию: 50. |
tg server install
создать службу systemd или агент launchd профиля; ничего не запускает
tg server installtg server uninstall
удалить службу профиля; сначала остановите
tg server uninstalltg store
локальная база сообщений
tg store status
по чатам: число сообщений, крайние даты, полностью сохранённые участки
tg store status [chat]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | необязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg store fetch
загрузить историю чата в локальное хранилище, сначала новые сообщения; повторите запуск для продолжения; --all загружает все чаты
tg store fetch [chat] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | необязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--all | каждый чат, сначала недавно активные — это нужно для поиска; последние 90d, если не заданы --since-time или --last. |
--limit <n> | не более указанного числа сообщений за этот запуск, на чат с --all; 1000, если не указано. |
--page-size <n> | число сообщений в одном запросе; по умолчанию 100. |
--pause <duration> | пауза между страницами для соблюдения лимитов. По умолчанию: 1s. |
--since-time <time> | остановиться у сообщений старше ISO 8601 или 2h / 1d назад. |
--last <n> | остановиться, когда сохранены последние n сообщений. |
--catch-up | подготовить локальный поиск после загрузки; переопределяет searchCatchUp. |
--no-catch-up | пропустить локальную подготовку после этой загрузки. |
--catch-up-chunks <n> | не более указанного числа локальных векторных фрагментов. |
--catch-up-messages <n> | пропустить перестроение графа, если число сообщений превышает это значение. |
--catch-up-time <duration> | лимит времени локальной подготовки, по умолчанию 30s. |
--background | фоновое задание после завершения команды; следить через store jobs show. |
--estimate | только оценить оставшиеся сообщения, запросы и минуты полной загрузки; по базе, без запросов. |
tg store gaps
проверить записанные внутренние пробелы охвата и явно загрузить данные для них
tg store gaps plan
локальный план охвата; отсутствие идентификаторов сообщений само по себе не означает нехватку истории
tg store gaps plan <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg store gaps repair
загрузить данные внутренних пробелов с ограничениями и перепроверить охват; никогда не удалять сообщения, которые не встретились при загрузке
tg store gaps repair <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--limit <n> | общее число сообщений при этом устранении пробелов, по умолчанию 500. |
--max-gaps <n> | не более указанного числа пробелов, по умолчанию 5. |
--repair-time <duration> | лимит времени устранения пробелов, по умолчанию 30s. По умолчанию: 30s. |
--page-size <n> | число сообщений на страницу провайдера. |
--pause <duration> | пауза между страницами провайдера. По умолчанию: 1s. |
--fingerprint <hash> | отказать, если этот ранее проверенный план охвата изменился. |
--catch-up | подготовить локальный поиск после устранения пробелов; переопределяет searchCatchUp. |
--no-catch-up | пропустить подготовку локального поиска после устранения пробелов. |
--catch-up-chunks <n> | максимальное число подготавливаемых локальных фрагментов. |
--catch-up-messages <n> | максимальное число сохранённых сообщений, читаемых для подготовки. |
--catch-up-time <duration> | время подготовки в пределах оставшегося лимита устранения пробелов. |
--background | устранять пробелы через существующий механизм заданий хранилища; проверять через store jobs show. |
tg store jobs
фоновые задания загрузки
tg store jobs list
задания от новых к старым
tg store jobs list [options]| Параметр | Назначение |
|---|---|
--state <state> | только задачи в этом состоянии. Одно из: running, done, failed, cancelled, died. |
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 jobs retry
повторить неудачное или прерванное задание как новое; загрузка продолжается с места остановки базы
tg store jobs retry [job] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
job | необязателен | идентификатор задания. |
| Параметр | Назначение |
|---|---|
--failed | каждый чат, чьё последнее задание неудачно или прервано. |
tg store jobs clear
забыть завершённые задания и удалить их журналы; запущенное задание сохраняется
Изменяет данные только на этом компьютере.
tg store jobs cleartg store export
сохранённые сообщения чата в JSON по строкам, от старых к новым; без запросов
tg store export [chats] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chats | необязателен | чат: название или его часть, идентификатор, @username или me для «Избранного»; несколько — с --to. |
| Параметр | Назначение |
|---|---|
--format <format> | jsonl (по умолчанию): сообщение на строку; markdown: переписка с дневными заголовками и цитатами ответов и пересылок. |
--since-time <time> | после времени ISO 8601 или 30m / 2h / 1d назад. |
--output <file> | записать JSON по строкам или переписку в новый закрытый файл. |
--to <dir> | записать в этот каталог файл на каждый чат и manifest; повторный запуск добавляет только изменения. |
--kind <kinds> | с --to: все сохранённые чаты этих типов через запятую: dialog, group, channel, saved. |
--all | с --to: все сохранённые чаты этого аккаунта. |
--encrypt | сжать и зашифровать паролем, введённым в скрытом запросе или переданным через stdin; пароль нигде не хранится — без него файл не открыть. |
tg store clear
удалить покинутые чаты из базы вместе с сообщениями
tg store clear [options]| Параметр | Назначение |
|---|---|
--left | только покинутые этим аккаунтом чаты. |
--allow-dangerous | подтвердить необратимое удаление; историю покинутого чата нельзя загрузить снова. |
tg store info
файл базы: путь, размер, структура, количество строк; без изменений
tg store infotg store check
проверка целостности, поисковых индексов, диска и отстающих чатов
tg store checktg store migrate
обновить структуру до текущей версии, затем нормализовать, проиндексировать и разобрать на основы старые сообщения и заметки
tg store migratetg store reindex
перестроить словесный индекс, словарь опечаток, основы слов, словесный индекс файлов и индексы заметок из сохранённых данных; ничего не теряется
tg store reindextg store backup
скопировать работающую базу в новый файл без перезаписи
tg store backup <file> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
file | обязателен | новый файл. |
| Параметр | Назначение |
|---|---|
--encrypt | сжать и зашифровать паролем, введённым в скрытом запросе или переданным через stdin; пароль нигде не хранится — без него файл не открыть. |
tg store restore
восстановить копию вместо базы; заменяемая база сохраняется рядом
tg store restore <file>| Аргумент | Обязательность | Описание |
|---|---|---|
file | обязателен | файл, созданный store backup; для файла, записанного с --encrypt, запрашивается пароль. |
tg store decrypt
расшифровать файл, записанный с --encrypt, в новый файл; запрашивает пароль
tg store decrypt <file> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
file | обязателен | файл, созданный store backup --encrypt или store export --encrypt. |
| Параметр | Назначение |
|---|---|
--output <file> | новый файл, доступный только вам. |
tg store repair
привести каждую таблицу к виду этой сборки, ничего не удаляя: таблица неправильного вида сохраняется копией рядом с новой
tg store repair [options]| Параметр | Назначение |
|---|---|
--dry-run | показать, что будет сделано, ничего не меняя. |
tg store copies
таблицы, которые store repair сохранил копиями
tg store copies delete
удалить одну копию, сохранённую store repair, по точному имени; другие таблицы не удаляет
tg store copies delete <name>| Аргумент | Обязательность | Описание |
|---|---|---|
name | обязателен | имя копии, как его вывел store repair. |
tg conversations
разговоры в чате по сохранённым ответам, упоминаниям и очередности авторов
tg conversations build
построить разговоры из базы вместо прошлого результата; без --chat — все чаты, изменившиеся после построения, и все ещё не построенные группы; без запросов
tg conversations build [options]| Параметр | Назначение |
|---|---|
--chat <chat> | чат: название или его часть, идентификатор, @username или me для «Избранного». |
--analyze | связать пакеты через настроенный сервис анализа; требует --chat и запоминает согласие для этого чата и сервиса. |
--provider <provider> | анализ: agent, openai или anthropic. |
--model <model> | модель анализа; заменяет analysisModel. |
--base-url <url> | адрес API анализа; заменяет analysisBaseUrl. |
--size <n> | сообщений-ответов на пакет анализа, 10–200; по умолчанию 50. |
--max-tokens <n> | предел резерва входных и выходных токенов анализа за запуск; по умолчанию 100000. |
--max-chats <n> | не больше этого числа чатов за запуск; по умолчанию 20. |
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 related
разговоры, ближайшие по смыслу к тому, в котором находится сообщение, во всех построенных чатах, лучшие первыми — по векторам, сохранённым conversations embed; модель не запускается
tg conversations related <chat> <message> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
message | обязателен | идентификатор сообщения в этом чате. |
| Параметр | Назначение |
|---|---|
--limit <n> | количество. |
--model <model> | локально: идентификатор из models text list (по умолчанию e5-small); удалённо: модель сервиса. |
--provider <provider> | сервис векторов: local или openai; параметры команды важнее настроек профиля. |
--base-url <url> | сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio. |
--dims <n> | размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI. |
tg conversations status
насколько актуальны разговоры и векторы каждого построенного чата: сообщения, которых не видело построение, фрагменты с актуальным, устаревшим или отсутствующим вектором
tg conversations status [options]| Параметр | Назначение |
|---|---|
--chat <chat> | только этот чат: название или часть, идентификатор, @username или me для «Избранного». |
--model <model> | локально: идентификатор из models text list (по умолчанию e5-small); удалённо: модель сервиса. |
--provider <provider> | сервис векторов: local или openai; параметры команды важнее настроек профиля. |
--base-url <url> | сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio. |
--dims <n> | размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI. |
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 consents
запомненные разрешения на анализ для чатов этого аккаунта и адресов сервисов
tg conversations consents list
tg conversations consents listtg conversations consents revoke
tg conversations consents revoke [options]| Параметр | Назначение |
|---|---|
--chat <chat> | отозвать согласия только этого чата; по умолчанию всех чатов. |
--provider <identity> | точное обозначение сервиса из consents list; по умолчанию все сервисы. |
tg conversations embed
векторизовать фрагменты разговоров локально или через --provider со своим ключом; повтор продолжает работу; без --chat — все построенные чаты с оставшимися фрагментами, только локально
tg conversations embed [options]| Параметр | Назначение |
|---|---|
--chat <chat> | чат: название или его часть, идентификатор, @username или me для «Избранного». |
--model <model> | локально: идентификатор из models text list (по умолчанию e5-small); удалённо: модель сервиса. |
--provider <provider> | сервис векторов: local или 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> | удалённо: не запускать задачу, превышающую лимит токенов. |
--max-chats <n> | не больше этого числа чатов за запуск; по умолчанию 20. |
--max-chunks <n> | не больше этого числа фрагментов за запуск; по умолчанию 2000, с --chat без ограничения. |
tg conversations embed status
число готовых и оставшихся векторов модели и стоимость остатка
tg conversations embed status [options]| Параметр | Назначение |
|---|---|
--chat <chat> | чат: название или его часть, идентификатор, @username или me для «Избранного». |
--model <model> | локально: идентификатор из models text list (по умолчанию e5-small); удалённо: модель сервиса. |
--provider <provider> | сервис векторов: local или 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> | сервис векторов: local или openai; параметры команды важнее настроек профиля. |
--base-url <url> | сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio. |
--dims <n> | размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI. |
tg attachments
файлы сохранённых сообщений: их текст в локальной базе для content: в поиске
tg attachments extract
сохранить текст скачанных файлов — текст, текстовые слои PDF/DOCX, ODT/ODS/XLSX/PPTX/EPUB — в локальном хранилище для поиска content:
tg attachments extract [options]| Параметр | Назначение |
|---|---|
--chat <chat> | только файлы этого чата: название или часть, идентификатор, @username или me для «Избранного». |
--from-dir <dir> | сопоставить файлы в этом каталоге без обхода подкаталогов; требуется --chat. |
--cursor <cursor> | продолжить с курсора, возвращённого извлечением с ограничениями. |
--download | сначала скачать из мессенджера в --output-dir файлы, которые ещё не скачивались. |
--output-dir <dir> | с --download: куда сохранить файлы; каталог создаётся при необходимости. |
--limit <n> | прочитать не больше этого числа файлов; повторный запуск продолжает. |
--ocr | явно вызвать models.ocr для массового извлечения текста из изображений и сканированных PDF. |
--concurrency <n> | удалённо: параллельные запросы (по умолчанию 4). |
tg attachments list
файлы сохранённых сообщений: где сохранён каждый и есть ли его текст — без самого текста
tg attachments list [options]| Параметр | Назначение |
|---|---|
--chat <chat> | только файлы этого чата: название или часть, идентификатор, @username или me для «Избранного». |
--needs-text | только сохранённые здесь файлы, текста которых ещё нет: их читает агент и записывает текст обратно. |
--limit <n> | количество результатов. |
--page <n> | номер страницы, начиная с 1. |
--all | все строки без страниц. |
tg attachments show
прочитать ограниченную порцию сохранённого вложения; JSON содержит байты в base64
tg attachments show <chat> [message] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | required | чат: название или его часть, ID, @username, либо me для Избранного; или только адрес msg:. |
message | необязателен | идентификатор сообщения. |
| Параметр | Назначение |
|---|---|
--attachment <n> | позиция файла от 1; обязательна при нескольких файлах. |
--page <n> | отрисовать одну страницу PDF как PNG, от 1; необязательные unpdf/canvas, без OCR. |
--offset-bytes <n> | смещение в байтах от 0. |
--chunk-bytes <n> | число возвращаемых байтов, 1–1048576 (по умолчанию524288). |
--if-sha256 <hash> | требовать SHA-256 всего файла из предыдущей порции. |
tg attachments text
текст одного файла в том виде, в каком его прочитал агент
tg attachments text set
сохранить текст, который агент прочитал из файла — скана, фотографии, — чтобы его находил content:; ничего не отправляется
tg attachments text set <chat> [message] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или часть, идентификатор, @username, me для «Избранного»; либо указатель msg: без следующего идентификатора. |
message | необязателен | идентификатор сообщения. |
| Параметр | Назначение |
|---|---|
--attachment <n> | какой файл сообщения, начиная с 1; нужен, если файлов больше одного. |
--text-file <path> | прочитать текст из этого файла; - или без значения — из stdin. |
tg tags
ваши собственные метки на чатах, людях и сообщениях; хранятся в локальной базе и никуда не отправляются; tag: в поиске находит помеченное
tg tags auto
назначить локальные теги группам и каналам по кешированным метаданным с помощью правил ключевых слов
Изменяет данные только на этом компьютере.
tg tags auto [options]| Параметр | Назначение |
|---|---|
--chat <chat> | сохранённая группа или канал; повторите для выбора нескольких. По умолчанию: ``. |
--limit <number> | обработать не более указанного числа чатов, от 1 до 500. По умолчанию: 50. |
--refresh-metadata | прочитать текущие описания из мессенджера перед классификацией. |
--dry-run | предварительно показать классификацию по кешу без изменения хранилища. |
tg tags add
поставить метки на один чат, человека или сообщение
Изменяет данные только на этом компьютере.
tg tags add <tag> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
tag | обязателен | одна или несколько меток: 1–32 символа из латинских букв a–z, цифр и дефисов; заглавные буквы переводятся в строчные. |
| Параметр | Назначение |
|---|---|
--chat <chat> | чат для метки или чат сообщения из --message: название или часть, идентификатор, @username или me для «Избранного». |
--contact <person> | человек для метки: идентификатор, @username или имя, как они известны локальной базе. |
--message <message> | сообщение для метки: его идентификатор в --chat или отдельный указатель msg:. |
tg tags remove
снять метки с одного чата, человека или сообщения
Изменяет данные только на этом компьютере.
tg tags remove <tag> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
tag | обязателен | одна или несколько меток: 1–32 символа из латинских букв a–z, цифр и дефисов; заглавные буквы переводятся в строчные. |
| Параметр | Назначение |
|---|---|
--chat <chat> | чат, с которого снять метку, или чат сообщения из --message: название или часть, идентификатор, @username или me для «Избранного». |
--contact <person> | человек, с которого снять метку: идентификатор, @username или имя, как они известны локальной базе. |
--message <message> | сообщение, с которого снять метку: его идентификатор в --chat или отдельный указатель msg:. |
--source <manual|auto> | удалить только отметку о принадлежности к этому источнику. |
tg tags list
что помечено: чаты и сообщения этого аккаунта и люди его мессенджера
tg tags list [options]| Параметр | Назначение |
|---|---|
--tag <tag> | только эта метка. |
--source <manual|auto> | только метки с отметкой о принадлежности к этому источнику. |
--type <names> | только помеченное этого типа: chat, contact или message. |
tg metadata
кешированные описания групп и каналов для локальных автоматических тегов
tg metadata get
tg metadata get [options]| Параметр | Назначение |
|---|---|
--chat <chat> | сохранённый чат. |
tg metadata refresh
Изменяет данные только на этом компьютере.
tg metadata refresh [options]| Параметр | Назначение |
|---|---|
--chat <chat> | сохранённая группа или канал; повторите для нескольких. По умолчанию: ``. |
--only-missing | только чаты без метаданных; без --chat — все сохранённые группы и каналы. |
--limit <number> | обработать не более указанного числа чатов, от 1 до 500. По умолчанию: 50. |
tg stats
Статистика сообщений, чатов и их авторов
tg stats messages
Статистика сообщений из локального хранилища
tg stats messages show
сколько сохранённых сообщений подходит, по чатам, авторам, дням или часам — только локальная база; с --sync-first сначала загружает новые сообщения
tg stats messages show [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязателен | строгий запрос Lucene, как для search messages; без него считаются все сохранённые сообщения; с --saved дополнительные слова добавляются через AND. |
| Параметр | Назначение |
|---|---|
--sync-first | сначала загрузить новые сообщения в пределах ограничений по чатам, времени и сообщениям. |
--max-chats <n> | обновить не больше этого числа чатов (по умолчанию 5). |
--sync-time <duration> | прекратить загрузку через это время (по умолчанию 30s). |
--max-messages <n> | загрузить не больше этого числа сообщений всего (по умолчанию 500). |
--by <chat|sender|day|hour> | по чему считать (по умолчанию chat). |
--chat <chat> | только чат, как chat: в запросе: название или часть, идентификатор, @username или me для «Избранного». |
--source <messenger> | все аккаунты мессенджера в базе: personal, bots, all, как in: в запросе. |
--limit <n> | количество строк. |
--timezone <zone> | часовой пояс IANA для календарных дней и часов. |
--exact | слова без поля и фразы в кавычках совпадают только в точной форме, как exact:word; text: по-прежнему учитывает все словоформы. |
--saved <name|id> | посчитать совпадения сохранённого поиска или прошлого запуска; указанные здесь параметры заменяют его собственные. |
tg stats messages counters
наблюдения каждого счётчика и ограниченное обновление из мессенджера
tg stats messages counters show
показать сохранённые значения счётчиков и свежесть наблюдений
tg stats messages counters show [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | optional | строгий запрос Lucene по сохранённым сообщениям. |
| Параметр | Назначение |
|---|---|
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--source <messenger> | подключённые аккаунты этого мессенджера; обновление использует активный. |
--exact | слова без операторов совпадают по точной форме. |
--timezone <zone> | часовой пояс IANA для дат запроса. |
--selection <json> | фиксированная выборка целей из counters show; несовместима с запросом и областью. |
--counters <names> | разные поля views,reactions,comments; по умолчанию все три. |
--limit <n> | сообщения, 1–100; по умолчанию 20. |
--max-age <duration> | максимальный возраст свежего наблюдения; по умолчанию 24h. |
tg stats messages counters refresh
прочитать достоверные счётчики ограниченного числа сообщений и обновить локальные наблюдения
Изменяет данные только на этом компьютере.
tg stats messages counters refresh [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | optional | строгий запрос Lucene по сохранённым сообщениям. |
| Параметр | Назначение |
|---|---|
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--source <messenger> | подключённые аккаунты этого мессенджера; обновление использует активный. |
--exact | слова без операторов совпадают по точной форме. |
--timezone <zone> | часовой пояс IANA для дат запроса. |
--selection <json> | фиксированная выборка целей из counters show; несовместима с запросом и областью. |
--counters <names> | разные поля views,reactions,comments; по умолчанию все три. |
--limit <n> | сообщения, 1–100; по умолчанию 20. |
--max-messages <n> | максимум сообщений для обновления, 1–100. |
--sync-time <duration> | время удалённого обновления; по умолчанию 30s, максимум 5m. |
--dry-run | показать точные сохранённые цели и поддерживаемые счётчики без подключения. |
tg stats messages unanswered
самые старые найденные вопросы без наблюдаемого подходящего прямого ответа
tg stats messages unanswered [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязательный | строгий запрос Lucene; без запроса выбираются все сохранённые сообщения. |
| Параметр | Назначение |
|---|---|
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--source <messenger> | все имеющиеся аккаунты этого мессенджера; personal, bots или all. |
--exact | слова без поля совпадают в точной форме, а не по основе слова. |
--saved <name|id> | запустить сохранённый отчёт этого вида; указанные опции заменяют сохранённые. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
--limit <n> | строк отчёта, 1–100; по умолчанию 20. |
--answerer <person> | сохранённое имя, псевдоним, @username, ID или person:provider/account/id; для неоднозначных имён нужен выбор; для нескольких повторить. |
--older-than <duration> | минимальный возраст вопроса без наблюдаемого подходящего ответа. |
tg stats messages discussion
просмотренные посты с малым сохранённым обсуждением
tg stats messages discussion [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязательный | строгий запрос Lucene; без запроса выбираются все сохранённые сообщения. |
| Параметр | Назначение |
|---|---|
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--source <messenger> | все имеющиеся аккаунты этого мессенджера; personal, bots или all. |
--exact | слова без поля совпадают в точной форме, а не по основе слова. |
--saved <name|id> | запустить сохранённый отчёт этого вида; указанные опции заменяют сохранённые. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
--limit <n> | строк отчёта, 1–100; по умолчанию 20. |
--min-views <n> | минимум известных накопленных просмотров. |
--max-replies <n> | максимум наблюдаемых ответов в обсуждении. |
tg stats messages top
ранжировать сохранённые сообщения по метрике или объяснимой оценке; у каждого счётчика показана свежесть наблюдения
tg stats messages top [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязательный | строгий запрос Lucene; без запроса выбираются все сохранённые сообщения. |
| Параметр | Назначение |
|---|---|
--sync-first | сначала загрузить новые сообщения в пределах ограничений по чатам, времени и сообщениям. |
--max-chats <n> | обновить не больше этого числа чатов (по умолчанию 5). |
--sync-time <duration> | прекратить загрузку через это время (по умолчанию 30s). |
--max-messages <n> | загрузить не больше этого числа сообщений всего (по умолчанию 500). |
--measure <name> | показатель ранжирования; не сочетается с score или weights. Одно из: views, reactions, forwards, comments, replies, thread-size. |
--score <preset> | helpful/active для авторов; engaging для обоих типов объектов. Одно из: helpful, active, engaging. |
--weights <json> | полный набор весов компонентов; заменяет веса предустановки. |
--message-kind <kind> | перед ранжированием выбрать все сообщения либо подтверждённые публикации или комментарии. Одно из: all, posts, comments. |
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--source <messenger> | все имеющиеся аккаунты этого мессенджера; personal, bots или all. |
--timezone <zone> | часовой пояс IANA для дат и активных дней. |
--exact | слова без поля совпадают в точной форме, а не по основе слова. |
--limit <n> | строки рейтинга, 1–100. |
--saved <name|id> | выполнить сохранённый запрос или запуск ранжирования; явно введённые параметры заменяют сохранённые. |
tg stats messages evidence
ограниченная страница сообщений, пар ответов или участников когорты из точной выборки drilldown
tg stats messages evidence <message> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
message | required | канонический адрес сообщения или ссылка когорты удержания из drilldown. |
| Параметр | Назначение |
|---|---|
--selection <json> | полностью определённая выборка рейтинга, возвращённая в drilldown. |
--component <name> | доступный компонент рейтинга. |
--limit <n> | строки подтверждающих данных, 1–100; 20, если не указано. |
--cursor <cursor> | продолжить для того же компонента и отпечатка сохранённых подтверждающих данных. |
tg stats contacts
Статистика о человеческих авторах
tg stats contacts responses
число ответов и медиана/p90 времени ответа выбранных людей
tg stats contacts responses [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязательный | строгий запрос Lucene; без запроса выбираются все сохранённые сообщения. |
| Параметр | Назначение |
|---|---|
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--source <messenger> | все имеющиеся аккаунты этого мессенджера; personal, bots или all. |
--exact | слова без поля совпадают в точной форме, а не по основе слова. |
--saved <name|id> | запустить сохранённый отчёт этого вида; указанные опции заменяют сохранённые. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
--limit <n> | строк отчёта, 1–100; по умолчанию 20. |
--answerer <person> | сохранённое имя, псевдоним, @username, ID или person:provider/account/id; для неоднозначных имён нужен выбор; для нескольких повторить. |
tg stats contacts top
ранжировать авторов сохранённых сообщений по метрике или объяснимой оценке; у каждого счётчика показана свежесть наблюдения
tg stats contacts top [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязательный | строгий запрос Lucene; без запроса выбираются все сохранённые сообщения. |
| Параметр | Назначение |
|---|---|
--sync-first | сначала загрузить новые сообщения в пределах ограничений по чатам, времени и сообщениям. |
--max-chats <n> | обновить не больше этого числа чатов (по умолчанию 5). |
--sync-time <duration> | прекратить загрузку через это время (по умолчанию 30s). |
--max-messages <n> | загрузить не больше этого числа сообщений всего (по умолчанию 500). |
--measure <name> | показатель ранжирования; не сочетается с score или weights. Одно из: messages, words, reactions, replies, answers, answer-time, threads, active-days. |
--score <preset> | helpful/active для авторов; engaging для обоих типов объектов. Одно из: helpful, active, engaging. |
--weights <json> | полный набор весов компонентов; заменяет веса предустановки. |
--message-kind <kind> | перед ранжированием выбрать все сообщения либо подтверждённые публикации или комментарии. Одно из: all, posts, comments. |
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--source <messenger> | все имеющиеся аккаунты этого мессенджера; personal, bots или all. |
--timezone <zone> | часовой пояс IANA для дат и активных дней. |
--exact | слова без поля совпадают в точной форме, а не по основе слова. |
--limit <n> | строки рейтинга, 1–100. |
--saved <name|id> | выполнить сохранённый запрос или запуск ранжирования; явно введённые параметры заменяют сохранённые. |
--min-messages <n> | минимальное число выбранных сообщений на автора; 1 либо 5 для engaging. |
tg stats contacts evidence
ограниченная страница сообщений, пар ответов или участников когорты из точной выборки drilldown
tg stats contacts evidence <person> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
person | обязательный | точный собственный идентификатор человека в мессенджере из строки рейтинга. |
| Параметр | Назначение |
|---|---|
--selection <json> | полностью определённая выборка рейтинга, возвращённая в drilldown. |
--component <name> | доступный компонент рейтинга. |
--limit <n> | строки подтверждающих данных, 1–100; 20, если не указано. |
--cursor <cursor> | продолжить для того же компонента и отпечатка сохранённых подтверждающих данных. |
tg stats chats
Статистика одного чата
tg stats chats show
показатели группы или канала за период: сообщения, активные участники, ответы, реакции, вопросы с ответом, вступления и выходы — по локальной базе; вступления и выходы запрашиваются у мессенджера
tg stats chats show <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--since-time <time> | ISO 8601 или 2h / 1d назад; по умолчанию 7 дней. |
--by <day|week> | также по строке на календарный день или неделю (недели начинаются с понедельника). |
--timezone <zone> | часовой пояс IANA для календарных дней. |
tg stats chats newcomers
участники с известным вступлением и помощь в окне после вступления
tg stats chats newcomers <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--since-time <time> | с этого времени ISO 8601 или 2h / 1d назад; по умолчанию 30d назад. |
--until-time <time> | до этого времени ISO 8601 или 2h / 1d назад включительно. |
--within <duration> | окно помощи после известного вступления новичка. |
--saved <name|id> | запустить сохранённый отчёт этого вида; указанные опции заменяют сохранённые. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
--limit <n> | строк отчёта, 1–100; по умолчанию 20. |
--answerer <person> | сохранённое имя, псевдоним, @username, ID или person:provider/account/id; для неоднозначных имён нужен выбор; для нескольких повторить. |
tg stats chats retention
когорты вступления и наблюдаемое участие в контрольные даты по сохранённым спискам состава
tg stats chats retention <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--since-time <time> | начало периода вступления в ISO 8601 или относительное время; по умолчанию последние 90 дней. |
--until-time <time> | конец периода вступления; по умолчанию сейчас. |
--checkpoints <durations> | до 10 возрастающих сроков после вступления через запятую; по умолчанию 1d,7d,30d. |
--within <duration> | окно активности и раннего ухода после вступления; по умолчанию 7d. |
--by <day|week> | группировать даты вступления по календарному дню или неделе с понедельника. Одно из: day, week. |
--timezone <zone> | часовой пояс IANA для когорт вступления. |
--limit <n> | когорты и доказательства участников, 1–100. |
tg stats chats official
статистика, вычисленная самим Telegram для группы или канала, которыми вы управляете: общие показатели в сравнении с предыдущим периодом, ведущие участники и все графики в виде рядов JSON; период выбирает мессенджер
tg stats chats official <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg stats tasks
Статистика задач
tg stats tasks show
для каждого чата: число открытых задач, самая старая открытая задача, медианное время до закрытия
tg stats tasks show [options]| Параметр | Назначение |
|---|---|
--chat <chat> | только этот чат; название или его часть, идентификатор, @username либо me для Избранного. |
--type <name> | только этот тип: question, request, mention или promise. |
tg stats charts
данные графика из статистики чата и, по желанию, изображение SVG или PNG с тёмным оформлением
tg stats charts <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--chart-kind <messages|active|membership> | что рисовать: сообщения, активных авторов или вступления и выходы. По умолчанию: messages. |
--by <day|week> | одна точка на календарный день или неделю (недели начинаются в понедельник). По умолчанию: day. |
--since-time <time> | ISO 8601 или 2h / 1d назад; по умолчанию 7 дней. |
--timezone <zone> | часовой пояс IANA для календарных дней. |
--output <file> | записать изображение с тёмным оформлением в новый файл .svg или .png. |
tg tasks
то, что требует вашего внимания — вопросы без ответа, упоминания, просьбы, обещания — в локальном хранилище; review и serve добавляют их
tg tasks list
задачи, сначала самые старые, с их источником — сообщением или заметкой
tg tasks list [options]| Параметр | Назначение |
|---|---|
--state <state> | только задачи в этом состоянии: open, done или dismissed. |
--chat <chat> | только задачи этого чата; название или его часть, идентификатор, @username либо me для Избранного. |
--type <names> | только эти типы через запятую: question, request, mention, promise. |
--before-time <time> | только задачи, открытые до этого времени в ISO 8601 или до момента 2h / 1d назад. |
--limit <n> | количество. |
tg tasks add
добавить задачу для сохранённого сообщения или заметки — обещания или просьбы
tg tasks add <message> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
message | обязательный | адрес сообщения msg:/// или note:. |
| Параметр | Назначение |
|---|---|
--type <name> | тип задачи: question, request, mention или promise. |
tg tasks close
закрыть задачу: done либо dismissed, если ответ не нужен; закрытая задача остаётся закрытой
tg tasks close <task> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
task | обязательный | идентификатор задачи, как показывает tasks list. |
| Параметр | Назначение |
|---|---|
--as <state> | как закрыть: done или dismissed — ответ не требуется. |
--reason <text> | причина, сохраняемая с задачей — например, no-reply-needed. |
tg search
поиск по тексту: search all ищет во всём, что есть в локальном хранилище, остальные — в одном ресурсе
tg search all
поиск во всём, что есть в локальном хранилище, — сообщения мессенджеров, почта и заметки, — лучшие совпадения первыми; начните с него, если не знаете, где это было написано
tg search all <query> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | обязателен | строгий запрос Lucene: слова, «фразы», AND/OR/NOT, группы полей и диапазоны дат. |
| Параметр | Назначение |
|---|---|
--only <resources> | только эти ресурсы через запятую: messages, mail, notes. |
--limit <n> | количество. |
--exact | слова без поля и фразы в кавычках совпадают только в точной форме, как exact:word. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
tg search messages
поиск сообщений мессенджера в локальном хранилище и на его сервере (--backend); по желанию загружает новые сообщения с --sync-first
tg search messages [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязателен | строгий запрос Lucene: слова, «фразы», AND/OR/NOT, группы полей и диапазоны дат; --language legacy сохраняет неточный поиск; с --saved дополнительные слова добавляются через AND. |
| Параметр | Назначение |
|---|---|
--sync-first | сначала загрузить новые сообщения в пределах ограничений по чатам, времени и сообщениям. |
--max-chats <n> | обновить не больше этого числа чатов (по умолчанию 5). |
--sync-time <duration> | прекратить загрузку через это время (по умолчанию 30s). |
--max-messages <n> | загрузить не больше этого числа сообщений всего (по умолчанию 500). |
--thread | сохранённая цепочка ответов и ответы на сообщение вместо соседей по времени; без графа — соседи по времени. |
--thread-hops <n> | не больше этого числа связей от найденного сообщения (по умолчанию 8). |
--thread-messages <n> | не больше этого числа сообщений в контексте каждой ветки (по умолчанию 50). |
--thread-bytes <n> | не больше этого числа байтов целых сообщений и связей в каждом контексте (по умолчанию 65536). |
--thread-within <duration> | сообщения в пределах этого времени по обе стороны от найденного (по умолчанию 1d). |
--backend <archive|server|both> | где искать: локальный архив, сервер мессенджера или оба (по умолчанию: both). |
--server-time <duration> | прекратить ожидание ответа сервера через это время (по умолчанию: 5s). |
--chat <chat> | только чат, как chat: в запросе: название или часть, идентификатор, @username или me для «Избранного». |
--source <messenger> | все аккаунты мессенджера в базе: personal, bots, all, как in: в запросе. |
--type <text|voice|file> | только сообщения этого типа: только текст, голосовое сообщение или файл. |
--limit <n> | количество. |
--newest | сначала новые вместо наиболее подходящих. |
--exact | слова без поля и фразы в кавычках совпадают только в точной форме, как exact:word; text: по-прежнему учитывает все словоформы. |
--context <n> | контекст до и после результата: 2 сообщения в терминале, иначе 0. |
--language <lucene|legacy> | язык запроса: строгий Lucene или прежний неточный поиск. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
--regex | слова считаются одним регулярным выражением без учёта регистра для всех сохранённых текстов. |
--saved <name|id> | запустить сохранённый поиск или прошлый запуск; указанные здесь параметры заменяют его собственные. |
tg search mail
поиск по почте, импортированной в локальное хранилище; её загружает memo mail import
tg search mail [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | необязателен | строгий запрос Lucene: слова, «фразы», AND/OR/NOT, группы полей и диапазоны дат. |
| Параметр | Назначение |
|---|---|
--chat <chat> | только эта почтовая переписка, по идентификатору или теме. |
--limit <n> | количество. |
--newest | сначала новые вместо наиболее подходящих. |
--exact | слова без поля и фразы в кавычках совпадают только в точной форме, как exact:word; text: по-прежнему учитывает все словоформы. |
--context <n> | контекст до и после результата: 2 сообщения в терминале, иначе 0. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
tg search notes
поиск по заметкам — написанным в memo или импортированным из папки заметок — по словам и, с локальной текстовой моделью, по смыслу; каждый результат показывает, чем он найден и на что ссылается
tg search notes <query> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | обязателен | строгий запрос Lucene: слова, «фразы», AND/OR/NOT, tag: и диапазоны дат. |
| Параметр | Назначение |
|---|---|
--type <internal|file> | только заметки, написанные в memo, или только заметки из папки. |
--folder <id> | только эта папка заметок, по идентификатору; повторите для нескольких. |
--tag <tag> | только заметки с этим тегом. |
--filter <query> | запрос, которому должен соответствовать каждый результат; поиск по смыслу он не меняет. |
--limit <n> | количество. |
--offset <n> | пропустить столько результатов — для следующей страницы. |
--exact | только слова в написанной форме; поиск по смыслу не выполняется. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
tg search conversations
ближайшие разговоры по смыслу и словам, лучшие первыми, один или все чаты; смысл после conversations embed; локальное выполнение
tg search conversations <query> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
query | обязателен | запрос своими словами на поддерживаемом моделью языке. |
| Параметр | Назначение |
|---|---|
--model <model> | локально: идентификатор из models text list (по умолчанию e5-small); удалённо: модель сервиса. |
--provider <provider> | сервис векторов: local или openai; параметры команды важнее настроек профиля. |
--base-url <url> | сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio. |
--dims <n> | размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI. |
--max-chats <n> | не больше этого числа чатов; по умолчанию 5 с --sync-first и 20 с --refresh. |
--max-chunks <n> | не больше этого числа фрагментов за запуск; по умолчанию 2000. |
--sync-first | сначала загрузить новые сообщения в пределах ограничений по чатам, времени и сообщениям. |
--sync-time <duration> | прекратить загрузку через это время (по умолчанию 30s). |
--max-messages <n> | загрузить не больше этого числа сообщений всего (по умолчанию 500). |
--chat <chat> | только этот чат: название или часть, идентификатор, @username или me для «Избранного». |
--since-time <time> | разговоры, продолжавшиеся после ISO 8601 или 30m / 2h / 1d назад. |
--filter <query> | строгий фильтр Lucene: ему должно соответствовать хотя бы одно сообщение разговора; запрос по смыслу не меняется. |
--source <source> | аккаунты для поиска: personal, bots, all или сервис; по умолчанию активный аккаунт. |
--timezone <zone> | часовой пояс IANA для дат фильтра; по умолчанию системный. |
--limit <n> | количество. |
--refresh | сначала локально построить и векторизовать изменившиеся или ещё не построенные чаты в выбранном охвате — в пределах --max-chats и --max-chunks. |
tg search topics
темы форума с подходящим названием
tg search topics <chat> <text> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
text | обязателен | слова из названия темы. |
| Параметр | Назначение |
|---|---|
--limit <n> | количество результатов. |
--page <n> | номер страницы, начиная с 1. |
--all | все строки без страниц. |
tg searches
сохранённые поиски и история search messages и stats messages show в локальном хранилище; --saved выполняет один
tg searches create
сохранить поиск под именем без запуска; его запускает search messages --saved
tg searches create <name> [query] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
name | обязателен | до 64 символов из латинских букв a–z, цифр и дефисов, не только цифры. |
query | необязателен | запрос, как для search messages; без него подходят все сохранённые сообщения. |
| Параметр | Назначение |
|---|---|
--chat <chat> | только чат, как chat: в запросе: название или часть, идентификатор, @username или me для «Избранного». |
--source <messenger> | все аккаунты мессенджера в базе: personal, bots, all, как in: в запросе. |
--limit <n> | количество. |
--newest | сначала новые вместо наиболее подходящих. |
--exact | слова без поля и фразы в кавычках совпадают только в точной форме, как exact:word; text: по-прежнему учитывает все словоформы. |
--context <n> | сообщения до и после каждого результата. |
--language <lucene|legacy> | язык запроса: строгий Lucene или прежний неточный поиск. |
--timezone <zone> | часовой пояс IANA для границ календарных дат. |
--regex | слова считаются одним регулярным выражением без учёта регистра для всех сохранённых текстов. |
--by <chat|sender|day|hour> | по чему группирует подсчёт stats messages show --saved. |
--selection <json> | сохранить полностью определённый исходный запрос рейтинга и параметры из детализации. |
--replace | перезаписать сохранённый поиск с тем же именем. |
tg searches show
один сохранённый поиск или прошлый запуск: запрос, параметры и сколько раз он выполнялся
tg searches show <name|id>| Аргумент | Обязательность | Описание |
|---|---|---|
name|id | обязателен | имя сохранённого поиска или идентификатор любой строки searches history. |
tg searches list
сохранённые поиски по имени
tg searches listtg searches history
выполненные поиски и подсчёты от новых к старым, включая сохранённые; без их результатов
tg searches history [options]| Параметр | Назначение |
|---|---|
--limit <n> | количество. |
tg searches delete
удалить сохранённый поиск или один запуск из истории
tg searches delete <name|id>| Аргумент | Обязательность | Описание |
|---|---|---|
name|id | обязателен | имя сохранённого поиска или идентификатор любой строки searches history. |
tg searches clear
очистить историю; сохранённые поиски остаются
tg searches cleartg flood
ожидания, которые Telegram попросил соблюдать этот профиль, и запрет на его запись
tg flood clear
забыть их, снять блокировку и ограничение частоты профиля, когда Telegram больше не ограничивает аккаунт; в Telegram ничего не меняет
tg flood cleartg replies
правила, которые отвечают на сообщения за вас; хранятся в файле этого профиля
tg replies add
добавить правило с явно указанными значениями по умолчанию; выключено, пока вы не отредактируете и не включите его
Изменяет данные только на этом компьютере.
tg replies add <id>| Аргумент | Обязательность | Описание |
|---|---|---|
id | обязательный | строчные буквы, цифры и -; уникален в этом профиле. |
tg replies on
включить одно правило ответа; его шаблон должен быть готов
Изменяет данные только на этом компьютере.
tg replies on <id>| Аргумент | Обязательность | Описание |
|---|---|---|
id | обязательный | идентификатор правила. |
tg replies off
отключить одно правило ответа
Изменяет данные только на этом компьютере.
tg replies off <id>| Аргумент | Обязательность | Описание |
|---|---|---|
id | обязательный | идентификатор правила. |
tg replies edit
изменить только указанные поля правила ответа; списки заменяются целиком
Изменяет данные только на этом компьютере.
tg replies edit <id> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
id | обязательный | идентификатор правила. |
| Параметр | Назначение |
|---|---|
--do <actions> | действия: reply, task или оба через запятую. |
--kinds <kinds> | типы чатов: dialog, group; через запятую, пустое значение — любые. |
--chats <ids> | только эти идентификаторы чатов через запятую; пустое значение — любые. |
--not-chats <ids> | исключить эти идентификаторы чатов через запятую; пустое значение очищает список. |
--words <words> | совпадение с любым из этих целых слов через запятую; пустое значение очищает список. |
--question | совпадать только с вопросами. |
--no-question | не требовать вопроса. |
--mentions-me | требовать упоминания вас или ответа на ваше сообщение. |
--no-mentions-me | не требовать упоминания вас или ответа на ваше сообщение. |
--people <ids> | только эти идентификаторы отправителей через запятую; пустое значение — любые. |
--not-people <ids> | исключить эти идентификаторы отправителей через запятую; пустое значение очищает список. |
--contacts-only | совпадать только с контактами. |
--no-contacts-only | не требовать, чтобы отправитель был контактом. |
--template <text> | шаблон ответа. |
--model <mode> | устаревший режим шаблона: fill-only или may-reword; вместо него используйте блоки ai. |
--as-reply | отправить как ответ на совпавшее сообщение. |
--no-as-reply | отправить без привязки к совпавшему сообщению. |
--per-chat <limit> | не более указанного числа на чат, например 1/12h. |
--per-person <limit> | не более указанного числа на человека, например 1/1d. |
--outside <hours> | отвечать вне этого интервала в 24-часовом формате, например 09:00-19:00. |
--days <days> | дни рабочего интервала, например mon-fri или sat,sun. |
--timezone <zone> | часовой пояс IANA для рабочего интервала. |
--no-hours | очистить рабочий интервал. |
tg replies audience
показать аудиторию ответов профиля или заменить указанные поля; список тестировщиков по-прежнему ограничивает ответы
Изменяет данные только на этом компьютере.
tg replies audience [options]| Параметр | Назначение |
|---|---|
--reply <mode> | отвечать всем или только указанным отправителям и чатам: all, listed. |
--allow-people <ids> | заменить разрешённые идентификаторы отправителей через запятую; пустое значение очищает список. |
--allow-chats <ids> | заменить разрешённые идентификаторы чатов через запятую; пустое значение очищает список. |
--deny-people <ids> | заменить запрещённые идентификаторы отправителей через запятую; пустое значение очищает список; запрет имеет приоритет. |
--deny-chats <ids> | заменить запрещённые идентификаторы чатов через запятую; пустое значение очищает список; запрет имеет приоритет. |
tg replies consents
согласие на модели ответа один раз для каждого профиля и адреса API, с исключениями для чатов
tg replies consents show
показать согласие на модель ответа и исключения чатов; никогда не вызывает модель
tg replies consents showtg replies consents grant
разрешить передачу входящих данных сообщений настроенной модели ответа этого профиля; исключения чатов сохраняются
Изменяет данные только на этом компьютере.
tg replies consents granttg replies consents revoke
немедленно отозвать согласие профиля на модель ответа; исключения чатов сохраняются
Изменяет данные только на этом компьютере.
tg replies consents revoketg replies consents deny
не передавать входящие данные этого чата модели ответа
Изменяет данные только на этом компьютере.
tg replies consents deny <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязательный | собственный идентификатор чата в мессенджере, используемый как указан; никогда не разрешается через сеть. |
tg replies consents allow
снять исключение этого чата из обработки моделью; не даёт согласия за профиль
Изменяет данные только на этом компьютере.
tg replies consents allow <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязательный | собственный идентификатор чата в мессенджере, используемый как указан; никогда не разрешается через сеть. |
tg replies test
что правила ответили бы на сохранённые сообщения, кому и почему — ничего не отправляет, ничего не меняет, без подключения
tg replies test [rule] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
rule | необязателен | только это правило, по идентификатору; без него — все правила в порядке файла. |
| Параметр | Назначение |
|---|---|
--since-time <time> | с времени ISO 8601 или 2h / 1d назад; по умолчанию 7d назад. |
--ai | вызвать настроенную модель ответа с сохранёнными данными сообщений; требуется согласие на использование модели ответа, иначе применяется запасной вариант. |
tg replies pause
сразу остановить все правила ответов этого профиля, в том числе в работающем serve; resume отменяет паузу
tg replies pausetg replies resume
разрешить правилам ответов снова отвечать после pause
tg replies resumetg replies status
могут ли правила отправлять, какие включены и кому они могут отвечать
tg replies statustg recipients
чаты, куда профилю разрешено отправлять при включённом списке
tg recipients list
разрешённые чаты; пусто и отключено до первого добавления
tg recipients listtg recipients add
разрешить отправку в чат; первое добавление включает ограничения
Изменяет данные только на этом компьютере.
tg recipients add <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg recipients remove
запретить чат; список остаётся включённым
Изменяет данные только на этом компьютере.
tg recipients remove <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | идентификатор или название из списка. |
tg recipients clear
удалить список и ограничения: снова разрешены все чаты
Изменяет данные только на этом компьютере.
tg recipients cleartg 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 migrate
заменить прежние настройки доступа разрешениями, сохранив действующие уровни в этом файле
Изменяет данные только на этом компьютере.
tg config migrate [options]| Параметр | Назначение |
|---|---|
--dry-run | показать преобразование без записи в файл. |
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, requestsPerMinute, transcribeWith, speechModel, catchUpMarksRead, searchCatchUp, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, analysisProvider, analysisModel, analysisBaseUrl, models, proxy, readOtherBots, updateCheck, skillHint, searchStemmers.cyrillic, searchStemmers.latin. |
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, requestsPerMinute, transcribeWith, speechModel, catchUpMarksRead, searchCatchUp, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, analysisProvider, analysisModel, analysisBaseUrl, models, proxy, readOtherBots, updateCheck, skillHint, searchStemmers.cyrillic, searchStemmers.latin. |
| Параметр | Назначение |
|---|---|
--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 — один путь команды за вызов
tg commands schema
argv и схемы результатов одной команды, эффекты, разрешения и указания по повторным попыткам
tg commands schema <path>| Аргумент | Обязательность | Описание |
|---|---|---|
path | обязательный | один путь команды, например stats messages show. |
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]| Параметр | Назначение |
|---|---|
--permission <key=level> | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
--confirm-send | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--allow-dangerous | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--allow-send | устарел: решение принимает профиль; сохранён для запуска старых настроек. |
--allow-mark-read | устарел: решение принимает профиль. |
--allow-delete | устарел: решение принимает профиль. |
--http | обслуживать через HTTP на 127.0.0.1 для ChatGPT и Claude в браузере, за вашим туннелем. |
--http-confirmation <mode> | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--port <port> | локальный порт для --http (по умолчанию 8765). |
--public-url <url> | https-адрес туннеля для браузерных приложений, например https://.ts.net. |
--revoke | забыть все входы, выданные браузерным приложениям; каждому придётся войти заново. |
tg mcp config
вывести mcpServers для Claude Desktop, Cursor и других с полными путями; без записи
tg mcp config [options]| Параметр | Назначение |
|---|---|
--permission <key=level> | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
--confirm-send | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--allow-dangerous | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--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 | подтвердить, что профиль предоставляет инструменты изменения данных. |
--permission <key=level> | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
--confirm-send | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--allow-dangerous | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--allow-send | устарел: решение принимает профиль; сохранён для запуска старых настроек. |
--allow-mark-read | устарел: решение принимает профиль. |
--allow-delete | устарел: решение принимает профиль. |
tg mcp doctor
проверить локальное подключение MCP и список инструментов этого профиля
tg mcp doctor [options]| Параметр | Назначение |
|---|---|
--permission <key=level> | переопределить разрешение только для этого сервера; повторите для нескольких ключей. |
--confirm-send | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--allow-dangerous | больше не используется — операции записи не показывают форму; решение определяют разрешения профиля. |
--allow-send | устарел: решение принимает профиль; сохранён для запуска старых настроек. |
--allow-mark-read | устарел: решение принимает профиль. |
--allow-delete | устарел: решение принимает профиль. |
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 и только 0 означает, что операция выполнена. 14 (outcome_unknown) означает, что сообщение могло
быть отправлено: повторяйте только с тем же --send-id, по которому Telegram отбрасывает вторую копию.