История изменений CLI Telegram
История выпусков CLI для Telegram: исправления, изменения и новые возможности.
Узнайте, что изменилось в выпусках: новые возможности, исправления и изменения, влияющие на команды. Начните со своей установленной версии, затем откройте инструкцию для функции, которую хотите попробовать.
Основные изменения @wirecat/tg-cli по версиям, от новых к старым. Используется семантическое версионирование; до 1.0.0 интерфейс команд может меняться.
0.123.0 — 10.11.2026
Added
muted:в поиске и статистике, из@wirecat/cli-core0.633.0.muted:falseисключает чаты, в которых вы отключили уведомления, поэтомуstats messages show -- 'date>=30d muted:false'считает только то, что синхронизация ещё читает.stats messages responsesиstats messages waitingтоже его принимают.store import, из@wirecat/cli-core0.633.0. Загружает выдуманные чаты, людей и сообщения из файла с пометкой synthetic в тестовое хранилище, например в песочницу Desktop. Настоящее хранилище владельца команда отклоняет.
0.122.0 — 10.11.2026
Changed — may break callers
- Основан на cli-core 0.630.0 (был 0.624.0). При первом открытии хранилище переходит на версию 63. Вид каждого человека
хранится у самого человека, а сохранение участников чата оставляет строки тех, кто остался, поэтому фильтры
people listв memo считают и листают в SQL. Люди, которые писали в личном чате или небольшой группе, теперь считаются людьми владельца, никакое правило не присоединяет кого-либо к человеку владельца, а имя сопоставляется между кириллицей и латиницей. Инструмент на более старом cli-core, который сохраняет участников, стирает сохранённые виды, поэтому tg, max и memo обновляются вместе. Что изменилось между версиями, описано в истории изменений cli-core.
0.121.0 — 09.11.2026
Changed — may break callers
- Основан на cli-core 0.624.0 (был 0.619.0). При первом открытии хранилище переходит на версию 61 (связи людей, только добавления). Что изменилось между версиями, описано в истории изменений cli-core.
search messages --timeout 30sможет искать примерно до 29 секунд. Раньше поиск останавливался через 2 секунды, сколько бы времени ни дали запуску, поэтому правильный запрос по большому хранилищу не выполнялся в WireCat Desktop. Без--timeoutостаются 2 секунды, в том числе для агентов и MCP.schedule pause <name>иschedule resume <name>снимают расписание с таймера и сохраняют его.schedule runпо-прежнему его запускает.--atможно повторять:--at 08:30 --at 18:00запускает дважды в день.
0.120.0 — 09.11.2026
Changed — may break callers
tg messages sync --allпропускает чаты, в которых вы отключили уведомления. Аккаунт с множеством таких групп больше не загружает их все. Ответ учитывает их вlimited.muted, а примечание говорит, как их прочитать. Уже сохранённые сообщения остаются, а чат, который вы называете (tg messages sync <chat>) или читаете с--full-history, читается как раньше. Чтобы снова читать такие чаты, передайте--with-mutedдля одного запуска или задайтеtg config set history_muted true. Из cli-core 0.619.0 (был 0.618.0).- EmbeddingGemma стала моделью по умолчанию для поиска по смыслу вместо e5-small. Компьютер, на котором уже есть
e5-small и нет EmbeddingGemma, продолжает использовать e5-small.
tg models downloadбольше не просит принять условия.--accept-termsигнорируется. tg contacts link, запущенная агентом, предлагает связь, а не создаёт её, и требует--reason. Решает только владелец.tg contacts unlinkот агента отклоняется.
Fixed
bin/releaseпубликует версию, когда в main есть только фрагментыchanges/и нет## Unreleased. Когда версия уже была занята в npm, скрипт искал## Unreleased, чтобы поставить под ним следующую версию, не находил его и останавливался до публикации. Теперь он добавляет заголовок новой версии над самой новой и собирает в неё фрагменты.
0.119.0 — 09.11.2026
Added
tg account remove --keep-data|--delete-dataзавершает сессию профиля на стороне Telegram, а затем забывает его на этом компьютере: файлы сессии, идентификатор и хеш приложения и пароль прокси в хранилище ключей, сессии его ботов для чтения истории и то, что cli-core хранит для профиля. С--keep-dataего сообщения остаются доступными для поиска. С--delete-dataони удаляются. Токен бота остаётся, как и все остальные профили. Запуск с перенесёнными папками забывает только свою копию и никогда не завершает сессию владельца.tg models setиtg models addиз cli-core 0.609.0: выбрать локальную модель векторов, которую использует каждый WireCat CLI, и добавить свою модель с Hugging Face. Вопрос со временем (HH:MM,10:30) снова ищется по словам.- tg поставляется с
contracts/wirecat.json, где указано, с какими хостами он работает по HTTP. WireCat Desktop читает этот файл, чтобы ещё до установки показать, к чему обращается tg:api.telegram.org(боты) иmy.telegram.org(регистрация вашего приложения), а также заданный вами прокси. Собственное соединение вашего аккаунта с Telegram (MTProto) не HTTP и в этот список не входит. - Pull request добавляет свои записи в историю изменений фрагментом
changes/<branch>.md. Открытые pull request больше не конфликтуют под## Unreleased.pnpm docs:checkпроверяет каждый фрагмент, аbin/releaseсобирает их в раздел версии. Запись под## Unreleasedна время перехода тоже работает.
Changed — may break callers
- tg теперь записывает общее хранилище в версии 59, и более старый WireCat CLI отказывается с ним работать, пока его не обновят. Выполните
<cli> upgradeдля каждого WireCat CLI на том же хранилище. Из cli-core 0.615.0, где шаблоны сообщений хранятся в хранилище.
Fixed
tg serveзавершается, когда его сборка устарела, и служба запускает новую. Каждую минуту он проверяет, не перешло ли общее хранилище на формат, который эта сборка уже не может записывать, и не установлен ли более новый tg. Если да, он пишет в журналserve.outdatedи завершается с кодом 3, а юнит systemd (Restart=on-failure) запускает установленную версию. Раньше serve мог сутки работать на старой сборке и ничего не сохранять.- После
tg store recover runследующая обычная синхронизация заново загружает то, что могло пропасть из-за повреждения. Восстановление помечает как не загруженное всё, что каждый чат хранил начиная с дня до последней успешной глубокой проверки, поэтому синхронизация больше не перескакивает через дыру внутри чата. Из cli-core 0.618.0 (был 0.616.0).
Security
- Чат с BotFather исключён из поиска. В нём есть каждый токен бота, который прислал BotFather, поэтому поиск по всем чатам
(и
memo search), поиск по смыслу иmemo contextего пропускают.tg messages listи поиск, в котором назван этот чат, по-прежнему его читают. Действует с выпуска cli-core, который читаетChat.searchable, при следующей синхронизации списка чатов. Этот выпуск также маскирует токены ботов во всех чатах. - HTTP в tg обращается только к объявленным хостам. Каждый вызов Bot API и каждый шаг регистрации приложения проходит
через
hostFetchиз cli-base. Он отклоняет любой другой хост до отправки первого байта, проверяет каждое перенаправление и убирает заголовокAuthorizationпри перенаправлении на другой сайт. Через прокси SOCKS5 или HTTP проверка тоже работает. Она не касается MTProto, который GramJS отправляет по своим сокетам в дата-центры Telegram, и MTProxy. Из cli-base 0.87.0 (был 0.80.8) и cli-core 0.615.0 (был 0.609.0).
0.118.0 — 08.11.2026
Added
tg config setпринимаетcrm.<provider>:<account>.linksиcrm.<provider>:<account>.company-types, настройки хранилища, которые читает синхронизация CRM-инструмента (cli-core 0.606.0).
Changed — may break callers
- tg открывает хранилище, которое теперь переносят memo и другие инструменты WireCat, и переводит его на версию 57. Хранилище версии 56 или новее отклоняют tg 0.117.0 и старше, а также каждый инструмент на cli-core старше 0.606.0, с просьбой обновиться. Обновляйте tg, max и memo вместе (cli-core 0.606.0, 0.607.0).
--offlineу команды, которой нужен Telegram, отвечаетpermission_error(offline.refused), код выхода 5.chats inspect,chats send-as,topicsиupgradeотвечалиvalidation_error, код выхода 2. Скрипту, который проверяет там код выхода 2, нужен новый код (cli-core 0.607.0).contacts contextиcontacts prepareчитают только аккаунты той же области, что и профиль. Личный профиль больше не показывает почту, сообщения, события или встречи связанного человека из рабочих аккаунтов, а рабочий профиль не показывает ничего из личных. Новое поле ответаaccountsперечисляет каждый прочитанный аккаунт с его областью (cli-core 0.605.0).- Имя, набранное через е, находит чат или человека, чьё имя написано через ё. Имя, которое точно совпадало с одним чатом или человеком, теперь
может совпасть с двумя (
АленаиАлёна). Тогда tg отклоняет его и перечисляет оба, как для любого другого неоднозначного имени (cli-core 0.601.0). - Поиск читает больше запросов как обычные слова.
?в конце слова считается вопросительным знаком, поэтомуinvoice?находит «invoice». Текст с двоеточием, URL, скобкой или непарной кавычкой (meeting at 10:30) ищется как слова, а раньше отклонялся (cli-core 0.602.0, 0.604.0).
Fixed
- Повреждённый файл хранилища останавливает запись и называет
tg store recover. Запуск, который натыкался на ошибку SQLite «database disk image is malformed», падал какinternal_error. Теперь он отвечаетconfiguration_error(store.damaged), а последующие команды, которые пишут, отказываются, пока не пройдёт глубокая проверка или восстановление. Чтение работает (cli-core 0.605.0). - Люди, которых вы разделили, остаются раздельными. Третья личность с тем же адресом e-mail могла снова объединить двух людей после того, как вы их разделили (cli-core 0.605.0).
0.117.0 — 07.11.2026
Changed — may break callers
schedule agentиschedule commandпринимают--deliver-to <route>, а не--to <route>. В tg--toуже называет получателя сообщения.schedule listназывает маршрутыdeliver_to; расписания, сохранённые с--to, продолжают доставлять (cli-core 0.600.0).
Fixed
- Открытие хранилища больше не снимает файловые блокировки SQLite. Раньше файл открывался с усечением, что освобождало POSIX-блокировки других процессов, и две записи могли пересечься (cli-core 0.599.0).
- Запись, прерванная Ctrl-C или сбоем самого сервера Telegram, завершается как
outcome_unknown. Запись бота, прерванная остановкой, сообщалаcancelled, а получившая ответ HTTP 5xx —provider_unavailable, как и запись аккаунта, на которую Telegram ответил внутренней ошибкой. Telegram мог выполнить каждую из них, и вызывающий, получивший «cancelled», мог отправить сообщение дважды. Чтение по-прежнему сообщаетcancelledиprovider_unavailable. - Запись аккаунта, на которую Telegram ответил внутренней ошибкой, отправляется один раз, а не снова и снова. mtcute без ограничений повторял каждый запрос, на который Telegram ответил 500, -500 или -503, поэтому создание, вступление, правка или удаление могли выполниться дважды. Теперь запись отправляется один раз и завершается как
outcome_unknown; чтение по-прежнему повторяется, аFLOOD_WAITпо-прежнему выжидается. -500 или -503 теперь означаютprovider_unavailable, а не отказ. - Отклонённый запрос бота больше не повторяет текст самого Telegram. Этот текст может цитировать название чата или чьё-то сообщение, поэтому ошибка теперь говорит, что произошло, постоянными словами по коду ошибки Telegram, а новый идентификатор супергруппы или ожидание берёт только из документированных полей Telegram. «chat not found» теперь
validation_error, так как Telegram отвечает на него кодом 400; раньше это былnot_found, выбранный по словам. tg account update, на который Telegram ответил внутренней ошибкой, завершается какoutcome_unknown. Имя, описание или фото могли измениться, а команда сообщалаprovider_unavailable.
0.116.0 — 05.11.2026
Fixed
- Вызов Bot API больше не держит завершённую команду в памяти 30 секунд. Его лимит времени был таймером, который доходил до конца и после ответа Telegram и удерживал всё, что команда загрузила. Процесс, делающий много вызовов подряд, например
tg bot watchилиtg bot mcp, рос на мегабайты за вызов. tg account listбольше не показывает бота как аккаунт без входа. Имя, которое использует только бот, не выводится; имя, которое одновременно ваш аккаунт и бот, показываетbot: true.tg mcp serve --profiles allтак же не включает ботов (cli-core 0.567.0).- Вход по QR-коду сообщает, когда код отсканирован. После этого Telegram десять секунд и дольше переносит вход в дата-центр аккаунта, а tg ничего не печатал, пока не спрашивал пароль 2FA или не завершал вход. Теперь он печатает
scan accepted, finishing sign-in, а с--json— строку в stderr{"event":"progress","step":"scanned","message":"scan accepted, finishing sign-in"}, которую показывает WireCat Desktop.
Added
tg config migrateзаписывает вdefaultsкаждую настройку, которой нет в файле, со значением по умолчанию, и каждая запись tg в файл тоже их добавляет. Тогдаlimit,sends_per_hour,recordи остальные можно найти и поправить вconfig.jsonбез документации. Ваши значения, их порядок и ключи, которых tg не знает, остаются;config unsetне возвращает то, что удалил, а простое чтение никогда не переписывает файл.tg config showпоказывает значение по умолчанию каждой настройки и что она делает (cli-core 0.563.0).- Из cli-core 0.563.0:
config repairисправляет синтаксис JSON в файле настроек;stats messages responsesиstats messages waiting;tasks status,tasks reviewиtasks acknowledge;tasks add --open-new. - Из cli-core 0.564.0–0.567.0:
store chats statusсчитает чаты, которые архив хранит до первого сообщения, частично или не хранит вовсе;stats tasks showпринимает запрос и считает задачи, открытые и закрытые за период (-- created>=30d);has:transcriptнаходит голосовые сообщения с расшифровкой. tg bot listне требует слова профиля (tg <profile> bot listпо-прежнему работает; cli-core 0.567.0).
Changed — may break callers
- Новый код ошибки
conflict(код выхода 15) есть вtg commands --jsonи в схеме ошибок инструментов MCP (cli-base 0.77.1). Он означает, что запись отклонена, потому что то, что она меняет, изменилось после чтения. Изменение задачи, которую кто-то изменил после вашего чтения, теперь завершается с ним, а не сconfiguration_error(код 3); причина остаётсяtask.stale(cli-core 0.567.0). search allранжирует все источники одним списком, ищет и в почте по смыслу и находит записи по вопросу, набранному предложением (cli-core 0.564.0). Раньше результаты источников шли по очереди, а вопрос находил только записи, содержащие все его слова.
0.115.0 — 03.11.2026
Added
wcat tgзапускает инструмент, аwcat --helpего перечисляет. Пакет устанавливаетwcat-tgрядом сtg, аwcat-tg --wcat-describeпечатает дляwcatимя, версию и описание инструмента.
Записи ниже вошли в 0.114.0, но отсутствовали в её заметках или были описаны там неверно.
Changed — may break callers
server installзавершается ошибкой там, где не работаетsystemctl --user(илиlaunchctl enable), после записи службы, а не сообщает об успехе. В macOSserver stopтолько выгружает агент: он снова запускается при следующем входе в систему, как служба systemd; это предотвращаетserver uninstall. (cli-core 0.552.0)
Fixed
- В заметках 0.114.0 было сказано, что
--full-historyчитает за пределами лимитов истории в течение одного запуска. Он читает один названный чат:messages sync <chat> --full-historyчитает этот чат за пределами лимитов и с этого момента хранит его полностью. search messages --briefоставляет только ссылку, чат, время, отправителя, фрагмент и оценку. Раньше он печатал все поля. (cli-core 0.551.0)- Вызов MCP, ответ которого называет шаг, доступный только человеку, больше не завершается как ошибка программы. (cli-core 0.551.0)
0.114.0 — 02.11.2026
Added
projects evidenceиprojects statusпринимают--purpose, чтобы выбрать связанные чаты для чтения:--purpose sales,workили--purpose all. Пропущенный чат перечисляется с числом сообщений и командой, которая его прочитает. (cli-core 0.553.0)projects evidence --include-proposedчитает и чаты и участников, предложенных для проекта и ещё не подтверждённых, и отмечает, что они добавили.--compactтеперь печатает строки дляprojects evidence. (cli-core 0.553.0)serveдочитывает то, что пришло, пока он был выключен. Собственная догрузка Telegram отказывается от пропуска, который после долгого простоя считает слишком большим. Через 30 секунд после подключенияserveтеперь перечитывает каждый чат, где есть сообщения новее, чем было в хранилище при старте: не больше 7 дней назад, 500 сообщений на чат и 5 минут в целом. После более чем недели без связи один раз выполнитеtg <profile> messages sync --all. (cli-core 0.552.0)server installвключает службу, поэтомуserveзапускается при каждом входе в систему и после перезагрузки. Служба, установленная старой версией tg, не включена: снова выполнитеtg <profile> server install.server statusпоказываетstarts_at_login. Служба, установленная из рабочей копии для разработки, записывается, но не включается. (cli-core 0.552.0)messages syncсоблюдает лимиты истории: по умолчанию пропускает группу, где больше 50 человек (history_group_members_max), читает группу на 365 дней назад, а личный чат на 1095 дней назад (history_group_days,history_dialog_days) и сообщает пропущенное вlimited.--full-historyчитает за их пределами в течение одного запуска; чтобы и дальше читать большие группы, увеличьте настройки. Новые сообщения никогда не теряются. (cli-core 0.551.0)tg <profile> projects status <project>показывает состояние проекта только по хранилищу. (cli-core 0.551.0)--compactпечатает для агента одну строку на элемент, из того же ответа, что печатает--json. (cli-core 0.550.0)messages listчитает окно, ограниченное с обеих сторон, в том числе офлайн. (cli-core 0.547.0)- Команда, принимающая чат или сообщение, принимает и ссылку, которую печатают другие инструменты WireCat (
msg:…,chat:…). (cli-core 0.546.0)
Changed — may break callers
projects evidenceиprojects statusпо умолчанию читают только рабочие чаты. Связанный чат без назначения считается рабочим; чат, связанный дляsales,supportилиother, теперь пропускается, если его не называет--purposeили не указан--purpose all. (cli-core 0.553.0)- Поиск, у которого вышло время, завершается с
timeoutи причинойquery.time-limitпримерно через 2 с, а не сvalidation_error/query.too-largeпосле работы намного дольше лимита. Запрос был верным; добавьтеchat:илиdate:, чтобы искать по меньшей части хранилища. (cli-core 0.552.0) - Текст вида
<kind>:<no spaces>, указанный как чат, читается как ссылка, а ссылка на другой аккаунт или мессенджер отклоняется со своей причиной. Параметр после--читается как параметр. (cli-core 0.546.0)
Fixed
- Синхронизация, у которой пропал читатель вывода, доводит работу до конца. Раньше закрытый конвейер её прерывал. (cli-core 0.552.0)
messages deleteбез идентификатора сообщения отказывает до подключения. (cli-core 0.551.0)page.nextуmessages listвыполняется как написано, а включительное начало сохраняет сообщение, отправленное ровно в этот момент. (cli-core 0.547.0)- Запуск по таймеру, заставший хранилище ключей заблокированным, — временная ситуация, а не неудачный вход. Расписание, догонявшее пропущенное при загрузке, до того как вход в систему разблокировал хранилище ключей, завершалось с
authentication_error(код 4), как будто владельцу нужно войти заново. Запуск по таймеру (TG_SCHEDULED) теперь завершается какserve:provider_unavailable(код 12) с причинойcredentials.unreachable, иschedule exec(cli-core) повторяет попытки до входа. Команда, набранная вручную, по-прежнему отвечаетauthentication_error, а профиль, который здесь никогда не входил, по-прежнему завершается с кодом 4.
0.113.0 — 02.11.2026
Added
tg <profile> messages download --offlineкопирует файл, который уже есть на этом компьютере, без подключения;--attachment <n>выбирает один файл сообщения, а локаторmsg:может заменить чат и сообщение. (cli-core 0.532.0)- Первый запуск новой версии обновляет инструкции агента, установленные старой. Устаревшая копия
SKILL.md(Claude Code,~/.agents/skills, Hermes) переписывается один раз, с одной строкой в stderr; отсутствующая копия, копия без версии или символическая ссылка не трогаются.TG_NO_SKILL_REFRESH=1отключает это. (cli-core 0.544.0)
Security
- Агент больше не может ослабить разрешения из своей оболочки.
tg <profile> config set|unset permissions…, запущенный агентом (Hermes, OpenClaw, Claude Code и другими, которые помечают свою оболочку), может только ужесточить уровень, но не ослабить, аmcp.authorityиbot.apiостаются за владельцем. Так режим только для чтения, который задаёт приложение для компьютера, сохраняется, даже если сообщение в чате уговорит агента выполнитьconfig set. Меняйте разрешения в терминале вне агента. (cli-core 0.544.0)
0.112.0 — 01.11.2026
Added
- Значок темы форума:
topics create --emoji <emoji>иtopics edit --emoji <emoji>. Эмодзи должен входить в стандартный набор значков тем Telegram, доступный любому аккаунту, с Premium или без;tg <profile> topics icons listпоказывает его. Другой эмодзи отклоняется, а ошибка перечисляет набор.topics edit --emoji noneубирает значок, и тема снова показывает свой цветной значок по умолчанию. (cli-core 0.531.0) - Задачи содержат
project_key,project_nameиcreated_by, а у командscheduleпоявились настоящие примеры и справка по аргументам. (cli-core 0.531.0)
0.111.0 — 01.11.2026
Added
projects evidence --jsonдаёт команду синхронизации для каждого связанного чата вlinked_chats[].sync_command: строку, которую текст показывает для синхронизации частично сохранённого чата, или null. (cli-core 0.517.0)
Fixed
projects evidenceбольше не пишет «held from only» для чата, который сохранён до первого сообщения: он пишет «held from its first message, behind since » или «with gaps». Прогрессmessages syncпоказывает, насколько далеко назад он дошёл, датой («back to »), а не ключом сообщения. (cli-core 0.517.0)- Навык агента начинает поиск с
search messages, а заметки и документы Drive добавляет, только когда об этом просит владелец (search all). Он также говорит, что через MCPaskне спрашивает: владелец включает подтверждение записи в своём клиенте. Проверка ClawHub отметила оба пункта в навыке 1.0.1.
0.110.0 — 01.11.2026
Added
tg <profile> projects evidence <project>(cli-coreprojectsCommand). Показывает, что сохранённые сообщения этого аккаунта содержат о проекте: его название, ключ, псевдонимы, слова, контакты, подтверждённых участников и подтверждённые связанные чаты.--sync-first(по умолчанию выключен, недоступен через MCP) сначала синхронизирует связанные чаты, которые хранилище не держит до--since-time, по одному, в пределах--sync-time(всего 3 минуты). Чат, прерванный по времени, остаётся частичным, со своимиmissingиnext. Его защищает разрешениеmessages. (cli-core 0.511.0)messages sync --jsonпечатает прогресс в stderr, только счётчики (cli-core 0.507.0). Теперь tg нужен@wirecat/cli-base0.68.1, как того требует cli-core 0.507.0.
Changed — may break callers
search messages --discoverищет по смыслу, когда запрос использует-,NOT,OR, группы, фразы илиexact:(cli-core 0.506.0). Раньше такой запрос выполнял только строгий поиск. Теперь его слова по-прежнему сопоставляются со всем запросом (discovery.method: "lexical-strict"), а к ним добавляются сообщения, близкие по смыслу к нужным словам. Каждый результат, найденный по смыслу, и каждый добавленный ответ и продолжение соответствуют каждому полю запроса и каждому исключённому слову.
Fixed
search messages --discoverс узким фильтром (chat:,date:) ранжирует по смыслу сообщения самого фильтра, если в нём не больше 100 000 сообщений, а не 100 ближайших в целом, поэтому страница заполняется (cli-core 0.506.0).search messages --discoverработает с хранилищем только для чтения (cli-core 0.506.0).- Долгая перестройка в одном процессе больше не приводит к ошибке «database is locked» при записи в другом (cli-core 0.506.0).
0.109.0 — 31.10.2026
Added
search messagesиsearch notesсообщают, сколько всего совпадений:page.total(cli-core 0.501.0).--jsonдобавляетpage.total: { value, relation }в формеhits.totalиз Elasticsearch:eq— точное число,gte— нижняя граница (подсчёт останавливается на 10 000). Терминал добавляетshowing 1–20 of 144под результатами.search messages --discoverпоказывает продолжения — более поздние сообщения, которые могут отменить или изменить результат, — и больше не падает на вопросе со временем или соотношением («until 22:00?») (cli-core 0.492.0, 0.496.0).messages list --offline,search messagesиsearch allсообщают, когда хранилище содержит чат лишь частично, с шагомmessages sync, который его дополнит (cli-core 0.493.0).- Голосовые сообщения может расшифровывать OpenAI:
transcribeWith: "openai", с ключом изmodels keys set openai(cli-core 0.499.0).
Changed — may break callers
- tg требует cli-base 0.67.0 (cli-core 0.501.0).
search messages,search allиmessages list --offlineотвечаютmeta.complete: false, когда прочитанный чат хранится лишь частично, и называют его вmissingиnext(cli-core 0.493.0). Скрипт, который читалmeta.completeкак «ответили все источники», теперь видит и пробелы архива.- Неизвестное значение
transcribeWithв профиле отказывает в расшифровке сvalidation_errorи называет четыре допустимых значения; раньше любое значение, кромеlocal, означало сначала спросить Telegram (cli-core 0.499.0).
Fixed
search notesсохраняет поля запроса для заметок, найденных по смыслу, и ранжирует по смыслу заметки самого узкого фильтра (cli-core 0.496.0, 0.501.0).
Security
- Запуск с перенесёнными папками больше не копирует вход владельца в хранилище ключей при обновлении токена (cli-core 0.494.0).
0.108.0 — 31.10.2026
Changed — may break callers
- Заметки, документы, аннотации и заметки о контактах находятся по части слова, в любом регистре.
tg personal search notes 'ontra'теперь находит «Contract», а кириллическое слово в смешанном регистре больше не пропускается. Поиск идёт и по заголовку, а не только по тексту, и отвечает за миллисекунды. Запрос из одного или двух символов отклоняется с «search needs at least three characters», как и поиск сообщений. Первый запуск после обновления обновляет хранилище (версия 40) и заполняет новый индекс порциями; до этого старые заметки находятся как раньше. Старая версияtgне индексирует новые заметки в обновлённом хранилище, поэтому обновите все CLI, которые его используют (cli-core 0.491.0).
0.107.0 — 30.10.2026
Fixed
- Названия чатов и имена контактов совпадают в любом регистре и любом алфавите.
tg personal chats list 'title:*ТАРТ*'теперь находит «Тартус»; раньше регистр не учитывался только для латиницы. То же относится к именам контактов и к названиям проектов, тегов, темам писем, почтовым ящикам и меткам, которые хранит общее хранилище. Первый запуск после обновления обновляет хранилище (версия 38) и заполняет новые копии в нижнем регистре для того, что в нём уже есть. Старая версияtgпродолжает работать с обновлённым хранилищем и предлагает обновиться (cli-core 0.484.0).
0.106.0 — 29.10.2026
Added
contacts syncсохраняет телефон каждого контакта, если Telegram его показывает, поэтомуcontacts show --offlineего выдаёт. Онлайновыйcontacts showтоже сохраняет прочитанный телефон. Нужен cli-core 0.479.0 (версия хранилища 37).- Карточка контакта в сообщении показывает имя и номер целиком, онлайн и из хранилища (
--offline).contacts showвыдаёт профиль, который раньше давалcontacts info, а--hide-phoneубирает номер изaccount show,account updateиcontacts show. Нужен cli-core 0.477.0. tg <profile> reactions list <chat> <message>показывает, кто отреагировал на сообщение: сначала новые, с реакцией и временем.reaction:<emoji>оставляет один эмодзи,--limitи--cursorлистают список. Команда только читает, поэтому её могут вызвать профиль только для чтения и MCP (ключ разрешенияreactions.list). Там, где Telegram прячет список, то есть в канале (reactions.broadcast) или в чате, где его отключили (reactions.list-hidden), команда отказывает и называет причину, а не выдаёт пустой список. Нужен cli-core 0.477.0.
Changed — may break callers
- Номера телефонов показываются целиком, а
contacts infoтеперьcontacts show.--show-phoneудалён: скрипт, который его передаёт, упадёт с ошибкой неизвестной опции, так что уберите его. Инструмент MCPcontacts infoтоже удалён, его заменяетcontacts show; сохранённое разрешениеcontacts.infoотклоняется с командойconfig unset, которая его убирает.
Fixed
- Ответы
inbox,review,search messagesиsearch allсодержатsender_is_me, как обещал 0.473.0, так что скрипт отличает собственные сообщения владельца от чужих и в них (cli-core 0.478.0).
0.105.0 — 29.10.2026
Changed — may break callers
- Навык для агента опубликован на ClawHub как
wirecat-tg. Установите его командойopenclaw skills install @wirecat/wirecat-tg. Записьtg-cliбольше не обновляется.tg skill installпо-прежнему записываетskills/tg-cli/.
Fixed
- Справка и справочник команд показывают
tg mcp serve --profiles work,personalбез профиля впереди. В 0.104.0 былоtg personal mcp serve --profiles work,personal, ноtgтакое отклоняет («назовите один профиль или --profiles, не оба»); примеры--profiles allуmcp revokeиmcp configсодержали ту же ошибку. Послеtg upgradeподсказка перезапустить фоновый сервер нескольких профилей сохраняет его--profiles(cli-core 0.474.0).
0.104.0 — 29.10.2026
Changed — may break callers
- Сервер MCP обслуживает только те профили, которые вы назвали.
tg mcp serveбез профиля теперь отказывается запускаться (код 2) и перечисляет ваши профили. Назовите один (tg work mcp serve), список (tg mcp serve --profiles work,personal) или все профили (tg mcp serve --profiles all); строка в stderr при запуске называет обслуживаемые профили. Тот же выбор действует для--http,mcp revoke,mcp configиmcp server start|stop|status. Запись в приложении, которая запускаетtg mcp serveбез профиля, перестаёт работать: напечатайте её заново черезtg mcp config --profiles allили назовите профиль. Фоновый сервер всех профилей, запущенный прежней версиейtg, останавливается командойtg upgrade; запустите его снова черезtg mcp server start --profiles all. Запись в MCP Registry теперь запускаетtg mcp serve --profiles all(cli-core 0.470.0).
Added
- У каждого сообщения, которое печатает
tg, естьsender_is_me— true для отправленного вами сообщения, вmessages list,show,context, окнах поиска иinbox(cli-core 0.473.0). tg runs showсохраняет сетевой код ошибки неудачного запуска (error.cause_code, напримерETIMEDOUT), но никогда не текст сервера (cli-core 0.473.0).
Fixed
--offline --transcribeсообщает, какие голосовые сообщения не расшифрованы. Они перечислены вmissingвместе с командойtg <profile> messages transcribe <chat> <id>для запуска (cli-core 0.473.0).- У каждого вызова инструмента MCP есть собственный
run_idв ответе и вtg runs(cli-core 0.471.0).
0.103.0 — 27.10.2026
Changed — may break callers
- cli-core 0.469.0 и cli-base 0.65.0. cli-core 0.469 принимает только cli-base 0.65, поэтому обе версии
меняются вместе. cli-base 0.65 знает глаголы
serveиrevoke, поэтому их записи в базовой линии линтера удалены, а егоcli-dev bundleнаходит сервер, запущенный с флагом передmcp serve. Начиная с cli-core 0.468, сервер MCP предлагает через инструмент чтения команду, которая только загружает данные в архив.
Fixed
tg --versionотвечает до загрузки любой части сборки. Сборку теперь делает общийcli-dev bundleиз cli-base, а не собственныйscripts/bundle.tstg; части сборки и весь вывод те же. Сервер, запущенный с флагом передmcp serve(tg work --read-only mcp serve), теперь загружает все части вскоре после запуска, как и обычныйmcp serve, поэтому обновление на месте не может убрать часть у него из-под ног.
0.102.0 — 27.10.2026
Changed — may break callers
- Теперь сохраняется каждый запуск, в том числе удачный. Удачный запуск хранится 7 дней
(
keep_successful_runs_for_days), неудачный — 30 (keep_runs_for_days), а папка запусков остаётся меньше 200 МБ (runs_size_limit_mb). При включённомrecord_input, как по умолчанию, удачныйsendтеперь сохраняет то, что вы ввели (сообщение, чат, названный по заголовку), в запуске, который может читать только вы, на этом компьютере, 7 дней.record_input failedсохраняет это только в неудачном запуске;record falseсохраняет только неудачные запуски;--no-recordне сохраняет ничего.watch,serveиmcp serveсохраняют удачный запуск только с--record. Запуск теперь говорит, кто его запросил: командная строка, приложение MCP (и его вызов инструмента) или WireCat Desktop (cli-core 0.467.0).
Added
tg runs showперечисляет каждый запрос к Telegram с его временем, повторами и ожиданиями. У запуска команды теперь есть строка для каждого обращения к Telegram, для аккаунта и для бота: метод (messages.getHistory,sendMessage), сколько он занял и чем закончился. Когда Telegram просит подождать (FLOOD_WAITили429в Bot API), аtgждёт и пробует снова, запуск показывает отклонённый вызов, а затем повтор как попытку 2 с временем ожидания. Текст сообщений, имена, номера телефонов и токен бота никогда не записываются.
0.101.0 — 27.10.2026
Changed — may break callers
- Сервер MCP — это
tg <profile> mcp serve;tg <profile> mcpсам по себе печатает справку. Входы браузерных приложений забываются командойtg <profile> mcp revokeвместоmcp --revoke. Сервер бота —tg <name> bot mcp serve. Запись в приложении, которая запускаетtg personal mcp, нужно заменить наtg personal mcp serve: снова выполнитеtg personal mcp add <app>илиtg personal mcp config.mcp server startи записи, которые печатаетmcp config, уже запускают новую команду (cli-core 0.463.0). tg skill show|status|install --jsonпечатают{ item, meta }. Поля навыка перенесены вitem; установщик для Windows читает их оттуда (cli-core 0.462.0).- Результаты поиска всех видов и
tg topics showназывают поля, которые агент должен читать как данные (untrusted, например["title"]у темы форума). Вызывающая программа, которая сверяет их со старой строгой копией схемы, отклоняет новое поле (cli-core 0.464.0). tg account listсообщает, выполнен ли вход в каждый профиль на этом компьютере (signed_in). Вызывающая программа, которая сверяет элементы со старой строгой копией схемы, отклоняет новое поле (cli-core 0.466.0).
Added
tg search allтакже находит события календаря в общем архиве, помеченные для агентов как недоверенный текст, аcontacts context|prepareназывают ещё одно поле (cli-core 0.453.0–0.461.0).tg upgradeперезапускает запущенный им браузерный сервер MCP и называет сессии агентов, оставшиеся на старой версии. После установки каждыйtg mcp serve --http, запущенный черезtg mcp server start, снова запускается на том же порту, адресе и с теми же ограничениями (mcp_servers, старая → новая версия); запущенный вручную остаётся работать и называется. Сессии агентов через stdio, оставшиеся на старой версии, перечисляются (stale_sessions): перезапустите их из приложения агента. Это работает начиная со следующего обновления (cli-core 0.464.0).
Fixed
tg mcp serveбез профиля помечает профили, в которые не выполнен вход. Он перечислял каждый профиль с файлом аккаунта, поэтому приложение могло выбрать профиль без сессии и получить ошибку. Теперь каждый профиль помечен (default — not signed in) в меню приложения и в описании, а вызов для профиля без входа отвечает, как войти:tg <profile> setupили через WireCat Desktop. Запись в реестре MCP и образ Glama запускаютtg mcp serve.- Страница входа браузерного сервера MCP говорит, что каждый код действует для одного входа. После входа приложения
новый код появляется в WireCat Desktop и в
tg mcp server status; повторный ввод старого кода сообщал только «Wrong code» (cli-core 0.466.0).
0.100.0 — 27.10.2026
Fixed
- Команды запускаются примерно на 0,2 с быстрее: пакет работает из сборки. Команда загружала около 1110 файлов
модулей до начала работы; теперь она загружает около 55 с тем же кодом.
tg messages list --helpускорилась с 389 до 192 мс, а при первом запуске после установки или перезагрузки — с 534 до 272 мс. Команда, которая подключается, по-прежнему загружает клиентскую библиотеку Telegram. Вывод не изменился. Пакет стал больше: 3,0 МБ для загрузки вместо 0,5 МБ, 16 МБ на диске вместо 4 МБ. Работающийtg serve,watchили сервер MCP загружает весь свой код через несколько секунд после запуска, поэтому обновлениеtgпод ним не оставит его без файла, который он ещё не использовал. - Навык агента tg снова публикуется в ClawHub как
tg-cli. ClawHub хранит имена навыков отдельно для каждого издателя, поэтомуwirecat/tg-cli— собственное имя tg, хотя у другого издателя тоже естьtg-cli, и навык каждого инструмента WireCat теперь использует простое имя.tg skill installпо-прежнему пишетskills/tg-cli/.
0.99.0 — 27.10.2026
Fixed
- Без сессии ошибка и инструкции MCP также предлагают WireCat Desktop.
no session,not logged inи отсутствующие ключи приложения теперь говорят: выполните команду в терминале или войдите через WireCat Desktop (Tools → Telegram → Manage). Через MCP агенту сказано никогда не просить коды или пароли (cli-core 0.452.0). - Навык агента tg публикуется в ClawHub как
wirecat-tg. Имяtg-cliв ClawHub принадлежит другому издателю, поэтому навык tg нельзя было под ним разместить.tg skill installпо-прежнему пишетskills/tg-cli/.
0.98.0 — 27.10.2026
Fixed
- Поиск по смыслу и
--discoverработают на нативном ONNX Runtime и в Windows (cli-core 0.451.0). Послеtg <profile> models downloadтекстовые модели и модель переранжирования используют нативную библиотеку в Windows x64 и arm64, как уже было в Linux и macOS: в 2–3 раза быстрее, чем WebAssembly. Загрузка берётonnxruntime.dllиз npm-пакетаonnxruntime-node(113,5 МБ, один раз, с проверкой sha256). Модели картинок (CLIP, SigLIP2) теперь тоже используют нативную библиотеку там, где она установлена. Результаты те же.
0.97.0 — 27.10.2026
Added
tg mcpбез профиля обслуживает все профили, через stdio и с--http(cli-core 0.450.0). Приложению ИИ нужно одно подключение к Telegram, а не по одному на профиль. Каждый инструмент (tg_tools_search,tg_read,tg_write) принимает обязательныйprofile(любой профиль на этом компьютере, без значения по умолчанию), и агенту сказано спросить, если вы не назвали аккаунт. Вызов выполняется в собственномtg <profile> mcpэтого профиля, который запускается при первом использовании и закрывается после 10 минут простоя, поэтому разрешения, сессия и журнал аудита каждого профиля действуют как прежде.tg mcp --revoke,tg mcp configиtg mcp server start|stop|statusтоже работают без профиля, со своим входом.--public-urlпринимает путь,https://<name>.ts.net/tg, чтобы инструменты делили один адрес туннеля. Запись в MCP Registry запускаетtg mcp.tg <profile> mcpне изменился.
Changed — may break callers
- tg нужен cli-base 0.63.0 (cli-core 0.450.0). Ничего из того, что использует tg, в нём не изменилось.
0.96.0 — 27.10.2026
Fixed
- Каждая команда тратит меньше времени на подготовку (cli-base 0.62.0, cli-core 0.449.0). Проверка общих команд
теперь описывает каждую команду один раз, а не заново для каждой группы над ней. Тёплый
run(["--version"])ускорился с 49 до 29 мс. Она ловит те же изменения, что и раньше. - Команды вне
bot apiзапускаются быстрее: 185 сгенерированных команд Bot API строятся только при необходимости.tg messages list,tg --helpи другие команды больше не загружают около 1,5 МБ сгенерированного кода.bot api,bot --help,bot mcp,commands,complete,help,mcp,serve,configиdoctorпо-прежнему строят группу, как и любая команда, если в настройках сохранено разрешениеbot.api. Вывод не изменился. - Поиск по смыслу и модель переранжирования в
search messages --discoverработают в 2–3 раза быстрее в Linux и на Mac с Apple silicon после следующегоtg models download(cli-core 0.448.0). Загрузка устанавливает нативный ONNX Runtime, и модели работают на нём; без него они работают как прежде. Модель переранжирования теперь читает только начало сообщения, на которое отвечает результат (cli-core 0.447.0).
0.95.0 — 26.10.2026
Added
-
tg <profile> session start --json --answer-stdinвыполняет вход без терминала, для WireCat Desktop (cli-core 0.443.0). Каждый вопрос — строкаneedsв stderr ({"event":"needs","field","secret","prompt","hint"}:api_id,api_hash,phone,code,password), а ответ на него — одна строка в stdin; my.telegram.org приходит строкойopen_url. Без--answer-stdinзапуск без терминала по-прежнему отказывается, поэтому оболочка агента никогда не ждёт ответа на вопрос. Ответы никогда не печатаются и не сохраняются в записи запуска. -
tg <profile> mcp server start|stop|statusзапускает HTTP-сервер MCP в фоне (cli-core 0.445.0).startпринимает--public-url,--portи--permission, какmcp --http, и возвращается, когда сервер начал слушать;statusпоказывает порт, адрес, одноразовый код входа и приложения, которые вошли;stopостанавливает только запущенный им сервер. WireCat Desktop запускает и останавливает его из панели Manage инструмента.
Changed — may break callers
- Запись запуска хранит командную строку в том виде, в каком её ввели (cli-core 0.439.0–0.447.0).
runs showиrun.jsonсодержатargv— слова послеtg, — где секреты заменены на[redacted](параметр с именем секрета, пароль в URL, известный формат токена, случайно выглядящая строка), а номер телефона никогда не сохраняется.tg <profile> config set record_input falseставит[redacted]вместо каждого введённого значения, которое может быть текстом. Записанные события по-прежнему содержат идентификаторы, но никогда не заголовок чата или текст сообщения.
0.94.0 — 26.10.2026
Added
tg skill install --for hermesдаёт навык Hermes Agent, аtg skill statusговорит, что читает Hermes (cli-base 0.59.0). Команда добавляет~/.agents/skillsвskills.external_dirsHermes черезhermes config set, сохраняя уже перечисленные папки, или копирует файл в домашнюю папку Hermes, если это не удалось. Без установленного Hermes она завершается сnot_foundи ничего не пишет. Простойtg skill installи--for allпо-прежнему пишут только копии для Claude Code и~/.agents/skills.skill status --jsonполучаетhermesрядом сtargets.- Запуск, начатый OpenClaw или Hermes Agent, называет этого агента (cli-core 0.437.0).
runs showуказываетagentкакopenclawдля команды, выполненной агентом OpenClaw, сfrom_chat: true, если её начало сообщение в чате; запуск из Hermes несёт его сессию, поэтому захват задачи из Hermes держится для каждой сессии отдельно. - Навык
tg-cliсообщает OpenClaw и ClawHub, что ему нуженtg, и как его установить (metadata.openclaw:requires.binsи npm-пакет@wirecat/tg-cli). Еслиtgнет в PATH, OpenClaw помечает навык как неготовый и предлагает установить пакет. Claude Code и Codex этот блок пропускают.
0.93.0 — 25.10.2026
Added
store reset --dry-runперечисляет, что очистил бы сброс, и ничего не удаляет (cli-core 0.429.0): файлы и байты архива, каждую таблицу данных с числом строк, будет ли сначала сделана резервная копия и держит ли файл открытымserveили другой процесс.search messages --discoverтакже находит сообщения, близкие по смыслу, когда загружена e5-small иconversations rebuildдал сообщениям собственные векторы (cli-core 0.432.0).discovery.found_byкаждого результата говорит, какой поиск его нашёл. До этого discovery ищет по словам, как прежде, и объясняет почему. Ничего не загружается, и текст не покидает компьютер.search messages --discoverпереранжирует первые 50 результатов, когда загружена модель переранжирования (cli-core 0.435.0). Локальная модель читает вопрос вместе с каждым результатом, и её оценка смешивается с собственной оценкой discovery; результаты после первых 50 сохраняют порядок. По умолчанию это mMARCO (136 МБ,tg models download mmarco); настройка профиляsearch_rerankerвыбираетbge-reranker-v2-m3(588 МБ) илиoff. У каждого переранжированного результата естьdiscovery.reranker_score;scoreостаётся оценкой discovery. Без модели discovery сохраняет свой порядок и сообщаетnot reranked: …(в--jsonи MCP:missingиnext). Поиск никогда не загружает модель и никуда не отправляет текст;--exact,--newestи строгие запросы не затрагиваются.search allтоже находит сообщения по смыслу, когда загружена e5-small и у сообщений есть векторы (cli-core 0.435.0). Результаты по смыслу объединяются с результатами по словам в один список сообщений;foundByкаждого элемента говорит, какой поиск его нашёл. Запрос с NOT или с фильтром под OR или в группе остаётся поиском только по словам. Без модели или векторовsearch allищет по словам, как прежде, и объясняет почему.--exactи--backend serverостаются поиском только по словам.
Changed — may break callers
- Запуск неудачной команды
botназывает вызов Bot API, который не удался.runs showиruns listдают в егоerror.httpполяmethodиendpoint_templateрядом со статусом —{ "method": "POST", "endpoint_template": "/:token/sendMessage", "status": 400 }, — тогда как раньше там был только статус. Токен всегда записывается как:token: Telegram помещает его в адрес, и настоящий токен никогда не попадает в запуск или трассировку. Запросы бота в--traceи в записанном запуске несут те же два поля, а читаемая строка трассировки показывает их после имени метода (← getMe POST /:token/getMe 401 …). Скрипт, который разбирает текст--trace, увидит этот дополнительный столбец. - tg нужен Node 22.19+ или 24+ (было 22.16+). Поддержка прокси для Bot API использует undici 8, которому нужен Node 22.19. Bun это не затрагивает.
- Общий архив переходит на версию 34 (cli-core 0.434.0). Поиск по смыслу ранжирует через векторный индекс в архиве, который строится при первом открытии этой версией. Как только эта версия открыла архив, CLI на cli-core 0.433.0 или старше отказывается его открывать и просит обновиться, поэтому обновляйте вместе все CLI WireCat, которые делят архив. Если SQLite-расширение индекса отсутствует или не загружается, открытие архива завершается ошибкой
store.vector-extension-missingилиstore.vector-extension-failed: переустановите tg.store checkсообщаетvector_indexesи завершается ошибкой, если индекс рассинхронизирован. tg upgrade --helpпоказывает в примере толькоtg upgrade --check(cli-core 0.433.0). Пример с простымtg upgradeудалён: скопированный и запущенный, он выполнял обновление.- Анализ через Anthropic отправляет ключ как
Authorization: Bearer(cli-core 0.433.0). Раньше отправлялсяX-Api-Key. Шлюз на собственномmodels.<purpose>.base_url, который читаетX-Api-Key, должен читатьAuthorization.
Fixed
- Hermes Agent устанавливает навык
tg-cliбез предупреждения о безопасности. Его проверка при установке держала навык на уровне «caution», потому что одно предложение называло папку SSH по её пути, хотя в нём говорится, что tg отказывается её отправлять. Теперь предложение говорит «SSH keys»; то, что tg отказывается отправлять, не изменилось. - Загрузка файла ботом через прокси SOCKS5 или HTTP отправляет файл. Раньше запрос через прокси нёс текст
[object FormData]вместо формы, поэтому Telegram отклонял фото, документы и голосовые сообщения, отправленные с--proxy. - Простой
--versionотвечает до загрузки программы: bin запускается через@wirecat/cli-core/cli/start(cli-core 0.429.0). - Сохранённый вектор удаляется, когда его не использует ни один текст в архиве (cli-core 0.435.0). Изображение с изменившейся картинкой и очищенный чат (
store clear --left, чат, объединённый с другим) оставляли векторы, а теперь нет.store rebuildудаляет оставленные старыми версиями (unused_vectors_dropped), аstore checkих считает (vectors.unused). conversations embeddings clear --chatудаляет и векторы сообщений чата (cli-core 0.435.0), а не только векторы его бесед.
0.92.0 — 25.10.2026
Changed — may break callers
- Разрешения проверяются по полному ключу каждой команды (cli-core 0.421.0).
messages syncпроверяется какmessages.sync, аbot messages sync— какbot.messages.sync; уровень наmessagesилиbot.messagesпо-прежнему действует на них. Сохранённый ключ читается только так, как он записан, поэтомуchats.muteбольше не распространяется наchats unmute. - Сохранённый ключ разрешения, который не называет ни одной команды, отклоняется, в том числе для команд бота. Для ключа под известным ресурсом любая команда, кроме
config show,setиunset, останавливается сconfiguration_error, где названы ключ иconfig unset, который его убирает. tg <profile> search mail— неизвестная команда. Почту ищетmemo search mail.doctor --jsonсообщает о проблемах файла настроек вconfig.issues(cli-core 0.423.0). Поляconfig.errorбольше нет. У каждой проблемы естьkind(invalid_json,unknown_setting,unknown_permission,missing_settingилиinvalid_value),file,profileиkey, где они применимы,lineиcolumnдля некорректного JSON, фраза о том, каким должно быть значение (никогда не само значение), иfix— командаconfig unset, которая её убирает.doctorперечисляет все проблемы файла, по-прежнему завершается с кодом 0 и отвечает, даже когда JSON сломан. Блокировка профиля, флаг или переменная окружения, которые настройки отклоняют, попадают вsettings.error.default_profile,analysis_provider,analysis_modelиanalysis_base_url— неизвестные настройки, аTG_ANALYSIS_PROVIDER,TG_ANALYSIS_MODELиTG_ANALYSIS_BASE_URLне читаются. Файл с одной из них отклоняется, как с любой неизвестной настройкой, вместе сconfig unset, который её убирает. Анализ задаётся черезmodels.analysis.provider,models.analysis.modelиmodels.analysis.base_url(TG_MODELS_ANALYSIS_*);--modelи--base-urlуconversations links rebuildпереопределяют их.- Команда, отклонённая из-за проблемы в файле настроек, называет первую проблему и команду, которая её убирает, и говорит, сколько ещё проблем перечислит
doctor.config show,setиunsetработают с таким файлом, аconfig unsetубирает настройку, которой не знает ни одна схема. Неизвестный ключ разрешения отклоняется в любом разделе файла, а не только в разделах, которые читает команда. config setсохраняетconfig.jsonс доступом только для вас (0600) (cli-core 0.428.0, cli-base 0.57.0). Раньше файл перезаписывался как0644. Всё, что читает настройки от имени другого пользователя — общесистемная служба, контейнер с другим uid, — после следующего сохранения прочитать их не сможет; запускайте это от владельца или дайте ему собственные настройки.- Запись о запуске говорит, как он был начат и почему не удался (cli-core 0.425.0). В
run.json,runs list,runs showиsearch runsпоявилисьcli_command(вся команда,tg messages list),argv, где каждое значение, которое может быть содержимым, записано как[redacted],agent(агент для программирования и его сессия, если он их сообщает) и, для неудачного запуска,error. Запуск без названного профиля не содержитprofile, вместо того чтобы записыватьdefault(cli-core 0.424.0). - Первый экран говорит, что zm и drive «можно искать вместе с другими данными WireCat» (cli-core 0.426.0), а пример
guideназывает настоящий сценарий вместо<name>.
Added
tg skill statusиtg skill show --for claude|agents(cli-base 0.56.0, через cli-core 0.427.0).skill statusсообщает для Claude Code и для~/.agents, совпадает ли установленный SKILL.md с этой версией;skill show --forпечатает установленную там копию.tg store tables listперечисляет все таблицы локального архива с их видом и числом строк;--fullдобавляет размер каждой таблицы (cli-core 0.427.0).store infoтакже говорит, какие инструменты открывали базу, её режим журнала, страницы, миграции и последнюю резервную копию, и считает данные по провайдеру, виду чата, аккаунту, году и виду вложений.
Security
doctorсообщает оconfig.jsonили папке настроек, которые могут читать другие пользователи, и даёт исправляющийchmod(cli-core 0.428.0).files.problemsперечисляет файл настроек (нужен0600) и его папку (нужен0700), в том числе когда папку задаётTG_CONFIG_DIR, а stderr печатаетto make it private: chmod 600 '<path>'.filesесть в ответе и без названного профиля, и когда настройки отклонены. На диске ничего не меняется; Windows не проверяется.
Fixed
- Каждая команда запускается быстрее: клиентская библиотека Telegram загружается, только когда команда подключается.
tg --version,--help,config showиruns listзагружали около 1 900 файлов модулей, 650 из них — mtcute; теперь около 1 100. - Сохранённый запрет на команду синхронизации теперь её останавливает.
permissions.messages.sync: denyможно сохранить, и он соблюдается, аpermissions.bot.messages.sync: denyбольше не игнорируется. Запрет наbot.messagesтакже останавливаетbot messages listиbot messages syncдо подключения. - Сбой посреди команды сообщается, как любая другая ошибка. Раньше печаталась трассировка стека Node; теперь печатается ошибка
internal_error(command.crashed) — одной строкой в терминале, иначе объектом ошибки JSON, — и код выхода по-прежнему 1. Трассировка стека ничего не говорит скрипту и может содержать текст, которому не место на экране. Скрипт, читавший трассировку в stderr, теперь читает объект ошибки.
0.91.0 — 25.10.2026
Changed — may break callers
- Общая база переходит на версию 33 (cli-core 0.420.0). После того как эта версия откроет базу, CLI на более старом cli-core отказывается с ней работать и просит обновиться, поэтому обновляйте вместе все CLI WireCat, которые делят базу.
0.90.0 — 25.10.2026
Changed — may break callers
tg <bot> bot store fetchтеперь называетсяtg <bot> bot messages sync, группыbot storeбольше нет. Команда загружает старые сообщения канала или супергруппы в локальную копию бота — то же, что делает личнаяmessages sync, поэтому у неё то же имя;storeотносится к локальной базе данных. Параметры не изменились. Старый путь отвечает подсказкой с новым. Сохранённый ключpermissions.bot.store.fetchотклоняется, пока вы не переименуете его вpermissions.bot.messages.sync.
0.89.0 — 25.10.2026
Changed — may break callers
-
Заблокированный аккаунт Telegram возвращает
permission_error(код выхода 5). Новый вход не снимает блокировку; используется тот же контракт причин и кодов, что и в других CLI. -
Общие контракты CLI теперь требуют явно объявленных отличий провайдера. Описание команд экспортирует унаследованные определения, схемы, причины ошибок и точные принятые отличия. Активность контакта фильтруется запросами
scope:иat:; поиск диагностических запусков использует границыstarted_at:вместо параметров времени. Неизвестные списки участников чата и неограниченные списки типов вебхуков опускаются, а не возвращаются какnull.
Security
- В разрешении зависимостей исключены уязвимые версии Zod и Vite. Локальная и свежая производственная проверки используют исправленные версии.
0.88.0 — 24.10.2026
Added
messages send --draftсохраняет текст в чате, чтобы вы проверили его и отправили из Telegram. Поддерживаются форматирование, ответы и темы форума; используется отдельное разрешениеdrafts, сообщение не отправляется. Пустые черновики и параметры только для отправки отклоняются.
Fixed
watch --eventsиserveполучают снимки реакций, доставленные как изменения сообщения, включая удаление реакции. Счётчики остаются актуальными, даже если Telegram не присылает отдельное обновление реакций.
0.87.0 — 24.10.2026
Fixed
- Руководства MCP описывают операции записи с отдельными ключами разрешений и отдельное разрешение на прямые вызовы Bot API.
- Сценарий catch-up использует
chats mark-readкак отдельную команду. Руководство по установке объясняет, как восстановить работу, если каталог глобальных команд pnpm отсутствует в PATH. - Запрещённые команды остаются видимыми в справке CLI и MCP с текущей доступностью, причинами и ключами разрешений. Настройки бота остаются в разделе бота, а вызовы проверяют текущие разрешения.
chats members check --helpснова использует описание tg: что читает--deepи что идентификаторы отправляются в публичные списки блокировок. Начиная с 0.86.0 отображалось общее описание без этих подробностей.
0.86.0 — 24.10.2026
Added
- Send up to ten attachments as one album by repeating
messages send --photoor--file. Photos and videos can share an album; documents form a separate group. The caption belongs to the first item, and JSON includes every sent message. Each item counts toward the hourly send limit. Retrying an unscheduled send with the same operation id repeats the same per-item Telegram ids.
Changed — may break callers
- Shared commands have one name each, and the old names are gone (cli-core 0.406.0).
contacts profileiscontacts info,contacts timelineiscontacts events,contacts alias set|rmiscontacts aliases set|remove.chats link …ischats links …andchats link revokeischats links remove;chats members auditischats members check;chats requests accept|declineischats requests confirm|reject.metadata get|refreshismetadata show|sync,tasks planistasks update,tags autoistags rebuild,attachments text setisattachments update,store reindexisstore rebuild,store gaps planisstore gaps showandstats messages counters refreshisstats messages counters sync.conversations buildisconversations links rebuild,conversations embed status|clearisconversations embeddings status|clear,conversations batches nextisconversations batches showandconversations consents revokeisconversations consents remove.models audio listandmodels text listaremodels list kind:audio|kind:text,models audio|text downloadismodels download,models text keyismodels keys.doctor report createisdoctor reports createanddoctor reportisdoctor reports show.mcp setupismcp add,mcp doctorismcp checkandcommands schemaiscommands info. An old name stops with the new one in the message; CLI and MCP use the same paths. - The hidden old option spellings are removed. Use
--analysis-provider,--embedding-provideror--consent-providerfor--provider,--answer-modelonconversations links clear,--template-modeon reply rules,--claimontags remove,--text-fileoncontacts notes, andkind:in theinboxandreviewquery. - A saved permission key with an old path stops every command with
configuration_errorand names the key to rename it to, for examplepermissions.conversations.embedtopermissions.conversations.embeddings.config setandconfig unsetstop too, so rename the key by hand inconfig.json(where it is).
0.85.0 — 24.10.2026
Added
- The first command at a terminal asks three questions once for every WireCat tool (cli-core 0.404.0): which
languages you write and speak, which other WireCat tools to install, and whether commands and agents may only read.
Answered in any tool, they hold in all of them; "read only" caps every profile, over MCP too.
tg setupasks them again. Agents,--json,--no-input,CIandTG_READ_ONLYare never asked.
0.84.0 — 24.10.2026
Added
permissions.mcp.authoritydecides whether an MCP server offers the commands that change what a later run may do (cli-core 0.400.0):config set|unset,schedule command|agent|remove, reply rules and consents, recipient lists, chat rules,server install,skill install, model keys, media archive timers andflood clear. It isdenyby default, so an agent still cannot loosen its own limits until you runtg <profile> config set permissions.mcp.authority allowin a terminal (add--botfor a bot's server). Permissions and the MCP guide explain it.
Changed — may break callers
-
tg mcpoffers the writes that had no permission key before, eachaskby default (cli-core 0.401.0): store backup, restore, migrate, repair, reset, clear, decrypt and copy deletion, server start/stop/restart, model downloads,schedule run|exec,doctor report createandaccount sessions end; the bot server offersstore fetch. Over MCPaskgoes ahead, so set a key toreadonlyordenyto hide a tool.tasks duplicatesistasks duplicates list. -
tg <profile> events list --jsonwrites times as ISO 8601 and ids as strings (cli-core 0.401.0):starts_at,ends_at,deleted_at,created_atandupdated_at, as every other answer does. -
A bot's MCP server can offer
bot api, behindpermissions.bot.api(cli-core 0.402.0). It isdenyby default;tg <profile> config set --bot permissions.bot.api allowin a terminal turns it on. -
tg <profile> watch --jsonlprints{"type":"item","data":…}lines and a final{"type":"end","complete":true}. Read each message or event fromdata, and stop at theendline. Fields are snake_case. A timeout or a normal stop ends withcomplete: true; a failure ends withcomplete: falseand its exit code. -
runs searchis nowsearch runs. Filters are terms in the query:status:failed,error_code:timeout,operation:messages.download,profile:work, next to plain words. Saved MCP requests use the new command path. -
statsreports take their filters as query terms.--message-kindismessage_kind:posts|comments|all,--min-messages 5ismin_messages:5,--min-viewsand--max-repliesaremin_views:andmax_replies:,--older-than 24hisolder_than:24h, and--chatischat:<chat>on the rankings and reports; exact words useexact:in place of--exact. Update saved commands and MCP requests. -
Options have one meaning each (cli-core 0.399.0). Use
--analysis-providerfor analysis and--embedding-providerfor vector search (conversations build|embed|related|status,search conversations),--consent-providerforconversations consents revoke,--claimfortags remove,--answer-modelforconversations links clear,--template-modefor reply templates and--text-fileforcontacts notes add|edit.inboxandreviewtakekind:group,channelin their query. The old spellings still work, hidden, for one release.
Fixed
-
Voice-note search no longer finds a different real English or Spanish word for the one you typed (cli-core 0.402.0). A misheard spelling still turns up: "budget" finds "budjet", but "cost" no longer finds "cast".
-
Downloading media skips service events and keyboards (cli-core 0.400.0). A chat with a group event or an inline keyboard no longer makes
attachments downloadfail withprovider.invalid-response.
0.83.0 — 23.10.2026
Added
-
tg <profile> messages press <chat> <message> <button>,chats start <bot>andchats app <bot>work with bots.messages shownow numbers the inline buttons under a bot's message;presspresses a callback button by its number or text. A button that asks for your 2FA password is refused, never pressed.chats startstarts a bot as its Start button does (--start <param>, or at.me/<bot>?start=link), andchats appprints the address of its mini app, which signs you in. -
The skill tells an agent to search again in other words before saying something is not there. A search finds the words it is given, and a paraphrase shares none with its answer.
-
tg <profile> chats archive|unarchive|pin|unpin|mark-unread|mute|unmute <chat>: your own chat list from the command line. Telegram's archive, pinned chats, the unread dot and notifications, withmute --until 2hfor a time and plainmutefor good. They change only your list; nobody in the chat is told, and repeating one is safe. -
Verified media backups.
attachments download <dir>archives available files across chats with size and SHA-256 manifests;attachments check <dir>verifies them offline.attachments jobsmanages opt-in Linux daily timers. Completed copies survive interrupted runs and message-store deletion; interrupted files restart.attachments move <dir> <archive-dir> --before-time <time>moves older images into another verified archive, retaining relocation records so checks follow the copies and later downloads do not duplicate them. -
tg <profile> review --offlinereads the local store (cli-core 0.398.0) instead of refusing. It shows only what was already synced and says so (missingin JSON, a warning on the terminal). -
The MCP server offers more commands, each limited by the profile's permissions (cli-core 0.398.0):
runs,store status|info|check|export|reindex,store jobs,attachments move,attachments jobs status,config show,commands schema,guide,skill show,doctor report, themodelslists,replies status|test|consents show,schedule list,server status|logs, and on the bot serverwebhooks,commands set|clear,chats leaveandchats admins. The MCP guide lists the few it leaves out, and why. -
Saved voice-note transcripts match word forms and spellings that speech recognition may have garbled.
text:searches written text only;exact:disables expansion for that word.
Changed — may break callers
-
tg <profile> setup --json: the command map isitem.commands, notitem.next. The envelope'snextis reserved for structured continuation steps, so the map of follow-up commands (instructions,inbox,chats,history,history_status, andskill,mcpwhen no agent skill was installed) moved toitem.commands; the values are unchanged. Login details stay underitem.session. What to do: readitem.commands.<name>where you readitem.next.<name>. -
MCP message deletion takes
message, chat export takeschat, and duplicate-task operations taketaskand, for a pair,other_task. Update saved MCP requests usingmessages,chatsordup. CLI positional arguments keep their order. -
Command discovery (
commandsandcommands schema) rejects--jsonl; use--jsonfor its single document.
Fixed
-
The docs and the skill say
search allalso asks Telegram. By default it sends the query's words to Telegram's own search too (--backend both);--offlineor--backend archivekeeps the query on your computer. README, usage, search and the skill said it read only this computer. -
Installation explains npm's install-script warnings. npm 11.17 also prints
not yet covered by allowScriptsfor@wirecat/tg-cliandbetter-sqlite3; both are harmless, and the guide says why. -
contacts prepareis in the people guide and the skill, and the comparison page covers tlgr and mcp-telegram, links the maintained tgcli and marks tgcli's several accounts. -
A pasted
--helpexample runs (cli-core 0.398.0): an account command's example names the profile (tg personal messages list Team) instead of failing with "name a profile". -
search all --helpsays it asks Telegram's server by default and names--offlineand--backend archiveto keep the query local (cli-core 0.398.0). -
Message-search commands no longer list or delete saved meeting searches.
-
Command corrections preserve the chosen profile; help shows concise descriptions and concrete examples.
0.82.0 — 23.10.2026
Added
tg <profile> contacts prepare <person>: what to know before talking to someone (cli-core 0.394.0). Whatcontacts contextgives, plus the one-to-one chats where their message is the newest the store holds, open tasks assigned to them, accepted facts about them and their projects, your notes about them, and their recent meetings — each with its reference, under one size budget, withprepare.coveragesaying what each section left out and why. Tasks of another Telegram account, and facts on a project bound to one, stay out.contacts.notes.list: denyleaves the notes out and says so;messages: denyrefuses the command, as it doescontacts context.- Message search reads
"a b"~N: the words at most N words apart in one message (cli-core 0.391.0). bot watch --public-url <url> [--port <n>]receives a bot's updates by webhook (cli-core 0.391.0).
Changed — may break callers
- Reads never mark chats read (cli-core 0.391.0).
messages list,inboxandreviewno longer take--mark-reador--no-mark-read, and thecatch_up_marks_readsetting is refused. Why: a command that only read sent the other person a read receipt. What to do: removecatch_up_marks_read; runtg <profile> chats mark-read <chat>when you mean to mark a chat read. - An unknown key under
permissionsrefuses messenger commands withconfiguration_error(cli-core 0.391.0), typos such asmessages.sednincluded. It was a warning, and the restriction did not hold. What to do: correct the key or remove it withconfig unset.
Fixed
- A local read with an unknown profile lists the profiles on this computer (cli-core 0.391.0), instead of suggesting to link a new account.
0.81.0 — 22.10.2026
Added
- JSON answers of commands with a date filter say how they read the date (cli-core 0.385.0):
meta.windowgives the bounds used, in UTC, andmeta.timezonenames the zone a date typed without one was read in. This coversstore export,messages sync,stats chats show,stats chats retention,contacts context,search conversations,replies test,runs search,stats messages unanswered,stats contacts responses,stats chats newcomers,stats messages discussion, and atime:ordate:term inchats events,chats members history,inboxandreview.
0.80.0 — 22.10.2026
Changed — may break callers
- A time typed without a zone is read in your zone, and a date alone means local midnight (cli-core 0.379.0).
This covers
messages send --at-time,chats link createandchats link update --expire-time,chats mute --untiland date-onlytime>=queries, such aschats events Valencia time>=2026-09-20. Before, some of them read a date alone as midnight UTC. A time withZor an offset is read as before, and JSON and MCP output still give every time in UTC withZ.
Fixed
-
stats chats retentionandchats stats showread--since-time/--until-timein their--timezone, and a date alone in retention's--until-timecovers that whole local day (cli-core 0.380.0).stats charts,contacts timelineand the MCPstatstool name the zone inmeta.timezoneand give the UTC window inmeta.window. -
The QR login line names the zone of its time: "valid until 22:00:00 Asia/Vladivostok". Before, it gave the computer's local time without saying so.
-
A frozen account's deletion date says it is a UTC date: "deletes it on 2026-10-03 (UTC)". The
untilfield is unchanged.
0.79.0 — 21.10.2026
Fixed
- An action Telegram keeps for Premium accounts now says so ("that needs Telegram Premium on this account").
Before, every such refusal, for example a reaction from a free account, said that Telegram transcribes only for
Premium.
messages transcribekeeps its own message about Premium and the free trial. - A locked or unreachable Linux keyring now warns and falls back to the credentials file (cli-base 0.47.5). The keyring is read through the Secret Service only; before, a failure could end in silent storage in kernel memory, which is gone after a logout or reboot.
0.78.0 — 21.10.2026
Changed — may break callers
- Markdown headings are refused when sending (cli-core parser). Send text now goes through cli-core's shared
Markdown parser, as
maxdoes. A line that starts with#used to go out as typed; it now fails with a validation error, because Telegram has no headings. Write the line in bold instead. Nothing else changes. - A message that sends you to another command names it with your profile: after a send or an edit with no answer
from Telegram, "check
tg personal chats list" replaces "checktg chats list", so it can be pasted as it stands. The words now come from cli-core. - Telegram's account and login refusals, a stopped watch and an unanswered write carry their own error
reasoninstead of the generic one for their code:login.revoked,login.duplicated,account.deactivated,account.banned,account.frozen,account.limited(wereauth.failedoraccess.denied),updates.stopped(wasprovider.unavailable) andwrite.unanswered(wasoutcome.unknown). Codes, exit codes and messages are unchanged. Under--debug, the record'scausenow gives the failure behind it, not only its code.
Fixed
- Search queries keep an
@that is followed by a letter inside a term. E-mail addresses without a dot after the@and chat ids no longer need quotes:email:[email protected]works as typed.
0.77.0 — 20.10.2026
Новое
- Хранилище помнит историю чата (версия хранилища 25, cli-core 0.366.0). Смена id, названия, участия или
видимости чата в поиске сохраняется в
chat_revisionsсо старым и новым значением; чтение по id, который чат носил до смены, находит чат, которым он стал. Хранилище переходит на версию 25 при первом открытии; ничего не отправляется.
Исправлено
- Покинутый чат находится по любому своему id (cli-core 0.368.0) в
store export,store status,messages thread, в--chatиchat:поиска, в тегах, задачах и других чтениях сохранённой истории.chats trackиstore gaps planотказывают для него: "you left chat ". tg guideпоказывает сценарий memo под тем же названием, что memo и остальные инструменты: "One person across every tool", с заглавной. На cli-core 0.370.0 проверка сценариев в тестах ловит и символы оболочки вне кавычек в шаге.
0.76.0 — 19.10.2026
Изменено — может сломать скрипты
- Без терминала QR-код для входа печатается текстом, чтобы агент вставил его в чат;
--qr-fileудалён. Агент записывал PNG и открывал его в просмотрщике изображений — в окне, которое легко потерять. Теперьtg <profile> session start qrиsetupпечатают код в stderr обычным текстом (полублоки, без цветов, для тёмной темы терминала), а затем говорят агенту вставить его блоком кода точно как напечатано, а обновлённый код вставить снова и сказать, что старый истёк. С--jsonкаждый код также печатается одной строкой в stderr,{"event":"qr","qr":{"text","expires_at","scan"}}. В терминале код рисуется как раньше.--qr-fileудалён изsession startиsetup. Без терминала вход по-прежнему требует сохранённых ключей приложения и отсутствия 2FA и отклоняется до открытия браузера; вход по телефону требует терминала. Вход по-прежнему не доступен через MCP: запустите команду (когда вход запускает агент).
Новое
store clear --leftназывает чаты, которые удаляет (cli-core 0.353.0): отказ без--allow-dangerousперечисляет первые 20,--dry-runперечисляет все, а ответ содержит списокleft(id,title,messages).
Исправлено
- Из cli-core 0.351.0–0.362.0:
chats leaveиchats joinобновляют хранилище, аchats showнаходит чат, который вы покинули; отправленное сообщение сохраняется в том чате, где ответил Telegram; чат со сменённым ключом сохраняет более строгую приватность из двух половин; чат, скрытый из поиска, не попадает ни в один поиск, который его не называет;last.jsonнеудачного запуска по расписанию хранит код ошибки, а не название чата; первыйserveпосле обновления переключает ключи чатов короткими проходами, не блокируя хранилище. messages forwardвозвращает и сохраняет пересланную копию в том чате, куда она ушла. Раньше он брал первое новое сообщение из ответа Telegram, а оно может принадлежать другому чату; теперь он берёт то, на которое указывает его id отправки, в целевом чате. Создание темы форума так же читает её первое сообщение.
0.75.0 — 19.10.2026
Исправлено
- Шаг входа в
setupназывается «Link this device» и больше не просит отсканировать QR-код до того, как он нарисован. Строка под кодом говорит, где сканировать; в узком терминале видна только подсказка расширить окно. - Терминал, слишком узкий для QR-кода, больше не просит его отсканировать (cli-core 0.350.0).
session startиsetupговорили, где сканировать в Telegram, ещё до кода; если код не помещался, за этим шла только подсказка расширить терминал или передать--qr-file. Теперь строка о сканировании идёт после нарисованного кода или заметки о--qr-file, а узкий терминал показывает только подсказку. tg <profile> setup --helpснова показывает блок Global Options. 0.74.0 потерял его, когда в строке использования появился<profile>.- Подсказки в ошибках и заметках называют профиль: «the store is behind this build —
tg personal store migrate» вместоtg store migrate, который при копировании падал с «name a profile».
Новое
- Следующий шаг в выводе
--jsonи в ошибке содержитline— всю команду с профилем, которую нужно ввести (cli-core 0.348.0):"line": "tg personal mcp config"рядом с"command": "mcp config". Скопированный одинcommandпадал с «name a profile».commandне изменился, а ответы MCP не содержатline.
0.74.0 — 19.10.2026
Новое
tg guideпоказывает сценарии: команды для частой задачи по порядку и зачем каждая. С tg поставляются четыре —catch-up,find-what-was-said,searchable-filesиagent-without-send, — а список указывает наperson-briefиз memo для одного человека во всех инструментах.tg guide <name> --jsonвыдаёт сценарий как данные. CI проверяет, что каждый шаг — команда tg, чьи опции и аргументы разбираются.--helpкаждой команды заканчивается строками Returns, Next usually и Example (cli-core 0.345.0), иdocs/commands.mdсодержит те же строки. Строка использования показываетtg <profile> ….
Изменено — может сломать скрипты
npm install -gустанавливает skill агента, только когда об этом просят. Раньше он по умолчанию записывал skill в~/.claude/skillsи~/.agents/skills, а npm скрывает вывод скриптов установки, так что никто об этом не знал. ТеперьTG_INSTALL_AGENT=all(или имя агента) устанавливает его при установке; иначе его предлагаетtg <profile> setup, илиtg skill install --for all. Установщик для Windows сам передаётallи не изменился.tg --helpиtgбез аргументов показывают короткий первый экран (cli-core 0.344.0): для чего tg, восемь вещей, которых не делает обычный клиент, другие инструменты WireCat и куда идти дальше. Полная справка commander со всеми командами и опциями — вtg --help-all; только опции — вtg help options. Скрипт, который искал команду или глобальную опцию вtg --help, должен читать--help-all.tg commandsбез--jsonпечатает текстовый список по разделам, даже при выводе в конвейер: одна строка на команду — использование, что она делает и(writes), если она что-то меняет. Раньше печатался весь документ JSON.--jsonи--jsonlпечатают тот же документ, что и раньше; скрипт, который разбирал выводtg commandsбез опций, должен передавать--json.provider_metadataчата содержитnullдля выключенного флага или исчезнувшего username: раньшеisBot,isForum,pinnedиusernameв этом случае пропускались. Хранилище cli-core скоро начнёт сохранять пропущенный ключ, и тогда откреплённый чат или удалённый username остались бы в хранилище, а@oldпо-прежнему находил бы чат. Все читатели в tg и cli-core считаютnullотсутствием значения, но вывод JSON теперь показывает эти ключи какnull: скрипт, который проверяет наличие ключа, его увидит.
Безопасность
- Вход по QR-коду — это
loginQrиз cli-core, как в max и wa.--qr-fileзаписывается во временный файл, созданный с правами0600и переименованный в нужный путь, а не записывается и затем получает права через chmod; и он удаляется, когда вход прерван Ctrl+C, отменой или--timeout, а не только когда вход завершился сам. В слишком узком для кода терминале ничего не рисуется, и tg предлагает расширить терминал или передать--qr-file. Без терминалаsession startсообщает "shows a QR code to scan — run it in a terminal, or pass --qr-file ". - При блокировке только для чтения и в профиле readonly запись отказывает до подключения; отказы видны в
sends list(cli-core 0.343.0).
Исправлено
inboxиreviewобъявляют свой вывод, поэтомуtg commands schema inboxвыдаёт поля сводки сообщений, а--json=<fields>отказывает на имени, которого у них нет, вместо того чтобы печатать пустые элементы (cli-core 0.345.0).
0.73.1 — 18.10.2026
Исправлено
- tg запускается немного быстрее. Сборка на cli-core 0.342.0 и cli-base 0.45.0: команда больше не разбирает таблицы правил, нужные только проверкам при разработке, — по замеру это экономит около 7–12 мс на запуск.
0.73.0 — 18.10.2026
Новое
- Через
tg mcpагенты получают все команды, которые разрешают уровни профиля (cli-core 0.341.0). Сервер предлагал инструменты, написанные вручную; теперь он строит их из самих команд и выполняет в этом процессе — всего 188 команд, среди новыхmessages sync,contacts sync,mentions confirm,conversations embedиimages embed. Что агенту нельзя, решают уровни профиля: задайте областиreadonlyилиdeny. Полный список закреплён вcontracts/mcp-catalogue.json. tg conversations rebuildзаново строит разговоры в изменившихся чатах и встраивает их моделью на этом компьютере; команда не обращается к Telegram, не скачивает модель и никуда не отправляет текст. Она заменяет инструментconversations_refresh, который был только у агента.
Изменено — может сломать скрипты
- Аргументы инструментов
tg mcp— это опции команды в snake_case:chat,limit,query,sync_firstи так далее. Агент, который помнит старые имена, снова спрашиваетtg_tools_search. search messagesу агента принимает запрос только текстом; структурированного вводаastбольше нет.- Агент не может отмечать прочитанным и действовать как владелец:
--mark-readуmessages list,inboxиreviewи--as-ownerему не предлагаются, настройкаcatch_up_marks_readна его запуски не действует, а его отметки--new— его собственные. - Под
TG_READ_ONLYлокальные записи, которые удаляют или перезаписывают сохранённое вами, запрещены (cli-core 0.336.0, 0.337.0):searches create,searches delete,searches clear,contacts alias set|rm,contacts notes add|edit|remove,contacts link|unlink,tags add|auto|remove,mentions confirm|reject,attachments text set,chats tracking add|remove,conversations links add|clear,conversations consents revokeиtasks reject, а также их инструменты для агента, завершаются с кодом 5. То, что хранилище восстанавливает само, синхронизация,serveи учёт задач по-прежнему работают. - Пока Telegram ограничивает аккаунт, никакая запись не уходит (cli-core 0.334.0): реакции, отметка прочитанным,
тихие закрепления, смена названия и профиля тоже запрещены; чтение работает. Бессрочный бан держит запись, пока
tg flood clearилиtg doctor --onlineне увидит, что аккаунт в порядке (until: nullв JSON). - Отправка, заблокированная чужой блокировкой процесса, завершается с кодом 9 (
timeout), а не 1 (cli-core 0.338.0); ничего не отправлено, так что повторить безопасно.flood clearтоже. tg upgrade --offlineзавершается с кодом 2 (cli-core 0.338.0), вместо того чтобы всё равно спросить npm.conversations build,conversations embedиsearch conversationsпредупреждают, что могут отправить текст наружу (cli-core 0.334.0, 0.336.0): с--analyze,--providerили удалённой моделью эмбеддингов. ПодTG_READ_ONLYони отказывают до отправки; локальная модель по-прежнему работает. Черезserveони не выполняются никогда.
Исправлено
tg mcpотвечает на каждый вызов, полученный до закрытия stdin, а не завершается, пока один ещё выполняется.tg bot mcpпока нет.- Агенту не предлагается
offlineдля команды, которая его отклоняет (cli-core 0.335.0):topics,chats events,chats inspect,chats members audit,chats members fetchи командыchats folders. - Занятая блокировка больше не задерживает
tg serve(cli-core 0.340.0) на время до 5 секунд. - Два одновременных изменения списка получателей больше не отменяют друг друга (cli-core 0.338.0).
tg store gaps repair --backgroundвыполняет свою задачу, а не сразу падает (cli-core 0.339.0).- Подсказки команд
serverи обслуживания хранилища называют профиль (cli-core 0.339.0). tg upgrade --checkработает подTG_READ_ONLY(cli-core 0.338.0).- Скачивание моделей никогда не идёт через
tg serve(cli-core 0.336.0). - Хранилище, которое не удалось открыть, закрывается (cli-core 0.332.0), так что его папку можно удалить в Windows.
0.72.0 — 18.10.2026
Новое
tg tasks agendaпоказывает, что вам должны другие (cli-core 0.328.0): открытые задачи, которые делает кто-то другой, от старых к новым, с исполнителями, в разделе «assigned» и в полеassignedв JSON.
Изменено — может сломать скрипты
- Путь команды одним аргументом — ошибка (cli-core 0.328.0):
tg 'chats list' --helpпечатал общую справку и завершался с кодом 0; теперь команда завершается ошибкой и показывает, какую строку запустить. - Интерактивная команда без терминала по умолчанию ждёт 5 минут, а не 30 секунд (cli-core 0.328.0), чтобы
tg session start --qr-fileу агента не обрывался, пока код не отсканирован.--timeoutиTG_TIMEOUT, если они заданы, по-прежнему решают сами. - Под
TG_READ_ONLYзапись, которая сначала спрашивает, останавливается с кодом 5 до вопроса, а не с кодом 7 (cli-core 0.329.0):messages delete,topics delete,account sessions end,chats deleteиchats clearговорили «спрашивает, прежде чем действовать», как будто--allow-dangerousих пропустит. Теперь они говорят «этот процесс только для чтения», как и любая другая запись. Без блокировки они спрашивают, как раньше.
Исправлено
- Меньше ложных подсказок о дубликатах из-за цепочек ответов (cli-core 0.331.0): ответ, в котором просят о чём-то новом, больше не помечает две задачи как, возможно, одну и ту же.
tg chats list --json | headзавершается тихо (cli-core 0.328.0), в том числе через запущенныйserve, а не печатает трассировку стека, когда читатель останавливается.
Безопасность
tg session endбольше не выходит из аккаунта у запущенногоtg serve(cli-core 0.328.0): когда для профиля работалserve,session endпередавался на выполнениеserve. Он выходил из подключения, которым пользовалсяserve, и удалял файл сессии, которыйserveещё держал открытым. Теперьsession start,session endиsetupникогда не выполняются черезserve, аsession endостанавливается с кодом 2 и просит сначала выполнитьtg <profile> server stop. ПодTG_READ_ONLYвсе три по-прежнему останавливаются с кодом 5, теперь с сообщением «нельзя войти или выйти».
0.71.0 — 17.10.2026
Изменено — может сломать скрипты
- В группе с тегом
watch-tasksвопрос закрывает ответ любого участника (cli-core 0.325.0): прямой ответ от кого-то, кроме спросившего, закрывает вопрос; более позднее сообщение, которое не отвечает на него, ничего не закрывает. - Инструменты
tg <bot> bot mcp— это сами команды бота (cli-core 0.325.0): аргументы агента — собственные аргументы команды в snake_case:messages sendиmessages editпринимаютmdилиhtmlвместоformat,messages deleteпринимаетmessages(список),search messages—query,chats members remove—person. Новое:chats rules showиofflineу каждого чтения. Отправка файлов,--allow-dangerousиchats moderate --max-actionsостаются за владельцем. Каталог зафиксирован вcontracts/bot-catalogue.snap.
0.70.0 — 17.10.2026
Что нового
tg <profile> contacts link <person> me(cli-core 0.323.0): указать, что контакт — это вы, для вашего аккаунта, который хранилище не может сопоставить само, напримерzoom:<id>.
Исправлено
- Упоминания реже находят неверные имена (cli-core 0.323.0). Отдельное слово из имени контакта учитывается само по себе, только если это имя или фамилия; контакт с названием как у компании («Smart Agents») находится только по полному названию, а вежливые «Ваш», «Вам», «Вас» не учитываются никогда. Имя святого в названии места («Saint Michael's Bridge») и город после «в»/«во» («во Владимире») — тоже не имена.
- Ваши собственные аккаунты — это вы (cli-core 0.323.0): собственная личность аккаунта связывается с вами при следующей синхронизации, так что ваше имя в ваших сообщениях больше не принадлежит кому-то другому.
- Адрес сохраняет свой город (cli-core 0.323.0): одна и та же улица в двух городах — два места; адрес, записанный без города, по-прежнему совпадает со своим местом на этой улице.
После обновления один раз перечитайте старые сообщения: tg <profile> mentions rebuild person-name place.
Безопасность
TG_READ_ONLYтеперь запрещает вход и выход, а также изменения хранилища сообщений:session start,session endиsetupотказывают сpermission_errorдо подключения, как иstore reset,restore,clear,migrate,repair,copies deleteиdecrypt. Раньшеsession endвыходил из аккаунта и удалял сессию при включённой блокировке.
0.69.0 — 17.10.2026
Изменено — может сломать скрипты
- Агент больше не может удалять сообщения для всех (cli-core 0.321.0). MCP
messages deleteне принимаетfor_everyone, и такой аргумент отклоняется как неизвестный; у владельца остаётсяtg <profile> messages delete --for-everyone. mcp --permissionтолько ужесточает (cli-core 0.321.0). Переопределение, которое ослабило бы уровень профиля, напримерmessages.send=allowдля профиля только для чтения, отклоняется при запуске с названием ключа; чтобы разрешить больше, измените разрешения профиля.--permission messages.send=denyи другие сужающие переопределения работают как раньше.
Исправлено
- Запрет агенту на
chats send-asиchats members listтеперь действует (cli-core 0.321.0). Через MCP эти команды брали уровни из других ключей, поэтомуchats.send-asиchats.members.listдо них не доходили.
0.68.0 — 17.10.2026
Изменено — может сломать скрипты
- Задачи открываются только там, где что-то спрашивают у вас (cli-core 0.318.0). В личном чате каждый вопрос, на который вы не ответили, открывает задачу, как и раньше; в группе — только вопрос в ответ на ваше сообщение и упоминание вас; в канале или «Избранном» — ничего. В хранилище владельца 300 постов одного канала раньше открыли бы 85.
tasks applyтеперь называетсяtasks scan(cli-core 0.320.0); MCPtasks_scan, ключ разрешенияtasks.scan.- Ни одна настройка больше не выбирает профиль (cli-core 0.319.0). Команда называет профиль первым словом или
через
TG_PROFILE. Файл настроек, в котором ещё естьdefault_profile, останавливает команду без профиля и подсказывает, какой профиль ввести иtg config unset default_profile;tg config set default_profileотклоняется. Профиль с именемdefault— обычное имя:tg default mcp configназывает свой серверtg-default, а неtg.
Что нового
- У задач есть исполнители (cli-core 0.320.0):
tasks addиtasks planпринимают--assignee sender(тот, кто отправил сообщение) или--assignee person:<id>;noneубирает исполнителя.tasks list "assignee:any state:open"— это то, что вам должны другие. tg <profile> tags add --chat <group> watch-tasksзаписывает каждый вопрос в этой группе как задачу, кому бы он ни был адресован.
Исправлено
- Подсказка
tg upgradeоб отложенном обновлении называет пакет и сохраняет исключение pnpm по возрасту релиза (cli-core 0.320.0).
0.67.0 — 17.10.2026
Безопасность
-
Внутренние ссылки вложений не попадают в JSON, JSON lines, MCP и поток событий (Core0.315.0); медиа-ключи и учётные данные провайдера остаются внутри клиента.
-
Файлы состояния WhatsApp нельзя загрузить как вложение (Core 0.314.0), в том числе при изменённых путях состояния и через символические ссылки. Обычные соседние файлы по-прежнему разрешены.
0.66.0 — 17.10.2026
Изменено — может сломать скрипты
- Первая синхронизация не открывает задач из истории (cli-core 0.309.0). После первой синхронизации аккаунта
правила задач открывают не больше
task_first_pass_per_chatзадач на чат, по умолчанию 0. В ответе синхронизацииtasksсчитает, что было отложено (held,held_chats), а примечание называетtasks apply. Следующие синхронизации по-прежнему открывают задачи из новых сообщений.tg <profile> config set task_first_pass_per_chat 50возвращает прежнее поведение.
Что нового
-
tg <profile> tasks apply <chat...>(cli-core 0.309.0): правила задач над последними сохранёнными сообщениями чата (--last, по умолчанию 50) — для чата, историю которого вы хотите превратить в задачи. Команда показывает, что откроется, и ничего не меняет без--yes. Только локальное хранилище. MCP:tasks_apply. -
Упоминания находят почтовые адреса и имена людей, которых хранилище ещё не знает (cli-core 0.308.0).
tg <profile> mentions placesпоказывает подтверждённые адреса во всех аккаунтах. Хранилище переходит на версию 18 с таблицейplaces, когда его впервые откроет команда.
Исправлено
tg upgradeчерез pnpm ставит самую новую версию (cli-base 0.40.2). pnpm 11 ставит только версии старше суток, поэтому обновление могло поставитьtgстарее того, что у вас был. Теперь для@wirecat/*это ожидание снято; для остальных пакетов оно остаётся.- Краткие описания в справке
mentionsукладываются в общий предел 80 символов (cli-core 0.311.0). - Проверка дубликатов сравнивает задачи по времени отправки их сообщений (cli-core 0.310.0), а не по времени записи задачи. Задачи, записанные из истории за один раз, больше не выглядят одинаковыми.
- Старые сообщения, загруженные в тихий чат, не открывают задач (cli-core 0.309.0): проход синхронизации пропускает чат, в котором ничего не отправлено с прошлого прохода.
- Нет строк
[client] cannot reach Telegram, пока tg не может подключиться. С 0.64.0 tg печатал каждую фоновую ошибку mtcute одной строкой; без сети это строка на каждую попытку подключения. Теперь они видны только с--verbose. Запрос, который не удался, по-прежнему сообщает свою ошибку.
0.65.0 — 17.10.2026
Что нового
- Карточка закрытой задачи показывает задачу, которая её продолжает (cli-core 0.305.0).
tasks showпечатаетtask:<id> follow-up-of this task, а--jsonи MCP возвращаютlinked_from. Раньше закрытую задачу называла только новая.
Изменено — может сломать скрипты
- Ежедневная строка «вышла новая версия» молчит и для
--json=…,--timeout=…и других тихих параметров, записанных через=(cli-core 0.307.0). Раньше её отключал только параметр без значения. Теперь tg берёт это уведомление из cli-core, общее с max и memo.
Исправлено
-
tg setup --app autoчитает ключи приложения на обновлённом my.telegram.org. Сайт теперь показывает api_hash точками и хранит его значение в кнопках копирования и показа, поэтому 0.64.0 останавливался с «could not read its keys». Теперь ключи читаются оттуда (проверено на настоящей странице), создание считается выполненным, когда сайт отвечает OK, и показывается текст ошибки самого сайта, а не его JSON. -
Сломанный файл настроек называется в короткой ошибке (cli-core 0.304.0): первый неверный ключ, никогда не его значение.
0.64.0 — 16.10.2026
Что нового
-
Импортированные документы Drive сохраняют ссылку Google и время правки в общем поиске (cli-core 0.301.0).
--source drive:<profile>выбирает зарегистрированный профиль Drive; списки документов чата могут показывать импортированное название, после того как синхронизация Drive свяжет сохранённые сообщения. -
Сервер MCP загружается, только когда MCP запущен (cli-core 0.300.0), поэтому другие команды при запуске загружают примерно на десятую часть меньше файлов.
Исправлено
-
tg setup --app autoбольше не пытается создать второе приложение, когда у аккаунта оно уже есть. Он читал ключи приложения только из одной точной разметки страницы; когда my.telegram.org показывал страницу приложения в другом виде, tg считал, что приложения нет, и просил сайт создать ещё одно (Telegram разрешает одно на номер). Теперь ключи читаются из текста страницы, а страница приложения, ключи которой прочитать нельзя, останавливает настройку с «use--app browser». Ошибка сайта больше не цитирует всю страницу, где мог бытьapi_hashприложения, — только её заголовок. Подсказка после неудачного шага с приложением называет выполненную команду (tg <profile> setup --app browser), а слишком много попыток ввести код сайта — этоrate_limited. -
Вход с паролем 2FA больше не печатает стек mtcute «unhandled error: ConnectionClosedError». После успешного входа mtcute намеренно заменяет свои соединения. Старое соединение сообщало, что закрыто, и без слушателя mtcute печатал это красным стеком с id аккаунта сразу после скрытого запроса пароля. Теперь tg слушает эти фоновые ошибки: ожидаемое закрытие видно только с
--verbose, а любая другая ошибка выводится одной строкой словами tg. -
bin/releaseперезапускает себя один раз, когда выпуск приносит более новыйbin/release: свёртка истории изменений и повышение версии перематываютmain, а оболочка продолжала читать старый скрипт с того байта, где остановилась, и остаток запуска был смесью старого и нового текста. Теперь новый скрипт запускается заново с теми же аргументами; второе изменение во время этого запуска останавливает его сrun it again. Перезапуск работает и тогда, когдаbin/releaseзапущен из другой папки по относительному пути. Это касается только выпуска самого репозитория; опубликованный пакет не меняется.
0.63.0 — 16.10.2026
Что нового
messages deleteпринимает id сообщений через запятую, а не только через пробел (cli-core 0.299.0).- tg запускается примерно на пятую часть быстрее после первого запуска. Он хранит скомпилированный код Node в
кэше, во временной папке системы (
NODE_COMPILE_CACHEпереносит его):tg --helpстал занимать около 0.49 секунды вместо 0.60. - Список категорий задач хранится в одном файле, общем для tg, MAX и memo (cli-core 0.298.0):
~/.config/WireCat/config.json, разделtask_categories. В нём только ваши изменения списка по умолчанию:"garden": "plants | seedling, es:planta"добавляет или заменяет категорию,"religion": nullубирает категорию по умолчанию, а категории, которые добавит следующий выпуск, всё равно появятся.tasks categories(MCPtasks_categories) называет файл вfile, аconfig showотмечает категории, которые взяты из него. Файл с неверным JSON или с неверной категорией отклоняется с указанием его пути. Хранилище, перенесённое черезMESSAGING_STORE, читаетconfig.jsonрядом с собой;WIRECAT_CONFIG_DIRпереносит файл.
Изменено — может сломать скрипты
config set task_categories.<name>иconfig unset task_categories.<name>теперь пишут в~/.config/WireCat/config.json, а не в хранилище, и сохраняют другие разделы файла;config unset task_categoriesубирает раздел. Список, который старая версия tg сохранила в хранилище, переходит в файл при следующемconfig setилиunsetкатегории; до этого действует список из хранилища. Старые версии tg не читают этот файл.
0.62.0 — 16.10.2026
Что нового
- Закрытие задачи агентом может ждать вас (cli-core 0.295.0):
tasks close, запущенная ИИ-агентом (заданаAI_AGENTилиCLAUDECODE), указывает уверенность через--certainty <0..1>. Ниже порога хранилища (config set task_agent_close_min, по умолчанию 0.8) или приconfig set task_agent_close offзадача остаётся открытой с предложением закрыть; его показываютtasks list close:suggestedиtasks agenda. Подтвердите его командойtasks close <task>или отклоните новойtasks reject <task>.--as-ownerзакрывает от вашего имени. - Новая задача о задаче, закрытой за последние 14 дней, открывается как её продолжение: она связана
follow-up-ofс закрытой, а не отклоняется как дубликат. Её по-прежнему отклоняют, пока открытая задача может быть той же работой. tasks categoriesназывает категории, которых больше нет в списке, но которые ещё стоят у задач, с числом открытых задач и всего (unlisted);tasks agendaперечисляет те, что стоят у открытых задач (unlisted_categories).
Изменено — может сломать скрипты
tasks closeот агента должна передать--certainty(MCPtasks_close: обязательныйcertainty), иначе она завершается ошибкойtask.certainty-required. Ниже порога ответ содержитstate: openиclose_suggestionвместо закрытой задачи. Скрипту, который закрывает задачи из терминала агента, нужен--certaintyили--as-owner, если закрыть попросил владелец.tasks addтеперь может отклонить задачу, сообщение которой разделяет слова с сообщением открытой задачи (код выхода 2,task.duplicate-candidates): проверка дубликатов читает и исходное сообщение задачи, и её новейшие связанные сообщения, поэтому задача правила с пустым заголовком сравнивается по своему сообщению. Повторите с--into <task>или--new.- 59 категорий задач по умолчанию вместо 7, например
bills,health,travel,fitnessиsubscriptions;tasks categoriesпечатает каждую с её смыслом и словами-признаками. Старые семь сохраняют имена, поэтому сохранённые задачи остаются верными, но правило теперь выбирает более узкое имя: счёт за коммунальные услуги — этоbills, а неmoney. Поэтому фильтр вродеcategory:personalловит меньше новых задач. Хранилище, где сохранён свой список, сохраняет его;config unset task_categoriesберёт новый список по умолчанию. В списке до 80 категорий.
Исправлено
- Испанский текст задач читается лучше: категория правила совпадает с другими формами испанского
слова-признака (
paguesпопадает вpagar), а проверка дубликатов читает испанские сроки, такие какmañanaилиel viernes.
0.61.0 — 16.10.2026
Изменения, которые могут затронуть скрипты
tg mcpиtg bot mcpбольше не принимают старые флаги доступа--allow-send,--allow-mark-read,--allow-delete,--allow-moderate,--confirm-send,--allow-dangerousи--http-confirmation(cli-core 0.292.0). Запись приложения, где остался такой флаг, перестаёт запускаться с ошибкой «unknown option»: уберите флаг; решают разрешения профиля, как и раньше.
Исправлено
-
Скрипты выпуска показывают живых держателей блокировки отдельно от устаревших меток выпуска. Общая диагностика больше не приписывает живую блокировку прошлому запуску; дождитесь, пока держатели закончат, и повторите.
-
Вход, который падает при открытии, больше не оставляет клиент Telegram открытым: если не удалось загрузить вошедшего пользователя, адаптер закрывает клиент и файл сеанса до того, как ошибка дойдёт до команды.
0.60.0 — 15.10.2026
Изменения, которые могут затронуть скрипты
- Задачи и сервер используют имена общего словаря, без псевдонимов (cli-core 0.288.0, cli-base 0.33.0):
tasks similar→tasks related;tasks duplicates unsure→tasks duplicates defer(ключ разрешенияtasks.duplicates.defer; сохранённое решение по-прежнемуunsure);tasks add --attach→--into;tasks claim --for→--lease;tasks agenda --due→--due-within;server logs --lines→--limit(-nсохранён). В MCP:tasks_related,tasks_duplicates_defer,into,lease,due_within. tasks agendaиtasks duplicatesфильтруются полями запроса, не флагами:tasks agenda --tag <name>→tag:<name>,--category <name>→category:<name>,--claimed→claimed:any;tasks duplicates --unsure→decision:unsure. В MCPtasks_agendaиtasks_duplicatesпринимаютquery.
0.59.0 — 15.10.2026
Изменения, которые могут затронуть скрипты
- Флаги используют имена общего словаря, без псевдонимов (cli-core 0.287.0):
chats members audit|fetch --budget→--max-pages;messages sync --estimate→--dry-run;contacts context --refresh,bot contacts show --refreshиtags auto --refresh-metadata→--sync-first;search conversations --refresh→--catch-up;attachments show --if-sha256→--expected-fingerprint;replies edit --chats|--not-chats|--people|--not-people→--allow-chats|--deny-chats|--allow-people|--deny-people;schedule agent|command --once→--at-time;bot chats moderate --no-ban→--no-block;chats mark-read --until→--until-id;tasks add|plan --check→--remind-time;store export --to→--output-dir, а--kind→--include;bot store fetch --from→--until-id. Аргументы MCP следуют этим именам:max_pages,until_id,expected_fingerprint,sync_first,remind_time.
0.58.0 — 15.10.2026
Что нового
- Задачи об одной работе (cli-core 0.285.0):
tasks similar <task>оценивает похожие задачи;tasks duplicates [--unsure]показывает найденные правилами пары;tasks merge <task> --into <other>объединяет их, аtasks unmergeотменяет объединение;tasks duplicates reject|unsureрешает судьбу пары.tasks agendaпринимает--categoryи--tag,config set task_categories.<name>меняет категории всего хранилища. - Упоминания (cli-core 0.285.0):
mentions domainsпоказывает сайты из ссылок;mentions list --new— найденное после последнего просмотра;mentions confirm|reject <id> --all-in-chatрешает все случаи имени в одном чате; ссылкаt.meуказывает на чат или человека.config set phone_countries es,ruчитает номера без+. - Версия хранилища 16: правила упоминаний также читают текст заметок и сохранённых документов;
один
mentions rebuildобрабатывает прежние записи.mentions listпо-прежнему показывает только упоминания в сообщениях. Добавляются лишь триггеры, поэтому старый tg продолжает открывать хранилище.
Изменения, которые могут затронуть скрипты
tasks addотклоняет возможный дубликат открытой задачи или закрытой за последние 14 дней (cli-core 0.285.0): код 2, причинаtask.duplicate-candidates, кандидаты вdetails.candidates. Повторите с--attach <task>, чтобы связать сообщение с задачей, или--new, чтобы всё же создать новую; это действует и вtasks addчерез MCP.phone:иvalue:также сопоставляют конец сохранённого номера с национальными цифрами запроса (от 8 цифр, cli-core 0.285.0). Номер, сохранённый доphone_countries, находится обоими способами. Российский городской номер в группах,(812) 000-00-01, сохраняется как+78120000001, а не голые цифры.- tg больше не ищет почту (cli-core 0.285.0, cli-core#1121):
tg search mailи MCPsearch_mailудалены,search allчитает сообщения и заметки, но не почту;--only mailотклоняется.tg search mail …отвечаетmail is memo's: install @wirecat/cli-memo, then `memo search mail …`.search notes, задачи, заметки и теги остаются.
Исправлено
- Название с кириллическими заглавными буквами находится запросом в нижнем регистре (cli-core 0.285.0).
- Вредоносное HTML-вложение больше не задерживает чтение (cli-core 0.285.0): страница с незакрытыми тегами или комментариями обрабатывается за время, линейное её размеру.
0.57.0 — 15.10.2026
Изменения, которые могут затронуть скрипты
bot api --allow-any-fileнаходится наbot api, а не каждой операции с файлами: укажите его один раз до или после имени метода, и каждый файл@pathвызова можно читать из защищённых мест. Без него файлы@pathиз каталогов учётных данных, собственных папокtgи локального хранилища отклоняются до подключения.tasks addтребует--category <name>(cli-core 0.282.0): money, documents, meeting, delivery, access, personal или other;tasks categoriesпоказывает список. Задачи получают ключи вродеQ-15;tasks claim/tasks releaseзанимают задачу для одной сессии агента.permissions— единственная настройка доступа (cli-core 0.282.0): файл сread_onlyилиallowотклоняется из-за неизвестного ключа,config migrateудалён. Настройки читаются только в snake_case;config setбольше не принимает camelCase.- Один язык поиска (cli-core 0.281.0):
--languageи--regexудалены изsearch messagesиsearches create; используйте Lucene, напримерbody:/.*invoice.*/.conversations embed --workersудалён. Сохранённый в старом языке поиск отклоняется: сохраните его заново. - Нет переноса папок при запуске: прежние папки в
~/Libraryбольше не перемещаются.
Что нового
messages syncоткрывает задачи по сохранённым сообщениям (cli-core 0.282.0): неотвеченный вопрос, упоминание вас; закрывает после вашего ответа.- Совпадение по заголовку идёт первым в
search notesиsearch all(cli-core 0.281.0).
Исправлено
- Уведомление об обновлении называет
tg upgradeи молчит лишь во времяupgrade(cli-base 0.29.0):tasks updateбольше не отключает его. - Вложенные пути полей
--jsonработают через списки (cli-base 0.31.1, cli-core 0.283.0).
0.56.0 — 14.10.2026
Изменения, которые могут затронуть скрипты
-
store exportсохраняет файлы в том же виде, что выводит на экран (cli-core 0.276.0): файлы--outputи папки--toсодержат те же записи (chat_id,sender_name,ref…). Папка от прежней версии отклоняется с сообщением "export into a new folder". -
bot apiотклоняет файлы@pathиз защищённых мест: известные файлы и папки учётных данных, собственные папкиtgи локальное хранилище — до подключения, какbot messages send --file;--allow-any-fileна операции с файлами разрешает отправить их. Файл больше 256 МиБ отклоняется без загрузки в память.
Что нового
config setиconfig unsetпринимают имена настроек в camelCase (cli-core 0.279.0):tg <profile> config set senderColors falseсохраняетsender_colors, как и написание в snake_case.- Возобновляемая синхронизация (cli-core 0.276.0): прерванный sync сохраняет обработанное, а следующий запуск продолжает с этого места.
Исправлено
- Отказ Telegram по лимиту до отправки разрешает повтор: если
messages send,messages forwardилиpolls createполучает FLOOD_WAIT до того, как Telegram принял сообщение,retry.safeравноtrueи указаноafter_ms. Если Telegram уже принял его, а лимит пришёл при проверке результата,retry.safeостаётсяfalse.
0.55.0 — 14.10.2026
Что нового
- Файлы читаются с диска по ходу отправки (cli-core 0.272.0).
messages send --file,--photo,--voice, фото профиля иtg botбольше не читают весь файл в память заранее, и отказ для файлов от 2 ГиБ убран: действует собственный лимит Telegram.
Изменено — может сломать скрипты
- Непрослушанное голосовое сообщение указывается в
missing(cli-core 0.274.0):review,inboxиmessages listдобавляют{field: "transcript", step: "messages.transcribe"}для каждого голосового сообщения без сохранённой расшифровки, поэтому ответ, в котором есть только голосовое сообщение, больше не выглядит полным. tasks link <task> task:<id>записывает связь между двумя задачами (cli-core 0.274.0), с--kind blocked-by,follow-up-ofилиrelated-to.- Следующий шаг с командой, которая меняет только этот компьютер, никогда не выполняется без спроса (cli-core
0.273.0): шаги
server restartиstore reindexсодержатsafe_to_auto_execute: false. mentions rebuildпринимает вид упоминаний аргументом:tg <profile> mentions rebuild person-name, а не--kind(cli-core 0.272.0).
0.54.0 — 14.10.2026
Что нового
-
tg images embed: поиск картинок по тому, что на них изображено (cli-core 0.268.0). Выключен, пока не заданоtg <profile> config set picture_search true; один раз загрузите модель командойtg <profile> models image download clip-b32(около 155 МБ), затем выполнитеtg <profile> images embed [--chat] [--limit]. После этогоsearch messagesвозвращает рядом с найденным списокpictures. Запросы по картинкам пишутся на английском. -
tg mentions: телефоны, e-mail, ссылки и документы Google, найденные в сохранённых сообщениях (cli-core 0.264.0, версия хранилища 7).mentions list kind:phone,mentions list domain:google.com; простое слово — это значение, записанное как угодно, поэтому89001234567находит+79001234567.mentions show <id>показывает текст вокруг упоминания. Для сообщений, сохранённых до этой версии, нужно один раз выполнитьtg <profile> mentions rebuild; новые читаются при сохранении. -
Упоминания в файлах и голосовых сообщениях (cli-core 0.269.0, версия хранилища 10). Текст, прочитанный
attachments extract, и расшифровка голосового сообщения тоже дают упоминания, сfieldfile_textилиtranscript. Для вложений с текстом, полученным до версии 10, нужно один раз выполнитьtg <profile> mentions rebuild, который теперь также считаетattachments. -
tg mentions confirm <id> [person:<uid>|organization:<id>]иmentions reject <id>решают, кому принадлежит телефон или адрес, или отклоняют его навсегда. Организация может владеть телефоном или адресом отдельно от любого человека (версия хранилища 11; старые сборки продолжают работать). -
phone:,email:,url:иdomain:в поиске сообщений находят сообщения по тому, что упомянуто в их тексте:phone:"8 900 000-00-01",email:"[email protected]",domain:docs.google.com. У почты упоминаний пока нет. -
О сбоях расписания сообщается перед любой другой командой одной строкой в stderr, пока следующий запуск не пройдёт успешно;
schedule listпоказывает серию сбоев.
Изменено — может сломать скрипты
contacts timelineразбивается на страницы, как любой другой список: список, обрезанный по--limit, отвечаетpage.has_more: true,page.cursorи шагомpage.next(--cursorпродолжает);meta.truncatedостаётся для изменений, которые ещё в очереди. Заметки «cut at --limit» в stderr больше нет.- Собрано на
@wirecat/cli-core0.269.0 и@wirecat/cli-base0.27.2. - Каждый ответ — обёртка с ключами в snake_case. Список — это
{items, page: {limit, has_more, cursor?}, next?, missing?, meta}, один объект —{item, next?, missing?, meta};meta.run_idназывает запуск. Это касается каждой команды: сообщения, чаты, контакты, запись ({item: {operation_id, send_id, message}}), inbox, review, поиск, статистика, хранилище, аккаунт, doctor, config, runs,upgrade,bot *, а также собственныеsession start|endиsetupв tg (app_keys,already_logged_in,chats.has_more). Что выполнить дальше, указывает шагnextвместо полей вродеnextBeforeId,nextOffset,nextCursorиhasMore. Ответы MCP — те же обёртки, и инструменты MCP отклоняют аргументы, которых не принимают. - Списки принимают запрос, а не параметры фильтрации.
chats list kind:group unread_count>0,chats events "Hiking" time>=7d,messages list "Book club" id<4242,contacts list notes:<text>,attachments list chat:<id> is:needs_text,store jobs list state:failed,inbox date>2h,review date>3d chat:<id>,search messages 'chat:"Book club" lease'.--search,--kind,--unread,--type,--since-time,--before-id,--after-id,--before-time,--after-time,--topic,--search-notes,--min-score,--revoked,--link,--answer,--needs-text,--state,--chatу review и--chatу search убраны из этих команд.messages evidenceиchats mediaпродолжают через--cursorизpage.next.contacts list name:требует сохранённых контактов. - Блок Telegram в
doctor— в snake_case:app_credentials,keyring_moved_by_environment,proxy.bot_api. - Подробности ошибок — в snake_case:
provider_error(былоproviderError); группа, ставшая супергруппой, сообщаетmigrated_chat_idв отказе Bot API; преобразование в форум, которое могло произойти, сообщаетprevious_chat_idиchat_id. - Настройки файла конфигурации — в snake_case (
keep_runs_for_days,sends_per_hour,read_only,default_profile, …). Существующий файл переводится сам при первом чтении. - Журналы запусков — в snake_case (
duration_ms,error_code,error_class,provider_error); запуски, записанные раньше, по-прежнему читаются. - Отчёты статистики отклоняют
--jsonl: отчёт — это один объект.stats chats showназывает свой чат ссылкойchat:;stats tasks showотвечает одним объектом сopenиrows. --json=<fields>заменяет--fieldsи--agent-json, которые убраны.--json=id,textоставляет эти поля у каждого объекта. JSON в CLI сохраняет текст сообщений как он написан; ответы MCP по-прежнему показывают невидимые символы.tags list,tasks listиconversations listпринимают запрос вместо параметров фильтрации.tags list tag:work type:chat,tags list sources:auto;tasks list state:open kind:promise chat:<id>;conversations list <chat> started_at>=7d.--tag,--type,--source,--state,--chat,--before-timeи--since-timeу этих списков убраны. Элементы — общие сущности: тег называет то, на чём стоит, какtarget, обсуждение сообщаетmessages_count,started_at,first_message.- Записи запусков хранят только перечисленные ключи атрибутов. Id сообщения в
ids.messageпока отбрасывается, поэтомуruns search <message id>его не находит (сообщено в cli-core).
Исправлено
- Промпты MCP называют только аргументы, которые принимают инструменты.
reviewпередаёт своё окно какquery(date>"…"). tg <profile> bot messages deleteпринимает больше 100 сообщений. Он отправлял все id одним вызовом, а Telegram принимает не больше 100, поэтому более длинный список завершался ошибкой. Теперь он отправляет их по 100; если следующий вызов не удаётся, ошибка говорит, сколько уже удалено.
0.53.0 — 14.10.2026
Изменено — может сломать скрипты
- Собрано на
@wirecat/cli-core0.262.0 и@wirecat/cli-base0.26.0.@wirecat/cli-core— новое имя@wirecat/cli-messaging; его версия 0.262.0 следует за 0.261.0. Команда проверки соответствия —cli-core-parity. Ключи машинного вывода пишутся в snake_case: вerror.details—operation_id,send_id,retry_after_ms; вcommands --json—global_options,inherited_options,exit_codes,takes_valueиcontract: 1. Дерево запроса в аргументе MCPastсодержитlower_inclusive,upper_inclusiveиmust_not. - HTML-файлы читаются как основной текст (cli-core 0.262.0): меню, подвалы и баннеры отбрасываются, заголовки,
списки, таблицы и ссылки остаются. Уже сохранённый текст HTML-вложений перечитывается при следующем
attachments extractи при этом меняется.title:,site:,lang:,author:иkeyword:ищут по заметкам и файлам.
Исправлено
tg config set defaultProfile <name>иconfig unset defaultProfileработают без указания профиля. Раньше они сначала требовали профиль и завершались ошибкой, если профилей было несколько (cli-core 0.262.0).tg default mcp configиmcp installуказывают профиль. Запись не содержала профиль с именемdefault, поэтому его сервер MCP останавливался на первом же вызове: tg больше не подставляет профиль сам (cli-messaging 0.260.0).
0.52.0 — 13.10.2026
Что нового
- Собрано на cli-messaging 0.259.0 и cli-base 0.24.0.
store fetchтеперь называетсяmessages sync(те же аргументы, параметры и JSON).store fetchпо-прежнему работает как скрытое устаревшее имя; документация и навык используютmessages sync.bot store fetchсохраняет своё имя. --debug: при сбое за ошибкой следует вся запись — причина и стек: в терминале после строки✗, в остальных случаях второй строкой JSON.runs listиruns searchчитают индекс по дням, поэтому отвечают за миллисекунды даже на тысячах запусков.
Исправлено
- Навык предупреждает о трёх ошибках, которые агент допустил при тестировании. Агент сравнивал простое слово в
одном инструменте с
content:в другом, читалrefтам, где поиск отвечаетlocator(илиitemsтам, где заметки отвечаютhits), и сообщал об ошибке, уже исправленной в более новой версии; цикл zsh по$cпередавал путь команды одним аргументом.
Изменено — может сломать скрипты
- Локальное хранилище и модели распознавания речи один раз переносятся в папку WireCat,
~/.local/share/WireCat/(Windows:%LOCALAPPDATA%\WireCat\Data\), при первом запуске — из~/.local/share/cli-messaging/и~/.cache/cli-common/models/. Перенос никогда ничего не перезаписывает: если в обоих местах лежат разные хранилища,tgостанавливается с кодом выхода3и называет оба файла.WIRECAT_STATE_DIRзаменяетCLI_COMMON_CACHE_DIRи переносит всю папку. Обновляйтеmaxиmemoвместе сtg: более старая версия создала бы новое хранилище на старом месте. Где tg хранит свои файлы. - Один объект ошибки:
{"error":{"code","reason","message","details"}}. То, что раньше лежало на верхнем уровнеerror—candidates,sendId,operationId,permission,retryAfterMs, — теперь находится вerror.details.reason— идентификатор через точки (output_limit→output.too-large,input_limit→input.too-large);retryableпоявляется только там, где его задаёт сбой, аactions— только у неудавшихся элементов частичного результата. Код выхода1— этоinternal_error(раньшеgeneric_failure), и его сообщение больше не содержит собственный текст сбоя; его показывает--debug. runs showпоказывает только то, что пошло не так (неудачные ответы, предупреждения, аварийное завершение), и добавляетeventCount;-v, как и раньше, показывает все события.tgникогда не выбирает профиль за вас. Команда, которая работает с аккаунтом и не называет профиль (нет первого слова, нетTG_PROFILE, нетdefaultProfileв файле настроек), останавливается с кодом выхода2, а не используетdefault— даже еслиdefaultединственный профиль. Это ломает все существующие установки с одним профилем:tg chats listтеперь завершается ошибкой. Ошибка перечисляет профили на этом компьютере, так что решение есть в самом сообщении:tg default chats list,export TG_PROFILE=defaultили"defaultProfile": "default"в файле настроек. На новом компьютере первый вход —tg personal setup(имя любое).--help,--version,commands,skill show,account listиconfig showпо-прежнему работают без профиля. Клиентам MCP и заданиям по расписанию, которые запускаютtg mcpилиtg serveбез профиля, нужно его добавить.store fetchбота использует только данные приложения и личную сессию своего профиля, а не профиляdefault.
0.51.0 — 12.10.2026
Что нового
-
--briefи--fullу каждой команды.--briefоставляет у найденного сообщения ссылку, чат, время, отправителя, отрывок и оценку;--fullоставляет всё. -
tg search allназывает автора каждого результата и то, как он найден (по словам или по смыслу). -
tg schedule: запуск команды или агента по таймеру через systemd (Linux), launchd (macOS) или Планировщик заданий (Windows).tg schedule command <name> --every 2h -- messages list <chat>запускает команду tg; чтение сохраняет прочитанное.tg schedule agent <name> claude "<prompt>" --at 08:30запускает агента (claude или codex), не чаще раза в час. Агент работает сTG_READ_ONLY=1и не может отправлять; его ответ сохраняется какlatest.mdрядом с расписанием, а уведомление на рабочем столе сообщает, что он готов.--once 2hзапускает один раз, после чего удаляет расписание.tg schedule list,runиremove. -
tg server installпредлагает команду для ежедневной проверки незакрытых дел и ничего не включает сам. -
TG_READ_ONLY=1запрещает процессу любую запись, главнее файла настроек и--permission.
Изменено — может сломать скрипты
tg search messagesвозвращает отрывок, а не весь текст. Каждый результат содержитexcerpt— около 240 символов вокруг первого слова запроса — вместоtext; весь текст сообщения дают--fullилиtg messages show <ref>. Пустые (null)editedAt,replyTo,forwardedFromиreactionsне попадают в машинный вывод. Скрипт, который читалtextиз результатов поиска, должен читатьexcerptили добавить--full.
0.50.0 — 11.10.2026
Что нового
- У задач появились план, связи и ежедневная повестка (общее хранилище 0.247.0, версия 4).
tg tasks addпринимает--title,--description,--dueи--check;tg tasks plan <task>меняет их позже,noneочищает дату. Следующая проверка — это время, когда агенту стоит снова посмотреть на задачу, а не напоминание: владельцу ничего не приходит.tg tasks linkсвязывает задачу с сообщениями, чатами, людьми, документами и URL;tg tasks showпечатает план со связями.tg tasks agendaбез текста сообщений перечисляет просроченные задачи и задачи с близким сроком, чаты, где ждут вашего ответа (owed), чаты, где вы ждёте других (waiting), и чаты, чьё новейшее сообщение не сохранено (unsynced).tg skill show follow-ups— ежедневный порядок работы для агента: только черновики, он никогда не отправляет.
Изменено — может сломать скрипты
- Общее хранилище 0.247.0: контекст встречи записывает факты через
fact.add;memory.addбольше не принимает видfact.
Исправлено
- Закреплён общий пакет 0.248.0 с записями проверки соответствия для отслеживания задач. Проверки релиза теперь распознают планы задач, связи, карточки, повестку и их параметры.
0.49.0 — 11.10.2026
Что нового
- Поиск принимает запись сравнения через двоеточие.
date:>=2026-01-01(а также:>,:<,:<=) означает то же, чтоdate>=2026-01-01; раньше такая запись завершалась ошибкойinvalid_syntax. Отклонённыеafter:илиbefore:теперь называют замену:after:2026-09-01предлагает использоватьdate>=2026-09-01.
Изменено — может сломать скрипты
- Общее хранилище 0.246.0 перед созданием сверяет новые метки с каноническими именами и псевдонимами. Похожие имена требуют проверки владельцем; используйте существующую метку или её явный псевдоним. Существующие метки и данные остаются, а автоматические совпадения по каноническому имени и по псевдониму засчитываются как одно утверждение.
0.48.1 — 11.10.2026
Что нового
- Общее хранилище 0.242.0: существующие идентификаторы проектов и задач сохраняются; новые проекты получают короткие ключи, а хранилище умеет проверять, какие задачи от каких зависят.
Исправлено
- npm снова устанавливает пакеты рядом друг с другом. Собрано на
@wirecat/cli-messaging0.241.0, чей@wirecat/cli-meetings0.4.2 принимает cli-core 0.20.0. С 0.240.0 npm помещал cli-messaging во вложенную папку со второй копией cli-core.
0.48.0 — 11.10.2026
Что нового
--sourceпринимает список аккаунтов и групп вsearch messages,search mailиsearch conversations:--source group:work,tg:mila,email:[email protected]ищет ровно в них. Элемент списка — группа,app:account(профиль любого приложения —max:defaultработает из tg, — идентификатор аккаунта или его имя) или обычное слово--source.config set accountGroups.<name> <list>сохраняет группу для всех приложений.- Общее хранилище обновляется до версии 2 при первом открытии в tg. Факты — что было сказано, спрошено, решено
или обещано — получают собственную таблицу рядом с воспоминаниями; воспоминания вида
factпереносятся туда, а назначения задач копируются в отдельную таблицу. Более старые tg, max или memo по-прежнему открывают обновлённое хранилище.
Изменено — может сломать скрипты
- В macOS tg хранит файлы там же, где в Linux:
~/.config/tg-cli,~/.local/share/tg-cliи~/.cache/tg-cliвместо~/Library/…. Первый запуск переносит туда старые папки вместе с общим хранилищем и моделями распознавания речи и направляет установленный агентtg serverна новый журнал. Пока работаетtg serveили сервер MCP, он один раз выводит предупреждение, на этот запуск оставляет старые папки и пробует снова в следующий раз. Linux и Windows не меняются. - Удаление данных аккаунта удаляет и людей, которых видел только этот аккаунт. Человек остаётся, пока на него ссылается другой аккаунт, метка, заметка или любая другая запись.
- Почта ищется по смыслу по веткам. Первый проход индексации после обновления заново делит каждую ветку и ещё раз вычисляет эмбеддинги почты; поиск по словам не меняется.
Исправлено
- Удаление данных аккаунта, в котором были встречи, больше не завершается ошибкой, а удаление убирает векторы, которые использовал только этот аккаунт.
- На
@wirecat/cli-messaging0.238.0.
0.47.0 — 11.10.2026
Что нового
messages list --limitвозвращает столько сообщений, сколько запрошено. Telegram отдаёт не больше 100 за запрос, и--limit 500раньше останавливался на 100 сhasMore: true; теперь команда читает дальше страница за страницей (cli-messaging 0.235.0).- Опрос в
messages listсодержит вопрос, варианты ответа и общее число голосов вproviderMetadata.poll, так что опросы канала читаются без отдельногоpolls showдля каждого сообщения.
Исправлено
messages comments --limit 100(или больше) сообщает, что остались более старые комментарии. Чтобы это узнать, команда запрашивала у Telegram на один комментарий больше лимита, но Telegram возвращает не больше 100, поэтому ветка из 1600 комментариев отвечала 100 комментариями сhasMore: false. Теперь команда запрашивает не больше 100 и считает полную страницу признаком того, что есть ещё.polls showпоказывает общее число голосов до того, как вы проголосуете. Telegram в любом случае присылает общее число; только число голосов за каждый вариант ждёт вашего голоса. Раньше общее число тоже былоnull.- На
@wirecat/cli-messaging0.235.0.
0.46.3 — 11.10.2026
Изменено — может сломать скрипты
- Вступление в чат и импорт контактов учитываются в
sendsPerHour. Вступление считается за одно, импорт — за одно на каждый номер;tg contacts importотправляет по 10 номеров за запрос. Если лимит останавливает импорт на полпути, ошибка сообщает, сколько номеров ушло, и что повторный импорт безопасен.
Что нового
tg bot watchпечатает и сохраняет обновление один раз, даже если Telegram доставляет его снова после перезапуска: каждое обновление записывается поupdate_idи пропускается после обработки. С--events --jsonlкаждая строка содержитupdate: { id, kind }.tg search all --backend archive|server|bothи--server-time, как уsearch messages; они действуют только на сообщения, почта и заметки всегда ищутся локально. По умолчанию —both.tg search mail --account <address>ищет в одном почтовом ящике; без него — во всех. Почту можно искать и по получателю, папке и теме (to:,cc:,bcc:,mailbox:,subject:), а вложения — по смыслу.
Исправлено
tg store fetch --allпережидает короткий FLOOD_WAIT при получении списка чатов (до 5 минут, как уже делали страницы сообщений), а не сразу завершается сrate_limited; ожидание в 21 с обрывало каждую загрузку пустого хранилища. Вошло в 0.46.2, но там не указано.- Листание чатов (
store fetch --allполучает их по 100) читает каждый диалог из Telegram один раз. Раньше каждая страница заново проходила все диалоги с начала, и около 1400 чатов стоили больше 100 запросов подряд вместо примерно 15. chats members list --allвыдерживает 1 с между страницами по 200 участников. Раньше он запрашивал до 50 страниц подряд, хотя страница о лимитах говорила, что темп ограничен.
Безопасность
- Поиск больше не отвечает сообщениями другого аккаунта.
search messages --backend serverс--source allилиin:allмог вернуть сообщение другого аккаунта с теми же id чата и сообщения, а id чата без аккаунта совпадал с этим чатом во всех аккаунтах; оба случая исправлены. - Работает на
@wirecat/cli-messaging0.233.0.
0.46.2 — 11.10.2026
Исправлено
- Поиск в архиве с
--discoverобрабатывает вопросы о правах доступа вроде «Есть ли у подрядчиков доступ к продакшену?», не превращая последний вопросительный знак в подстановочный. Строгий поиск и фильтры работают как прежде. - Поиск почты и контекст связанного человека читают также отдельное хранилище писем, наряду с прежним импортом. Почта поддерживает фильтры отправителя и цепочки; в поисковой выдаче каждое письмо со своей ссылкой показывается один раз.
- Фоновая загрузка истории больше не останавливается на стандартном 30-секундном пределе; явный
--timeoutпо-прежнему действует.
Изменено — может сломать скрипты
- Неустранимый сбой загрузки истории до первой сохранённой страницы теперь завершает команду ошибкой, а не
кодом
0сissue. Загрузка истории бота без начального сообщения завершается с кодом2и просит--from. Сбои после того, как часть сохранена, по-прежнему дают частичный результат.
0.46.1 — 11.10.2026
Исправлено
- Названия пакетов, документация и примеры используют пространство имён WireCat.
Изменено — может сломать скрипты
- Независимый отказ файла или страницы истории сохраняет успешную часть и возвращает
complete: false,batchилиissueс кодом выхода0. Скриптам нужно проверять полноту; JSONL загрузки добавляетbatch_summary. Ошибки содержатactionsдля восстановления. Повтор загрузки учитывает неудачные ID checkpoint. - Пакет прекращает новые запросы после десяти попыток, если доля ошибок выше 50%;
MESSAGING_BATCH_MAX_ERROR_PERCENTменяет процент, а 100 отключает этот процентный останов. Ограничение частоты и отказ авторизации останавливают раньше; запись с неизвестным исходом не повторяется автоматически.
Что нового
- Размер файла для извлечения и передачи настраивается через
MESSAGING_ATTACHMENT_MAX_MIB(по умолчанию 50). PDF-превью теперь допускает 4000 пикселей по стороне и 8 МиБ;MESSAGING_PDF_PREVIEW_MAX_PIXELSиMESSAGING_PDF_PREVIEW_MAX_MIBменяют эти пределы. Большие значения требуют больше памяти; пределы внешнего OCR и распаковки остаются отдельными. tg runs searchи командаruns searchв MCPtg_readищут безопасные диагностические записи по тексту, статусу, коду ошибки и времени без подключения к мессенджеру.
0.46.0 — 11.10.2026
Изменено — может сломать скрипты
- Локальная копия сама чистит растущие журналы при открытии, не чаще раза в день: вызовы инструментов агентом старше 90 дней удаляются, а у обработанного обновления бота старше 30 дней строка остаётся, но содержимое стирается. Обновите max-cli и cli-memo одновременно: копия у них общая.
Что нового
tg store reset— для копии, которую эта сборка не может перенести на новую схему: сохраняет её рядом, удаляет и создаёт пустую. Сначала спрашивает;--yesпропускает вопрос,--no-backup— копию.tg search all --meetings [provider:account]ищет ещё и в одной учётной записи встреч: расшифровки, чат и итоги;--max-meetings <n|all>задаёт, сколько встреч просмотреть (по умолчанию 100).
Безопасность
- Старый
messages.dbудаляется при открытии копии по пути по умолчанию: незашифрованный файл, который был доwirecat.db, вместе с-walи-shm. Одна строка в stderr называет его. Файл остаётся, если заданMESSAGING_STOREили пока его держит открытым другой процесс. Из@wirecat/cli-messaging0.222.0.
0.45.0 — 10.10.2026
Изменено — может сломать скрипты
- Локальная копия теперь в новом файле
wirecat.dbи после обновления пуста. Он лежит рядом со старымmessages.db, которыйtgоставляет как есть: не читает, не переносит, не удаляет.tg store fetch --allзаново скачивает сообщения из Telegram. То, что есть только на этом компьютере, — например заметки, псевдонимы, метки, задачи и расшифровки — остаётся вmessages.db. Вход сохраняется. Обновите max-cli одновременно, иначе они будут видеть разные архивы.
Что нового
tg contacts timeline <person>, и через MCP — командаcontacts timelineвtg_read: всё, в чём участвовал один человек, во всех связанных с ним мессенджерах, новое сверху, из локальной копии.--scope personal|work,--since-time,--until-timeи--limitсужают выдачу.
0.44.1 — 10.10.2026
Исправлено
- Локальное извлечение текста PDF и просмотр страниц принимают документы длиннее 20 страниц; извлечение следует отмене команды вместо отдельного тайм-аута в 30 секунд. Ограничения размера файла и изображения сохраняются.
- Локальная расшифровка принимает полные записи Ogg Opus с одним или двумя каналами длиннее десяти минут. Длинным записям нужно больше памяти и времени на обработку.
- Вложения из обычных скрытых рабочих папок разрешены. Известные файлы с учётными данными, папки CLI и хранилище сообщений остаются защищены.
- Экспорт Markdown сохраняет форматирование сообщений. Аргументы записи MCP сохраняют исходные символы Unicode, а возвращаемый текст по-прежнему показывает невидимые управляющие символы; настроенные шлюзы моделей поддерживают обычные перенаправления.
- Обновление и настройка MCP в Windows поддерживают обычные относительные записи PATH и пользовательское окружение командного процессора. Эта версия сохраняет существующую схему хранилища сообщений.
- Руководство по поиску различает запросы к локальному архиву с discovery или offline и обычный поиск слов через сервер: пустой локальный архив не означает, что поиск в Telegram был выполнен.
0.44.0 — 10.10.2026
Что нового
- Поиск сообщений с
--discoverили MCPdiscover: trueнаходит частичные совпадения слов и подходящие прямые ответы в локальном архиве без скачивания моделей. Строгий поиск остаётся по умолчанию; совпавшие и отсутствующие слова помогают агенту проверить основания ответа.
0.43.1 — 10.10.2026
Изменено — может сломать скрипты
- Проект распространяется по лицензии Apache License 2.0. Условия — в
LICENSE.
0.43.0 — 10.10.2026
Изменено — может сломать скрипты
- Пакет называется
@wirecat/tg-cli, репозиторий находится в WireCatLabs. Используйте этот пакет для установки и обновления. - Локальная расшифровка принимает полную запись Ogg Opus с одним или двумя каналами до 10 минут. Более длинную запись разделите. Извлечение текста PDF ограничено 20 страницами и 30 секундами.
- MCP делает невидимые управляющие символы видимыми в текстовых результатах и аргументах записи, включая декодированную разметку. Эмодзи флагов отдельных регионов сохраняются; обычный JSON CLI сохраняет исходные строки.
Исправлено
- После обновления перезапуск сервера вызывает Node напрямую с отдельными аргументами и сохраняет выбранное окружение, в том числе пути с пробелами в Windows. Неверные имена профилей в файлах блокировки пропускаются.
Безопасность
- Извлечение текста из папки и передача сохранённых вложений не читают скрытые пути, собственные папки CLI и хранилище сообщений, в том числе через ссылки. Загрузка через MCP также не пишет в эти места.
- DOCX проверяется тем же ограниченным читателем архивов офисных форматов до загрузки содержимого документа.
0.42.0 — 09.10.2026
Изменения, влияющие на скрипты
- Автоответы отвечают всем, кто соответствует вашим правилам, если вы не ограничиваете аудиторию; отдельный список
testersисчез.tg replies audience --reply listed --allow-people <ids>отвечает только избранным людям;--deny-peopleи--deny-chatsисключают отдельных людей и чаты. Ничего не отправляется, покаpermissions.replies.sendне станетallow, а новое правило отключено, пока вы его не включите. Файл правил, в котором все еще естьtesters, продолжает отвечать тем же людям: они становятся разрешенными людьми (только теми, кому аудитория также разрешила, если это уже былlisted). Разрешенные чаты в таком файле удаляются, поскольку в них будут открываться ответы всем участникам этих чатов; списки запретов остаются. Файл перезаписывается безtestersпри следующем редактированииtg replies. tg replies status --jsonбольше не имеетtesters; подсчетыaudienceговорят, кому можно ответить. Вtg replies testиserveотправитель, не входящий в аудиторию, пропускается с надписью «не в списке разрешений» вместо «не тестовый аккаунт».
0.41.0 — 09.10.2026
Изменения, влияющие на скрипты
- Хранилище сообщений удаляет копии, сохраненные для более старых версий (версия хранилища 28, cli-messaging 0.212.0). Заметки, заметки о контактах, связи и сущности, написанные до рефакторинга заметок, копируются в новые таблицы один раз во время обновления. После него старые tg, max и memo отказываются открывать архив с сообщением "upgrade this tool" - обновляйте все три вместе.
0.40.1 — 09.10.2026
Исправлено
tg search allничего не находил в новом хранилище. Он искал только по аккаунтам, уже записанным в хранилище, поэтому до первого сохранения не искал нигде; теперь он всегда включает аккаунт этого профиля и обращается к серверу так же, какtg search messages.tg search mailбез импортированной почты возвращает пустой результат с пояснением в stderr, а не завершается ошибкой.- Заметки, найденные только слабым совпадением по смыслу, отбрасываются, поэтому редкое слово больше не возвращает все заметки.
0.40.0 — 09.10.2026
Что нового
tg topics show <chat> <topic>показывает одну тему форума: её название, закрыта ли она или закреплена, непрочитанные сообщения и последнюю активность.tg messages forward --topic <id>пересылает в тему форума группы--to. Тема сначала проверяется, как вmessages send --topic; тема 1 — General.tg attachments show --page 1возвращает страницу сохранённого PDF как PNG. Удалённые агенты, чьи приложения не открывают встроенные PDF, могут читать страницы как изображения; для рендеринга нужны необязательные пакетыunpdfи@napi-rs/canvas.
Изменено — может затронуть скрипты
-
--answererв статистике принимает сохранённые имена, псевдонимы и @username. Разрешение остаётся локальным в аккаунтах выбранной истории; для неоднозначных имён возвращаются кандидаты в пределах области. Неизвестные имена теперь дают ошибку, а не выдуманного человека с нулём ответов. Чтобы явно выбрать ещё не встречавшийся непрозрачный ID, используйтеperson:provider/account/id. В строки ответа добавленоidentityKnown; у ID без наблюденийidentityKnown: falseиstatus: unknown. Ноль замеченных ответов не доказывает неактивности (статистика). -
Весь поиск перенесён в
tg search. Старых команд больше нет:Инструменты для агентов перенесены так же:
search messages,search conversations,search topicsи новыйsearch all, с которого стоит начинать. -
tg search messagesникогда не возвращает почту. Сохранённый поиск сin:emailтеперь предлагает использоватьtg search mail. -
Права, названные по старым путям (
messages.search,conversations.search,topics.search), блокируютtg search, покаtg config migrateне переименует их с сохранением уровней.
0.39.1 — 08.10.2026
Исправлено
- Общая библиотека сообщений закреплена на 0.205.0, как у Memo и MAX, для совместной установки.
0.39.0 — 08.10.2026
Что нового
tg polls create --close-time 5mавтоматически закрывает опрос через заданное время: от 5 секунд до 10 минут.tg polls voters <chat> <message> [--answer <id>]показывает, кто за что голосовал в неанонимном опросе. Если Telegram отвечает, что сначала нужно проголосовать самому или что канал скрывает проголосовавших, ошибка так и говорит.tg chats link update --expire-time neverснимает срок действия ссылки. Основную ссылку группы тоже можно менять; справка больше не утверждает обратное.tg store jobs list --state <state>фильтрует фоновые задачи: running, done, failed, cancelled или died.
Изменено — может затронуть скрипты
tg chats link createиupdateотклоняют сочетание--approvalи--max-uses. Telegram молча снимал лимит вступлений при включении одобрения; теперь нужно выбрать одно.- Латинские слова ищутся по основам английского и испанского одновременно. Раньше использовался только испанский, и английские формы слов («budgets» → «budget») находились хуже. Учтите: после обновления индекс основ перестраивается сам — небольшой архив при открытии, большой по частям:
tg serveдостраивает его в фоне,tg store migrate— сразу. Пока индекс не готов, поиск находит только точные формы слов, сообщает об этом в stderr, а в JSONquery.stemming.appliedравноfalse. Индекс основ для латиницы примерно вдвое больше. Заданное вами значениеsearchStemmers.latinсохраняется, иtg store reindexпо-прежнему его применяет. Обновите иmax: старая версия, открыв перестроенный архив, отвечает на поиск по основам просьбой обновить инструмент (архив). - Заметки о человеке (
tg contacts notes) видны во всех профилях, где он доступен. Раньше — только в профиле, где их написали. Почему: заметки принадлежат вам, а не одному аккаунту; общий архив теперь хранит их отдельно от сообщений, вместе с заметками изmemo. Учтите: при нескольких профилях Telegram заметки о человеке из всех них теперь показываются вместе. Свои имена (contacts alias) по-прежнему действуют только в своём профиле.
Исправлено
tg polls voters --answer <id>правильно указывает выбранный ответ. Без--answerбольше не сообщает о дополнительных голосах, когда показаны все.
0.38.0 — 08.10.2026
Новое
tg account listпоказывает все профили на компьютере, аккаунт каждого и его имя. В Telegram не обращается.
Исправлено
tg session startсообщает «Already logged in», если сессия работает и ничего не запрошено; для повторного входа предлагаетsession end. Раньше это выглядело как вход без кода. В--jsonдобавленоalreadyLoggedIn.tg session start phone --smsпродолжает вход, если Telegram не может отправить SMS (SEND_CODE_UNAVAILABLE): сообщает об этом и просит уже отправленный в приложение код.tgи группы без подкоманды (tg account,tg chats) снова показывают справку в терминале вместо✗ (outputHelp). Скрипт или--jsonполучаетvalidation_errorс просьбой указать команду.
0.37.0 — 08.10.2026
Новое
- Агент читает чаты одной папки по именам через MCP, как
tg chats folders show(tg_read, command:chats folders show). tg chats link update <chat> <link> [--approval | --no-approval] [--expire-time] [--max-uses]меняет одну дополнительную ссылку: меняются только заданные параметры.- Сохранённые файлы для удалённого агента:
attachments showпередаёт ограниченные порции с SHA256 всего файла. MCP возвращает целые изображения или бинарные ресурсы с запасным JSON/base64. Передача не распознаёт и не индексирует текст; агент читает файл и сохраняет результат (вложения). - Общая библиотека добавляет наблюдаемые когорты удержания и наблюдения счётчиков со свежестью каждого поля; неизвестное остаётся явным.
Изменения, которые могут сломать скрипты
- JSON рейтингов и доказательств содержит наблюдения счётчиков и свежесть; evidence принимает выборки когорт удержания. Проверяйте каждое поле и вид selection; неизвестные значения и неполный архив не означают ноль.
0.36.0 — 08.10.2026
Новое
tg polls create --quiz --correct <n> [--solution <text>]создаёт викторину: один правильный ответ по позиции от1; голос окончательный.- Сохранённые отчёты администратора находят вопросы без наблюдаемого ответа, время ответа выбранных людей, помощь после известного вступления и просмотренные посты с малым обсуждением. Покрытие/evidence показывают границы данных; история сохраняет параметры/selection.
tg chats folders show <folder>показывает папку и названия чатов, закреплённых и исключённых. Названия сначала берутся из архива; Telegram спрашивается только о недостающих.tg metadata refresh --only-missingчитает описания только там, где их ещё нет; без--chat— все сохранённые группы/каналы до--limit.tg store jobs retry <job>запускает неудачное или прерванное задание с теми же опциями;--failed— каждый чат с таким последним заданием.tg store jobs clearудаляет завершённые задания и журналы.tg session start phone --smsпросит отправить код по SMS; способ выбирает Telegram, CLI сообщает фактическую доставку.tg topics delete <chat> <topic>удаляет тему и все сообщения у всех. По умолчанию спрашивает;--allow-dangerousпропускает вопрос.- Текст вложений читается локально: ODT, ODS, XLSX, PPTX, EPUB, UTF-16 с BOM и уверенно определённые старые кодировки. Без модели; формулы не вычисляются, картинки остаются агенту (поиск).
- Правила папок в
tg chats folders create|update:--includecontacts, non-contacts, groups, channels, bots;--skipmuted, read, archived;--exclude-chat,--pin,--emoji.folders listпоказывает правила.
Изменено — может сломать скрипты
tg chats folders joinсообщает о неверной/истёкшей ссылке с кодом6;folders orderвозвращает только id и название.tg chats folders create|updateвозвращают реально сохранённую папку: Telegram отбросит--emoji, если это не его значок папки; раньше CLI сообщал, что он установлен.
0.35.0 — 08.10.2026
Новое
tg chats requests list --search <name>или--link <link>сужает список запросов — по имени либо до тех, что пришли по одной ссылке; Telegram не позволяет сочетать оба фильтра.tg polls showсообщает, является ли опрос викториной (quiz), можно ли изменить голос (revote) и создали ли вы его (creator) — закрыть опрос может только его создатель.tg polls voteиtg polls closeдо отправки отклоняют то, что отклонил бы Telegram: закрытый опрос, два ответа в опросе с одним ответом, изменение или отзыв окончательного голоса,--retractбез голоса и закрытие чужого опроса. Отказы Telegram при работе с опросами теперь объясняют, что делать, вместо «Telegram refused: X», а тайм-аут чтения опроса больше не сообщает, что голос мог быть отправлен.tg chats requests accept|decline <chat> --all [--link <link>]обрабатывает все ожидающие запросы сразу, аtg chats link list/tg chats link revokeпоказывают ваши ссылки запросы и прекращают их действие. Принятие с--allпроверяется с учётом почасового лимита до того, как кого-либо впустят.- Рейтинги сохраняют связи ответов Telegram и связанные обсуждения каналов, поэтому показатели бесед используют эти связи, когда они доступны; неоднозначные связи с темами форума остаются неизвестными.
- Руководство по рейтингам объясняет показатели, оценки, охват, сохранённые выборки и подтверждающие данные. Повторное выполнение сохранённой выборки теперь сохраняет исключающие границы дат.
tg store fetch --allзагружает все чаты — последние 90 дней каждого, сначала недавно активные;--backgroundзапускает загрузку как задание. Это нужно для поиска: подготовьте архив.- Ваши имена и заметки о людях:
tg contacts aliasиtg contacts notes, хранящиеся только на этом компьютере;contacts show --with-notesиcontacts list --search-notesпоказывают их и выполняют поиск (люди). - Автоматические теги для групп и каналов:
tg metadata refreshиtg tags auto, по названию и описанию, без изменения ваших собственных тегов (поиск).
Изменения, влияющие на скрипты
-
Каждый поиск сообщает, какие данные проверил. Одна строка в терминале показывает число проверенных сообщений и чатов, чаты, которые ещё не загружались или устарели, и команду для исправления ситуации;
coverage.nextв JSON сообщает агенту, что выполнить. -
Руководства по поиску теперь верно описывают существующее значение по умолчанию (
--backend both). Поиск по словам обращается к Telegram и локальному архиву, как уже в 0.34.0. Для поиска только в архиве используйте--backend archive. Подсчёты черезstats, поиск тем и запросы, которые сервер не поддерживает, по-прежнему читают только архив. -
tg chats joinдля группы с одобрением вступления администраторами отвечаетrequested: trueи завершается с кодом0, вместо кода11: запрос и раньше успешно отправлялся. Скрипт, считавший код выхода 11 признаком отправленного запроса, теперь читаетrequested.
0.34.0 — 07.10.2026
Новое
-
tg stats messages topиtg stats contacts topранжируют сохранённые сообщения и их авторов, аevidenceпод каждой командой показывает сообщения, подтверждающие место в рейтинге. Они читают только локальное хранилище и не обращаются к Telegram;searches create --selectionсохраняет такой рейтинг как поиск. -
Каждый профиль теперь имеет общее ограничение частоты запросов для всех использующих его процессов
tg. Две одновременные команды, фоновые заданияstore fetch,mcpиserveраньше ограничивали частоту отдельно, поэтому несколько процессов умножали частоту запросов; теперь у них общий лимит — пакет из 20, затем один запрос в секунду. Назначенное Telegram ожидание блокирует весь профиль, а запрос, которому пришлось бы ждать более 5 минут, сразу завершается с кодом выхода8. Массовая работа, запущенная параллельно, занимает больше времени.requestsPerMinuteилиTG_REQUESTS_PER_MINUTEменяет частоту; limits.md объясняет все правила. -
tg messages send --htmlиtg messages edit --htmlчитают HTML Telegram —<b>,<i>,<u>,<s>,<a href>,<code>,<pre>,<blockquote>,<tg-spoiler>— сохраняя введённые переводы строк (использование). -
tg messages send --file … --filename <name>отправляет файл с именем, которое видят другие. -
tg messages list <chat> --topic <id>читает одну тему форума, назад от последнего сообщения или--before-id. -
tg chats folders orderрасполагает папки в указанном вами порядке, аtg chats folders join <link>добавляет папку, которой поделились через ссылкуt.me/addlist/, вступая в каждый её чат. -
tg chats link create <chat>создаёт ещё одну ссылку запросы:--approvalтребует сначала запросить вступление,--expire-timeи--max-usesограничивают ссылку;tg chats update --join-approval on|offтребует запроса от всех вступающих. Обе возможности работают как в частных, так и в публичных группах. -
tg chats requests list <chat>показывает запросивших вступление в группу с одобрением, аtg chats requests accept|decline <chat> <person>обрабатывает один запрос. Запросы видят только администраторы; принятый запрос учитывается в почасовом лимите, как добавление участника. -
tg messages search --backend bothобращается к Telegram и архиву. Результаты Telegram сохраняются и проверяются тем же запросом, поэтомуexact:,-wordи ранжирование сохраняют своё значение; каждое сообщение указывает, пришло ли оно из архива, Telegram или обоих источников.--backend serverпоказывает только результаты Telegram;--server-timeограничивает ожидание (5 с). По умолчанию используетсяboth(поиск). -
tg chats mark-read <chat> --topic <id>помечает одну тему форума прочитанной, до--untilили её последнего сообщения, не меняя состояние остального чата. -
tg topics edit <chat> <topic>переименовывает (--title), закрывает или открывает (--closed on|off), закрепляет или открепляет (--pinned on|off) тему форума, а также скрывает или показывает тему General (--hidden on|off);tg topics order <chat> <topic...>упорядочивает закреплённые темы. Обе команды безопасно повторять. -
tg messages send --spoilerразмывает фото или видео до нажатия, а--caption-aboveразмещает текст над ним. Спойлер для документа или голосового сообщения отклоняется. -
tg chats send-as <chat>показывает, от чьего имени вы можете публиковать в группе, а--send-as <id>выбирает одно из них — вtg messages send(включая файлы),tg messages forwardиtg polls create. В списке всегда есть вы и отмечен сохранённый выбор группы; чтение ничего не меняет. Идентификатор вне списка отклоняется.
Изменения, влияющие на скрипты
- Отправка, пересылка или опрос без
--send-asв группу, которая по умолчанию публикует от имени канала, отклоняется (код выхода2), вместо отправки от имени канала. Ошибка указывает--send-as <your id>для публикации от своего имени и--send-as <channel id>для публикации от имени канала.
0.33.0 — 07.10.2026
tg contacts profileиtg contacts checkоценивают возраст аккаунтов, созданных до августа 2026 года. Таблица оценки месяца регистрации по идентификатору аккаунта заканчивалась ноябрём 2025 года, поэтому самые новые аккаунты не получали оценки. Идентификаторы конца 2025 года теперь дают дату до четырёх месяцев позже, ближе к реальной дате создания. Погрешность оценок для 2026 года — около трёх месяцев;source: "estimate"по-прежнему отмечает каждую оценку.- OCR вложений через общий шлюз. Обычно агенты сами читают изображения и сканы и
записывают текст через
attachments text set. Явная массовая обработка используетattachments extract --ocr,models.ocrи ограниченный--concurrency; полный текст попадает в существующий индексcontent:. Кеширование по хешу и модели предотвращает повторные вызовы, а ошибки сохраняют текст агента и прежний проиндексированный текст.
0.32.0 — 07.10.2026
Новое
tg messages comments <channel> <post>читает комментарии под публикацией канала, аtg messages send --comment-to <post>пишет комментарий. Комментарии находятся в группе обсуждения канала; публикация без неё даёт код выхода6.tg contacts profileперечисляет прежние имена и имена пользователей вaliases, сначала старые, со ссылкойt.meдля прежнего имени пользователя. Локальное хранилище теперь сохраняет имя или имя пользователя при его изменении. См. Люди.
0.31.0 — 07.10.2026
Новое
-
Извлечение файлов через MCP, явно указанные каталоги и
messages download --extract; изменения файлов проверяются по хешу содержимого. После загрузки истории возможна локальная подготовка с ограничениями, по умолчанию выключенная.store gaps planиstore gaps repairпроверяют записанные внутренние пробелы и явно устраняют их с ограничениями и возобновляемыми заданиями; неизвестные края и неоднозначные страницы остаются в ожидании. -
tg stats chats official <chat>: статистика самого Telegram для управляемой вами супергруппы или канала, как в приложениях Telegram — общие показатели в сравнении с прошлым периодом, ведущие авторы, администраторы и приглашающие (супергруппы), последние публикации и доля включённых уведомлений (каналы), а также все графики в виде рядов JSON. Только чтение. Работает там, где Telegram показывает вам статистику; иначе завершается ошибкой разрешения или проверки. См. Группы, которыми вы управляете. -
cli-messaging 0.162.0 также добавляет
store gaps repair, параметры подготовки дляstore fetch,messages download --extractиattachments extract --from-dir/--cursor. -
У конфигурации, разрешений и профилей отдельные руководства. Настройка начинается с расположения файлов и обычных задач; полный справочник настроек остаётся доступным.
Изменения, влияющие на скрипты
-
Конфигурация разделена на краткое руководство и полный справочник ключей, типов, значений по умолчанию, областей действия и переменных окружения. Публичный контракт CLI описывает выполнение без интерактивного ввода, схемы, ограничения, предварительный просмотр и правила повторных попыток.
-
Проверка переносимых метаданных навыка, установленной версии, путей команд и полноты охвата ключей конфигурации в CI. Встроенный вход и необязательные вопросы настройки соблюдают общую политику запрета интерактивного ввода.
-
Первое определение настроек создаёт config.json. Существующие файлы сохраняются; переопределения из окружения и флагов не записываются. config show теперь может создать файл, а обычные значения указывают значения по умолчанию из файла как свой источник.
-
Поиск слов и фраз учитывает словоформы. Запросы в скриптах могут возвращать больше сообщений. Используйте exact: или --exact для прежнего поиска точной формы; явное text: по-прежнему учитывает словоформы. Языковые настройки архива влияют на совпадения.
Исправления
-
Подготовка поиска соблюдает readonly или запрет
conversations.linksдо загрузки или постановки подготовки в очередь, включая устранение пробелов. Явное--no-catch-upпо-прежнему позволяет разрешённое чтение истории. -
Контекст человека находит личные диалоги без записанных участников, если идентификатор диалога совпадает с идентификатором человека, восстанавливая личные сообщения и последнее сообщение в каждом направлении в существующих хранилищах Telegram.
-
Прерванные операции записи сохраняют неизвестный исход, идентификатор операции и сведения для повторной попытки; проверьте результат перед повторением операции записи Bot API, у которой истекло время ожидания.
0.30.0 — 07.10.2026
Изменения, влияющие на скрипты
-
tg mcpпредлагает агенту три инструмента вместо одного на команду:tg_tools_search,tg_readиtg_write. Агент находит команду по словам и выполняет её как{ "command": "messages list", "arguments": { … } }, с теми же аргументами и ответом, что у прежнего инструмента.tg bot mcpработает так же:tg_bot_tools_search,tg_bot_read,tg_bot_write. Причина: агент читал описания примерно 80 инструментов до первого вопроса. На что обратить внимание: прежние имена (tg_messages_send,tg_statusи остальные) больше не работают, как и правила клиента, ссылающиеся на них; разрешите в клиентеtg_readи, если хотите,tg_write(MCP). -
Операции записи через MCP не показывают форму подтверждения: решение определяют только разрешения профиля. Уровень
askработает какallowчерез MCP, как через stdin/stdout, так и через--http. Причина: формы не работали во многих клиентах и мешали работе. На что обратить внимание: с разрешениями по умолчанию агент теперь может удалять ваши сообщения; задайтеtg config set permissions.messages.delete readonly, чтобы это запретить. Действия, для которых правила группы требуют подтверждения, остаются за вами.--confirm-send,--allow-dangerousи--http-confirmation(из 0.30.0) принимаются с предупреждением и ничего не меняют;tg mcp configбольше их не записывает. -
Статистика использует
stats messages show,stats chats showиstats tasks show. Прежние путиmessages stats,chats statsиtasks statsудалены. Обновите команды и точные разрешения доstats.messages.show,stats.chats.show,stats.tasks.show. MCP: используйтеtg_readс тем же путём команды. -
Ошибки разбора возвращают код выхода 2 со структурированным validation_error. Скрипты, ожидающие обычный текст или код выхода 1, должны обновить обработку ошибок.
Новое
-
Ход
tg setupлегче понять. Каждый шаг — заголовок[1/5] This computer, а результат показан под ним с отступом; вопросы и QR-код находятся под своим шагом, вокруг кода — пустые строки. Заключительный блок выравнивает подписи, а команда для первой попытки находится вверху. Вывод--jsonи его ключи не изменились;--quietпо-прежнему скрывает шаги. -
Список того, что требует вашего внимания. Начиная с 0.29.0,
reviewиserveсохраняют задачу в локальном хранилище для вопроса без ответа и сообщения с упоминанием вас по имени, а после вашего ответа закрывают её; теперь задачи можно увидеть.tg tasks listпоказывает каждую с её сообщением;tg tasks add <message> --type promiseдобавляет то, что правила не распознают;tg tasks close <task> --as done|dismissedзакрывает задачу окончательно;tg stats tasks showподсчитывает их по чатам. Эти команды ничего не отправляют. MCP: используйтеtg_readилиtg_writeс тем же путём команды. -
Правила ответа можно редактировать через CLI; они используют шаблоны Liquid с необязательными блоками ai.
replies add|edit|on|offменяет правила, аreplies audience— списки разрешений и запретов профиля.models.repliesвыбирает провайдера;replies consentsдаёт согласие для профиля и адреса API с исключениями по собственным идентификаторам чатов. Обычнаяreplies testпоказывает инструкции и запасной ответ без вызовов;--aiявно передаёт сохранённые данные. Старые шаблоны сохраняют буквальный запасной ответ с предупреждениями. Отправка по-прежнему ограничена тестировщиками и replies.send; см. архив. -
Операции записи MCP могут выполняться из веб-клиентов без серверных форм. Уровни разрешений профиля одинаково действуют для HTTP и stdio;
askиallowразрешают запрошенную запись MCP. Повторяйте--permission key=level, чтобы переопределить разрешения для этого процесса сервера без изменения конфигурации. Подтверждение приложения — отдельный механизм, который сервер не может проверить. Настройка в браузере. -
Графики можно сохранять в PNG.
tg stats charts <chat> --output activity.pngзаписывает график с тёмным оформлением в новый файл; SVG остаётся доступным. В MCPtg_readсcommand: "stats charts"иformat: "png"возвращает изображение и JSON без подключения к Telegram и без записи файла. -
Промпт MCP open-tasks перечисляет ожидающие задачи. Он вызывает review для обновления задач, затем выводит их с необязательным фильтром
chat; закрывает задачи только после одобрения и ничего не отправляет. -
Настройка в браузере охватывает Windows, macOS и Linux. Руководство отдельно описывает команды PowerShell и терминала, временные разрешения на отправку, веб-вход Codex, два одновременных сервера и остановку отдельных туннелей. Настройка в браузере.
Исправления
-
Оценки дат регистрации стали точнее для аккаунтов, созданных в 2022–2025 годах. Если Telegram не сообщает месяц,
contacts profileоценивает его по идентификатору; оценка теперь основана на 212 реальных датах регистрации. Аккаунты 2022 года больше не выглядят примерно на девять месяцев моложе: типичная погрешность оценок составляет один-два месяца. Идентификаторы до ноября 2025 года теперь получают оценку; более новые по-прежнему её не получают. -
tg serveиtg watchкорректно завершаются при остановке через SIGTERM или Ctrl-C. Раньше они завершались с кодом 1 иdatabase is not open, а поступающие обновления и контакты терялись: библиотека Telegram закрывала файл входа по сигналу до того, как команда заканчивала работу с ним. Теперь команда закрывает его один раз после сохранения поступивших данных. -
chats showпоказывает реальное число участников супергруппы, которое в списке чатов Telegram отсутствовало или устарело, а карточка группы или ссылка запросы показывает число участников обычной группы вместо 0. Список участников теперь тоже содержит число участников группы, поэтомуchats members fetchсможет определить, кто вышел из супергруппы, когда tg перейдёт на следующую версию общей библиотеки.
0.29.0 — 06.10.2026
Новое
-
Длинные сообщения участвуют в поиске по смыслу целиком. Сообщение длиннее примерно 1200 символов делится на перекрывающиеся фрагменты перед построением векторов, поэтому поиск по смыслу
messages searchчитает всё сообщение, а не только начало. Построенные раньше чаты считаются устаревшими, иconversations buildилиsearch --refreshперестраивает их (cli-messaging 0.153.0; хранилище переходит на версию 21, в которую старые сборки по-прежнему могут записывать). -
Профиль человека.
tg contacts profile <person>показывает сведения Telegram о человеке: все имена пользователей, описание, день рождения, отметки самого Telegram (бот, проверенный, premium, мошенник, фальшивый аккаунт, ограничен, удалён), последний визит (recently,weekиmonthбольше не обозначаются как скрытые), являетесь ли вы контактами друг друга, дату создания аккаунта (месяц от Telegram или оценка по идентификатору, всегда помеченная), есть ли у человека собственная фотография, а также для каждого общего чата — число его сохранённых сообщений, первое и последнее. Номер телефона показывает последние четыре цифры, если не задан--show-phone. Команда обращается к Telegram не больше, чемcontacts show. MCP:tg_contacts_profile. -
История участия в группах.
tg chats members fetch <chat>сохраняет профили, изменения состава и ежедневное число участников;--budgetограничивает страницы, а после неполного чтения никто не отмечается как вышедший.--trackзапускает ежедневную загрузку, пока работаетtg serve.chats tracking list|show|add|removeуправляет отслеживаемыми группами; прекращение отслеживания сохраняет записанную историю.chats members history --since-timeчитает записанные вступления, выходы и изменения профилей без обращения к Telegram. Первый снимок фиксирует исходное состояние, а не доказывает, что каждый вступил в тот день; пропущенные дни не восстанавливаются.chats members list --offlineчитает последний полный сохранённый список. Использует cli-messaging 0.152.0. -
tg contacts context <person> --chat <chat>(повторите для нескольких чатов) даёт последние сообщения человека в каждом чате только со временем и текстом, чтобы агент мог их обобщить;-vдобавляет идентификаторы и ссылки,--limitдействует на чат, а--refreshсначала обращается к Telegram с одним поиском по отправителю для каждого чата. -
Этот аккаунт — бот?
tg contacts check <person>оценивает человека по отметкам самого Telegram, профилю и самой старой фотографии, его сообщениям в хранилище и публичным спискам спама Combot CAS и lols.bot, в которые отправляется его идентификатор;--no-registriesпропускает списки.tg chats members audit --deep <n>выполняет ту же проверку для первых n участников, по одному в секунду. Каждая причина указывает свой источник; это готовый запрос, а не окончательный вывод.
Исправления
- Справка объясняет, что читают проверки участников и куда подключаются.
--no-registriesпропускает публичные списки блокировок, но всё равно запрашивает профиль и фотографии человека у Telegram;--offline— режим только локальных данных. Глубокие проверки читают не более 1,000 сохранённых сообщений на человека и делают отдельные запросы для выбранных участников.contacts context --chat --refreshявно подключается перед чтением хранилища. contacts profileбольше не оценивает дату регистрации самых новых аккаунтов. Таблица идентификаторов заканчивается декабрём 2024 года и не позволяет отличить новый идентификатор 2025 года от 2026 года; такие идентификаторы теперь не получают оценки, вместо даты, которая могла быть на несколько лет раньше действительной.tg mcp --http: Claude и ChatGPT могут завершить вход. Страница входа заставляла браузер отправлять форму как будто без источника, иtgотклонял её с «Origin not allowed». Теперь вход работает (cli-messaging 0.152.0).
0.28.0 — 06.10.2026
Новое
-
Поиск по тексту внутри файлов.
attachments extractиндексирует сохранённый обычный текст, документы Word и текстовый слой PDF для запросовcontent:. Для Word и PDF нужны необязательныеmammothиunpdf; сканы и фотографии читает агент и сохраняет их текст черезattachments text set.--download --output-dirявно скачивает недостающие файлы. -
Обновление перед поиском и переход по ответам.
--sync-firstзагружает новое в пределах значений по умолчанию: пять чатов, 500 сообщений и 30 секунд; при неполном обновлении остаются локальные результаты, а охват отмечается как устаревший.--threadпроходит по ограниченному сохранённому графу ответов с указанием происхождения связей, а без него переходит к контексту по времени. -
Фильтр разговоров и выбор аккаунтов.
--filterиспользует строгий Lucene и применяется до ранжирования; одно сообщение должно соответствовать всему фильтру.--sourceявно расширяет охват. В MCP появились пакеты для связывания агентом, запись связей, пересборка и запросlink-conversations. -
Настройки векторов и анализа задаются отдельно для каждого профиля. По умолчанию остаются локальные векторы и агент владельца. Удалённые сервисы получают текст, только если вы их выбрали;
build --analyze --chatзапрашивает и запоминает согласие для аккаунта, чата и сервиса до отзыва. Настройка удалённых векторов также отправляет текст поисковых запросов MCP. -
tgподключается через прокси: SOCKS5, HTTPCONNECTили MTProxy. Прокси задаётся для профиля черезtg config set proxy <url>— илиtg config set proxy -, чтобы вставить адрес с паролем или секретом MTProxy; секрет хранится в хранилище ключей ОС и никогда не попадает в файл настроек, — либо для одного запуска черезTG_PROXY. Команды Bot API используют тот же прокси SOCKS5 или HTTP; с MTProxy они подключаются напрямую, иtg doctorоб этом сообщает. Прокси, который отказывает или недоступен, сразу даёт ошибкуconfiguration_error(код 3), поэтому её нельзя принять за недоступность Telegram. -
tg doctorсообщает, что он действительно проверил. Вход показан какnot checked, пока вы не добавите--online, а каждый закрытый файл или каталог, который могут прочитать другие пользователи, назван вместе с командойchmod, которая это исправляет; самdoctorправа не меняет.tg doctor --onlineтакже сравнивает часы этого компьютера с часами Telegram (предупреждение при расхождении больше 10 секунд) и сообщает, активен ли аккаунт, заморожен (с датами и ссылкой на обжалование), заблокирован, удалён или вышел из системы.tg doctorиtg server statusпоказывают вfloodожидания, которые Telegram попросил соблюдать этот профиль, и запрет на его запись, если он есть. -
tg flood clearзабывает эти ожидания и снимает запрет на запись, когда Telegram уже не ограничивает аккаунт. Команда не подключается к Telegram. Инструмента MCP для неё у агентов намеренно нет. -
Метки: ваши собственные пометки на чате, человеке или отдельном сообщении, хранятся в локальной базе и никуда не отправляются.
tg tags add <tag…> --chat <chat> | --contact <person> | --message <message>,tags removeс той же целью иtags list.tag:<tag>в поиске находит помеченное. MCP:tags_list,tags_add,tags_remove. -
Сохранённые поиски и история поиска.
tg searches create <name> [query]сохраняет поиск без запуска;tg messages search --saved <name>иtg messages stats --saved <name>запускают его — дополнительные слова добавляются через AND, а указанные параметры заменяют сохранённые.searches list,show,history,deleteиclearуправляют ими. Каждый успешный поиск и подсчёт сохраняется в истории: запрос и параметры, но не сообщения и не результаты, последние 1000.--no-recordне добавляет запуск в историю; для MCP —tg mcp --no-recordилиrecordсо значениемfalse. Сохранённые поиски и история общие с max-cli, который использует ту же базу. -
tg contacts context <person>: что хранится в базе об одном человеке — общие чаты, последнее сообщение в каждую сторону, его недавние сообщения, где его упоминали другие — во всех связанных с ним мессенджерах. Команда никогда не подключается, иpermissions.messages: denyблокирует её, как другие чтения сообщений.tg contacts link <person> max:<person>записывает, что аккаунты Telegram и MAX принадлежат одному человеку;contacts unlinkотменяет это. -
Правила ответов могут отвечать тестовым аккаунтам.
tg serveотвечает по правилам изconfig/<profile>.replies.jsonтолько аккаунтам из спискаtestersи только еслиpermissions.replies.sendимеет уровеньallow— по умолчанию онdeny, а пустой список не отвечает никому.tg replies testпоказывает, что правила ответили бы на сохранённые сообщения, и ничего не отправляет;replies pauseсразу останавливает все правила, в том числе в работающемserve;replies resumeотменяет паузу;replies statusсообщает, могут ли правила отправлять и кому. -
tg store repair [--dry-run]приводит каждую таблицу базы к виду этой сборки, ничего не удаляя: таблица неправильного вида сохраняется копией рядом с новой, аtg store copies delete <name>удаляет копию после проверки. Команда восстанавливает базу, в которой чтение сообщения завершалось ошибкой наmessages.mentions. -
При первом открытии этой версией в базе появляются таблицы для меток, сохранённых поисков, истории участников и основ слов; старые сборки
tgпо-прежнему открывают файл.tg store migrateиtg store reindexтакже строят индекс основ слов (для большой базы один раз выполнитеtg store migrate), аtg config set searchStemmers.cyrillic(russianилиnone) иsearchStemmers.latin(spanish,englishилиnone) выбирают стеммеры для всей базы. Поиск пока не использует основы. -
chats members auditучитывает всё, что содержит список участников Telegram. Для каждого участника теперь известно, когда он вступил, кто его пригласил и является ли аккаунт ботом, удалённым, помеченным как scam или fake, или без фотографии, — поэтому видны всплески вступлений, массовые запросы и помеченные аккаунты без дополнительных запросов на каждого человека. -
chats statsсчитает комментарии к постам канала, наряду с просмотрами и пересылками. -
Файл, загрузка которого оборвалась, отправляется повторно до трёх раз, прежде чем что-либо будет отправлено. Если не получилось, ошибка сообщает, что ничего не отправлено, вместо кода
14«возможно, отправлено». Само сообщение по-прежнему отправляется один раз, со своим идентификатором отправки. -
У поиска три руководства. Поиск сообщений — повседневный поиск по словам, людям, датам, файлам, ссылкам и меткам; Поиск по темам объясняет разговоры, векторы, актуальность и что отправляется удалённой модели; Язык запросов — справочник.
-
tg mcp doctorпоказывает последние строки вывода ошибок сервера, если он не запустился; домашний каталог, длинные числа и всё похожее на токены скрыты.
Изменения, влияющие на скрипты
-
Результаты по смыслу от локальной e5-small должны иметь косинусное сходство выше 0.80, прежде чем объединяться с результатами по словам. Точные совпадения слов остаются в выдаче. Результатов может стать меньше, а совмещённое попадание может стать только словесным.
-
В общем архиве появились таблицы текста вложений и согласия на анализ. При открытии локальная схема обновляется с сохранением существующих сообщений; перед обновлением сделайте резервную копию большого архива.
-
Ожидание, которое попросил Telegram, запоминается. После
FLOOD_WAIT(код 8,rate_limited, сretryAfterMs) тот же вызов — а если ожидание касалось чата, то тот же вызов в этом чате — сразу завершается кодом 8 иdetails.remembered: true, пока ожидание не истечёт, без запроса к Telegram. Скрипт, который сразу повторял запрос после кода 8, теперь снова получит код 8, только раньше.tg flood clearзабывает ожидания. -
Запись замороженного аккаунта или аккаунта с ограничением за спам удерживается. После того как Telegram отклонил запись, потому что аккаунт заморожен или ограничен за спам (
PEER_FLOOD), любая запись типа отправки завершается кодом 5 (permission_error) с указанием, до какого времени; чтение, реакции и отметка прочитанным работают. Ограничение за спам удерживается час и продлевается каждым новым отказом; заморозка — до даты окончания от Telegram или на сутки.tg doctor --onlineустанавливает запрет из-за заморозки и снимает его, когда аккаунт снова активен; запрет из-за спама он не снимает никогда — это делаетtg flood clear, когда вы знаете, что ограничение снято. -
PEER_FLOODзавершается кодом 5 (permission_error), а не 11, и указывает на @SpamBot: повторы только ухудшают ситуацию. Отказ замороженному аккаунту тоже даётpermission_errorс указанием наtg doctor --online, а не ограничение частоты, которое нужно переждать. Заблокированный или удалённый аккаунт больше не предлагает войти заново. -
Разовая команда пережидает FLOOD_WAIT до 10 секунд не более двух раз, а не пяти, и сообщает об этом в stderr; следующее ожидание завершает её кодом 8 (
rate_limited) иretryAfterMs.serveиwatchждут до 2 минут, три раза. -
tg serveиtg watchзавершаются, когда Telegram завершает вход во время их работы, с кодом 4, примерно в течение 15 минут; служба после этого не перезапускается. Если обновления прекращаются по другой причине или Telegram не отвечает на запрос в течение 30 секунд, они завершаются с кодом 12, после которого systemd перезапускает службу. Раньше они продолжали работать и ничего не получали. -
AUTH_KEY_DUPLICATEDот Telegram (вход завершён, потому что его одновременно использовали два соединения) теперьauthentication_error, код 4, а неprovider_error. Сообщение предлагает войти заново и называет причиной пересекающиеся процессыtg. -
Закрепление, открепление, реакция, отметка прочитанным, удаление, голосование, закрытие опроса, изменения папок и контактов завершаются кодом
14(outcome_unknown), если Telegram не ответил, вместо ошибки времени ожидания или сети, которую журнал отправок записывал как неудачу. Сообщение говорит, безопасно ли повторить; для создания папки — нет: сначала проверьтеtg chats folders list. -
tg inbox,inbox --new,reviewиchats list --unread(также с--searchи--kind) просматривают все чаты, а не только последние 100 или 200, поэтому непрочитанный чат ниже по списку больше не пропускается. Это стоит одного запроса на 100 чатов.partialтеперь означает только то, что Telegram не смог перечислить все чаты; чаты сверх ограничения в 20 за запуск названы в примечанииskipped N chats. -
tg messages list --after-id,--after-timeи--before-timeбольше не останавливаются на странице короче--limit. Telegram не включает удалённые сообщения в страницу, поэтому короткая страница в середине чата давалаhasMore: falseи теряла подсказку для следующей страницы. Теперь они сообщают о продолжении, пока Telegram не вернёт пустую страницу, как уже делал обычныйmessages list: последняя страница может сообщать о продолжении, а переход по её подсказке возвращает пустую страницу. -
tg messages searchпринимает запрос как необязательный, поскольку--savedможет использоваться отдельно; без обоих команда по-прежнему отказывает.
Исправления
-
Локаторы контекста с указанием аккаунта отклоняют чужой аккаунт до чтения. MCP также принимает
offline: trueдля обычного сохранённого контекста. -
Остановка
tg serveчерез Ctrl-C или сигналом завершается с кодом 0. База сессии закрывается один раз, без прежней ошибки «database is not open» при завершении. -
messages deleteсначала проверяет, что идентификаторы принадлежат чату. В личном чате или обычной группе Telegram нумерует сообщения отдельно для каждого аккаунта и удаляет только по номеру, поэтому идентификатор из другого чата — или номер того же сообщения у собеседника — удалял сообщение там. Теперь любой идентификатор не из указанного чата останавливает всё удаление с кодом 2, и ничего не удаляется. -
text:/…/в строгом поиске приводит буквы к общему виду так же, как индекс слов, поэтомуtext:/Квартир.*/иtext:/счёт/находят пропущенные раньше слова. Ошибка поиска подсказывает, что делать:~указывает на--language legacy, слишком короткий для раскрытия префикс — на более длинный, а ещё строящийся индекс — на точную командуtg store migrate. -
Два
tg serve, запущенные одновременно для одного профиля, больше не могут работать вместе.
0.27.0 — 04.10.2026
Новое
-
tg mcp --http --public-url https://<name>.ts.netработает за вашим HTTPS-туннелем с собственным входом OAuth по коду владельца. Каждая запись через HTTP требует формы;tg mcp --revokeзабывает входы из браузера для профиля. -
tg chats stats <chat>считает сохранённую активность группы или канала и запрашивает у Telegram вступления и выходы. Результаты без подключения и через MCP не содержат состава участников; неполные счётчики — нижняя граница. -
tg chats members auditперечисляет подозрительные признаки участников, никого не удаляя; недоступные признаки указываются вunknown. Входящие и review в MCP принимаютkindsиnewс собственными позициями. -
Личный MCP использует общий каталог, принятый и в MAX. Предпросмотр фотографий принимает
index, а прямое распознавание речи —model. SDK также добавляет статистику архива, готовность разговоров и ограниченное локальное обновление; модели никогда не скачиваются автоматически.
Изменения, влияющие на скрипты
-
Охват поиска и статистики использует фактический список чатов и время загрузки; каждая запись о полноте получает
fetchedAt. Старые базы получат эти данные после следующего полного чтения списка чатов и загрузки истории. Запрос/catch-upпринимаетkindиmodeвместоsince. -
config set permissionsотклоняет неизвестные ключи команд, в том числе внутри целого объекта, с кодом 2. Существующие файлы дают предупреждение и продолжают работу;config unsetможет удалить старый неизвестный ключ. -
store fetch --page-sizeбольше 100 отклоняется до подключения. Выполнитеstore fetch <chat>повторно, чтобы исправить неверную отметку начала истории, если есть более старые сообщения. -
tg serveзавершается с кодом 12 (provider_unavailable), если сохранённая сессия есть, а данные приложения недоступны, например пока хранилище ключей заблокировано. Systemd повторяет запуск через 30 секунд; в macOS нуженtg server start. Другие команды и профили без сохранённой сессии по-прежнему завершаются с кодом 4. -
tg serveиtg watchне запускаются и завершаются с кодом 4 (authentication_error), если сессия уже отозвана. Они проверяют вход до сообщения о готовности. Сессию, отозванную после запуска, по-прежнему нужно проверять отдельно. -
Фоновая служба больше не перезапускается при этом коде. В systemd код 4 запрещает перезапуск. В macOS launchd не умеет исключить один код завершения, поэтому агент больше не перезапускается ни после какой ошибки. Снова выполните
tg server install, чтобы обновить службу; послеtg session startвыполнитеtg server start. -
Неизвестные аргументы личного MCP теперь вызывают ошибку до выполнения. Используйте объявленную схему, в том числе
at_timeдля отложенной отправки. Одобренная отложенная отправка выполняется в абсолютное время, показанное в форме. -
tg messages listможет ответитьhasMore: trueс подсказкойolder messages: --before-idна странице короче--limit. Telegram не включает удалённые сообщения в страницу, поэтому короткая страница не доказывает, что достигнуто первое сообщение чата. Даже последняя непустая страница может сообщать о продолжении; переход по её подсказке может вернуть пустую страницу.
Исправления
-
Прежний поиск, поиск по регулярному выражению и поиск только по фильтрам сообщают фактическую готовность индекса слов.
server statusсообщает о последнем обычном завершении службы и даёт подсказку об остановленном входе, если служба намеренно остаётся остановленной. -
tg store fetchбольше не останавливается раньше времени и не считает чат полным, если страница пришла короткой. Telegram не включает удалённые сообщения в страницу, поэтому страница может быть короткой в середине чата; загрузка теперь продолжается, пока у Telegram есть более старые сообщения. Для чата, уже отмеченного полным, хотя более старых сообщений не хватает, снова выполнитеtg store fetch <chat>: команда прочитает то, что ниже сохранённого.
0.26.0 — 04.10.2026
Новое
-
Встроенные инструкции для агента объясняют, как находить договорённости, готовиться к встречам и рекомендовать контакты. Агент проверяет полноту архива, сопоставляет групповые и личные переписки, различает людей с одинаковыми именами и сохраняет черновик, если отправка запрещена.
-
tg messages linkи инструмент MCP для чтенияtg_messages_linkвозвращают постоянную ссылку и локатор сообщения. В каналах и супергруппах ссылки сохраняют контекст обсуждения; для частных ссылок нужен доступ, сама ссылка не добавляет пользователя в чат. Для личных переписок, обычных групп и Избранного возвращается локатор. Без соединения проверяется сохранённое сообщение; локаторы другого аккаунта отклоняются. Командаlinkотличается отlinks, которая показывает связи переписок.
Изменения, влияющие на скрипты
-
Снятие закрепления использует отдельное разрешение
messages.unpinв cli и MCP. Раньше общая проверка использовалаmessages.pin. В профилях с явно заданными современными разрешениями стоит проверить правило снятия закрепления; прежнееallow: ["pin"]по-прежнему покрывает оба действия. -
tg commands [path...] --jsonописывает отдельную команду или группу. Например,tg commands messages search --jsonвозвращает глобальные параметры и коды завершения вместе со справкой этой команды. Без пути возвращается всё дерево; ответ для конкретного пути содержитscopeиinheritedOptions. Разные пути команд проверяйте отдельными вызовами.
Исправления
-
Перед отбором вопросов без ответа учитываются сохранённые и запрошенные новые расшифровки голосовых сообщений. Добавьте
--transcribe, чтобы распознать голосовые сообщения без сохранённого текста. Нераспознанные сообщения оставляютcompleteравным false: сохраните прежнюю границу проверки, а не считайте пустой результат доказательством того, что отвечать не на что. -
Команды, одновременно открывающие локальный архив, немного ждут его инициализации вместо немедленной ошибки при блокировке записи другим процессом. Длительная блокировка по-прежнему вызывает ошибку.
-
Файлы для распознавания речи скачиваются через соединение с историей; перед локальным распознаванием оно закрывается. Второе соединение для
messages list --transcribe,inboxиreviewбольше не требуется.
0.25.0 — 03.10.2026
Исправления
chats showобъясняет, что различие между списком участников и их общим количеством может быть связано с отсутствием самого пользователя в списке или с частичным списком, а не обязательно с неполной загрузкой. Данные JSON не изменились.
Новое
-
README и руководство по ботам явно описывают полный набор методов API: все 185 методов зафиксированной схемы Telegram Bot API 10.3, а также удобные команды бота и инструменты MCP для конкретных задач.
-
config migrate --dry-runпоказывает преобразование прежних настроек доступа в современные разрешения без записи и соединения;config migrateприменяет его по явному запросу, сохраняя действующие уровни доступа. Остальные настройки не меняются. -
tg <bot> bot api <method>предоставляет методы зафиксированной схемы Telegram Bot API через генераторы cli-core и общий сборщик команд MAX/TG. Флаги полей API, тела JSON/stdin и вложенные загрузки файлов используют общую проверку данных и разрешений записи. Разрушительные методы требуют подтверждения по умолчанию; операции записи без ответа не повторяются. Учётные данные управляемых ботов требуют явного назначения--store-token <profile>и хранятся только в системном хранилище ключей; stdout содержит подтверждение сохранения.
0.24.0 — 03.10.2026
Изменения, влияющие на скрипты
--mdиспользует собственный форматтер Telegram для отправки, правок и подписей личного аккаунта и бота. Поддерживаются вложенные стили, подчёркивание, спойлеры, ссылки, блоки кода и цитаты.__text__означает подчёркивание; одиночный*text*теперь означает жирный текст. Синтаксис MAX отличается. Недопустимая вложенность и небезопасные ссылки отклоняются до изменения данных.
0.23.0 — 03.10.2026
Изменения, влияющие на скрипты
-
Локальный поиск сообщений по умолчанию использует строгий профиль Lucene: группы, типизированные поля и диапазоны дат,
--timezone, подстановочные знаки и regex с ограничениями, а также охват при пустом результате. Начало слова задавайте явно черезword*; для прежнего неточного поиска используйте--language legacy. Руководство по поиску и skill агента объясняют переход. JavaScript--regexработает в изолированном рабочем потоке с ограничениями размера и времени. -
tg upgrade --jsonвсегда включаетrestarted, даже при проверке и обновлении без изменений. Прежние поля сохраняются; успешное обновление сохраняет политику перезапуска управляемых серверов. Скриптам с проверкой точного набора ключей нужно принимать пустой массив, если ни один сервер не перезапущен.
Новое
-
tg mcpосвобождает модель поиска через 10 минут без запросов:conversations_searchагента больше не удерживает около 1 ГБ памяти на протяжении всей сессии. Следующий поиск заново загружает модель примерно за секунду. -
tg <bot> bot meи MCPtg_bot_meпоказывают идентификатор, имя и имя пользователя бота профиля. Команда использует токен бота, не поддерживает автономный режим и не отправляет сообщений. -
Глобальная установка npm устанавливает skill агента до входа, если разрешён установочный скрипт. В Windows сохраняет каталог команд npm в пользовательский PATH и оставляет рабочий запуск
.cmdпри ограничительной политике PowerShell. Установщик Windows одной командой также обновляет текущую оболочку, устанавливает skill при пропущенных скриптах и проверяет запускtgбез доступа к аккаунту. -
Настройка доступна сразу после установки: основная справка и ошибки первого запуска направляют к
tg setup; справка настройки и входа содержит примеры, инструкции для агента и советы для Windows. Быстрый старт, установка, MCP и безопасность согласованно объясняют первый запуск.tg skill showработает до входа; завершение настройки направляет агента к этой команде. -
tg topics enableвключает темы форума,tg topics createсоздаёт тему с названием. Обычная группа требует явного--upgrade --yes; её идентификатор меняется, результат содержит новый адрес. CLI и MCP проверяют права и сообщают частичный результат, если преобразование удалось, а включение тем — нет. Создание темы использует--send-idкак идентификатор попытки; журнал запрещает повторное использование после успешного или неизвестного результата. Никогда не повторяйте создание темы с неизвестным результатом. Старые строки архива сохраняют исходные идентификаторы чатов. -
tg messages send --topicиtg polls create --topicотправляют в выбранную тему форума. Текст, подписи медиа, ответы и отложенные сообщения сохраняют тему; отсутствующие или закрытые темы и ответы из другой темы отклоняются до отправки. MCP принимает тот же адрес вtopic. -
tg setupпроводит первый запуск: локальные проверки, автоматическая регистрация приложения или регистрация через браузер, вход по QR или телефону, проверка пяти чатов и необязательный skill агента. Использует существующую сессию, объясняет ожидание около пяти минут и оставляет загрузку истории отдельным выбором. Инструкции Windows включают обёртки.cmdи запасной вариант npm exec при отсутствии PATH. -
tg mcp setup codex|claude-codeиtg mcp doctorдобавляют локальный сервер в клиент и проверяют подключение со списком инструментов. Setup требует--allow-writes, если профиль предоставляет инструменты изменения; doctor не проверяет вход в Telegram. -
tg <bot> bot store fetch <chat>загружает старые сообщения каналов и супергрупп в локальную копию бота без отправки и отметки прочитанным. Для первого запуска без известного номера сообщения используйте--from <message link>; следующие запуски продолжают назад. Личные чаты и обычные группы не поддерживаются. См. руководство по ботам.
Исправления
-
При усечённом
tg runs list --limitпредлагается увеличить--limit, а не использовать неподдерживаемый--page. JSON по-прежнему сообщаетhasMore; чтение сохранённых запусков не создаёт новую запись. -
Ранние ошибки команд бота учитывают настройки записи бота, а неизвестная подкоманда больше не обвиняет корректный профиль в начале команды. Общий исполнитель применяет эти правила согласованно.
-
Завершение входа корректно сокращает пути домашнего каталога Windows. Проверки документации выпуска распознают разделители путей Windows. Тесты прав файлов применяют Unix-права только в Unix; в Windows доступ определяется унаследованными ACL, что теперь указано на странице безопасности.
0.22.0 — 03.10.2026
Новое
-
tg messages evidence <chat>иtg_messages_evidenceв MCP готовят ограниченный пакет локального архива для сводки агента без подключения и отметки прочитанным. Указатели источников, отпечатки, явная полнота и курсор старой страницы обеспечивают точность цитат и продолжения. Целые сообщения занимают до 64 КиБ JSON;--limitпринимает 1–100. -
tg <name> bot contacts show --refreshиспользует справку какmax, без имени мессенджера (cli-messaging 0.109.0). -
Полная документация бота (Бот Telegram): поиск идентификатора чата, файлы, лимиты и коды завершения.
-
tg <name> bot contacts show,bot messages search,bot messages betweenчитают локальную базу бота. См. Сохранённые данные. -
tg <name> bot chats moderate,bot chats rulesпроверяют новые сообщения по правилам и выполняют разрешённое. Читают сохранённоеbot watch, поскольку Telegram не даёт историю. См. Модерация. -
tg <name> bot mcp— бот для агента с инструментами по разрешениям профиля и формой перед удалением. См. MCP бота. -
Язык запросов
tg messages search:"a phrase",-word,a OR b,from:,chat:,after:/before:,has:. Исправление опечаток сообщается в stderr.--context <n>показывает контекст (2 сообщения в терминале).in:max,in:all,--sourceвключают другие аккаунты, в том числе MAX. См. Поиск. -
Поиск разговоров группы по смыслу:
tg conversations embed --chat <chat>строит локальные векторы;tg conversations search "<question>"ищет ближайшие в одном или всех обработанных чатах.tg models text list|downloadскачивает модель в общий с моделями речи каталог.--provider openaiили--base-urlдля Ollama, LM Studio и других использует ваш сервис после оценки передачи и стоимости. См. Поиск по темам. -
tg store fetchне зацикливается при повторных ответах Telegram с теми же сообщениями. -
tg bot watchсохраняет события до вывода;--events— правки, кнопки, вступления и выходы.tg bot callbacks answer,tg bot commands list|set|clear,tg bot webhooks list|set|delete, какmax bot. См. Бот Telegram. -
tg bot chats admins list|add|remove,tg bot chats members remove [--block]: администраторы, права и титул, назначение с--can,--title, снятие прав, удаление участника, с--block— блокировка. См. Бот Telegram. -
tg bot messages send|list|show|edit|delete|pin|unpin,tg bot chats show|leave|action: бот пишет по идентификатору/названию илиuser:<id>, с--md,--html, файлом/фото.list,showчитают локально отправленное и полученное, поскольку истории Telegram нет. Удаление требует подтверждения или--allow-dangerous. -
Ваш ИИ-агент связывает разговоры по запросу:
tg skill show link-conversationsобъясняет процесс. Сначала объём текста и согласие, затем пакеты (tg conversations batches next,tg conversations links add);tg conversations links clearудаляет связи. Сам tg не вызывает модель. См. Локальная база. -
tg mcpпредоставляет инструкцию ресурсомtg://skill, указывая её при подключении: агент читает безtg skill show.
Изменения, влияющие на скрипты
tg messages searchсначала показывает лучшее совпадение;--newestвозвращает прежний порядок. Без всех слов поиск пробует любое, затем часть слова. JSON сохраняетitems,limit,hasMore, добавляетmatch,score,corrections,completeness(полнота по чатам),wordsReady. Запросы из одной-двух букв больше не отклоняются.- Нужен Node 22.16+ или Bun. При слишком старом системном SQLite в Linux
tgперезапускается на своём SQLite из@wirecat/cli-messaging-sqliteдо чтения/отправки. Официальные сборки Node/Bun работают без изменений.
Исправления
-
Отказ изменения ботом указывает правильную команду настройки с
--botи ключом разрешения (cli-messaging 0.111.0). Раньшеconfigошибочно располагался внутриbot. -
Локальные изменения больше не помечаются как изменения Telegram.
config set,unset,chats rules set,unset,recipients add,remove,clear, а такжеauth set,auth remove,recipients add,remove,clearбота записывают настройки, правила, получателей или ключи. Справочник команд отмечает локальные изменения; вtg commandsони остаются изменяющими.chats moderate,session endменяют Telegram. -
tg contacts showвключает личный чат в общий список от новых к старым. Раньше показывались только группы, возвращаемые списком общих чатов Telegram.
0.21.0 — 01.10.2026
Новое
tg bot— бот Telegram через официальный Bot API:bot auth set|show|remove,bot list [--check],bot chats list,bot recipients list|add|remove|clear,bot sends list, аналогичноmax bot. Несколько имён ботов; токен в хранилище какbot:<name>илиTG_BOT_TOKEN. См. Бот Telegram.tg conversations batches status|next --chat <chat> [--size <n>]— пакеты групповой переписки для связывания вашим ИИ-агентом.statusпоказывает оставшиеся сообщения и пакеты,next— следующий пакет. Сам tg не вызывает модель.tg skill install [--for claude|agents|all]устанавливает инструкцию для Claude Code и других агентов. При отсутствии копии агенту сообщается раз в день в stderr; отключение:tg config set skillHint false --defaults.tg store clear --leftудаляет покинутые чаты с сообщениями из базы. Требует--allow-dangerous, иначе только показывает объём.tg conversations build|list|show,tg messages links, MCPtg_conversations_list,tg_conversations_show— разговоры группы из сохранённых ответов, упоминаний и очередности авторов без Telegram и AI. Построение только послеbuild. См. Локальная база.- Сохраняются упоминания по имени, а не только @username, для связывания разговоров.
tg chats rules show|set|unset,tg chats moderate, MCPtg_chats_rules_show,tg_chats_moderate— правила ссылок, приглашений, пересылок, флуда и заблокированных участников. Уровни: запрет, отчёт, подтверждение (по умолчанию), действие. Ничего не работает в фоне. См. Группы.tg messages list --before-timeчитает назад от ISO 8601 или2h/1dназад.tg contacts add|remove|block|unblock|rename|import,tg account update,tg account sessions end --others, MCPtg_contacts_add|remove|block|unblock|rename,tg_account_update.contacts importчитает строкиnumber, nameи возвращает только числа и найденных людей. Завершение сессий отключает и телефон, требует подтверждения и не предлагается агенту.tg chats folders list|create|update|delete, MCPtg_chats_folders_list|create|update|delete. Остальные чаты папки сохраняются; неизменяемая папка «Все чаты» не выводится.tg chats members add|remove,tg chats admins add|remove, MCPtg_chats_members_add|remove,tg_chats_admins_add|remove.--can: members, admins, info, pin, link, post, edit, delete; отдельного права читать нет. Неудачные добавления перечисляются; каждый участник входит в часовой лимит.tg chats update <chat>:--title,--description,--all-can-pin on|off,--only-admins-add on|off;tg chats link show|reset, MCPtg_chats_update,tg_chats_link_show,tg_chats_link_reset.tg chats showпоказывает описание, приглашение и настройки.tg chats create <title> [person...],tg chats join <link>,tg chats leave <chat>, MCPtg_chats_create,tg_chats_join,tg_chats_leave. Создаётся супергруппа (--channel— канал); ошибки добавления перечисляются. См. Использование.- Разрешения команд для вас и агента.
permissions:deny(включая чтение),readonly,ask,allow. Конкретный ключ важнее общего:tg config set permissions.messages.delete allow. По умолчанию всё разрешено кроме удаления и завершения других сессий с подтверждением.askспрашивает y/N;--allow-dangerousподтверждает удаление,--yes— другое изменение в скрипте.readOnlyиallowсовместимы. См. Безопасность. tg messages send --voice <file>— Ogg Opus как голосовое;.mp4,.movс--fileвоспроизводятся как видео;--as-fileоставляет скачиваемым файлом.tg messages list --mark-readотмечает чат до последнего показанного сообщения. Обычное чтение не отмечает.--modelс--transcribeдляtg messages list,tg inbox;tg review --transcribe— текст голосовых в обзоре.tg store fetch --last <n>останавливается после сохранения последних n сообщений; повтор с--lastпроверяет одну страницу и выходит.tg polls create --revoteразрешает менять голос.tg store export --output <file> --since-time <time>пишет в новый закрытый файл без перезаписи, начиная с выбранного времени.tg account showпоказывает последние четыре цифры телефона, полный номер — с--show-phone.tg_account_showвсегда показывает только четыре.tg messages forward --send-idповторяет неизвестную пересылку без дубликата, как отправка.--jsonвозвращаетsendId;tg_messages_forwardпринимаетsend_id.tg messages edit --mdформатирует какmessages send --md;tg_messages_editпринимаетmarkdown.- Обслуживание базы:
tg store info,check,migrate,backup,restore.info— путьmessages.db, размер, структура, строки.check— целостность, внешние ключи, индексы, свободный диск, отстающие чаты; ничего не исправляет.migrateобновляет структуру и старые сообщения.backup <file>копирует используемую базу в новый закрытый файл.restore <file>сохраняет заменяемую базу рядом; запрещён приtg serveили открытой базе. После восстановления общей с max-cli базы перезапуститеserveиmcpобоих CLI. - Каждое изменение имеет
operationIdв--json, MCP, журнале и--trace: отправка, правка, пересылка, удаление, закрепление, реакция, отметка прочитанным, голос. Для отправкиoperationIdравенsendId. - Размер установки меньше примерно на 16 МБ: cli-messaging 0.60.0 включает слой базы вместо отдельной зависимости.
Изменения, влияющие на скрипты
tg server status --jsonвозвращает общие для обоих инструментов поля:sinceстановитсяstartedAt,listening—connected,listeningSince—connectedAt; добавленыcliVersion,logиstale, когда завершившийсяserveоставил блокировку.tg server startвозвращаетstartedAtиconnectedAtтак же, аtg server stopсообщает, кто его запустил (by). Строки вывода говорят «connected» вместо «listening».tg messages send --at→--at-time.- Аргументы MCP соответствуют параметрам:
tg_messages_list:before_id,before_time,after_id,after_time;tg_messages_context:before_n,after_n;since→since_timeвtg_inbox,tg_review,tg_chats_events, гдеevent→type;tg_messages_send:md,at_time. - Названия параметров указывают тип принимаемого значения. Старые названия отклоняются как неизвестные параметры;
псевдонимов нет. Аргументы инструментов MCP не меняются.
tg messages list --before→--before-id;--after→--after-idдля идентификатора или--after-timeдля времени.tg messages context --before,--after→--before-n,--after-n.--since→--since-timeвtg inbox,tg review,tg chats events,tg store fetch.tg messages download --output→--output-dir.tg chats events --event→--type.
tg review --unansweredпринимает длительность (4h,1d), а не часы без единицы;--unanswered 4отклоняется. Без значения 24 часа. MCPtg_reviewпо-прежнему принимает часы.tg chats events --json:{ items, page, limit, hasMore, chatId, since },events→items,more→hasMore.tg server logs --json:lines→items.--jsonlне меняется..mp4,.movс--fileвоспроизводятся как видео;--as-fileсохраняет прежний вид файла.tg mcpвыбирает инструменты по разрешениям профиля. По умолчанию отправка, правка, пересылка, реакции, голосование, отметка прочитанным без--allow-sendи формы. Удаление с формой;tg mcp --allow-dangerousпропускает её. Для чтения профиль сreadOnly: MCP.--allow-send,--allow-mark-read,--allow-deleteустарели и предупреждают;--confirm-sendпоказывает каждое изменение.tg messages deleteспрашивает без--allow-dangerousвместо отказа; без терминала отказ сохраняется.tg store fetch --max <n>удалён:--limit <n>ограничивает сообщения запуска (1000),--page-size <n>— страницу (100), как max-cli. Псевдонима--maxнет.- Опрос без
--revoteбольше не позволяет менять голос, как в max-cli; раньше Telegram разрешал это по умолчанию. Добавьте--revote, чтобы сохранить прежнее поведение. tg polls vote,tg polls close --json:{ operationId, poll }, опрос теперь в.poll.tg_polls_vote,tg_polls_closeаналогичны.tg runs list,tg sends list,tg recipients list --json:{ items, page, limit, hasMore }вместо массива; строки в.items.--jsonlне меняется.
Исправления
-
tg chats listне дублирует закреплённые чаты. Страницы Telegram с архивом повторяли закрепления ниже: на одном аккаунте 8 из 1361 чатов. Название такого чата также ошибочно считалось неоднозначным. -
tg server stopи Ctrl-C корректно завершаютserve,watch. Раньше очистка не успевала, иtg server statusпоказывалstale. -
tg serverиз репозитория не меняет службу установленного tg. СвоиTG_STATE_DIRили база дают отдельное имя службы; установленный используетtg-serve-<profile>.service. -
Покинутые чаты исчезают из
chats list --offlineпосле полногоtg chats list. Сообщения остаются доtg store clear --left; повторное вступление возвращает чат. -
Отказы объясняют действия. При повторном добавлении вышедшего или удалённого человека без взаимных контактов предлагается приглашение (
tg chats link show <chat>). Неизвестный аккаунту идентификатор требует @username или предварительного чтения его чата. -
Ошибка библиотеки не повторяет аргументы. Раньше могли раскрыться названия и ссылки. Теперь сообщается тип неверных данных: не вступивший чат, сообщение, приглашение, телефон, код или пароль; иначе общий отказ аргумента.
-
Переписка отображается на английском. Ваши сообщения —
you, даты —26 September 2026; раньше были русскими. -
Отсутствующие чат/сообщение —
not_found, неверный тип чата —validation_error, вместо общего кода 1 и текста библиотеки с возможным раскрытием названия. -
Ошибка входа указывает профиль:
tg <profile> session start. -
Права загрузок и экспортов снова обычные. Раньше вход делал все последующие файлы tg закрытыми. Сессия и связанные файлы остаются доступны только владельцу.
0.20.0 — 30.09.2026
Новое
- В базе сохраняется @username автора, для
--from @nameи связывания упоминаний. cli-messaging 0.57.0+; старая история обновляется при следующей загрузке. tg store fetch <chat> --since <time>останавливается у сообщений старше2026-09-01или2h/1dназад.
Изменения, влияющие на скрипты
Команды используют единый порядок: существительное, затем глагол. Старые имена удалены без псевдонимов; скрипты получают «unknown command» или «unknown option».
tg export <chat>→tg store export <chat>,tg sync status [chat]→tg store status [chat],tg backfill <chat>→tg store fetch <chat>,tg backfill list|status|cancel→tg store jobs list|show|cancel.store fetchзагружает по умолчанию;--estimateоценивает.--pace→--pauseтам и вtg messages download --all.--maxпока сохраняется и считает сообщения.tg messages replyудалён: ответ черезtg messages send <chat> [text] --reply-to <id>, доступны--file,--photo,--silent,--atи остальные. Дляmsg:telegram/…замены нет: укажите чат и сообщение.tg chats read→tg chats mark-read;tg_chats_read→tg_chats_mark_read.tg recipients off→tg recipients clear.tg update [--check]→tg upgrade [--check], уведомление тоже указываетtg upgrade.tg messages search <words…>переименовывает аргумент в<text…>без изменений поиска.
0.19.0 — 30.09.2026
Исправления
- tg выходит после завершения команды. Раньше загрузка могла оставаться открытой полчаса даже с
--timeout. Через пять секунд перечисляются открытые ресурсы в stderr и процесс выходит со своим кодом, дожидаясь записи вывода.
0.18.0 — 30.09.2026
Исправления
- Супергруппа/канал, впервые увиденные через сообщение, не теряют сообщения из-за удаления в личном чате (cli-messaging 0.54.0). В 0.16.0 тип мог быть неизвестен; теперь достаточно
-100…. - Ошибочно удалённые записи восстанавливаются при чтении чата (
messages list,messages context, правка в реальном времени). Более позднее удаление сохраняется.
0.17.0 — 30.09.2026
Новое
tg messages download <chat> --allсохраняет все фото, документы, видео и голосовые в--outputот новых к старым. После--timeoutили Ctrl-C продолжает, также подхватывая новое; позиция в.download-<chat>.json. Ожидание Telegram выполняется до пяти минут;--pace(1 секунда) разделяет страницы. К занятому имени добавляется идентификатор; без перезаписи (cli-messaging 0.53.0).
0.16.0 — 30.09.2026
Исправления
- Удаление в личном чате/обычной группе не помечает сообщения других чатов удалёнными (cli-messaging 0.52.0). Telegram не указывает чат, а база раньше затрагивала все совпадающие номера, включая каналы/супергруппы. Старые ошибочные отметки остаются; текст сохранён.
0.15.0 — 30.09.2026
Исправления
- Локальная модель не пропускает тихие слова. Раньше тихий фрагмент считался тишиной; исправлено для Parakeet и GigaAM. Ранее обработанные локально записи распознаются заново при
--transcribe; расшифровки Telegram сохраняются (cli-messaging 0.51.0).
0.14.0 — 30.09.2026
Новое
Изменения видимых другим сообщений проходят защиту, как messages send: профиль для чтения запрещает, allow должен разрешать, получатели и лимит проверяются, tg sends list записывает без текста.
tg messages edit <chat> <id> [text]правит своё сообщение; повтор не меняет ничего.tg_messages_editсmcp --allow-send.tg messages forward <chat> <id> --to <chat> [--silent]проверяет получателя; при неизвестном результате сначала проверьте чат.tg_messages_forward.tg messages pin|unpin <chat> <id>, тихо без--notify; в личном чате закрепление только у вас.tg_messages_pin,tg_messages_unpin.tg reactions add <chat> <id> <emoji>,tg reactions remove <chat> <id>без часового лимита.tg_reactions_add,tg_reactions_remove.tg chats read <chat> [--until id]отмечает прочитанным видимо собеседнику.tg_chats_readтолько сtg mcp --allow-mark-read;--allow-sendне включает.tg messages delete <chat> <id…> --allow-dangerous [--for-everyone]: максимум 10, только у себя без--for-everyone, ничего без--allow-dangerous. Супергруппы/каналы требуют--for-everyone.tg mcp --allow-deleteпредоставляетtg_messages_deleteтолько для своей копии.tg polls show|vote|close|create: опрос, голос по идентификатору или--retract, закрытие своего, новый публичный без--anonymous;--send-idбезопасно повторяет.tg_polls_showчитает;tg_polls_vote,_close,_createс--allow-send.
0.13.0 — 30.09.2026
Изменения, влияющие на скрипты
- Структура общей базы версии 6 (cli-messaging 0.49.0). Первый
tgобновляетmessages.db; старыйmaxтребуетnpm install -g @wirecat/max-cli@latest. Командыtgне меняются.
0.12.0 — 30.09.2026
Новое
tg chats inspect <link>,tg_chats_inspect: название, участники, описание, ваш статус и необходимость одобрения по ссылке без вступления.tg topics list <chat>,tg topics search <chat> <text>,tg_topics_list: темы форума постранично с идентификаторомthreadId.
0.11.0 — 30.09.2026
Новое
- Текст голосовых в
tg messages listиtg inbox. Расшифровка сохраняется для профиля и видна при следующих чтениях:transcriptв--json,🎤 …в терминале.--transcribeраспознаёт остальные через Telegram или локальную модель, максимум две минуты на список; остаток вunheard. Аналогичноtranscribeуtg_messages_list,tg_inbox. tg chats members list <chat>,tg_chats_members: участники постранично с ролью и последним появлением, до лимита Telegram 10 000.tg contacts lookup,tg_contacts_lookup: человек по номеру при разрешённой приватности; телефон через stdin или запрос, не аргумент.tg contacts syncзагружает контакты и возвращает числа новых и изменённых.tg account sessions list,tg_account_sessions: устройства и приложения без IP; сессии не завершаются.
0.10.0 — 29.09.2026
Новое
-
Локальное распознавание речи.
tg models audio list,tg models audio download <id>скачивают Parakeet v3 (25 языков, по умолчанию), GigaAM v3/CTC (русский) в общую~/.cache/cli-common/models/audio.tg messages transcribeсначала пробует Telegram, без Premium — локальную модель;--local,--model <id>пропускают Telegram.transcribeWith(auto,messenger,local) иspeechModelзадают исходные значения. Автозагрузки нет. -
tg messages send --photo <path>,--file <path>,photo,fileуtg_messages_send: текст — подпись. Скрытые файлы,~/.ssh, каталоги tg и база запрещены без--allow-any-file; через MCP обхода нет. Журнал сохраняет тип/размер, не имя. Повтор с--send-idдаёт одну копию (проверено на фото). -
tg updateперезапускает сервер новой версией; ручной serve предлагается перезапустить.tg server statusсообщает устаревшую версию serve, как max-cli. -
tg chats events <chat> [--since] [--event],tg_chats_events: вступления, выходы, добавления, удаления с авторами, создание, переименование, закрепление из служебных сообщений; семь дней по умолчанию. Максимум десять страниц,moreпоказывает остаток.
0.9.0 — 29.09.2026
Новое
tg session startобъясняет аккаунт, путь сессии, источник ключей и следующий шаг;--jsonдобавляетsession,appKeys(environment,keyring,file, без ключей).tg chats list --search <text> --kind <kind> --unread, аналогичноtg_chats_list: совместные фильтры последних 200 чатов,--searchминимум 3 символа.tg messages list --after <id-or-time>читает вперёд после идентификатора или времени (2h,1d, ISO 8601);afterвtg_messages_list.tg messages send --silent --no-preview --md— без уведомления, без карточки предпросмотра ссылки и с**bold**,_italic_,~~struck~~и`code`как форматированием Telegram. Инструмент отправки MCP принимаетsilent,no_previewиmarkdown. Журнал отправок по-прежнему хранит только длину.tg messages send --at <time>передаёт отложенную отправку Telegram:2h,1d,2026-10-01T09:00местного времени.tg messages scheduled <chat>,tg_messages_scheduledпоказывают очередь. Повтор запрещён,--send-idотклоняется.
Изменения, влияющие на скрипты
tg service …→tg server …:start|stop|restart|status|logs|install|uninstall, как max-cli.tg serve statusзаменён наtg server status.tg server startбез службы работает в фоне. Служба изtg service installраспознаётся (cli-messaging 0.40.0).
0.8.0 — 29.09.2026
Новое
tg review: все сообщения, включая ваши, в чатах с активностью после--since(три дня). Показывает начало следующей проверки.--chat— один чат,--unanswered [hours]— вопросы без ответа с учётом администраторов,--all— архив и отключённые уведомления. Аналогичноtg_reviewи запросуreview.
0.7.0 — 29.09.2026
Новое
tg messages transcribe <chat> <id>,tg_messages_transcribeраспознают голосовые/видеозаметки через Telegram для Premium или пробной квоты. Ожидание до минуты, затем"pending": true. Отказ поясняет неверный тип, длину, отсутствие Premium.tg_messages_photoпередаёт агенту фото до 512 КБ. Большие фото, файлы, видео и голосовые отклоняются с командой сохраненияtg messages download.
0.6.0 — 29.09.2026
Новое
tg inboxисключает архив и чаты без уведомлений, кроме упоминаний и ответов вам.--all/allуtg_inboxвключает их. Иначе они занимали лимит 20 чатовinbox;quietсчитает исключённые.- Чат содержит
muted,archived,unreadMentionsв--json.archivedвынесен изproviderMetadata;mutedотсутствует при общих настройках аккаунта.
Исправления
tg messages send --silent,--no-preview,--markdownотклоняют отправку вместо игнорирования: cli-messaging 0.32 добавил их, но tg ещё не передаёт Telegram.
0.5.0 — 29.09.2026
Новое
tg service install|uninstall|start|stop|status|logsзапускаетtg serveслужбой systemd (Linux) или launchd (macOS) по профилям.installпишет файл; запуск только черезtg service start.tg backfill <chat> --background— фоновое задание;tg backfill list,status [job],cancel <job>управляют им. Ctrl-C/cancelзаканчивают текущую страницу и сохраняют её.tg backfill <chat> --estimateоценивает оставшиеся сообщения, запросы, секунды по базе без Telegram.tg export <chat> --format markdown— читаемая переписка.tg messages search --regex '<pattern>'— регулярное выражение по базе.tg doctor report create— версии, пути, ошибочный запуск и отправки без текста; идентификаторы заменяются метками.tg session start --qr-file login.pngсохраняет QR в PNG для агента и удаляет после входа; при сохранённом приложении терминал не нужен.tg messages download <chat> <id> [--output dir]сохраняет вложение в текущий или--outputкаталог и возвращает путь/размер. Имя не может выйти из каталога или скрыть файл; перезаписи нет. Сообщение каждый раз загружается заново, даже старое.
Исправления
tg messages list --jsonl,tg messages search --jsonlвыводят сообщение на строку, как в--help, вместо страницы. Скрипты должны читать строки, а не.items.
0.4.0 — 29.09.2026
Новое
tg inbox— чужие непрочитанные;--new— после последней проверки, каждое один раз. MCPtg_inbox, запросcatch-up.tg skill showвыводит инструкции агенту.- Готовые запросы MCP и ресурс чата:
reply,find,tg://chat/{id}.
0.3.0 — 28.09.2026
Новое
tg mcpпредоставляет профиль по stdin/stdout, по умолчанию чтение.--allow-sendдобавляет отправку,--confirm-sendпоказывает каждую владельцу.tg mcp configвыводит настройки клиента.
Изменения, влияющие на скрипты
- Ошибки до запуска команды сохраняются: неверное использование или конфигурация. Видны в
tg runs list;--no-recordотключает.
0.2.0 — 28.09.2026
Новое
tg updateобновляет через установивший менеджер пакетов;--checkпроверяет.- Раз в день stderr сообщает о новой версии npm, только в терминале после команды.
TG_NO_UPDATE_CHECK=1отключает.
0.1.0 — 27.09.2026
Первый выпуск в npm.
Новое
- Вход по QR или телефону (
tg session start); приложение my.telegram.org через браузер или--app auto, ключи в системном хранилище. - Чтение:
account show,chats list|show,contacts list|show,messages list|show|context. - Отправка:
messages send,messages replyс получателями, профилем для чтения, журналом (tg sends),--send-idдля безопасного повтора неизвестного результата. - Локальный архив: каждое чтение сохраняется в общую базу;
--offlineчитает,messages searchищет,backfillзагружает,watch,serveобновляют,sync status,exportпоказывают. - Записи запусков (
tg runs),config,doctor,commands, автодополнение (complete).