История изменений CLI MAX
История выпусков CLI для MAX: исправления, изменения и новые возможности.
Узнайте, что изменилось в выпусках: новые возможности, исправления и изменения, влияющие на команды. Начните со своей установленной версии, затем откройте инструкцию для функции, которую хотите попробовать.
Заметные изменения в @wirecat/max-cli. Формат — по одному разделу на версию, новое сверху;
номера версий по семантике, то есть до 1.0.0 интерфейс команд
ещё может меняться.
0.111.0 — 12.11.2026
Что нового
- Журнал запуска хранит прогресс синхронизации. Каждая строка прогресса
messages syncтеперь ещё и событиеsync.progressсо счётчиками, при любом формате вывода, поэтомуmax <profile> runs show <run>показывает, что видел WireCat Desktop и когда. - Часть имени в
from:иchat:.from:Ярослав*иchat:*Квестор*находят по части имени, алиаса или @username, регистр и ё/е не важны. Если под образец не подходит никто, ответnot_foundс ближайшими именами; если подходят больше 50,query.too-large, уточните образец. Номер и точное имя работают как раньше. Если точно так названы несколько людей, ошибка теперь предлагает и тех, у кого это имя только входит в имя: на «Ярослав» и «Ярослав Орлов». - Часть слова в тексте сообщений.
*договор*без поля находит «Договор», «ДОГОВОРЫ» и «переговоры», в том числе в большом архиве, внутриAND,OR,NOTи вместе сchat:иdate:. Нужны три буквы подряд. - Начало слова ищет там же, где целое слово.
счет*без поля теперь находит слово и в расшифровках голосовых, в тексте и в именах файлов, аmatched_inговорит, где именно.
Изменено — может сломать скрипты
- Собран на cli-core 0.642.0 (был 0.638.0). Хранилище остаётся на версии 66. Подробности в журнале изменений cli-core.
*часть*в тексте сообщений ищется так, как написана. Раньше*мои*находил и «мой», а*cafe*и «café». Теперь не важны только регистр и ё/е. Что учесть: пишите букву так, как она стоит в тексте, или ищите целое слово (мой), оно по-прежнему находит все формы.- Удалённые эмбеддинги по обычному http только на этом компьютере.
--base-urlилиembedding_base_urlс адресомhttp://на другой машине теперь отказmodel.address-refused: сообщения шли бы по сети без шифрования. Что учесть: укажитеhttps://или запустите модель на этом компьютере (localhost,127.0.0.1). Сохранённая настройка по-прежнему читается, другие команды не ломаются. list:в поиске сообщений теперь отказ. Это поле почты, и раньше запрос с ним молча ничего не находил. Теперь ответquery.unsupported-fieldс объяснением.- Тестовые данные скрыты из списков людей. Человек, у которого все адреса тестовые (
example.com,.testи подобные) или заведены как пример, больше не показывается ни в одном виде, в том числе вall.
Исправлено
messages sync --allпоказывает прогресс внутри чата. MAX отдаёт чат по 30 сообщений с паузой 5–10 секунд, а строка прогресса выходила, только когда чат закончен: на большом чате WireCat Desktop минутами показывал «Чат 1 из 36 · 0». Теперь счётчикfetchedрастёт после каждой страницы, не чаще двух раз в секунду.- Подсказка про хранилище паролей больше не отправляет в cron. Если вход в профиль был, а токен не читается,
ошибка и
max <profile> doctorтеперь говорят, что хранилище, скорее всего, заблокировано: сразу после загрузки оно открывается при входе в систему, и запуск по расписанию ждёт этого сам. Совет проXDG_RUNTIME_DIRостался для cron и ssh. - Ежедневное и разовое расписание пережидает просьбу MAX подождать. Если такой запуск по таймеру получил
rate_limited, он ждёт столько, сколько попросил MAX, если это не больше шести часов, и пробует ещё раз, а не пропадает до следующего дня. Что учесть: расписание с--everyи запуск руками по-прежнему завершаются ошибкой сразу. *слово*в тексте подсказывает выход. Если такой образец перебирает слишком много слов, ошибка теперь предлагаетслово*, который находит и формы слова.
0.110.0 — 11.11.2026
Что нового
participants_countв поиске и статистике.participants_count<10находит сообщения в чатах меньше чем из десяти человек, поэтомуstats messages show -- 'kind:private OR (kind:group participants_count<10)'считает личные разговоры без больших групп.
Изменено — может сломать скрипты
- Собран на cli-core 0.638.0 (был 0.633.0) и cli-base 0.96.0 (была 0.93.0). При первом открытии хранилище переходит на версию 66.
contacts unlinkтеперь требует--from person:<uid>или--from person:me: человек, от которого отвязывается аккаунт. Без него команда отказывает и подсказывает, что добавить. Аккаунт, который уже записан на другого человека, не двигается. Подробности в журнале изменений cli-core.
Исправлено
- Перевод системных часов назад больше не останавливает синхронизацию на часы. Если часы компьютера шли вперёд и их поправили, max считал, что MAX попросил подождать, и отказывал в каждой синхронизации, хотя к MAX даже не обращался. Теперь ожидание пересчитывается на величину сдвига, а в отказе больше не написано, что ждать попросил MAX.
0.109.0 — 10.11.2026
Что нового
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.108.0 — 10.11.2026
Изменено — может сломать скрипты
- Собран на cli-core 0.630.0 (был 0.624.0). При первом открытии хранилище переходит на версию 63. Вид каждого
человека хранится при нём, а сохранение участников чата не трогает строки тех, кто остался, поэтому
people listв memo фильтрует, считает и листает страницы в SQL. Кто писал в личном чате или в малой группе, теперь считается человеком владельца, ни одно правило не присоединяет никого к самому владельцу, а имя совпадает на кириллице и латинице. Инструмент на старом cli-core, который сохраняет участников, стирает сохранённые виды, поэтому max, tg и memo переходят вместе. Что изменилось между версиями, в журнале изменений cli-core.
0.107.0 — 09.11.2026
Изменено — может сломать скрипты
- Собран на cli-core 0.624.0 (был 0.618.0). При первом открытии хранилище переходит на версию 61 (связи людей с владельцем, только добавление). Что изменилось между версиями, в журнале изменений cli-core.
search messages --timeout 30sищет до 29 секунд. Раньше поиск останавливался через 2 секунды, сколько бы времени ни дали запуску, и правильный запрос по большому хранилищу падал в WireCat Desktop. Без--timeoutпредел остаётся 2 секунды, в том числе для агентов и MCP.schedule pause <имя>иschedule resume <имя>: расписание снимается с таймера и остаётся,schedule runего по-прежнему запускает.--atможно дать несколько раз:--at 08:30 --at 18:00.
0.106.0 — 09.11.2026
Что нового
- Пулреквест пишет свои строки для журнала изменений в отдельный файл,
changes/<ветка>.md. Открытые пулреквесты больше не конфликтуют в разделе «Не выпущено».pnpm docs:checkпроверяет каждый такой файл, аbin/releaseсобирает их в раздел версии. Пока идёт переход, запись в «Не выпущено» тоже работает.
Исправлено
max serveзавершается, когда его версия устарела, и служба запускает новую. Раз в минуту он проверяет, не перешло ли общее хранилище на формат, в который эта версия уже не может писать, и не установлена ли более новая версия max. Если да, он пишет в журналserve.outdatedи выходит с кодом 3, а служба systemd (Restart=on-failure) запускает установленную версию. Почему: раньшеserveмог работать на старой версии и ничего не сохранять.- После
max store recover runобычная синхронизация снова загружает то, что могло пропасть при повреждении. Восстановление помечает как не загруженное всё, что чат хранил начиная с суток до последней пройденной глубокой проверки. Из cli-core 0.618.0 (было 0.616.0).
0.105.0 — 09.11.2026
Что нового
max <профиль> account remove --keep-data|--delete-dataвыводит профиль из MAX и стирает его на этом компьютере. Команда завершает сессию на сервере MAX, потом удаляет токен из ключницы и файлы профиля: состояние, сокет и журналmax serve, а вместе с ними то, что общий слой хранит для профиля.--keep-dataоставляет сообщения в хранилище, и поиск их находит;--delete-dataудаляет и их. Другие профили не затрагиваются. Почему: до сих порsession endзабывал только токен, а остальное профиль оставлял за собой. Что учесть: пока для профиля работаетmax serve, команда отказывает, как иsession end: сначалаmax <профиль> server stop. Токен бота (bot:<профиль>) остаётся: бот это отдельный аккаунт. Запуск с перенесёнными папками забывает только свою копию и не выводит владельца из MAX.
0.104.0 — 08.11.2026
Изменено — может сломать скрипты
maxоткрывает хранилище, которое уже перевели memo и другие инструменты WireCat, и сам переводит его на версию 57. Хранилище версии 56 и выше не открываютmax0.103.0 и старше и все инструменты на cli-core старше 0.606.0: они просят обновиться. Что учесть: обновляйтеmax,tgи memo вместе (cli-core 0.606.0, 0.607.0).--offlineу команды, которой нужен MAX, отвечаетpermission_error(offline.refused) с кодом выхода 5. Раньшеchats inspect,chats events,chats folders …иupgradeотвечалиvalidation_errorс кодом 2. Что учесть: скрипт, который ждёт там код 2, должен ждать 5 (cli-core 0.607.0).contacts contextиcontacts prepareчитают только аккаунты той же сферы, что и профиль. Личный профиль больше не показывает почту, сообщения, события и встречи человека из рабочих аккаунтов, а рабочий — из личных. В ответе появилось полеaccounts: каждый прочитанный аккаунт и его сфера (cli-core 0.605.0).- Имя, набранное через «е», находит чат или человека с «ё». Имя, которое раньше совпадало с одним чатом или
человеком, теперь может совпасть с двумя (
АленаиАлёна); тогдаmaxотказывает и называет оба варианта, как при любом неоднозначном имени (cli-core 0.601.0). - Поиск чаще читает запрос как обычные слова.
?в конце слова — знак вопроса:счёт?находит «счёт». Текст с двоеточием, ссылкой, скобкой или незакрытой кавычкой (встреча в 10:30) ищется как слова, а раньше поиск отказывал (cli-core 0.602.0, 0.604.0).
Исправлено
- Повреждённый файл хранилища останавливает запись и называет
max store recover. Раньше команда, получившая от SQLite «database disk image is malformed», падала сinternal_error. Теперь ответ —configuration_error(store.damaged), и следующие команды, которые пишут, отказывают, пока глубокая проверка или восстановление не пройдут. Чтение работает (cli-core 0.605.0). - Людей, которых вы разделили, ничто не соединяет снова. Третий контакт с тем же адресом почты мог снова соединить двух людей после того, как вы их разделили (cli-core 0.605.0).
0.103.0 — 07.11.2026
Изменено — может сломать скрипты
max schedule agentиmax schedule commandпринимают--deliver-to <маршрут>вместо--to <маршрут>, аschedule listназывает полеdeliver_to(cli-core 0.600.0). Расписания, сохранённые с--to, доставляют результат как раньше.
Исправлено
- Открытие хранилища больше не сбрасывает блокировки файла SQLite. Раньше файл открывался с усечением, и это снимало POSIX-блокировки, которые держали другие процессы, так что две записи могли пересечься (cli-core 0.599.0).
max mcp serve --permission <ключ>=denyтеперь действует и на собственные командыmax. Раньше уровни, заданные серверу MCP, не видели проверкиmax: агент мог выполнитьcontacts sync,messages transcribe,watchи командыmax bot(например,bot comments send) по сохранённым уровням профиля, а запрос уходил в MAX. Теперь такая команда получаетpermission_errorдо соединения. Что учесть: запуск агента с такими уровнями больше не идёт через общийmax serve(он знает только сохранённые уровни), а открывает своё соединение, как и запуск с--permissionв терминале.
0.102.0 — 05.11.2026
Исправлено
max bot listиmax bot list --checkснова работают без имени профиля. В 0.101.0 на компьютере без профилей они отвечали ошибкойname a profile, и список ботов можно было получить, только поставив любое слово первым:max personal bot list. Команда читает все боты на этом компьютере, поэтому профиль ей не нужен, как и вtgиwa. Что учесть: остальные командыmax bot …по-прежнему требуют профиль,maxсам его не выбирает.
0.101.0 — 05.11.2026
Исправлено
- Запрос к Bot API и загрузка файла больше не держат завершённую команду в памяти до конца своего лимита
времени. Таймер лимита работал до конца, даже когда MAX уже ответил, и удерживал всё, что загрузила команда.
Процесс, который делает много запросов подряд, как
max bot mcpилиmax bot updates watch, рос с каждым запросом. То же исправлено для--timeoutу командmax bot.
0.100.0 — 05.11.2026
Что нового
max config migrateдописывает в файл каждую настройку, которой там нет, со встроенным значением, и так же делает любая записьmaxв файл. Вconfig.jsonвидны и правятся все настройки,serveиtranscribe_modelтоже, без документации. Ваши значения, их порядок и незнакомые ключи остаются;config unsetубранное обратно не пишет, а простое чтение файл не переписывает (cli-core 0.563.0).max config showу каждой настройки показывает встроенное значение и что она делает, а такжеkeep_successful_runs_for_daysиruns_size_limit_mb, которых в списке не было.- Из cli-core 0.563.0:
config repairчинит синтаксис JSON в файле настроек;stats messages responsesиstats messages waiting;tasks status,tasks reviewиtasks acknowledge. - Из cli-core 0.564.0–0.566.0:
store chats statusсчитает чаты, которые архив хранит с первого сообщения, частично или не хранит вовсе;stats tasks showпринимает запрос и считает задачи, открытые и закрытые за период (-- created>=30d);has:transcriptнаходит голосовые сообщения с расшифровкой.
Изменено — может сломать скрипты
- Запись в задачу, которую изменили после того, как вы её прочитали, теперь завершается кодом
conflict, выход 15, а неconfiguration_error, выход 3. Причина по-прежнемуtask.stale(cli-core 0.567.0, cli-base 0.77.1). max account listбольше не показывает бота как аккаунт без входа. Имя, которое есть только у бота, не выводится; имя, которое и ваш аккаунт, и бот, помеченоbot: true(cli-core 0.567.0).- Новый код ошибки
conflict(код возврата 15) есть вmax commands --jsonи в схеме ошибок инструментов MCP (cli-base 0.77.1). Он значит, что запись отклонена, потому что то, что она меняет, изменилось после чтения. Его возвращает запись в задачу на устаревшей копии (см. выше). search allранжирует все источники одним списком, ищет почту и по смыслу и находит записи по вопросу, написанному предложением (cli-core 0.564.0). Раньше находки источников шли по очереди, а вопрос находил только записи, где были все его слова.
0.99.0 — 03.11.2026
Что нового
wcat maxзапускает программу, аwcat --helpеё показывает. Пакет ставит командуwcat-maxрядом сmax, иwcat-max --wcat-describeпечатает дляwcatимя, версию и описание программы.
0.98.0 — 02.11.2026
Что нового
projects evidenceиprojects statusчитают связанные чаты по назначению:--purpose sales,workили--purpose all. Без флага берутся назначения по умолчанию (встроенное —work). Чат, который не попал в выборку, не пропадает молча: это строкаmissingс назначением, числом сообщений и командой, которая его прочтёт (cli-core 0.553.0).projects evidence --include-proposedчитает и чаты с людьми, которые предложены для проекта, но ещё не подтверждены; всё, что они принесли, помеченоproposed(cli-core 0.553.0).projects evidence --compactпечатает по строке на найденное, связанный чат, пропущенный чат и участника (cli-core 0.553.0).
Изменено — может сломать скрипты
- В JSON
projects statusпоявилось полеpurposes, а у чата, пропущенного по назначению, — аккаунт, id чата и счётчики (cli-core 0.553.0).
0.97.0 — 02.11.2026
Что нового
max serveдочитывает то, что пришло, пока он не работал. Через 30 секунд после подключения он читает чаты, в которых есть сообщения новее тех, что лежали в копии при его запуске: не дальше 7 дней назад, до 500 сообщений на чат и не дольше 5 минут. После простоя больше недели запустите один разmax <profile> messages sync --all(cli-core 0.552.0).server installвключает службу, иserveстартует при каждом входе в систему и после перезагрузки. Службу, которую поставил прежнийmax, включите, повторивmax <profile> server install;server statusпоказываетstarts_at_login. Служба из рабочей копии max записывается, но не включается (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).max <profile> projects status <проект>показывает, где стоит проект, только по локальной копии (cli-core 0.551.0).--compactпечатает по строке на элемент для агента, из того же ответа, что и--json(cli-core 0.550.0).messages listчитает окно с обеих сторон, и без сети тоже:'date>=2026-10-01 date<2026-10-20'читает вперёд от начала и останавливается на конце. Раньше такой запрос отказывал (cli-core 0.547.0).- Команда, которой нужен чат или сообщение, принимает и ссылку, которую печатают другие программы WireCat
(
msg:…,chat:…) (cli-core 0.546.0).
Изменено — может сломать скрипты
- Поиск, которому не хватило времени, завершается
timeoutс причинойquery.time-limitпримерно за 2 секунды, а неvalidation_error/query.too-largeпосле долгой работы. Запрос правильный; добавьтеchat:илиdate:, чтобы искать в меньшей части копии (cli-core 0.552.0). - Текст вида
<вид>:<без пробелов>вместо чата читается как ссылка, а ссылка на другой аккаунт или мессенджер отклоняется со своей причиной. Ключ после--читается как ключ (cli-core 0.546.0).
Исправлено
- Синхронизация, у которой закрылся вывод, доделывает работу. Закрытый канал (EPIPE) раньше её обрывал (cli-core 0.552.0).
messages deleteбез номера сообщения отказывает до подключения (cli-core 0.551.0).page.nextуmessages listвыполняется как написано, а начало «включительно» сохраняет сообщение, отправленное ровно в этот момент (cli-core 0.547.0).- Если ключница заперта,
max serveи запуск по расписанию пробуют снова, а не просят войти заново. Профиль, который уже входил на этом компьютере, но не может прочитать токен, отвечалauthentication_error(код 4). СлужбаserveсRestartPreventExitStatus=4после этого не перезапускалась до ручногоserver start, а таймер, сработавший при загрузке до входа в систему, терял запуск на весь день. Теперьmax serveи запуск под таймером (MAX_SCHEDULED) отвечаютprovider_unavailable(код 12) с причинойcredentials.unreachable: systemd перезапускает службу, аschedule exec(cli-core) повторяет запуск, пока вход не откроет ключницу. Команда, набранная вручную, отвечает как раньше.
0.96.0 — 02.11.2026
Что нового
max <profile> messages download --offlineкопирует файл, который уже есть на этом компьютере, не подключаясь;--attachment <n>выбирает один файл сообщения, а вместо чата и сообщения можно передать ссылкуmsg:(cli-core 0.532.0).- Первый запуск новой версии обновляет инструкции для агентов, которые поставила старая. Устаревшая копия
SKILL.md(Claude Code,~/.agents/skills, Hermes) переписывается один раз, с одной строкой в stderr; копию, которой нет, без версии или ссылку команда не трогает.MAX_NO_SKILL_REFRESH=1это отключает (cli-core 0.544.0).
Безопасность
- Агент больше не может ослабить права из своей оболочки.
max <profile> config set|unset permissions…, запущенная агентом (Hermes, OpenClaw, Claude Code и другие, что помечают свою оболочку), может только ужесточить уровень, но не ослабить, аmcp.authorityиbot.apiменяет только владелец. Поэтому режим «только чтение», который ставит приложение WireCat, держится, даже если сообщение в чате уговорит агента запуститьconfig set. Права меняйте в терминале вне агента (cli-core 0.544.0).
0.95.0 — 01.11.2026
Что нового
projects evidence --jsonдаёт команду докачки для каждого привязанного чата вlinked_chats[].sync_command: ту же строку, что в тексте, или null, если чат загружен полностью (cli-core 0.517.0).
Исправлено
projects evidenceбольше не пишет «held from only» про чат, который дошёл до первого сообщения: теперь «held from its first message, behind since » или «with gaps». Прогрессmessages syncпоказывает, докуда дошёл, датой («back to »), а не ключом сообщения, который в MAX был числом миллисекунд (cli-core 0.517.0).
0.94.0 — 01.11.2026
Что нового
max <profile> projects evidence <project>(projectsCommandиз cli-core). Показывает, что о проекте есть в сохранённых сообщениях этого аккаунта: название, ключ, другие имена, слова, контакты, подтверждённые участники и привязанные чаты.--sync-first(по умолчанию выключен, в MCP его нет) сначала докачивает привязанные чаты, которых в хранилище нет до--since-time, по одному, за--sync-time(3 минуты на все). Чат, на который не хватило времени, остаётся частичным, сmissingиnext. Если докачать не удалось (например, нужен запущенныйserve), чат помечаетсяfailedс причиной, а чтение продолжается. Доступ закрывает правоmessages(cli-core 0.511.0).
Изменено — может сломать скрипты
- Журнал вызовов MCP называет агента, который сделал вызов, а не
max-mcp(cli-core 0.509.0): имя, которым клиент назвал себя (clientInfo.name, напримерclaude-code), иначе агента, запустившего сервер, иначеmax-mcp. Фильтр поmax-mcpновые вызовы не находит. Имя — слова самого клиента, только подпись.
0.93.0 — 31.10.2026
Что нового
messages sync --jsonпишет ход синхронизации в stderr (cli-core 0.507.0): по одной строке JSON, только счётчики, без id и названий чатов. stdout по-прежнему несёт один ответ.
Изменено — может сломать скрипты
search messages --discoverищет по смыслу и тогда, когда в запросе есть-,NOT,OR, скобки, фразы илиexact:(cli-core 0.506.0). Раньше такой запрос шёл только строгим поиском. Теперь слова по-прежнему ищутся всем запросом (discovery.method: "lexical-strict"), а к ним добавляются сообщения, близкие по смыслу к его словам. Каждое сообщение, найденное по смыслу, и каждый добавленный ответ или продолжение подходят под все поля запроса и не содержат исключённых слов.
Исправлено
- Описание
doctorто же, что у остальных CLI: «the state this installation is in, without connecting unless --online» (cli-core 0.507.0). Раньше max подменял его своим, и сводка расходилась с общей. 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).
- Запасной файл для токена теперь ведёт cli-base 0.68.0, без своего кода в max (cli-core 0.507.0). Токен из
личного файла читается оттуда, и ротация оставляет его там;
session startвозвращает его в связку ключей и удаляет копию в файле, как в 0.92.0. Предупреждение о недоступной связке ключей — по-прежнему одно за запуск.
0.92.0 — 31.10.2026
Что нового
search messagesговорит, сколько всего сообщений подходит:page.total(cli-core 0.501.0). В--jsonпоявилосьpage.total: { value, relation }в формеhits.totalиз Elasticsearch:eq— точное число,gte— не меньше (счёт останавливается на 10 000). В терминале под найденным —showing 1–20 of 144.session start --credential-storage keyring|file. По умолчанию токен в системном хранилище паролей, а если оно недоступно — в файле, доступном только вам, без вопросов и с одним предупреждением.fileвыбирает файл сразу; не советуем. Токен из файла читается первым, так что запертое хранилище для него больше не трогается; следующий вход с хранилищем возвращает токен туда. Ответ говорит, куда лёг токен:credential_storage. Нужен cli-core 0.503.0.
Изменено — может сломать скрипты
- max требует cli-base 0.67.0 (cli-core 0.501.0).
0.91.0 — 31.10.2026
Что нового
messages list --offline,tasks agendaиsearch allговорят, когда локальная копия держит чат только частично (cli-core 0.493.0). Чат, скачанный не до начала или ни разу не скачанный, даётmeta.complete: false,missingиnextс шагомmessages sync <чат>(сначала за окно ответа, если оно есть). Вtasks agendaу каждой строки естьcompletenessиheld, а в тексте такой чат помечен[partial]или[never fetched]. Код выхода остаётся 0.
Изменено — может сломать скрипты
search messages,search all,tasks agendaиmessages list --offlineотвечаютmeta.complete: false, если чат, который они читали, есть в копии только частично (cli-core 0.493.0). Раньше былоtrue, а пробел был виден только вmissingиnext. Скрипт, который считалmeta.completeзнаком «ни один источник не упал», должен читать причину вmissing. Код выхода по-прежнему 0.- Продолжения в
search messages --discover --jsonидут отрывком до 240 знаков, как сама находка:items[].follow_ups[].excerptвместоtext(cli-core 0.496.0). В 0.90.0 продолжение шло целым сообщением, и на реальном архиве одно длинное сообщение добавляло 7 КБ к ответу из пяти находок. Целиком сообщение показываетmessages context <ref>. Вывод в терминале не изменился.
Исправлено
search messages --discoverс датой и временем в кавычках больше не падает сquery.invalid-date(cli-core 0.496.0). Исправление «22:00» в 0.90.0 заменяло двоеточие между цифрами и внутри кавычек, поэтомуdate:["2026-08-21T21:30:00Z" TO "…"]с--discoverне работал.search notesи заметки вsearch allсоблюдают поля запроса и для найденного по смыслу (cli-core 0.496.0).date:todayилиtag:workбез--exactвозвращали около 20 заметок, не подходящих ни под одно поле. Теперь по смыслу ищутся только слова запроса, а каждое поле и каждое исключённое слово (-draft) действуют на все находки.- У документа Drive
date:и показанноеupdated_at— одно время, время правки в Drive (cli-core 0.496.0). Раньшеdate:читал время изменения копии, и из 20 находок поdate>=30dу 16 была показана более старая дата. - Запуск с перенесёнными папками больше не может стереть вход владельца из связки ключей и не выводит его из MAX
(cli-base 0.65.5, WC-SECR-24). Раньше перенесённым считался только запуск с
MAX_*_DIR; запуск с другимHOMEили папкой XDG трогал настоящую записьmax-cli, иsession endв нём стирал её. Теперь такой запуск читает вход владельца, но не меняет и не удаляет его, а новый вход пишет во временную запись.session endна входе владельца ничего не завершает и отвечаетkept: "owners-sign-in". bin/maxв рабочей копии больше не копирует токены: копия читает вход владельца, аscripts/seed-worktree.tsпереносит только состояние профиля.- max требует cli-base 0.65.5 и cli-core 0.496.0.
0.90.0 — 31.10.2026
Что нового
max <профиль> search messages '<вопрос>' --discoverпоказывает продолжения — более поздние сообщения, которые могут отменить или поменять найденное (cli-core 0.492.0). К первым пяти найденным добавляется до двух более поздних сообщений из любого чата, который читает поиск, с редким общим словом (его основа есть не более чем в трёх сообщениях архива): так видно, если решение потом отменили, а отмена не была ответом. В--jsonэтоitems[].follow_ups, в терминале — строкиlater, shares a rare word. Что учесть: продолжения появляются, когда основы слов уже построены.
Исправлено
search messages --discoverбольше не падает на вопросе со временем или пропорцией («до 22:00», «1:1») (cli-core 0.492.0). Двоеточие между цифрами читалось как фильтр поля, и поиск завершался ошибкойquery.invalid-syntax.- Поправка к 0.89.0: в нём же запись в хранилище перестала падать с «database is locked», пока другая программа WireCat пишет в него (cli-core 0.485.0). Запись 0.89.0 об этом не говорит.
- max требует cli-core 0.492.0 (cli-base остаётся 0.65.0).
0.89.0 — 31.10.2026
Что нового
contacts list notes:находит часть слова в любом регистре, в том числе кириллицу (cli-core 0.490.0). Раньшеnotes:КВАРТне находил заметку со словом «квартира»: сравнение без учёта регистра работало только для латиницы, а поиск читал все заметки. Теперь заметки ищутся по индексу из трёх символов и отвечают за миллисекунды. Что учесть: запрос короче трёх символов отклоняется с ошибкой «search needs at least three characters» (пустой запрос по-прежнему ничего не отбирает). Хранилище обновится до версии 40 при первом открытии; заметки, сохранённые раньше, получают индекс порциями приsearch notesилиstore migrate, а пока их ищет прежний способ. Сборка другой программы WireCat со старым cli-core не пишет индекс в уже обновлённое хранилище, поэтому обновите все программы WireCat сразу.
Исправлено
- Поправка к 0.88.0: поля карточки контакта называются
firstName,lastNameиuserId. В записи 0.88.0 про вложениеCONTACTони названыfirst_name,last_nameиuser_id; #874 переименовал их, а запись осталась прежней. - max требует cli-core 0.491.0 (cli-base остаётся 0.65.0). В 0.491.0 исправлена только почтовая синхронизация, max её не использует.
0.88.0 — 31.10.2026
Что нового
- Карточка контакта в сообщении (
CONTACT) читается как контакт: у вложения естьcontactс именем,first_name,last_nameиuser_id. Раньше такое вложение приходило только с видомcontact, без имени. Что учесть: MAX не присылает телефон в карточке, поэтому поляphoneнет.
Исправлено
- Поиск по названию чата и по имени контакта не зависит от регистра в любом алфавите (cli-core 0.484.0). Раньше
max <профиль> chats list 'title:СТАС*' --offlineне находил чат «Стас»: локальное хранилище сравнивало без учёта регистра только латинские буквы. Теперь находит; так же работаетname:вtags listдля названий чатов и имён контактов. Что учесть: хранилище обновится до версии 38 при первом открытии, ничего делать не нужно. Если то же хранилище открывает более старая сборка другой программы WireCat и переименовывает что-то, поиск по новому названию заработает после следующего открытия хранилища новой сборкой. max --helpпоказываетgcalв списке «Works with» (cli-core 0.482.0). Это Google Календарь рядом с остальными данными WireCat;max setupпредлагает установить@wirecat/gcal-cli. Если скрипт сверяет текст первого экрана, в нём появилась одна строка.- max требует cli-core 0.484.0 (cli-base остаётся 0.65.0).
0.87.0 — 30.10.2026
Исправлено
- Личные диалоги в локальном хранилище получают название по имени собеседника, и
max <профиль> chats list 'title:Стас*' --offlineих находит. Раньше у диалога в хранилище не было названия, а каждый вход в MAX стирал и то, что успел записатьchats list, поэтому поиск по названию без сети не находил ни одного диалога, и агентам приходилось перебирать все. Теперь после входа название берётся из имени собеседника (то же имя показываетcontacts), в том числе у диалогов, записанных раньше. Что учесть: диалог, чьего собеседника нет в контактах и среди участников чатов, остаётся без названия, пока не выполненchats listс сетью.
0.86.0 — 29.10.2026
Изменено — может сломать скрипты
max contacts infoзаменён командойmax contacts show(cli-core 0.477.0). Она показывает контакт целиком, телефон теперь выводится полностью, без маски. Что сделать: в скриптах заменитеcontacts infoнаcontacts show. Старого вида команды больше нет.- max требует cli-core 0.478.0 (cli-base остаётся 0.65.0).
Исправлено
sender_is_meвinbox,review,search messagesиsearch all(cli-core 0.478.0). Эти ответы не отмечали ваши собственные сообщения; теперь поле есть, как вmessages list.
0.85.0 — 29.10.2026
Изменено — может сломать скрипты
max mcp serveбез профиля больше не отдаёт все профили (cli-core 0.470.0). Он завершается с кодом 2 (validation_error) и перечисляет профили этого компьютера. Назовите профиль первым словом (max work mcp serve), список (max mcp serve --profiles work,personal) или все (--profiles all). Так же работают--http,mcp server start|stop|status,mcp revokeиmcp config. Кого касается: запись MCP-клиента из 0.83.0–0.84.0 сmax mcp serveбез профиля перестанет запускаться — напечатайте её заново черезmax mcp config --profiles allили впишите профиль. Фоновый сервер всех профилей, запущенный этими версиями, запустите заново командойmax mcp server start --profiles all. Запись в MCP Registry уже запускаетmcp serve --profiles all, Docker-образ — профильglama,doctor --online— проверяемый профиль.- У каждого сообщения в ответах
messages list,show,context, поиска иinboxестьsender_is_me(cli-core 0.473.0). Оно истинно для своих сообщений, в том числе в MAX, где у владельца нет id отправителя. Скрипт, который сверяет ответ со строгой копией схемы, отвергнет новое поле. - max требует cli-core 0.473.0 (cli-base остаётся 0.65.0).
max --helpв «Works with» теперь называет иmail. - Навык для агентов опубликован в ClawHub под именем
wirecat-max. Установка:openclaw skills install @wirecat/wirecat-max. Записьmax-cliбольше не обновляется.max skill installпо-прежнему пишетskills/max-cli/.
0.84.0 — 27.10.2026
Изменено — может сломать скрипты
- 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-сервер предлагает команду, которая только загружает данные в хранилище, через инструмент чтения.
0.83.0 — 27.10.2026
Изменено — может сломать скрипты
- MCP-сервер запускается командой
max mcp serve, аmax mcpтолько показывает справку (cli-core 0.463.0). Так же для бота:max <бот> bot mcp serve. Входы браузерных приложений завершаетmax mcp revokeвместоmax mcp --revoke. Записи, которые печатаютmcp configиmcp add,mcp server start,doctor --online, запись в MCP Registry и Docker-образ уже запускаютmcp serve. Что сделать: в своей записи MCP-клиента или в скрипте заменитеmax <профиль> mcpнаmax <профиль> mcp serve, аmcp --revokeнаmcp revoke. Старого вида команды больше нет. skill show,skill statusиskill installс--jsonпечатают{ item, meta }(cli-core 0.462.0). Поля, которые были на верхнем уровне (name,content,written), теперь внутриitem. Установщик для Windows уже читает новый вид.max account listпоказывает, вошёл ли профиль на этом компьютере (signed_in), а результаты поиска любого вида называют поля, которые агент читает как данные (untrusted). Скрипт, который сверяет ответ со старой строгой копией схемы, отвергнет новое поле (cli-core 0.464.0 и 0.466.0).- Каждый запуск записывается по умолчанию, удачный тоже (cli-core 0.467.0). Удачные хранятся 7 дней
(
keep_successful_runs_for_days), неудачные — 30 (keep_runs_for_days); каталог запусков не большеruns_size_limit_mb(200). Приrecord_inputпо умолчанию удачная отправка оставляет набранный текст в локальной записи с правами0600на 7 дней.record: falseтеперь оставляет неудачные запуски (раньше — ничего),record_input: falseскрывает набранное везде,--no-recordне оставляет ничего.kept_because_failedвrun.jsonбольше не ставится. - max требует cli-core 0.467.0 и cli-base 0.64.0.
Что нового
- Запрос в записи запуска помечен как сетевой и знает свою попытку. Каждый кадр личного протокола и каждый
запрос Bot API в
events.jsonlполучает"level": "wire"иtransport(max-wsилиhttp). Запрос Bot API получает ещёattempt, а повтор после429или сбоя —wait_ms, сколько клиент ждал перед ним. Так же нумеруются повторыmessages send, пока файл не готов (attachment.not.ready). Нужен cli-core с записью каждого запуска. max upgradeперезапускает браузерный MCP-сервер, который запустилmax mcp server start, на том же порту, с тем же адресом и ограничениями (mcp_servers, старая → новая версия); сервер, запущенный вручную, остаётся и называется. Сессии агентов по stdio на старой версии перечислены (stale_sessions): перезапустите их из приложения агента. Работает со следующего обновления (cli-core 0.464.0).
Исправлено
max mcp serveбез профиля помечает профили, в которые не выполнен вход. Раньше в списке были все профили, и приложение могло выбрать профиль без входа и получить ошибку. Теперь в меню приложения и в описании у такого профиля стоит «— not signed in», профили только для бота не показываются (у бота свойbot mcp serve), а вызов для профиля без входа отвечает, как войти:max <профиль> setupили из WireCat Desktop.- Страница входа браузерного MCP-сервера объясняет, что код работает для одного входа. После входа приложения
новый код появляется в WireCat Desktop и в
max mcp server status(cli-core 0.466.0). - Навык max-cli больше не отправляет агента в
search allи вmessages sync --all. Поиск начинается сsearch messages; заметки и Drive только по просьбе владельца. Если ничего не нашлось, агент сообщает об этом и предлагает ограниченную загрузку одного чата, а запускает её после согласия владельца. Те же правки в README и в docs (search, usage, index, troubleshooting).
0.82.0 — 27.10.2026
Что нового
- Без сессии ошибка предлагает и WireCat Desktop.
no session,has not logged in yetи истёкший токен теперь говорят: команда в терминале или вход в WireCat Desktop (Tools → MAX → Manage). По MCP агенту сказано не просить коды и пароли (cli-core 0.452.0; с ним и 0.451.0: поиск по смыслу на нативном ONNX Runtime и в Windows). max mcpбез профиля обслуживает все профили, по stdio и с--http(cli-core 0.450.0). В AI-приложении нужен один коннектор для MAX, а не по одному на профиль. У каждого инструмента (max_tools_search,max_read,max_write) есть обязательное полеprofile(все профили на этом компьютере, без умолчания), и агенту сказано спросить, если вы не назвали аккаунт. Вызов идёт в собственныйmax <profile> mcpэтого профиля: он запускается при первом вызове и закрывается после 10 минут простоя, так что права, сессия и журнал профиля действуют как раньше.max mcp --revoke,max mcp configиmax mcp server start|stop|statusработают без профиля, со своим входом.--public-urlпринимает путь,https://<name>.ts.net/max. Запись в MCP Registry запускаетmax mcp.max <profile> mcpне изменился.
Изменено — может сломать скрипты
- max требует cli-base 0.63.0 (cli-core 0.450.0). Ничего из того, чем пользуется max, в нём не изменилось.
Исправлено
- Каждая команда тратит меньше времени на подготовку (cli-base 0.62.0, cli-core 0.449.0). Проверка общих команд
описывает каждую команду один раз, а не заново для каждой группы над ней. В tg прогретый
run(["--version"])стал быстрее: 29 мс вместо 49. Почему: проверка занимала около 60% подготовки каждой команды. Что учесть: ничего, проверка ловит те же изменения. - Поиск по смыслу и
--discoverработают на родной ONNX Runtime и в Windows (cli-core 0.451.0). Послеmax <профиль> models downloadтекстовые модели и переранжировщик используют родную библиотеку в Windows x64 и arm64, как уже в Linux и macOS: в 2–3 раза быстрее WebAssembly. Загрузка берётonnxruntime.dllиз npm-пакетаonnxruntime-node(113,5 МБ, один раз, сверка по sha256). Модели картинок (CLIP, SigLIP2) тоже идут через родную библиотеку, где она установлена: примерно вдвое быстрее. Результаты те же.
0.81.0 — 26.10.2026
Что нового
- Поиск по смыслу и переранжирование
search messages --discoverработают в 2–3 раза быстрее на Linux и Mac с Apple Silicon (cli-core 0.448.0). Модели теперь считаются нативной библиотекой ONNX Runtime вместо WebAssembly: на одном архиве--discoverускорился с 4,6 до 3,2 с, ответы те же. Библиотеку (10–42 МБ, официальный выпуск Microsoft, проверяется по sha256) ставитmax <профиль> models download; поиск сам ничего не скачивает. Что учесть: на уже настроенной машине ускорение появится после следующегоmodels download e5-smallилиmodels download mmarco. Windows, Mac на Intel и Alpine по-прежнему работают через WebAssembly.
Исправлено
- Переранжирование
--discoverвидит само найденное сообщение, а не только то, на которое оно отвечает (cli-core 0.447.0). Раньше модель читала сначала исходное сообщение целиком и обрезала текст на 512 токенах, так что при длинном исходном ответ выпадал из её окна. Теперь от исходного берутся первые 300 знаков.
0.80.0 — 26.10.2026
Что нового
max <профиль> session start qr --json --answer-stdinвходит без терминала, для WireCat Desktop (cli-core 0.443.0). Облачный пароль MAX спрашивается строкойneedsв stderr ({"event":"needs","field":"password","secret":true,"prompt","hint"}), а ответ читается одной строкой из stdin;session start tokenтак же спрашивает токен. Без--answer-stdinзапуск без терминала по-прежнему отказывается, чтобы оболочка агента никогда не ждала вопроса. Ответ не печатается и не попадает в записи запусков.max <профиль> mcp server start|stop|statusдержит HTTP-сервер MCP в фоне (cli-core 0.445.0).startпринимает--public-url,--portи--permission, какmcp --http, и возвращается, когда сервер слушает;statusпоказывает порт, адрес, одноразовый код входа и вошедшие приложения;stopостанавливает только свой сервер. WireCat Desktop запускает и останавливает его из панели Manage.max <профиль> tasks list claimed_by:<кто>показывает задачи, которые взял этот исполнитель (cli-core 0.441.0).claimed_by:*— все взятые задачи,NOT claimed_by:*— те, за которые никто не взялся; шаблон вродеclaimed_by:claude-code:*тоже работает. Учитываются только живые захваты: захват с истёкшим сроком ничего не держит.
Изменено — может сломать скрипты
- Справка
--recordговорит, что на самом деле хранит запись запуска. Было: «ids and timings, never message content», хотя с 0.79.0 запись хранит командную строку так, как вы её набрали. Стало: «with the command as typed and secrets hidden; record_input false leaves the typed words out». Что учесть: меняется текстmax --helpиdocs/commands.md; проверка, которая сравнивает справку, увидит новую строку.
Исправлено
- Код входа для браузерного приложения у
mcp --httpобновляется, когда истекает (cli-core 0.445.0), а не только после неверного или опоздавшего ввода. Страница входа говорит, что код показан в WireCat Desktop или в терминале. Второйmcp --httpдля того же профиля теперь отказывается запускаться. search messages --discoverс переранжированием читает только первые 300 символов сообщения, на которое отвечает найденное (cli-core 0.447.0). Почему: длинное исходное сообщение занимало всё окно модели, и она оценивала его вместо самого ответа. Что учесть: порядок результатов--discoverс моделью переранжирования может измениться; модель делает примерно на 40% меньше работы.
Безопасность
- Запись запуска скрывает больше секретов по их виду, а не только по имени флага (cli-core 0.440.0–0.444.0). На
[redacted]заменяются токены известных форматов (GitHub, OpenAI и Anthropic, Slack, AWS, Google, Stripe, npm, токен бота Telegram, JWT, закрытый ключ PEM),BearerиBasic, значение после «секретного» имени (password=…,пароль 1234,pin 1234,код 123456), длинные случайные строки и hex-ключи; остальные слова остаются. Номер телефона с «+» или 11–15 цифр подряд скрыт, где бы его ни набрали, в том числе в тексте сообщения. Что учесть: полный хеш коммита и положительный id из 11–15 цифр тоже станут[redacted]; номер без «+», записанный группами (8 912 345-67-89), не распознаётся. - Если настройки не загрузились, запись запуска скрывает набранные слова (cli-core 0.442.0). Раньше в этом случае
record_inputсчитался включённым, даже если в настройках записаноrecord_input: false.
0.79.0 — 26.10.2026
Что нового
max skill install --for hermesставит навык для Hermes Agent, аmax skill statusговорит, какую копию читает Hermes (cli-base 0.59.0). Команда добавляет~/.agents/skillsвskills.external_dirsHermes черезhermes config set, не трогая уже записанные папки, а если это не вышло — копирует файл в домашнюю папку Hermes. Если Hermes не установлен, команда падает сnot_foundи ничего не пишет. Простоmax skill installи--for allпо-прежнему пишут только копии для Claude Code и~/.agents/skills. Вskill status --jsonрядом сtargetsпоявилсяhermes.- Запуск, начатый OpenClaw или Hermes Agent, называет этого агента (cli-core 0.437.0). В
runs showу команды, которую запустил агент OpenClaw,agent—openclaw, а если её начало сообщение из чата — ещёfrom_chat: true; у запуска Hermes есть его сессия, так что задачу, взятую Hermes, держит одна сессия. - Новая настройка
record_input(cli-core 0.439.0).max personal config set record_input falseскрывает в записях запусков то, что вы набрали;config setиconfig showеё показывают. - Навык
max-cliобъявляет для OpenClaw и ClawHub, что ему нужна программаmaxи как её поставить (metadata.openclaw:requires.binsи пакет npm@wirecat/max-cli). Еслиmaxнет в PATH, OpenClaw помечает навык как неготовый и предлагает установить пакет. Claude Code и Codex этот блок не читают.
Изменено — может сломать скрипты
- Запись запуска хранит командную строку так, как вы её набрали (cli-core 0.439.0). В
argvвrun.jsonи вruns showтеперь видно название чата, поисковый запрос, текст сообщения — раньше вместо них стоял[redacted]. Секреты скрыты всегда: значения флагов вроде--tokenи--password, пароль в адресе, длинная строка, похожая на ключ, телоbot api … --body, номер телефона, набранный послеcontacts lookup. Почему: по записи должно быть видно, что именно запускали. Что учесть:max personal config set record_input falseвозвращает прежнее скрытие для профиля,max config set record_input false --defaults— для всех; скрипт или проверка, которая ждёт вargvтолько[redacted], увидит набранные слова.doctor reports createпо-прежнему скрывает их в отчёте.
Безопасность
- Первое слово, которое не может быть профилем, не попадает в запись запуска (cli-core 0.438.0). Раньше такой запуск хранил его как
profile, хотя это мог быть текст сообщения или имя человека. - Ошибка, которая цитирует
--token=…илиpassword=…, больше не хранит значение (cli-core 0.439.0).
Исправлено
- Навык
max-cliбольше не предлагает агентуnpx @wirecat/max-cli, еслиmaxне находится. Он запускает уже установленныйmaxпо полному пути:"$(npm prefix -g)/bin/max" personal doctorили"$(pnpm bin -g)/max" personal doctor. Почему:npxскачивает код, а каталоги плагинов могут запрещать такой запуск; обычноmaxустановлен, но его нет в PATH агента. Агенты читают навык черезmax skill show.
0.78.0 — 26.10.2026
Исправлено
maxпредставляется текущим веб-клиентом MAX:appVersion26.10.7 и Chrome 154 (было 26.9.8 и Chrome 151, прочитано 25.09). MAX отказывает версиям клиента, которые больше не поддерживает;max doctorпоказывает дату 2026-10-26.npx skills add WireCatLabs/max-cliпредлагает только навыкmax-cli. Раньше он показывал и четыре навыка для разработчиков max (add-command,parity-audit,release,test-live): они лежали в.claude/skills, а skills.sh ищет навыки и там. Теперь они вdocs/dev/skills.- Вектор удаляется, как только его не использует ни один текст в базе (cli-core 0.435.0). Раньше после смены
картинки у изображения, смены текста расшифровки встречи и очистки чата (
store clear --left, слияние чата с другим) векторы оставались.conversations embeddings clear --chatтеперь убирает и векторы сообщений чата, не только его бесед;conversations embed --chatсоздаёт их снова. Что учесть:store rebuildудаляет векторы, оставшиеся от прежних версий, и сообщает их число вunused_vectors_dropped;store checkсчитает их вvectors.unused. - В установке одна копия sherpa-onnx, а не две (cli-core 0.433.0). В 0.77.0 max перешёл на sherpa-onnx 2.0 раньше cli-core, и установка выросла примерно на 15 МБ; теперь и cli-core на 2.0. Команды и их вывод не меняются.
Изменено — может сломать скрипты
- Общая база переходит на версию 34: CLI на cli-core 0.433.0 и старше её больше не откроют (cli-core 0.434.0).
Поиск по смыслу берёт кандидатов из индекса sqlite-vec в базе, а не перебирает все векторы; ответ тот же, что у
перебора. Первое открытие базы этой версией строит индекс по уже сохранённым векторам, короткими порциями.
Почему: перебор всех векторов медленнее с каждым сообщением, у которого есть вектор.
Что учесть: обновите вместе с max все CLI, которые читают ту же базу (tg, wa, memo, zm, drive), — старые откажутся
от неё и попросят обновиться. Расширение входит в установку (
@wirecat/cli-core-sqlite1.1.0); если оно не загрузилось, команда, которой нужна база, завершается ошибкойstore.vector-extension-missingилиstore.vector-extension-failed— переустановите max.store checkпоказываетvector_indexesи не проходитchecks.vector_indexes, когда индекс расходится с векторами. - Справка
max upgradeпоказывает только примерmax upgrade --check(cli-core 0.433.0). Почему: примерmax upgradeбез флага, скопированный и запущенный, сразу обновлял программу. Что учесть: в выводеmax upgrade --helpиmax commands --jsonменяется только эта строка. - Модель Anthropic получает ключ в заголовке
Authorization: Bearer, а неX-Api-Key(cli-core 0.433.0,@anthropic-ai/sdk1.3). Почему: так отправляет ключ новая версия библиотеки Anthropic. Что учесть: касается толькоmodels.<назначение>.base_urlс провайдеромanthropic, то есть своего шлюза вместо адреса Anthropic: такой шлюз должен читать ключ изAuthorization.
Что нового
search messages --discoverпереставляет первые 50 результатов моделью-реранкером, когда она скачана (max models download mmarco, 136 МБ; cli-core 0.435.0). Модель читает вопрос вместе с каждым результатом, его чатом, автором, датой и сообщением, на которое он отвечает; её оценка смешивается с оценкой поиска, а остальные результаты сохраняют порядок. У каждого переставленного результата естьdiscovery.reranker_score, аscoreостаётся оценкой поиска. Без модели порядок прежний, и поиск говорит об этом: заметкаnot reranked: …в терминале,missing/next(models.download) в--jsonи MCP. На перестановку отведено 15 секунд сверх поиска по словам; не успела — результаты остаются без неё. Новая настройка профиляsearch_rerankerвыбираетbge-reranker-v2-m3(588 МБ) или выключает перестановку (off). Ничего не скачивается само, и текст не уходит с компьютера.models listпоказывает реранкеры с видомreranker.search allищет сообщения и по смыслу, когда модель e5-small скачана и у сообщений есть векторы (cli-core 0.435.0). Совпадения по словам и по смыслу сливаются в один список сообщений, аfoundByу каждого говорит, какой поиск его нашёл. Запрос с NOT или с фильтром внутри OR и групп, а также--exactи--backend serverищут только по словам. Без модели или векторовsearch allищет по словам, как раньше, и говорит почему: заметкаmessages: meaning search not used: …,missing/nextв--jsonи MCP.
0.77.0 — 25.10.2026
Изменено — может сломать скрипты
- Распознавание голосовых сообщений работает на sherpa-onnx 2.0, а установка стала больше примерно на 15 МБ.
Раньше max и cli-core использовали одну копию sherpa-onnx 1.13.8.
Почему: все зависимости обновлены до последних версий; в 2.0 убраны только части синтеза речи,
распознавание работает как прежде.
Что учесть: пока cli-core не перейдёт на sherpa-onnx 2.0, в установке лежат две копии этого пакета.
Команды и их вывод не меняются. Неиспользуемые
string-widthиwrap-ansiбольше не ставятся вместе с max; если ваш скрипт подключал их из установки max, поставьте их отдельно. - Запуск
bot-команды, который упал, называет вызов Bot API, на котором это случилось. Вruns showиruns listуerror.httpрядом с HTTP-кодом появилисьmethodиendpoint_template, например{ "method": "GET", "endpoint_template": "/chats/:id", "status": 403 }; раньше там был только код. Почему: по одному коду не видно, какой из вызовов команды отказал. Что учесть: id чата, пользователя и сообщения в пути записаны как:id, токен видео — как:token, а параметры запроса в шаблон не попадают, поэтому настоящие id и токен в запись не попадают. Те же два поля есть у запросов бота в--traceи в записи запуска, а строка--traceпоказывает их после имени операции (← getMyInfo GET /me 200 …). Скрипт, который разбирает текст--trace, увидит лишний столбец.
Что нового
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говорит, какой поиск его нашёл. До этого поиск идёт по словам, как раньше, и объясняет почему. Ничего не скачивается, и текст не уходит с компьютера.
Исправлено
- Голый
--versionотвечает до загрузки программы: bin запускается через@wirecat/cli-core/cli/start(cli-core 0.429.0).
0.76.0 — 25.10.2026
Исправлено
- Сбой посреди команды теперь сообщается как любая другая ошибка. Раньше печаталась трассировка стека Node, теперь — ошибка
internal_error(command.crashed): одна строка в терминале, JSON-объект ошибки в остальных случаях; код выхода по-прежнему 1. Почему: трассировка ничего не говорит скрипту и может вывести на экран текст, которому там не место. Что учесть: если скрипт разбирал трассировку в stderr, пусть читает объект ошибки.
Что нового
max doctor --jsonперечисляет все ошибки файла настроек вconfig.issues(cli-core 0.423.0). Каждая ошибка —{ kind, file, profile?, key?, line?, column?, what, fix? };kind—invalid_json,unknown_setting,unknown_permission,missing_settingилиinvalid_value. Для неверного JSONlineиcolumnпоказывают, где разбор остановился; для остальныхfix— командаconfig unset, которая убирает ключ и выполняется как написана. Значение настройки в ответ не попадает. С ошибками в файлеdoctorотвечает и завершается с кодом0, а без имени профиля отвечает сprofile: null.config showработает с файлом, в котором есть ошибки, и называет каждую с командой, которая её убирает.config unsetудаляет и ключ, который не знает ни одна схема, в том числе в корне файла (max config unset <ключ>).max skill statusиmax skill show --for claude|agents(cli-core 0.427.0).statusговорит, совпадает ли установленный SKILL.md с этой версией;show --forпечатает установленную копию.max store tables listперечисляет таблицы общего архива, аstore infoпоказывает больше о файле (cli-core 0.427.0).- Запись запуска говорит, кто его начал и что пошло не так (cli-core 0.425.0). В
run.json,runs list,runs showиsearch runsпоявилисьcli_command,argv(содержимое и секреты —[redacted]),agentи для упавшего запускаerror.
Изменено — может сломать скрипты
npm install -gвыбирает агента для навыка только поMAX_INSTALL_AGENT.TG_INSTALL_AGENTбольше не читается.- В ответе
doctorвместо строкиconfig.error— списокconfig.issues. Если настройки не удалось разрешить из-за блокировки профиля, флага или переменной окружения, сообщение — вsettings.error. - Старые имена настроек больше не распознаются.
default_profile,analysis_provider,analysis_model,analysis_base_urlс переменнымиMAX_ANALYSIS_*и имена в camelCase (sendsPerHourи другие) — неизвестные настройки, как любые другие: команда отказывает и называетconfig unset, который убирает ключ. Модель анализа задаётся вmodels.analysis.provider,models.analysis.modelиmodels.analysis.base_url. messages syncиbot messages syncпроверяются по своим ключамmessages.syncиbot.messages.sync(cli-core 0.421.0). Уровень наmessagesилиbot.messagesпо-прежнему действует на них, а запрет, записанный прямо наmessages.syncилиbot.messages.sync, теперь останавливает команду. Команды бота проверяют запрет на чтение до подключения.- Сохранённый ключ права, который не проверяет ни одна команда, останавливает и команды бота, и
--dry-run. Ошибка называет ключ иconfig unset, который его удаляет;config show,setиunsetработают, чтобы файл можно было исправить. - Прежние имена команд получают обычный ответ «unknown command», без подсказки.
max personal search mailбольше не называет memo: почту ищетmemo search mail. - Запуск без названного профиля записывается без
profile, а не с"profile": "default"(cli-core 0.424.0). - В записи запуска стек упавшей команды начинается с имени пакета и без строк Node (cli-core 0.425.0). Строка стека —
MaxClient.connect @wirecat/max-cli/client.js:1497, а неclient.js:1497; строкnode:internalбольше нет. config setзаписываетconfig.jsonс правами0600, а не0644(cli-base 0.57.0). В файле — профили, аккаунты и пути владельца. Программа, которая читает настройки от имени другого пользователя, после следующегоconfig setих не прочитает.
Безопасность
max doctorназываетconfig.jsonи его каталог, если их могут читать другие пользователи, и командуchmod, которая это исправляет. В--jsonэтоfiles:{ checked, ok, problems: [{ path, mode, want }] }, файл должен быть0600, каталог —0700. Для каждой проблемы на stderr строкаto make it private: chmod 600 '<путь>'; самdoctorправа не меняет. Каталог проверяется и тогда, когда его задаётMAX_CONFIG_DIR. Блок есть и без имени профиля, и когда настройки не разрешились; в отчётdoctor reports createон тоже попадает. В Windows права не проверяются:files—{ checked: false, reason }.
0.75.0 — 25.10.2026
Что нового
Изменено — может сломать скрипты
- Старые имена разрешений статистики и поиска больше не распознаются. Раньше ключи
messages.stats,chats.stats,tasks.stats,messages.search,conversations.searchиtopics.searchостанавливали команду с подсказкой, как их переименовать; теперь такой ключ просто не действует, и запрет, сохранённый под старым именем, больше не применяется. Переименуйте их вstats.messages.show,stats.chats.show,stats.tasks.show,search.messages,search.conversationsиsearch.topics. - Общая база переходит на версию 33 (cli-core 0.420.0). Когда эта версия откроет базу, CLI на более старом cli-core откажется с ней работать и попросит обновиться, поэтому обновляйте все CLI WireCat, которые делят базу, вместе.
0.74.0 — 25.10.2026
Изменено — может сломать скрипты
bot store fetchтеперьbot messages sync, группыbot storeбольше нет. Команда делает то же, что личнаяmessages sync, поэтому и называется так же;store— это локальная база. Старое имя отвечает подсказкой с новым. Если в настройках сохраненоpermissions.bot.store.fetch, команды откажут, пока ключ не переименован вpermissions.bot.messages.sync.
0.73.0 — 25.10.2026
Что нового
-
chats requests confirm|reject <чат> --allотвечает на все заявки канала сразу. Количество заявок сначала проверяется по правам профиля и лимиту действий в час, затем уходит один запрос MAX. Используйте только для канала, где нужно ответить всем ожидающим. Отбор через--linkнедоступен: текущий интерфейс MAX не сообщает, по какой ссылке пришла заявка. -
Списки участников бота, комментариев и разрешённых получателей принимают запрос по полям. Идентификаторы участников и комментариев передаются в Bot API до ограничения страницы; список получателей фильтруется при чтении и не меняет права отправки. Комментарий также показывает свой строковый
id, когда API передал его вbody.mid.
Исправлено
-
watch --jsonlпечатает записиitemи итоговуюend. Ошибка источника завершает поток неполным итогом;--jsonотказывается до подписки. Список разрешённых получателей использует общий нативный запрос. -
Архивирование не останавливается на событии звонка рядом с файлом. Файл сохраняется и проходит проверку контрольной суммы, сообщения только со звонком не требуют скачивания.
-
Диагностический отчёт использует общий модуль WireCat. Формат MAX и технические поля событий сохраняются; содержимое сообщений исключается, идентификаторы получают метки внутри отчёта.
-
Запрет прав не скрывает команду. Каталог CLI и MCP сохраняет команды и показывает текущую доступность с причиной запрета; вызов по-прежнему проверяет права. MCP бота также показывает команды настройки в пределах профиля бота.
-
Изменение настроек использует общую реализацию WireCat.
config set|unsetсохраняет формат ответа, настройки MAX и ограничения прав; проверка и запись файла выполняются общим модулем.
Изменено — может сломать скрипты
-
Второй адрес webhook добавляется с
--append.--add <chat>остаётся флагом изменения папки. Неизвестный состав чата и список типов webhook теперь отсутствуют вместоnull. -
Общие контракты команд нельзя менять молча.
commands info --jsonпоказывает исходные определения, схемы, причины ошибок и явные отличия MAX. Для событий контакта вместо флагов времени и области используютсяat:иscope:, для записей диагностики —started_at:.
Безопасность
- Разрешение зависимостей исключает уязвимые версии Vite. Проверка производственных зависимостей выполняется и для сохранённого, и для нового разрешения.
0.72.0 — 24.10.2026
Что нового
-
max serveпосле входа запрашивает ещё больше того, что запрашивает вкладка web.max.ru: карточки и статус «в сети» собеседников из личных чатов. После первого входа ещё истории для списка чатов, недостающие чаты папок и следующую страницу списка. Почему: чем меньшеmaxотличается от веб-клиента, тем меньше у MAX поводов его заметить. Что учесть: всё это только чтение, ответы не показываются. Подписки на push-уведомленияmaxпо-прежнему не отправляет (что уходит в сеть). -
При первом обычном запуске в терминале
maxзадаёт три общих вопроса: языки поиска, установка других инструментов WireCat и допустимость изменений. Ответ «только чтение» ограничивает все профили, в том числе MCP, даже если у профиля есть более точныйallow. Агентам, конвейерам, JSON-режиму и CI вопросы не задаются. Изменить ответы можно черезmax setup.
Изменено — может сломать скрипты
-
Общие команды переименованы по единому словарю, старых имён больше нет (cli-core 0.406.0). Например:
contacts profile→contacts info,contacts timeline→contacts events,contacts alias→contacts aliases,chats link→chats links,metadata refresh→metadata sync,store reindex→store rebuild,commands schema→commands info,stats messages counters refresh→stats messages counters sync,models text key→models keys,models audio list→models list kind:audio,doctor report→doctor reports show. Старая команда не запускается и называет новую. Скрытые старые написания опций тоже убраны. Что учесть: перенесите скрипты, расписания и сохранённые вызовы MCP. Ключ прав со старым путём (напримерpermissions.metadata.refresh) теперь останавливает запуск сconfiguration_errorи называет новый. -
max <profile> watch --jsonпечатает записи{ "type": "item", "data": … }и в конце{ "type": "end" }(cli-core 0.400.0). Поля сообщений и событий — snake_case, значения сообщений в каноническом виде со ссылками. Нормальная остановка и таймаут завершаются полнымend, сбой источника — неполным и кодом ошибки. Что учесть: читатели прежних сырых строк нужно обновить. -
Поиск запусков —
max <profile> search runs, а неruns search. Условияstatus:,error_code:,operation:иprofile:пишутся в запросе:search runs status:failed error_code:timeout. Псевдонима нет; сохранённые запросы MCP нужно перенести наsearch runs. -
Статистика выбирает строки запросом. Вместо
--chatи--exact—chat:иexact:; рейтинги —message_kind:иmin_messages:, обсуждения —min_views:иmax_replies:, вопросы без ответа —older_than:. Сохранённые вызовы CLI и MCP нужно перенести;--sourceи--timezoneостались опциями. -
Команды, меняющие то, что смогут следующие запуски, доступны агенту через MCP только при
permissions.mcp.authority: allowилиaskв профиле (по умолчаниюdeny):config set|unset,recipients add|remove|clear,replies …,schedule command|agent|remove,skill install,flood clear, ключи моделей и другие. Агент не может сменить этот ключ черезconfig set. Подробности — в разделе «Чего нет в MCP». -
Работа с хранилищем, управление сервером, скачивание моделей и создание отчёта доступны через MCP. У команд появились собственные ключи разрешений, например
store.backup,server.start,models.download,doctor.reports.create; по умолчанию —ask. Проверьте права профиля, если агент должен выполнять только чтение: в MCPaskдопускает запрошенную запись без формы подтверждения. -
Сырые операции
bot apiдоступны агенту только при явномpermissions.bot.api: allowилиask. По умолчанию —deny; общийbot: allowэтот доступ не открывает. Агент не может менятьmcpиbot.apiчерез настройки или заменятьpermissionsцеликом; отдельные остальные ключи доступны при разрешённомmcp.authority. Вызовы Bot API в max сохраняют проверки прав и списка получателей, запись в журнал. -
Пары похожих задач читаются через
tasks duplicates list [query...]. Группаtasks duplicatesбольше не выводит список. Перенесите сохранённые вызовы CLI и MCP на явную командуlist. -
events listвозвращает даты ISO 8601 и строковые идентификаторы.starts_at,ends_at,deleted_at,created_at,updated_atбольше не числа миллисекунд;idиevent_series_idбольше не числа. Обновите обработчики JSON, если они рассчитывали на прежние типы. -
doctor reports createпроверяет права до создания файла. При неверной конфигурации команда отказывает с кодом 3, потому что разрешение на запись нельзя проверить. Сначала прочитайте причину черезdoctorи исправьте настройку; при корректном файле безопасное создание отчёта доступно и подMAX_READ_ONLY.
Исправлено
attachments downloadпропускает сервисные события и встроенные клавиатуры. Такие вложения не содержат файла; раньше чат с ними останавливал копирование с кодом 13. Уже сохранённые копии можно проверить черезattachments check; повторное скачивание сохраняет их.
0.71.0 — 23.10.2026
Что нового
-
Расшифровка голосового находится в любой форме слова и в искажениях распознавания речи (cli-core 0.396.0).
max <profile> search messages риелторнаходит в расшифровке и «риелтору», и «реелтора». Сообщение, найденное только через искажение, помеченоmatch: "corrected"иcorrections. Числительные, фразы,exact:и написанный текст сообщений не расширяются. Текст, который агент записал к голосовому, — тоже расшифровка. Хранилище переходит на версию 29 при первом запуске. -
Через MCP агенту доступно больше команд, каждая в пределах прав профиля (cli-core 0.398.0):
config show,doctor report,runs list|show|path,store status|info|check|export|reindex,store jobs cancel|retry|clear,attachments move,attachments jobs status,commands schema,guide,skill show, списки моделей,replies status|test|consents show,schedule list,server status|logs; у бота —list,chats leave,chats admins add|remove,commands set|clear,webhooks list|set|delete. Что агенту недоступно и почему — в разделе «Чего нет в MCP». -
max <profile> review --offlineотвечает по локальной копии вместо отказа (cli-core 0.398.0). Он показывает только то, что уже было синхронизировано, и предупреждает об этом (missingв JSON). -
Проверяемые копии файлов.
attachments download <dir>сохраняет доступные файлы разных чатов с размером и SHA-256;attachments check <dir>проверяет копии без сети.attachments jobsуправляет ежедневным копированием в Linux, включаемым явно. Готовые копии переживают прерывания и очистку истории сообщений.attachments move <dir> <archive-dir> --before-time <time>переносит старые изображения в другой проверяемый архив и сохраняет новое расположение, чтобы проверять копии и не скачивать их повторно. -
Поиск по сохранённым расшифровкам голосовых находит формы слов и варианты, искажённые распознаванием речи.
text:ищет только написанный текст;exact:отключает расширение поиска для указанного слова.
Исправлено
- Пример из
--helpможно вставить и запустить: строкаExample:называет профильpersonal(max personal review "date>2h"), а не падает с «name a profile» (cli-core 0.398.0). - Сохранённые поиски встреч больше не показываются и не удаляются командами поиска сообщений.
- Подсказки исправления команд сохраняют явно выбранный профиль; справка показывает краткие описания и примеры.
Изменено — может сломать скрипты
- В аргументах MCP удаление сообщений принимает
message, экспорт чатов —chat, операции с дубликатами задач —taskи, для пары,other_task. Обновите сохранённые MCP-запросы с ключамиmessages,chatsилиdup. Порядок позиционных аргументов CLI не изменился. - Команды справочника
commandsиcommands schemaотклоняют--jsonl: используйте--jsonдля одного документа.
0.70.0 — 23.10.2026
Что нового
contacts prepare <person>готовит сводку перед разговором из сохранённых сообщений, задач, фактов и заметок, со ссылками на источники. Команда общая с tg и wa и не подключается к MAX (cli-core 0.394.0).- В справке команд появились примеры вызова из cli-core 0.394.0.
Изменено — может сломать скрипты
- Чтение больше не помечает чаты прочитанными. У
messages listудалён--mark-read, уinboxиreview—--mark-readи--no-mark-read; настройкаcatch_up_marks_readбольше не принимается. Чтобы явно отправить отметку, используйтеchats mark-read. - Неизвестный вложенный ключ разрешений теперь отклоняется как ошибка конфигурации, до подключения. Исправьте опечатку в ключе вместо прежнего предупреждения.
0.69.0 — 22.10.2026
Что нового
- JSON-ответы команд с фильтром по дате называют пояс, в котором прочитана дата, и дают окно в UTC
(cli-core 0.385.0):
meta.timezone— пояс, если в значении его не было,meta.window— границыsinceиuntilв UTC. Так отвечаютstats chats show,stats chats retention,stats messages unanswered,stats messages discussion,stats contacts responses,stats chats newcomers,contacts context,search conversations,runs search,messages sync,store export,replies test, а такжеinbox,review,chats eventsиchats members historyс условиемtime:илиdate:в запросе. Почему: по одному ответу было не понять, какое окно команда взяла на самом деле, если дата была без пояса. Что учесть: поля новые и необязательные, прежние поля не изменились.search conversationsс--timezoneтеперь читает дату без времени в этом поясе. - У чата в JSON появились
muted_until(когда кончается отключение звука, UTC) иmarked_unread(чат помечен непрочитанным) (cli-core 0.382.0).
Изменено — может сломать скрипты
inboxиreviewпо сохранённым чатам больше не показывают чаты с отключённым звуком и архивные (cli-core 0.382.0). Раньше в сохранённых чатах этих отметок не было, и такие чаты попадали в выдачу. Почему: max присылает отметки в списке чатов, и ответ по сохранённым чатам теперь совпадает с ответом MAX. Что учесть: если скрипт ждал такие чаты вinboxилиreview, ищите их черезchats list.- Хранилище, в которое процесс не может писать, теперь даёт ошибку прав (
permission_error, код выхода 5, причинаstore.not-writable) (cli-core 0.381.0). Раньше это былаinternal_errorс текстом «this is a bug». Что учесть: скрипт, который ловил код выхода этой ошибки, получит 5 вместо прежнего.
Исправлено
- Чат или человека теперь находит имя, скопированное вместе с эмодзи (cli-core 0.381.0). Скопированный эмодзи часто несёт невидимый знак, которого нет у набранного, и «Семья❤️» не находила чат «Семья❤».
0.68.0 — 22.10.2026
Изменено — может сломать скрипты
- Дата или время без пояса в
--since-time,--until-time,--at-timeиchats mute --untilчитаются в поясе компьютера, а дата без времени — как местная полночь (cli-core 0.379.0, cli-base 0.48.0). Раньше2026-09-01означало полночь по UTC. Пояс, названный в самом значении (…Z,+02:00), по-прежнему главный; где у команды есть--timezone, он важнее пояса компьютера. Как граница «до» дата без времени охватывает весь местный день. Почему: «сообщения за 1 сентября» — это день владельца, а не день по UTC, который начинается на несколько часов раньше или позже. Что учесть: скрипт, который передавал дату без пояса и ждал UTC, теперь получит другое окно. Чтобы оно не менялось, пишите время сZ:2026-09-01T00:00:00Z. JSON-ответы по-прежнему дают время в UTC сZ. stats chats retentionиchats stats showчитают--since-timeи--until-timeв поясе--timezone, а дата в--until-timeу retention охватывает весь местный день (cli-core 0.380.0). Ответыstats charts,contacts timelineи MCPstatsназывают пояс вmeta.timezoneи окно в UTC вmeta.window.
Исправлено
max watchпишет время сообщений в поясе компьютера и называет его строкойtimes in <пояс>перед первым сообщением. Раньше пояс нигде не назывался. Строки--jsonlне изменились.max doctorи отказ во входе после частых попыток пишут время как2026-10-21 16:03 Europe/Madrid. Раньше это была строка UTC вида2026-10-21T14:03:00.000Z, которую легко прочитать как местное время. Вmax doctor --jsonвремя осталось в UTC.
0.67.0 — 21.10.2026
Исправлено
- Закрытая или недоступная связка ключей Linux теперь даёт предупреждение и переходит на файл учётных данных (cli-base 0.47.5). Связка читается только через Secret Service; раньше сбой мог закончиться тихим сохранением в памяти ядра, которое пропадает после выхода из сессии или перезагрузки.
0.66.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 ». max guide catch-upи первый экранmax --helpберут фильтр в кавычки:max review 'date>1d' --unanswered 4h. Без кавычек оболочка читала>как перенаправление: создавала файл1d, аreviewшёл без фильтра. На cli-core 0.370.0 проверка сценариев в тестах ловит такие символы вне кавычек.- «Works with» пишет название сценария memo так же, как memo и остальные инструменты: «One person across every tool», с заглавной.
0.65.0 — 19.10.2026
Что нового
store clear --leftназывает чаты, которые удаляет (cli-core 0.353.0–0.362.0). Отказ без--allow-dangerousперечисляет первые 20 по id, названию и числу сообщений; новый--dry-runпоказывает все вleftи ничего не удаляет; ответ после удаления тоже несётleft.
Изменено — может сломать скрипты
- Без терминала
session start qrиsetupпечатают QR-код текстом, а--qr-fileудалён. Владелец входил через PNG, который агент открывал в просмотрщике картинок, — отдельное окно легко потерять. Теперь код идёт в stderr обычным текстом (символы█▀▄, без цвета, читается на тёмной теме), агент вставляет его в чат блоком кода. С--jsonкод ещё и строка{"event":"qr","qr":{"text","expires_at","scan"}}в stderr. В терминале код рисуется как прежде. Скрипт с--qr-fileтеперь получает ошибку о неизвестной опции. Как агенту войти — sessions.md.
Исправлено
- Чат, в который владелец вернулся, больше не остаётся помеченным «покинут» (cli-core 0.352.0). Неполный
список чатов и вход снимают эту метку с чатов, которые они называют; «в архиве» и другие состояния остаются.
Раньше такой чат мог пропасть из
max chats list, аstore clear --leftудалял его вместе с сообщениями. Полный список, как и прежде, помечает «покинут» чаты, которых в нём нет.
0.64.0 — 19.10.2026
Что нового
session start qr --qr-file <png>иsetup --qr-file <png>, как в tg и wa: QR-код пишется в PNG для агента, без терминала. Файл создаётся сразу с режимом0600и удаляется после входа. Вход по QR теперь идёт черезloginQrиз cli-core 0.347.0, один для всех трёх CLI.- Следующий шаг в выводе
--jsonи в ошибке несётline— всю команду с профилем (cli-core 0.348.0):"line": "max personal mcp config"рядом с"command": "mcp config". Скопированная однаcommandпадала с «name a profile».commandне меняется, в ответах MCPlineнет.
Изменено — может сломать скрипты
- Узкий терминал больше не открывает QR-код в браузере. Код не рисуется, и
maxпишет, что окно нужно расширить или передать--qr-file. Почему: вход по QR теперь общий для tg, max и wa, а браузер, открытый сам собой, нельзя было перенести в cli-core для всех трёх. MAX выдаёт один код на запуск, поэтому в узком окне дождаться нечего: прервите команду и запустите её шире или с--qr-file. - Без терминала
session start qrиsetupотвечают так же, как tg и wa: «shows a QR code to scan — run it in a terminal, or pass --qr-file ».
Исправлено
- Шаг входа в
setupназывается «Link this device» и больше не просит отсканировать QR-код до того, как он нарисован. Где сканировать, говорит строка под самим кодом; в узком терминале — только подсказка расширить его. - Узкий терминал больше не просит отсканировать QR-код, которого нет (cli-core 0.350.0).
session start qrиsetupписали «scan this code with the MAX app on your phone» до кода; если код не помещался, дальше шла только подсказка расширить окно или передать--qr-file. Теперь строка «scan in the MAX app on your phone» идёт после нарисованного кода или заметки о--qr-file, а на узком терминале выводится только подсказка. - Подсказки в ошибках и заметках называют профиль: «the store is behind this build —
max personal store migrate» вместоmax store migrate, которая при копировании падала с «name a profile». Так же подсказка о скачивании модели речи:max personal models audio download gigaam-v3.
0.63.0 — 19.10.2026
Что нового
max --helpиmaxбез команды показывают короткий первый экран (cli-core 0.345.0): что умеет max, другие инструменты WireCat и куда идти дальше —max commands,max guide,max help options,max skill show. Полный список команд и все общие опции он больше не печатает.max guide— сценарии: какие команды выполнить по порядку для частой задачи. Четыре сценария:catch-up(разобрать накопившееся),find-what-was-said(найти, что кто-то написал),agent-on-a-timer(агент по расписанию, который не может отправлять) иpost-as-a-bot(написать от имени бота).max guide <имя>печатает шаги,--json— то же данными. Сценарийmemo guide person-briefпоказан в разделе «Works with».max help optionsпечатает опции всех команд,max --help-all— прежнюю полную справку.max commandsбез--jsonпечатает список команд по разделам (Read, Write, Organise, Automate, Set up), по строке на команду;max commands <путь>сужает его.- Справка каждой команды заканчивается строками Returns, Next usually и Example, и те же строки есть в справочнике команд.
Изменено — может сломать скрипты
npm install -gбольше не ставит навык агента сам. Он молча писал в~/.claude/skillsи~/.agents/skills, а npm прячет вывод сценария установки. Теперь навык ставитmax <профиль> setupилиmax skill install --for all;MAX_INSTALL_AGENT=all(или имя агента) при установке ставит его сразу, как раньше. Установщик для Windows передаётallсам и ведёт себя как прежде.max --helpбольше не перечисляет команды и общие опции. Скрипту, который искал их там, нуженmax --help-allилиmax help options.max commandsбез--jsonпечатает текст, даже в канал. Раньше он печатал весь JSON-документ (сотни килобайт); скрипту, который его разбирал, нужно добавить--json.- Опечатка в опции списка с запросом — ошибка неизвестной опции (
unknown option '--limt' (Did you mean --limit?)), а не слово запроса. Отрицание вроде-kind:channelпо-прежнему часть запроса.
Исправлено
inboxиreviewобъявляют свой вывод (cli-core 0.345.0):max commands schema inboxдаёт поля сводки сообщения, а--json=<поля>с именем, которого у неё нет, отказывает со списком полей, а не возвращает пустые записи.--briefи--fullбольше не упоминают почту в справке max.- Опечатка в имени профиля больше не создаёт профиль.
max typoprofile chats listотказывал, но оставлял файлprofiles/typoprofile.json, и потом ошибка «name a profile» иmax completeпредлагалиtypoprofileкак профиль на этом компьютере. Теперь файл появляется только при входе;session endдля такого имени его тоже не создаёт. Файлы, оставшиеся от прежних опечаток, можно удалить из~/.local/share/max-cli/profiles/. max <профиль> doctorбез токена советуетmax <профиль> setup, как README и ошибка «no session», а неsession start.
Безопасность
- Запрет записи срабатывает до подключения к MAX (cli-core). Под
MAX_READ_ONLY=1или с уровнемreadonlyлибоdenyкомандыmessages send,messages edit,messages delete --for-everyone,reactions addи другие записи сначала подключались к MAX и только потом получали отказ; при сломанном входе выходили с кодом10. Теперь — код5, соединения нет, как и обещает страница о безопасности. Отказ остаётся вsends listкороткой строкой: ключ команды и вид, чат — только если указан его id. --dry-runподMAX_READ_ONLYбольше не отвечает «можно» на запись, которую настоящий запуск запретил бы.max mcpподMAX_READ_ONLYне предлагает записи в MAX, а вызов такой команды черезmax_writeполучает отказ запрета, а не «нет такой команды».
0.62.0 — 18.10.2026
Что нового
- Агент получает через
max mcpвсе команды, которые разрешают уровни профиля (cli-core 0.341.0). Раньше сервер предлагал 141 написанный вручную инструмент; теперь инструменты строятся из самих команд, и агенту доступна 181 команда — среди нихmessages sync,contacts sync,chats members fetch,chats tracking add/remove,contacts link/unlink,mentions confirm/reject/rebuild,conversations embed,images embed,tasks reject,contacts import,account privacy setиchats app. Что агенту нельзя, решают уровни профиля: поставьтеreadonlyилиdenyнужной области. Полный список закреплён вcontracts/mcp-catalogue.json. conversations rebuild— собрать заново беседы чатов, которые изменились, и посчитать для них векторы моделью на этом компьютере; MAX не спрашивает, модель не скачивает, текст никуда не отправляет. Заменяет инструмент агентаconversations_refresh.
Изменено — может сломать скрипты
- Аргументы инструментов
max mcpназываются как опции команд в snake_case:chat,limit,query,sync_firstи так далее. Агенту, который запоминал старые имена, нужно заново спроситьmax_tools_search. search messagesу агента больше не принимает структурный запросast— только текст запроса, как в командной строке.- Агент не может отметить прочитанным и действовать от имени владельца:
--mark-readуmessages list,inboxиreview,--as-ownerиmessages send --allow-any-fileагенту не предлагаются, а настройкаcatch_up_marks_readна его запуски не действует. Его отметки--newотдельные от ваших.
Исправлено
max mcpотвечает на все вызовы, полученные до закрытия stdin, а не выходит, бросив тот, что ещё выполнялся. Уmax bot mcpтак пока не сделано.max tasks --helpбольше не обещает, что задачи открываетserve. Справка говорила «review and serve add them». Теперь она говорит, что задачи открываютreview,inboxиmessages sync, аserve— только просьбы из правил автоответа. Почему:serveв MAX не проверяет вопросы и упоминания при получении. Кто держалserveзапущенным и ждал задач, видел пустой список до следующегоreviewилиmessages sync. Что учесть: поведение не изменилось. Пустойtasks listтеперь говорит то же самое (cli-core 0.341.0).max mcp --helpподсказываетclaude mcp add max -- max <profile> mcp(cli-core 0.341.0). Прежняя подсказка без профиля всегда падала с «name a profile», и агент получал неработающий сервер.- На Node 22 команды, которые открывают хранилище, больше не печатают
ExperimentalWarning: SQLite is an experimental feature(cli-core 0.341.0). Агенты принимали эти две строки в stderr за ошибку. Другие предупреждения печатаются как раньше. tags removeпо псевдониму метки снимает её так же, какtags addеё ставит (cli-core 0.341.0).- Запуск немного быстрее (cli-base 0.45.0): таблицы словаря и правил больше не разбираются при каждом запуске, только когда стартует сервер для агента.
Безопасность
attachments extract --output-dirотказывает в папках с ключами, папках самогоmaxи папке хранилища (cli-core 0.341.0), как уже отказывал инструмент агента.
0.61.0 — 18.10.2026
Что нового
tasks agendaпоказывает, что должны вам другие (cli-core 0.328.0): открытые задачи, которые делает кто-то другой, — отдельный раздел иassignedв--json, старые сверху.- Агент может выключить и включить звук чата (cli-core 0.338.0):
chats muteиchats unmuteтеперь есть среди инструментовmax mcp. Каждый проверяется по своему ключу (chats.mute,chats.unmute); в чате никто об этом не узнаёт. - Примеры в справке у
account privacy show,account privacy set,chats mute,chats unmute,messages pin,messages unpin,metadata getиmetadata refresh(cli-core 0.336.0, 0.339.0).
Изменено — может сломать скрипты
bot messages send --reply-toпринимает только id сообщения MAX,mid.…, и агент сreply_toтоже. Другое значение команда отклоняет до отправки (код 2). Раньше оно уходило в MAX как есть.bot messages show,edit,delete,pinиunpinтоже принимают толькоmid.…, и агент тоже. Другое значение команда отклоняет до первого запроса (код 2). Раньшеdeleteс несколькими id удалял сообщения до первого неверного и только на нём падал (not_found).- Команда без терминала, которая ждёт человека, получает 5 минут, а не 30 секунд (cli-core 0.328.0), например
session startу агента.--timeoutиMAX_TIMEOUTпо-прежнему решают, если заданы. - Путь команды одним аргументом — ошибка (cli-core 0.328.0):
max 'chats list' --helpраньше печатал общую справку с кодом 0, теперь отвечаетvalidation_errorи показывает, как написать правильно. - Агент больше не видит
offlineуbot me,bot comments list,bot comments getиbot chats members list. Эти команды всегда спрашивают MAX и отклонялиoffline; теперь аргумента нет в описании инструмента (cli-core 0.335.0). conversations buildиconversations embedпомечены как меняющие что-то вне этого компьютера (cli-core 0.334.0, 0.336.0): с--analyzeи--providerони отправляют текст переписки внешнему сервису, аsearch conversationsс удалённой моделью отправляет туда запрос. ПодMAX_READ_ONLYвсе три отказывают до отправки; модель на этом компьютере или на локальном сервере работает как раньше. Черезmax serveони не выполняются. Вdocs/commands.mdтакая пометка теперь звучит «вне этого компьютера: в MAX или во внешнем сервисе», а не «в MAX».- Под
MAX_READ_ONLYsession start,session endиsetupотказывают ещё до начала работы (код 5, «it cannot log in or out»), а не изнутри команды. - Под
MAX_READ_ONLYотказывают локальные записи, которые удаляют или переписывают то, что вы сохранили (cli-core 0.336.0, 0.337.0):searches create,searches delete,searches clear,contacts alias set,contacts alias rm,contacts notes add,contacts notes edit,contacts notes remove,contacts link,contacts unlink,tags add,tags auto,tags remove,mentions confirm,mentions reject,attachments text set,chats tracking add,chats tracking remove,conversations links add,conversations links clear,conversations consents revoke,tasks rejectи их инструменты у агента — код 5,permission_error. Работает по-прежнему то, что хранилище восстановит само (images embed,mentions rebuild,conversations embed clear,store jobs …), синхронизация,serveи учёт задач (tasks add,scan,closeи другие).tasks closeпод замком только предлагает закрыть задачу, а--as-ownerотклоняется. - Пока MAX ограничил аккаунт, не уходит никакая запись (cli-core 0.334.0): реакция, прочтение чата, тихое
закрепление, смена названия и профиля тоже отклоняются (
permission_error); чтение работает. Блокировка без срока держит записи, пока вы не выполнитеflood clearилиdoctor --onlineне увидит, что аккаунт в порядке; в--jsonу такой блокировкиuntil: null. - Отправка, которая не дождалась блокировки файла другим процессом, выходит с кодом 9 (
timeout), а не 1 (cli-core 0.338.0): ничего не отправлено, повторять безопасно. То же уflood clear. upgrade --offlineвыходит с кодом 2 (cli-core 0.338.0):upgradeспрашивает npm, поэтому с--offline(и с--check) теперь отказывает, а не идёт в сеть вопреки флагу.- Инструмент агента
messages listбольше не предлагаетtopic:(cli-core 0.340.0): в MAX нет тем, и такое условие отклоняется, как уже отклонялось в командной строке.
Исправлено
- Хранилище, которое не открылось, закрывается (cli-core 0.332.0): на Windows папку с таким файлом можно удалить.
doctor report createснова работает подMAX_READ_ONLY. cli-core 0.337.0 запрещает под этим замком любую локальную запись, которую не отметили как безопасную; отчёт только добавляет новый файл, и теперь он отмечен.- Чужая блокировка файла больше не останавливает
max serve(cli-core 0.340.0): раньше serve ждал её до 5 секунд, и на это время вставали все команды через него и поддержка соединения с MAX. - Два изменения списка получателей одновременно больше не отменяют друг друга (cli-core 0.338.0):
recipients add,removeиclearчитают и пишут список под одной блокировкой. store gaps repair --backgroundвыполняет задание, а не падает сразу (cli-core 0.339.0).- Подсказки
server status,server …и обслуживания хранилища называют профиль:max <profile> session start, а неmax session start(cli-core 0.339.0). upgrade --checkработает подMAX_READ_ONLY(cli-core 0.338.0): он только спрашивает npm о новой версии.- Загрузка моделей не идёт через
max serve(cli-core 0.336.0):models … downloadиimages models downloadкачают с сервера моделей, а не из MAX. images embedпри запущенном serve читает картинки через его соединение, как другие чтения (cli-core 0.337.0).- Ограничение или блокировка, которые остановили
watchилиserve, запоминаются (cli-core 0.334.0): следующая команда ждёт, как после такой же ошибки у обычной команды.
Безопасность
session endбольше не выходит из аккаунта, которым пользуетсяmax serve. Если serve запущен вручную или службой,session endраньше выходил из того же сеанса MAX, на котором работает serve, и удалял его токен. Теперь команда отказывает (код 2) и просит сначалаmax <profile> server stop. Serve, который запустила другая команда, она по-прежнему останавливает сама.session start,session endиsetupникогда не выполняются через serve (cli-core 0.333.0,logsInOrOut).chats.unmute: readonlyтеперь останавливаетchats unmute(cli-core 0.336.0). Раньше включение звука проверялось по ключуchats.mute, и свой ключ не действовал. Настройка, в которой есть толькоchats.mute, работает как раньше, пока не заданchats.unmute.
0.60.0 — 17.10.2026
Что нового
stats messages top --measure reactionsпоказывает реакции по эмодзи (cli-core 0.324.0): рядом с итогом —👍 4 · 😂 3(до пяти эмодзи, дальше+N), а в--jsonу каждой строки естьreactions: [{reaction, count}].max <profile> contacts link <person> me(cli-core 0.323.0): отметить, что контакт — это вы, для вашего аккаунта, который хранилище не узнаёт само, напримерzoom:<id>.
Изменено — может сломать скрипты
- Инструменты
max bot mcpтеперь строятся из самих командmax bot(cli-core 0.325.0) и выполняются через них. Аргументы называются как у команды:messages sendиmessages editпринимаютmd/htmlвместоformat,messages delete— списокmessages,search messages—query,chats members remove—person. Появилисьchats rules show,offlineу команд, которые читают MAX, и аргументыpage,newest,notify,no_block,sync_first. Запись на уровнеaskагенту разрешена: отвечать на вопрос некому. - Агенту не предлагаются:
session,setup,config,doctor report,bot uploads, а также--allow-dangerousуbot comments deleteи уbot api. Их по-прежнему запускает только владелец.
Исправлено
- Упоминания находят меньше ложных имён (cli-core 0.323.0). Слово из имени контакта считается само по себе только как имя или фамилия; контакт с именем как у компании («Smart Agents») находится только по всему имени, а вежливые «Ваш», «Вам», «Вас» не считаются никогда. Имя святого в названии места («Saint Michael's Bridge») и город после «в»/«во» («во Владимире») — тоже не имена.
- Ваши аккаунты — это вы (cli-core 0.323.0): собственная личность аккаунта связывается с вами при следующей синхронизации, и ваше имя в ваших сообщениях больше не принадлежит другому человеку.
- Адрес сохраняет город (cli-core 0.323.0): одна улица в двух городах — два места; адрес без города по-прежнему находит своё место на этой улице.
- В группе с меткой
watch-tasksвопрос закрывает ответ любого участника (cli-core 0.325.0). Прямой ответ на вопрос (ответ с цитатой) от кого-то, кроме спросившего, закрывает задачу с пометкой «answered in the group». Раньше задачу закрывал только ваш ответ, и вопросы, на которые уже ответили другие, оставались открытыми. Сообщение, которое не отвечает на вопрос, ничего не закрывает. В личных чатах и в группах без метки по-прежнему считается только ваш ответ.
После обновления один раз перечитайте старые сообщения: max <profile> mentions rebuild person-name place.
Безопасность
MAX_READ_ONLYтеперь запрещает вход и выход, запись от имени бота и изменения хранилища:session start,session endиsetupотказывают сpermission_errorещё до подключения. Так же отказываютbot api(каждая операция, которая что-то меняет, иget-updates),bot comments send|edit|delete,bot chats members add,bot uploads put, а такжеstore reset,restore,clear,migrate,repair,copies deleteиdecrypt. Раньшеsession endпод этим запретом выходил из MAX и забывал сессию, а эти команды бота отправляли запрос в MAX.store repair --dry-runпод запретом по-прежнему показывает, что было бы исправлено.- Запись в Bot API, для которой max не знает, как вести журнал, отказывает с
configuration_error, а не уходит в MAX мимо списка получателей и журнала отправок. Так операция, которую добавит будущее обновление схемы Bot API, не проскочит проверки. Без журнала проходит толькоget-updates: он никому ничего не отправляет.
0.59.0 — 17.10.2026
Что нового
- У задачи есть исполнитель (cli-core 0.320.0):
tasks add --assignee,tasks plan --assigneeи фильтрassignee:вtasks list— задача может быть и тем, что кто-то должен вам. Группа с меткойwatch-tasksполучает задачу на каждый вопрос без ответа, кому бы он ни был задан.
Изменено — может сломать скрипты
- Профиль по умолчанию больше не выбирается (cli-core 0.319.0). Настройка
default_profileне читается: если она осталась в файле настроек, команда без имени профиля останавливается и подсказывает, что набрать. Называйте профиль первым словом —max <профиль> …— или задайтеMAX_PROFILE, а старую настройку уберите:max config unset default_profile.max config set default_profileтеперь отказывает. - Профиль с именем
default— обычное имя.max default mcp configназывает MCP-серверmax-default, а неmax; запись, сделанная раньше, работает, покаmcp setupне перепишет её под новым именем. tasks applyтеперьtasks scan(cli-core 0.320.0). Инструмент MCP —tasks_scan, ключ разрешения —tasks.scan. Работает так же: показывает, какие задачи откроет история чата, и создаёт их только с--yes.- Агент больше не может удалить сообщение у всех (cli-core 0.321.0). MCP-инструмент
messages deleteне принимаетfor_everyone: такой аргумент отклоняется как неизвестный. Владелец по-прежнему удаляет у всех черезmax <профиль> messages delete --for-everyone. mcp --permissionтолько ужесточает права (cli-core 0.321.0). Переопределение, которое ослабило бы уровень профиля, напримерmessages.send=allowдля профиля сreadonly, сервер отклоняет при запуске и называет ключ. Чтобы разрешить больше, измените права профиля;--permission messages.send=denyи другие сужения работают как раньше.
Исправлено
- Запрет агенту на
chats members listтеперь действует (cli-core 0.321.0). Через MCP команда брала уровень из ключаchats.members, и запрет наchats.members.listдо неё не доходил. tasks show HRB-12показывает задачу проекта (cli-core 0.320.0). Раньше задача проекта, а не аккаунта, считалась ненайденной.- Задачи открываются только там, где что-то спросили у вас (cli-core 0.317.0). В личном чате, как и раньше, — каждый вопрос без ответа; в группе — только ответ на ваше сообщение и упоминание вас; в канале и «Избранном» — ничего. Раньше любой вопрос без ответа в любом чате становился вашей задачей.
- Правка сообщения не стирает то, чего в ней нет (cli-core 0.317.0): время отправки, реакции и служебные поля сохранённого сообщения остаются прежними.
- Инструменты
max bot mcpучитывают окружение сервера. Раньше вызов шёл мимо переменных, с которыми запущен сервер: например, приMAX_READ_ONLY=1бот всё равно отправлял сообщение. Теперь вызов через MCP ведёт себя так же, как та же команда в терминале.
0.58.0 — 17.10.2026
Безопасность
-
Внутренние данные вложений не попадают в вывод, в том числе в поток событий бота (cli-core 0.315.0). Медиа-ключи и токен остаются внутри клиента.
-
Файлы состояния WhatsApp нельзя отправить как вложение (cli-core 0.314.0). Проверка учитывает стандартные каталоги, переменные окружения и символьные ссылки; обычные файлы рядом по-прежнему разрешены.
Что нового
- Имена и адреса можно проверить как упоминания (cli-core 0.311.0).
mentions rebuild person-nameиmentions rebuild placeнаходят их в сохранённом тексте;mentions placesпоказывает подтверждённые адреса. tasks apply <chat...>показывает задачи из выбранной сохранённой истории.--yesсоздаёт их с проверкой дубликатов.
Изменено — может сломать скрипты
- Первый sync по умолчанию не открывает задач из старых сообщений (cli-core 0.311.0). Настройка
task_first_pass_per_chatвключает их создание;tasks applyпозволяет отдельно проверить выбранные чаты. Следующие sync по-прежнему обрабатывают новые сообщения.
Исправлено
max doctor report createпишет отчёт и при неверном файле настроек. Раньше он завершался с ошибкойconfiguration_error, и сообщить о проблеме было нечем. Теперь в отчёте вместо проверки профиля — ошибка настроек (названа неверная настройка, значение не показывается), а также последний неудачный запуск.
0.57.0 — 17.10.2026
Что нового
-
Документы Drive находятся в общем локальном поиске (cli-core 0.301.0), с Google-ссылкой и временем изменения.
--source drive:<профиль>выбирает импортированный профиль.chats documents list <чат>показывает документы, которыми делились в сохранённых сообщениях, без запроса к MAX. -
MCP-сервер загружается только тогда, когда max работает как MCP (cli-core 0.300.0): остальным командам при запуске нужно загрузить примерно на десятую часть меньше файлов.
-
Карточка задачи показывает задачи, которые на неё ссылаются (cli-core 0.304.0):
tasks showпечатаетtask:<id> follow-up-of this task, а--jsonи MCP возвращаютlinked_from. Раньше связь видела только новая задача, а закрытая — нет. -
max запускается примерно на четверть быстрее, начиная со второго запуска. Скомпилированный код Node сохраняется в кэше во временной папке системы (её меняет
NODE_COMPILE_CACHE):max --help— около 0,42 секунды вместо 0,56.
Изменено — может сломать скрипты
- Ошибка в файле настроек — одна строка, и значение в ней не показывается (cli-core 0.304.0): первое неверное
поле, причина и число остальных —
config.json: profiles.default.limitt is an unknown setting (and 2 more problems). Для поля из старой версии (clientId) ошибка подсказывает новое имя (rename it to client_id, cli-core 0.307.0). Раньше сообщение перечисляло все ошибки и все допустимые поля и цитировало значение, а туда мог по ошибке попасть токен. search notesвыбирает заметки полемsource:internalилиsource:fileв запросе (cli-core 0.303.0): флага--typeбольше нет, у MCP-инструментаsearch_notesнет поляtype. Имя поля совпадает с полемsourceзаметки.--source notes:<папка>по-прежнему выбирает, какие аккаунты читать.- Ежедневная подсказка о новой версии молчит и при
--timeout=5,--help=…и других словах через=— так же, как при--timeout 5. Проверка теперь общая, из cli-core. - Команды, которых в MAX нет, больше не показываются (cli-core 0.299.0). У
messages send,chats mark-readиpolls createнет--topic(в MAX нет тем форума),messages listне принимаетtopic:, а уchats requests acceptиdeclineнет--allи--link: человек указывается всегда. Раньше эти флаги были видны и только отказывали. max doctorотвечает и при неверном файле настроек. Раньше он завершался с ошибкойconfiguration_errorи кодом 3; теперь отвечаетconfig: {error: …}, где названа неверная настройка, и выходит с кодом 0. Почему:doctorзапускают как раз тогда, когда настройка сломана. Что учесть: скрипт, который по коду выходаdoctorузнавал о неверном файле настроек, теперь должен смотреть наconfig.errorв ответе.
0.56.0 — 16.10.2026
Что нового
tasks rejectотклоняет предложение агента закрыть задачу, аtasks list close:suggestedнаходит такие задачи (cli-core 0.295.0).tasks agendaпоказывает их с причинойclose-suggested; владелец подтверждает предложение тем жеtasks close <задача>,--asможно не указывать. Насколько агенту можно закрывать задачи, задают настройки общего хранилищаtask_agent_close(onпо умолчанию) иtask_agent_close_min(0.8);config showих показывает.- Новая задача о задаче, закрытой за последние 14 дней, — продолжение закрытой (cli-core 0.295.0):
reviewиtasks addсвязывают её с закрытой связьюfollow-up-of. Закрытая остаётся закрытой и не попадает вtasks duplicates;tasks showпоказывает связь. - 59 категорий задач по умолчанию вместо 7, в списке до 80 (cli-core 0.295.0 и 0.296.0):
bills,health,travel,fitness,subscriptionsи другие.tasks categoriesпечатает смысл каждой и слова на английском, русском и испанском, по которым её выбирает правило. Хранилище, где список сохранили черезconfig set task_categories.*, оставляет свой;config unset task_categoriesберёт новый. - Категорию, которую убрали из списка, видно (cli-core 0.296.0):
tasks categoriesназывает её и сколько у неё открытых и всех задач (unlistedв JSON), аtasks agenda— категории, которые несут открытые задачи (unlisted_categories). - Испанский в задачах (cli-core 0.296.0): слово-триггер с
es:находит и другие формы слова (pagues—pagar), когда сообщение написано по-испански, а проверка дублей понимает сроки вродеmañana,el viernes,15 de noviembre. - Повторная проверка дублей после привязки сообщения (cli-core 0.295.0): после
tasks link <задача> msg:…,tasks add --intoиtasks mergeпохожие задачи попадают вtasks duplicates, а полеreviewв ответе их считает. Связь остаётся, ничего не объединяется само. commands --jsonговорит, сколько работает команда (cli-base 0.38.0): уserveиwatchполеlifetime—persistent, уsetupиsession start—interactive. Раньше программа узнавала их по имени.
Изменено — может сломать скрипты
- Агент закрывает задачу только с
--certainty <0..1>, а неуверенный — уже не закрывает (cli-core 0.295.0). Агента узнаём поAI_AGENTилиCLAUDECODE;--as-ownerзакрывает как владелец. Почему: агент может ошибиться, а закрытая задача пропадает из плана владельца. Что учесть:tasks closeагента без--certaintyотклоняется (task.certainty-required); в MCP уtasks_closeновый обязательный аргументcertainty. Ниже порога (task_agent_close_min, по умолчанию 0.8) или приtask_agent_close offответ приходит сstate: openиclose_suggestion, и задача остаётся открытой. tasks addбольше не отказывает, если похожи только закрытые задачи (cli-core 0.295.0): он открывает новую со связьюfollow-up-of(follow_up_ofв ответе). Отказ с кодом 2 остаётся, когда похожа открытая задача. Что учесть: скрипт, который ждал кода 2 для закрытой задачи, теперь получает новую задачу.- Правило выбирает категорию уже: счёт за свет —
bills, а неmoney, врач —health, а неpersonal(cli-core 0.295.0 и 0.296.0). Старые семь категорий сохранили имена и смысл, задачи в базе не меняются. Что учесть: фильтр вродеtasks agenda category:personalловит меньше новых задач. Часть слов перешла в более узкие категории:gym— вfitness,restaurant— вfood,переезд— вmoving. - Проверка дублей читает сообщения, на которых стоит задача (cli-core 0.295.0): исходное и пять последних
привязанных. Задача правила без своего текста теперь сравнивается по словам сообщения, поэтому
tasks addможет отказать (код 2) там, где раньше открывал задачу. max mcpиmax <бот> bot mcp— теперь общий MCP-сервер, тот же, что уtg. Инструменты те же:max_read,max_tools_searchиmax_write. Командыchats checkвmax_writeбольше нет — вместо неёchats moderate; второго имениchats rulesтоже нет — толькоchats rules show.max bot mcpбольше не принимает флаги--allow-send,--allow-delete,--allow-moderate,--confirm-sendи--allow-dangerous. Почему: у max и tg один сервер для агентов — одно поведение и один код, который проверяют. Что учесть: старые флагиbot mcpи раньше ничего не включали, но теперь сервер с ними не запускается (код 2, «unknown option») — уберите их из настроек приложения;max <бот> bot mcp configпечатает новую запись. Агенту, который звалchats checkилиchats rules, нужно новое имя.max mcp configбольше не переносит в запись--yes: по MCP запись уровняaskи так идёт без вопроса. Голосовое по MCP теперь сначала скачивается, потом распознаётся моделью на этом компьютере, как вtg.chats moderateберёт место последней проверки только из файла правил: место, которое очень старые версии хранили в сессии, больше не переносится.setup --jsonпредлагает следующие команды в общем спискеnextконверта, а не вitem.next. Вместо объектаitem.nextс полямиinstructions,chats,historyиskill— два шага верхнего уровня:skill showиchats list --limit 5, оба только читают. Почему: у всех команд следующие шаги лежат в одном месте, и агент читает их одинаково. Что учесть: скрипт, который читалitem.next, должен читатьnext. Загрузка истории и установка навыка остаются только в выводе для человека.chats mediaотвечает сообщениями той же формы, что история чата. Голосовое там теперьvoice, а неaudio, как вmessages list. Id файла и видео MAX лежат вprovider_refвложения (provider_ref.file_id,provider_ref.video_id), а не на верхнем уровне вложения. Почему: раньшеchats mediaотдавал вложения в собственной форме MAX, не так, как все остальные чтения. Что учесть: скрипт, который искал в ответеaudioили читалfile_idиvideo_id, должен искатьvoiceи читать их изprovider_ref. Фильтр--type audioпо-прежнему выбирает голосовые.max watchрисует сообщения тем же кодом, чтоmessages list. Опрос показан вопросом, ответами и числом голосов. JSON и--jsonlне меняются. Что учесть: строки для человека могут выглядеть немного иначе, чем в 0.55.0. Скрипту нужен--jsonl.
Исправлено
- Отчёт
doctor report createзаменяет метками также id сообщения, на которое отвечали, и id попыток записи. Метки позволяют сопоставить записи внутри одного отчёта и меняются при создании следующего.
Безопасность
- Каждая запись проверяется в одном месте — общей защитой, из командной строки, через
max serveи по MCP. Отправка, правка, удаление, реакции, отметка «прочитано», пересылка, модерация, изменения чатов, контактов и аккаунта проходят одни и те же проверки: уровень прав,MAX_READ_ONLY, список получателей и журнал отправок, а записи, которые видят другие люди (сообщения, пересылки, правки, удаления, новые группы и добавление людей), — ещё и лимит в час.denyиreadonlyзапрещают запись.askв терминале спрашивает или ждёт--yes(удаление —--allow-dangerous), а с--jsonбез флага команда отказывает. По MCP отвечать некому, и запись уровняaskвыполняется, как и раньше: решают права профиля, в том числе заданные серверу через--permission. Почему: раньше для MCP проверки шли отдельным путём внутри max; теперь путь один, и он общий сtg. Что учесть: для команд в терминале ничего не меняется. Если агент не должен удалять или отправлять без вас, задайте этому действиюdenyилиreadonly, а неask: такие инструменты агенту даже не предлагаются.MAX_READ_ONLY=1запрещает любую запись, в том числе по MCP.
0.55.0 — 15.10.2026
Изменено — может сломать скрипты
- Флаги общих команд называются по общему словарю, старые имена больше не принимаются (cli-core 0.288.0):
--budget→--max-pages;messages sync --estimate→--dry-run(в max он по-прежнему отклоняется: id сообщений MAX не говорят, сколько их пропущено);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 --once→--at-time;bot chats moderate --no-ban→--no-block;chats mark-read --until→--until-id;tasks add|plan --check→--remind-time;tasks add --attach→--into;tasks claim --for→--lease;tasks agenda --due→--due-within;server logs --lines→--limit(-nостаётся); вchats start--payload→--start, как вchats app;store export --to/--kind→--output-dir/--include. Почему: у max, tg и других CLI WireCat одно слово значит одно и то же, и агенту не нужно помнить имя флага для каждой программы. Что учесть: старое имя завершает команду с кодом 2 («unknown option») до подключения к MAX — проверьте скрипты и расписания (schedule list). В MCP аргумент — новое имя флага в snake_case, напримерmax_pages,until_id,expected_fingerprint,output_dir,allow_chats,at_time. Вsearch conversationsне меняйте--refreshна--sync-first: этот флаг уже был и сначала читает новые сообщения из MAX, а прежнюю сборку поиска делает--catch-up. tasks similarтеперьtasks related, аtasks duplicates unsure—tasks duplicates defer, без старых имён. Почему: тот же общий словарь. Что учесть: в MCP ищите командыtasks relatedиtasks duplicates deferчерезmax_tools_search. Ключ прав —tasks.duplicates.defer. Старый ключtasks.duplicates.unsureв файле настроек теперь только предупреждает в stderr и не действует, так что команда получает уровеньtasks: уберите его черезconfig unsetи задайте тот же уровень ключуtasks.duplicates.defer. В базе решение по-прежнему называетсяunsure.tasks agendaиtasks duplicatesфильтруют полями запроса, а не флагами:tasks agenda --tag <имя>→tag:<имя>,--category <имя>→category:<имя>,--claimed→claimed:any(ещёnone,mine,others; по умолчанию, как раньше, — ничьи и свои);tasks duplicates --unsure→decision:unsure(по умолчаниюdecision:review). Почему: список фильтрует база, как у остальных списков, а не программа после чтения. Что учесть: OR или NOT, который смешивает поля задачи сchat_kind:, отклоняется (query.unsupported-placement). В MCP эти команды принимаютqueryвместоtag,category,claimedиunsure.- Каждый ответ
--json— конверт:itemдля одной вещи илиitems+pageдля списка, иmeta. Теперь так отвечают и те, что отдавали голый объект: предпросмотр--dry-run --json(подitem, ключи в snake_case:business_rules,action_invoked,write_reserved,messenger_contacted,configuration_read),mentions confirm|rejectиimages embed --json,max_tools_searchв MCP ({items, more}→{items, page, meta}) и ресурс MCPmax://chat/<id>(чат и сообщения подitem), а такжеbot me,bot api …(ответ Bot API — внутриitemбез изменений, пустой ответ —null),contacts sync,contacts lookup(displayName→display_name,lastMessagedAt→last_messaged_at),doctor report,doctor report create(sendTo→send_to) иsetup(chats.hasMore→chats.has_more). Почему: агент разбирает любой ответ одним способом. Что учесть: читайте поля из.item; вместоmore—page.has_more. - Повреждённая локальная копия переписки — ошибка, а не пустая копия (cli-core 0.286.0). Раньше команда с
подключением к MAX молча обходилась без неё. Копию пропускают, только если её нет, если аккаунт ещё не записан
или если другой процесс (
serve) держит её дольше 5 секунд. Почему: ответ без копии выглядел полным, хотя в нём не хватало сохранённого. Что учесть: такая ошибка — повод дляmax <профиль> store repair --dry-run.
Исправлено
- Подсказка следующего шага содержит профиль (cli-core 0.286.0): после
max personal …строка→ …тоже начинается сmax personal, и вставленная как есть она работает, а не просит выбрать профиль.
Удалено
- Открытие базы больше не удаляет старый файл
messages.dbи не пишет об этом в stderr (cli-core 0.286.0). Если файл остался от давних версий, удалите его сами.
0.54.0 — 15.10.2026
Что нового
- Задачи можно занять, пометить тегом и разложить по категориям:
tasks claim <задача> [--for 30m],tasks release,tasks categories,tags add|remove --task,tasks agenda --claimed(cli-core 0.282.0). - Задачи, которые могут быть одной работой (cli-core 0.285.0):
tasks similar <задача>оценивает похожие задачи;tasks duplicates [--unsure]показывает пары, найденные правилами,tasks merge <задача> --into <другая>объединяет их,tasks unmergeотменяет объединение,tasks duplicates reject|unsureрешает пару.tasks agendaпринимает--categoryи--tag, аconfig set task_categories.<имя>меняет список категорий для всей базы. - Упоминания (cli-core 0.285.0):
mentions domainsпоказывает сайты, на которые ведут ссылки;mentions list --new— найденное с прошлого просмотра;mentions confirm|reject <id> --all-in-chatрешает имя во всём чате.config set phone_countries es,ruчитает номера, записанные без+. - Версия базы 16: правила упоминаний читают и текст заметок и сохранённых документов, а один
mentions rebuildчитает сохранённые раньше;mentions listпо-прежнему показывает только упоминания в сообщениях. Обновление добавляет только триггеры, так что прежняя версия max базу по-прежнему открывает.
Изменено — может сломать скрипты
- Настройки называются только в snake_case (cli-core 0.283.0):
config setиconfig unsetбольше не понимают camelCase, а ключ в camelCase в файле настроек считается неизвестным. Общие настройки хранилища теперьsearch_stemmers.cyrillic,search_stemmers.latinиaccount_groups.<имя>. tasks addтребует--category <имя>из спискаtasks categories(money,documents,meetingи другие); если ничего не подходит —--category other.MAX_READ_ONLYтеперь запрещает запись и в max: раньше эта переменная до проверки записи не доходила.tasks addотказывает, если задача может быть той же работой, что открытая или закрытая за последние 14 дней (cli-core 0.285.0): выход 2, причинаtask.duplicate-candidates, кандидаты вdetails.candidates. Повторите с--attach <задача>, чтобы привязать сообщение к ней, или с--new, чтобы открыть новую; через MCPtasks addведёт себя так же.phone:иvalue:находят и сохранённый номер, который кончается национальными цифрами набранного (от 8; cli-core 0.285.0), так что номер, сохранённый доphone_countries, находится в любом виде. Российский городской номер, записанный группами,(812) 000-00-01, теперь хранится как+78120000001, а не голыми цифрами.max search mailбольше нет: почту ищет memo (решение владельца 14.10.2026, cli-core 0.285.0, cli-core#1121). У MCP нетsearch_mail.max search allищет сообщения и заметки (и встречи, если их назвал--source), но никогда почту;--only mailотклоняется. Вместо «unknown command»max search mail …отвечает подсказкойmail is memo's: install @wirecat/cli-memo, then `memo search mail …`. Задачи, заметки о контактах, метки,search notesиsearch allостаются вmax.
Исправлено
- Заголовок с заглавными кириллическими буквами находится запросом в нижнем регистре (cli-core 0.285.0).
- Вредный HTML во вложении больше не подвешивает чтение (cli-core 0.285.0): страница из незакрытых тегов или комментариев читается за время, линейное по её размеру.
Безопасность
messages send --file, отправка из MCP и фото профиля или группы не берут файлы из мест с учётными данными (cli-core 0.283.0) — тот же список, что уbot uploads putс 0.53.0: ключи SSH и облаков,.netrc,.git-credentials, настройки gh, docker и kube, учётные данные Claude и Codex, связки ключей, профили браузеров, хранилища паролей и папки приложений WireCat; на macOS и Windows без учёта регистра. Раньше они отказывали только для.ssh,.gnupg,.aws,.envи похожих и папок max. Нужен именно такой файл —--allow-any-file.- Список мест, из которых файл не отправляется, теперь один на все приложения WireCat: max берёт его из cli-core, а не держит свою копию. Если файла ещё нет, ссылки в папках над ним тоже раскрываются.
- Под
MAX_READ_ONLYнельзя изменить то, что разрешит запись позже (cli-core 0.281.0):schedule command|agent|remove,config set|unset,recipients add|remove|clear,flood clear,server install|uninstall,mcp setup,skill install,upgrade, ключи моделей иbot authотвечаютpermission_error. Агент по расписанию идёт с этой переменной и раньше мог назначить себе отправку на потом; теперь не может, а расписание, сохранённое под ней, тоже запускается только на чтение. Чтение, синхронизация, задачи и заметки работают как прежде.
Удалено
- Код совместимости.
max mcpиmcp config|setup|doctorбольше не принимают--allow-send,--confirm-send,--allow-mark-read,--allow-delete,--allow-moderate,--allow-dangerousи--http-confirmation; доступ задаютpermissions.messages download --outputубран, остаётся--output-dir. Командыconfig migrateбольше нет. Настройкиread_only,allowиmcp_toolsудалены: файл с ними не читается, вместо них задайтеpermissions.<ресурс> readonly.doctorне ищет старый файл кэша (legacy_cache), аinboxбольше не переносит старую отметкуlastCheckAt. - Перенос папок при запуске (из
~/Libraryи в папку WireCat): он уже сделан. - Старый язык поиска: у
search messagesиsearches createбольше нет--languageи--regex. Сохранённый поиск на старом языке сохраните заново. conversations embed --workers.
0.53.0 — 15.10.2026
Что нового
config setиconfig unsetпонимают имя настройки в camelCase (cli-core 0.279.0):max <профиль> config set senderColors falseпишетsender_colors,max <профиль> config set readOtherBots true --botпишетread_other_bots. Путь команды послеpermissions.пишется как есть.
Исправлено
max bot uploads putи отправка файлов из кода не берут файлы из папок с ключами, связкой ключей и профилями браузера, как и остальные отправки; на macOS и Windows имена сравниваются без учёта регистра.- Отправку, которую MAX отклонил по лимиту, можно повторить: если
messages send,messages forwardилиpolls createполучили отказ по лимиту, в ошибкеretry.safeтеперьtrue— сообщение не ушло. Если лимит пришёл на повтор после потерянного ответа, это по-прежнемуoutcome_unknownиretry.safe: false.
0.52.0 — 14.10.2026
Что нового
- Синхронизация продолжается с места остановки:
store jobs showпоказываетprogress, аmessages sync --allне спотыкается о чат, который уже занят (cli-core 0.276.0). max watchне падает со стеком, если обработчик события бросил ошибку: подписка завершается этой ошибкой, связь с сервером остаётся.- Файлы и видео уходят с диска по ходу загрузки (cli-core 0.272.0).
max messages send --file,--photo, фото профиля и группы иmax botбольше не читают файл в память целиком перед отправкой, и отказ для файлов от 2 GiB снят. Голосовое по-прежнему читается целиком — по нему считается длина и волна — до 256 MiB. - Поиск по картинкам:
max <профиль> images embedиmax <профиль> images models download|list. Включаетсяmax <профиль> config set picture_search true(по умолчанию выключен), модельclip-b32скачивается один раз (около 155 МБ),images embedсчитает вектор для каждой картинки в архиве. Поиск сообщений по словам тогда возвращаетpicturesрядом с находками. Почему: найти картинку по тому, что на ней изображено. Что учесть: запрос для картинок только английский, агент переводит его сам. Подробнее — в поиске.
Изменено — может сломать скрипты
max store export --format jsonlпишет в файлы и папки те же записи, что на экран: snake_case,chat_id; строка удаления{ "id", "chat_id", "deleted": true }(cli-core 0.276.0). Что учесть: папку, выгруженную раньше, новая сборка не дописывает; выгружайте в новую папку.max watch --jsonlпишет сообщения в той же форме, чтоmessages list: snake_case, сref(chat_id,chat_title,sender_name). Строки--eventsтоже snake_case:chat_id,message_id,user_id,up_to_time,unread_count. Человек видит то же, что раньше. Что учесть: скрипты, читавшиеchatId, берутchat_id.- Голосовое без текста попадает в
missingуreview,inbox,messages listи в MCP, чтобы агент видел, что его ещё нужно расшифровать (cli-core 0.275.0). - Следующий шаг к команде, которая меняет только этот компьютер, не запускается сам (cli-core 0.273.0):
у шагов
server restartиstore reindexстоитsafe_to_auto_execute: false. mentions rebuildпринимает вид аргументом:max <профиль> mentions rebuild person-name, а не--kind(cli-core 0.272.0).max doctor --json,session startиsession endотвечают конвертом в snake_case:{item, meta}, ключиlegacy_cache,keyring.moved_by_environment,session.state_file,revoked_on_server. Человек по-прежнему видит строки. Что учесть: скрипты, читавшие эти ответы, берут поля изitemв snake_case.max bot chats members list --cursorвместо--marker, синонима нет; MCP инструмент бота тоже берётcursor. Ответ называет следующий шаг вpage.next. Свои команды max (recipients,config,mcp,messages transcribe,bot comments,bot uploads) отвечают так же, как общие: строка конца--jsonlи подсказки на stderr.
0.51.0 — 14.10.2026
Что нового
- У каждого
max watchсвоя очередь. Медленный наблюдатель больше не задерживает остальных; буфер — 64 MiB на наблюдателя и 256 MiB на всех,max serve --max-subscriber-buffer-bytesи--max-subscriber-total-buffer-bytesменяют их,0снимает предел. max mentions: телефоны, почта, ссылки и документы Google из сохранённых сообщений (cli-core 0.264.0, версия базы 7).mentions list kind:phone,mentions list domain:google.com; слово без поля — значение в любой записи,89001234567найдёт+79001234567.mentions show <id>показывает текст вокруг. Сообщения, сохранённые раньше, читает одинmax <профиль> mentions rebuild; новые читаются при записи.max mentions confirm|reject, упоминания в файлах и голосовых, поиск поphone:,email:,url:,domain:(cli-core 0.269.0, версия базы 11).mentions confirm <id> [person:<uid>|organization:<id>]записывает, чей это телефон или адрес (организации тоже),mentions reject <id>отклоняет значение насовсем; автор записи — агент или владелец (--as-owner). Текст из файлов и расшифровки голосовых тоже даёт упоминания (полеfile_textилиtranscript); сохранённые раньше читает одинmentions rebuild. Поиск сообщений находит их поphone:"8 900 000-00-01",domain:docs.google.com,email:"[email protected]". Старые сборки базу читают как раньше.
Изменено — может сломать скрипты
- Сборка на
@wirecat/cli-core0.269.0:contacts timelineлистается как остальные списки. Список, обрезанный--limit, отвечаетpage.has_more: true,page.cursorи шагомpage.next(--cursorпродолжает с теми же--scope,--since-timeи--until-time); раньше былоhas_more: falseиmeta.truncated.meta.truncatedостаётся для изменений, ещё стоящих в очереди. Заметка «cut at --limit» на stderr исчезла. Что учесть: скрипты, читавшиеmeta.truncatedуcontacts timeline, читаютpage.has_more. - Ключи ошибок — snake_case и у
max bot, и у отправки без ответа. Код отказа MAX у бота теперьerror.details.max_code(былmaxCode);outcome_unknownпри отправке сообщения отдаётsend_id(былsendId). - На
@wirecat/cli-core0.270.0 и@wirecat/cli-base0.27.2. --json=<поля>заменяет--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 <чат> started_at>=7d. Флагов--tag,--type,--source,--state,--chat,--before-timeи--since-timeу этих списков больше нет. Элементы — общие сущности: метка называет, на чём она, какtarget, разговор отдаётmessages_count,started_at,first_message.
Исправлено
max serveне теряет вход, если его закрыли в момент ответа MAX. Состояние профиля и обновлённый токен сохраняются до проверки на закрытие: MAX этот вход уже засчитал, и следующий запуск не входит заново.- Переполненный общий буфер
max watchотключает того, кто держит больше всех, а не того, кому пишут следующим. Отказ приходит вwatchс кодомinvalid_responseи причинойoutput.too-large, а неprovider_error. - Запись о неудачном запуске снова хранит код отказа MAX (
providerError, напримерproto.payload). С cli-core 0.263.0 он читается изerror.details.provider_error, а max писалproviderError, и код терялся; так же опрос «уже проголосовали» и повторная попытка послеnot.foundсмотрят на новый ключ. MaxClientназывает файл от 2 ГиБ таким, а не «it cannot be read». Файл по пути вsend({ files })и фото группы или профиля сначала проверяются по размеру: Node не читает файл от 2 ГиБ, и ошибка теперь говорит это.max <бот> bot chats members addберёт не больше 100 человек за раз. Bot API MAX принимает до 100 id в одном запросе; список длиннее теперь отказывается до запроса и просит разбить его на несколько запусков.
0.50.0 — 14.10.2026
Изменено — может сломать скрипты
- Сборка на
@wirecat/cli-core0.262.0 (новое имя@wirecat/cli-messaging, следует за его 0.261.0; команда сверки —cli-core-parity) и@wirecat/cli-base0.26.0. Ключи в машинном выводе — snake_case: вerror.details—operation_id,send_id,retry_after_ms; вcommands --json—global_options,inherited_options,exit_codes,takes_valueиcontract: 1. Дерево запроса в MCP-аргументеastпишетlower_inclusive,upper_inclusiveиmust_not. - HTML-файлы читаются как основной текст (cli-core 0.262.0): меню, подвалы и баннеры отбрасываются, заголовки,
списки, таблицы и ссылки остаются. Уже сохранённый текст HTML-вложений перечитывается при следующем
attachments extractи меняется.title:,site:,lang:,author:иkeyword:ищут по заметкам и файлам.
Исправлено
max config set defaultProfile <имя>иconfig unset defaultProfileработают без указания профиля. Раньше команда сначала требовала профиль и падала, если их несколько (cli-core 0.262.0).
0.49.0 — 13.10.2026
Что нового
- Сборка на
@wirecat/cli-messaging0.259.0 и@wirecat/cli-base0.24.0. Командаstore fetchтеперь называетсяmessages sync(те же аргументы, параметры и JSON); старое имя скрыто и считается устаревшим. --debug: при сбое полная запись — причина и стек — идёт следом за ошибкой: в терминале после строки✗, иначе второй строкой JSON.runs listиruns searchчитают индекс по дням и отвечают за миллисекунды даже на тысячах запусков.
Изменено — может сломать скрипты
- Общая копия сообщений и модели речи один раз переезжают в папку WireCat,
~/.local/share/WireCat/(Windows:%LOCALAPPDATA%\WireCat\Data\), при первом запуске — из~/.local/share/cli-messaging/и~/.cache/cli-common/models/. Переезд ничего не перезаписывает: если в обоих местах лежат разные копии,maxостанавливается с кодом3и называет оба файла.WIRECAT_STATE_DIRзаменяетCLI_COMMON_CACHE_DIRи переносит всю папку. Обновляйтеtgиmemoвместе сmax: старый CLI создаст новую копию на прежнем месте. Где лежат файлы. - Один объект ошибки:
{"error":{"code","reason","message","details"}}. То, что лежало прямо вerror, —candidates,sendId,operationId,permission— теперь вerror.details.reason— идентификатор через точку (output_limit→output.too-large,input_limit→input.too-large);retryableесть, только если его задал сам сбой, аactions— только у неудавшихся элементов частичного результата. Код1называетсяinternal_error(былоgeneric_failure), и его сообщение больше не несёт текст самого сбоя — его показывает--debug. Ключи, которых нет в общем списке cli-messaging, изdetailsпропадают:providerErrorостаётся только в тексте сообщения, ID неудалённых сообщенийmessages deleteтоже перечислены в сообщении. runs showпоказывает только то, что пошло не так (неудачные ответы, предупреждения, падение) и добавляетeventCount; все события — с-v, как раньше.maxбольше не выбирает профиль сам. Если профиль не назван ни первым словом, ниMAX_PROFILE, ни настройкойdefaultProfile, команда, которой нужен аккаунт, завершается с кодом2и перечисляет профили этого компьютера — даже когда профиль один. Раньше она молча работала с профилемdefault. Первый вход тоже с именем:max personal setup(любое имя вместоpersonal); на компьютере без профилей ошибка подсказывает именно эту команду. Без профиля по-прежнему работают--help,--version,commands,skill show,account list,config show. Подсказки в ошибках теперь всегда называют профиль (max default setup, а неmax setup), иmax mcp configвсегда передаёт его серверу. Почему: какой аккаунт пишет и читает, решает владелец, и решает явно — иначе агент или скрипт мог действовать не от того аккаунта. Что учесть: у всех, кто жил на профилеdefaultбез имени,max chats listи скрипты без профиля перестанут работать. Ошибка называет профили; одно из трёх:max default chats list,export MAX_PROFILE=defaultв профиле оболочки илиmax config set defaultProfile default. Записи MCP, сделанные черезmax mcp config, переделайте этой же командой. Профили.
0.48.0 — 12.10.2026
Что нового
-
--briefи--fullу любой команды.--briefоставляет у найденного сообщения ссылку, чат, время, автора, отрывок и оценку;--fullвозвращает всё. -
max search allназывает автора каждого найденного и то, как найдено (по словам или по смыслу). -
max schedule: команда или агент по расписанию — через systemd (Linux), launchd (macOS) или Планировщик заданий (Windows).max schedule command <имя> --every 2h -- messages list <чат>запускает команду max; чтение сохраняет прочитанное в хранилище.max schedule agent <имя> claude "<задание>" --at 08:30запускает агента (claude или codex), не чаще раза в час. Агент работает сMAX_READ_ONLY=1и не может ничего отправить; его ответ лежит вlatest.mdрядом с расписанием, о готовности приходит уведомление на рабочем столе.--once 2h— один запуск, после него расписание удаляется само.max schedule list,run,remove. -
max server installподсказывает, как включить ежедневный разбор договорённостей, и ничего не включает сам. -
MAX_READ_ONLY=1запрещает процессу любые отправки, сильнее файла конфигурации и--permission.
Изменено — может сломать скрипты
max search messagesотдаёт отрывок, а не весь текст. У каждого найденного вместоtext—excerpt, около 240 символов вокруг первого слова запроса; весь текст — с--fullилиmax messages show <ссылка>. ПустыеeditedAt,replyTo,forwardedFromиreactionsв машинном выводе больше не печатаются. Скрипт, который читалtextу результатов поиска, читаетexcerptили добавляет--full.
0.47.0 — 11.10.2026
Что нового
- Задачи получают план, ссылки и повестку дня (общее хранилище 0.247.0, версия 4).
max tasks addберёт--title,--description,--dueи--check;max tasks plan <задача>меняет их потом,noneочищает дату. Дата проверки — когда агенту снова посмотреть на задачу, это не напоминание: владельцу ничего не приходит.max tasks linkпривязывает к задаче сообщения, чаты, людей, документы и ссылки;max tasks showпоказывает план со ссылками.max tasks agendaбез текста сообщений перечисляет просроченные и близкие задачи, чаты, где ждут ответа владельца (owed), где владелец ждёт ответа (waiting), и чаты, чьё последнее сообщение ещё не сохранено (unsynced).max skill show follow-ups— ежедневный разбор для агента: только черновики, ничего не отправляет. - Поиск понимает сравнение через двоеточие.
date:>=2026-01-01(и:>,:<,:<=) — то же, чтоdate>=2026-01-01; раньше такая запись давалаinvalid_syntax. Отклонённыйafter:илиbefore:теперь подсказывает замену: наafter:2026-09-01ответ — используйтеdate>=2026-09-01.
Изменено — может сломать скрипты
- Общее хранилище 0.247.0: контекст встречи записывает факты действием
fact.add;memory.addбольше не принимает видfact. - Общее хранилище 0.246.0 проверяет новые метки перед созданием. Похожее название требует проверки владельцем; можно использовать существующую метку или её явный алиас. Существующие записи сохранены; автоматические совпадения имени и алиаса объединяются в одну метку.
0.46.0 — 11.10.2026
Изменено — может сломать скрипты
- На macOS max хранит файлы там же, где на Linux:
~/.config/max-cli,~/.local/share/max-cliи~/.cache/max-cliвместо~/Library/…. Первый запуск переносит туда старые папки вместе с общим хранилищем и моделями речи и переводит лог установленного агентаmax serverна новую папку. Пока работаетmax serveили MCP-сервер, max пишет одно предупреждение, в этот раз работает со старыми папками и пробует снова при следующем запуске. На Linux и Windows ничего не меняется. - max работает на
@wirecat/cli-messaging0.242.0: существующие ключи проектов и задач сохранены; новые проекты получают короткие ключи, общее хранилище поддерживает проверяемые зависимости задач. - max работает на
@wirecat/cli-messaging0.238.0, архив — версии 2. При первом открытии архив обновляется: записи памяти видаfactстановятся фактами (то, что произошло — отдельно от выводов), а связи «назначено» копируются в назначения задач. Предыдущие сборки max открывают обновлённый архив как раньше. - Письма для поиска по смыслу режутся на куски по переписке, а не по одному письму. Цитаты, приветствия и подписи в куски не попадают. При первой индексации старые куски удаляются, и вся почта векторизуется заново — один раз, это займёт время. Сам текст писем и поиск по словам не меняются.
Что нового
--sourceвsearch messages,search mailиsearch conversationsпринимает список аккаунтов и групп:--source group:work,max:default,email:[email protected]. Группа сохраняется командойmax config set accountGroups.<имя> <список>и видна всем приложениям, работающим с архивом.max search conversationsнаходит письма почтовых ящиков и по словам, а не только по смыслу.
0.45.5 — 11.10.2026
Изменено — может сломать скрипты
- Вступление в чат и импорт контактов идут в счёт
sendsPerHour. Вступление считается за одно действие, импорт — за каждый номер;max contacts importотправляет номера по 10 за запрос. Если лимит остановил импорт посередине, ошибка говорит, сколько номеров ушло, и повторный импорт безопасен.
Что нового
max search all --backend archive|server|bothи--server-time— как уsearch messages; касается только сообщений, почта и заметки ищутся локально. По умолчаниюboth.max search mail --account <адрес>ищет почту одного почтового ящика; без него — во всех.- Почта ищется по получателям, папке и теме (
to:,cc:,bcc:,mailbox:,subject:), вложения писем — по смыслу.
Безопасность
- Поиск больше не возвращает сообщения другого аккаунта.
search messages --backend serverс--source allилиin:allмог показать чужое сообщение с теми же id чата и сообщения; поиск по чату без аккаунта теперь отклоняется. Из@wirecat/cli-messaging0.233.0.
0.45.4 — 11.10.2026
Что нового
max search messagesбез чата спрашивает и сервер MAX, как строка поиска на web.max.ru: один запрос по всем чатам, из каждого чата одно лучшее совпадение. Найденное сохраняется в архив и проверяется вашим запросом. С--chatсервер, как и раньше, ищет в одном чате.--backend archiveоставляет только архив; с--jsonу таких поисков теперь есть блокserver.
Изменено — может сломать скрипты
max search messagesсо словами и без чата теперь подключается к MAX (раньше отвечал только архив) и может ждать сервер до 5 секунд. Это же касается поиска через MCP. Чтобы искать только в архиве, как раньше, добавьте--backend archive(в MCP —backend: "archive").
Исправлено
- Работает на
@wirecat/cli-messaging0.231.0: там же cli-meetings 0.3.0 и пакеты SQLite и ONNX 1.0.1 с файлом лицензии; дляmaxничего не меняется.
0.45.3 — 11.10.2026
Изменено — может сломать скрипты
- Поиск в архиве с
--discoverобрабатывает вопросы вроде «Могут подрядчики подключиться к проекту?»: знак вопроса больше не превращается в поисковый шаблон. Строгий поиск и фильтры работают как прежде. - Поиск почты и переписка связанного человека читают также отдельное хранилище писем, наряду с прежним импортом. Почта поддерживает фильтры отправителя и цепочки. В поисковой выдаче письмо с одинаковой ссылкой показывается один раз.
0.45.2 — 11.10.2026
Изменено — может сломать скрипты
- Загрузка истории, у которой первая же страница не удалась без надежды на повтор, снова завершается ошибкой
(код выхода
2), как до 0.45.1. Ожидание, о котором просит MAX, и сбой после нескольких страниц по-прежнему дают частичный результат сcomplete: falseи кодом0.
Исправлено
max store fetch --backgroundбольше не обрывается через 30 секунд. Фоновая задача получала общий для команд предел в 30 секунд и останавливалась примерно после сотни сообщений. Теперь она идёт до конца; явный--timeoutпо-прежнему её ограничивает.max store fetch --allпережидает короткую паузу, о которой просит список чатов (до 5 минут, как уже делали страницы сообщений), вместо того чтобы сразу завершиться сrate_limited.
Безопасность
- Старый
messages.dbудаляется при открытии копии по пути по умолчанию (так с 0.45.1): незашифрованный файл, который был доwirecat.db, вместе с-walи-shm. Одна строка в stderr называет его. Файл остаётся, если заданMESSAGING_STORE, и пока его держит открытым другой процесс.
0.45.1 — 11.10.2026
Исправлено
- Названия пакетов, документация и примеры используют пространство имён WireCat.
- Скачивание вложения по HTTP отличает отказ 429 от обычного сетевого сбоя: прекращает новые файлы и передаёт паузу
Retry-After, если она есть. Отказ 413 предлагает уменьшить входные данные, а не поднимать локальный лимит.
Изменено — может сломать скрипты
- Независимый отказ файла или страницы истории сохраняет успешную часть и возвращает
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 и распаковки остаются отдельными. max runs searchи командаruns searchв MCPmax_readищут безопасные диагностические записи по тексту, статусу, коду ошибки и времени без подключения к мессенджеру.
0.45.0 — 11.10.2026
Изменено — может сломать скрипты
- Локальная копия сама чистит растущие журналы при открытии, не чаще раза в день: вызовы инструментов агентом старше 90 дней удаляются, а у обработанного обновления бота старше 30 дней строка остаётся, но содержимое стирается. Обновите tg-cli и cli-memo одновременно: копия у них общая.
Что нового
max store reset— для копии, которую эта сборка не может перенести на новую схему: сохраняет её рядом, удаляет и создаёт пустую. Сначала спрашивает;--yesпропускает вопрос,--no-backup— копию.max 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.44.0 — 10.10.2026
Изменено — может сломать скрипты
- Локальная копия теперь в новом файле
wirecat.dbи после обновления пуста. Он лежит рядом со старымmessages.db, которыйmaxоставляет как есть: не читает, не переносит, не удаляет.max store fetch --allзаново скачивает сообщения из MAX. То, что есть только на этом компьютере, — например заметки, псевдонимы, метки, задачи и расшифровки — остаётся вmessages.db. Вход сохраняется. Обновите tg-cli одновременно, иначе они будут видеть разные архивы.
Что нового
max contacts timeline <человек>, и через MCP — командаcontacts timelineвmax_read: всё, в чём участвовал один человек, во всех связанных с ним мессенджерах, новое сверху, из локальной копии.--scope personal|work,--since-time,--until-timeи--limitсужают выдачу.
0.43.1 — 10.10.2026
Исправлено
-
Скачивание вложений использует обычный HTTP(S) и настроенный транспорт без отдельной проверки DNS или запрета локальных адресов. Это сохраняет совместимость с VPN, прокси и частными сетями; поддержку любого конкретного прокси определяет транспорт.
-
Локальное чтение текста и просмотр страниц PDF больше не требуют делить документ после 20 страниц; отдельный 30-секундный срок извлечения убран. Общая отмена команды и ограничения размера остаются.
-
Локальная расшифровка полной mono/stereo Ogg Opus записи больше не отказывается после 10 минут. Длинная запись потребует больше памяти и времени.
-
Вложения из обычных скрытых рабочих папок снова доступны. Известные файлы с учётными данными, папки CLI и хранилище остаются защищёнными.
-
Экспорт Markdown сохраняет разметку сообщений; MCP передаёт исходный Unicode при записи, сохраняя видимые управляющие символы в ответах. Настроенные шлюзы моделей допускают обычные перенаправления.
-
Обновление и настройка MCP в Windows принимают обычные относительные записи PATH и нестандартное окружение командного процессора. Хранилище сообщений сохраняет прежнюю схему.
-
Руководство уточняет, что поиск с
--discoverчитает только локальный архив. Обычный поиск в одном чате может также спрашивать сервер MAX; режим discovery его не спрашивает.
0.43.0 — 10.10.2026
Что нового
- Поиск сообщений с
--discoverили MCPdiscover: trueнаходит частичные совпадения слов и подходящие прямые ответы в локальном архиве без скачивания моделей. Строгий поиск остаётся по умолчанию; отсутствующие слова помогают агенту проверить основания ответа.
Изменено — может сломать скрипты
- Проект теперь распространяется по лицензии Apache 2.0. Условия использования — в
LICENSE.
0.42.0 — 10.10.2026
Изменено — может сломать скрипты
-
Пакет называется
@wirecat/max-cli, репозиторий находится в WireCatLabs. Используйте этот пакет для установки и обновления. -
Удаление проверяет результат чтением с сервера. Если MAX продолжает возвращать сообщение или проверить результат не удалось, команда сообщает
outcome_unknownвместоdeleted. Прочитайте сообщение перед повторной попыткой; подтверждение запроса ещё не означает, что сообщение исчезло. -
Локальная расшифровка речи принимает полную запись Ogg Opus с одним или двумя каналами до 10 минут. Более длинную запись сначала разделите на части. Извлечение текста из PDF ограничено 20 страницами и 30 секундами; большие PDF также разделите перед обработкой.
-
В MCP невидимые управляющие символы становятся видимыми последовательностями в ответах и аргументах записи, включая текст после преобразования разметки. Флаги регионов сохраняются целыми. Обычный JSON вывода CLI сохраняет исходные строки.
Исправлено
-
Загрузка вложений через MCP завершается без зависания. Локальное извлечение текста больше не блокирует подключение, нужное для скачивания файла.
-
messages deleteпринимает список id через запятую, как и отдельные аргументы через пробел. -
Руководства MCP описывают права профиля и подтверждение в приложении агента. Сервер сам не показывает формы подтверждения; устаревший неиспользуемый код формы удалён.
Безопасность
- Чтение каталога вложений и передача сохранённых файлов проверяют расположение файла. Скрытые файлы и папки, собственные папки CLI и хранилище сообщений не читаются, в том числе через ссылки. Загрузка через MCP также не пишет в эти места; используйте обычную папку загрузок.
- DOCX проходит те же ограничения распаковки, что другие офисные форматы. До чтения проверяются число частей, суммарный распакованный размер и размер текстовой части.
0.41.0 — 09.10.2026
Изменено — может сломать скрипты
- Автоответы получает каждый, кого выбрали правила, пока вы не ограничите аудиторию; отдельного списка
testersбольше нет.max replies audience --reply listed --allow-people <id>оставляет только выбранных людей,--deny-peopleи--deny-chatsисключают некоторых. Ничего не отправляется, покаpermissions.replies.sendнеallow, а новое правило выключено, пока вы его не включите. Раньше ответ шёл только тому, кто был и вtesters, и в аудитории; два списка путали. Файл, где ещё естьtesters, отвечает ровно тем же людям: они становятся разрешёнными (если аудитория уже былаlisted, — только те, кого она тоже разрешала). Разрешённые чаты в таком файле убираются, иначе ответ получил бы любой участник этих чатов; запреты сохраняются. Безtestersфайл перезапишется при следующей правке черезmax replies. - В
max replies status --jsonбольше нет поляtesters; кому можно отвечать, показывают счётчикиaudience. Вmax replies testиserveотправитель вне аудитории пропускается с причиной «not on the allow list» вместо «not a test account».
Исправлено
max mcp configпереносит в запись клиентаMESSAGING_STOREиXDG_RUNTIME_DIR, какtg. Клиент, который запускает сервер с урезанным окружением, на Linux не доходил до связки ключей и отвечал «нет сессии», а с собственнымMESSAGING_STOREискал в другой копии сообщений. Запуститеmax mcp configещё раз и замените запись в настройках клиента.
0.40.0 — 09.10.2026
Изменено — может сломать скрипты
- Хранилище сообщений удаляет копии, которые держало для старых версий (версия хранилища 28, cli-messaging 0.212.0). Заметки, заметки о контактах, связи и сущности, записанные до перехода на новые заметки, один раз переносятся в новые таблицы при обновлении. После него старые max, tg и memo отказываются открывать хранилище с сообщением «upgrade this tool» — обновляйте все три вместе.
0.39.0 — 09.10.2026
Что нового
-
max attachments show --page 1отдаёт страницу сохранённого PDF как PNG. Удалённый агент может прочитать все страницы своим зрением и сохранить текст для поиска. Нужны необязательныеunpdfи@napi-rs/canvas; API OCR и запись в индекс сами не запускаются. Если MCP-клиент показывает только метаданные ресурса, запроситеformat: base64и покажите PNG средствами агента. -
max search all "<слова>"ищет сразу во всём, что хранится на этой машине: сообщения MAX и Telegram, почту, импортированную memo, и заметки. У каждой находки указан вид: сообщение, письмо или заметка.--only notes(илиmessages,mail) сужает поиск. -
max search mailиmax search notesищут в одном виде. Заметки находятся по словам и, если скачана локальная текстовая модель, по смыслу;--type internal(написанные в memo) илиfile(из папки заметок). -
max search messages --type voice(илиtext,file) находит только такие сообщения.
Изменено — может сломать скрипты
-
Статистический
--answererпринимает сохранённые имена, свои имена и @username. Поиск идёт локально в аккаунтах выбранной истории; при неоднозначности возвращаются кандидаты. Неизвестное имя теперь вызывает ошибку вместо отчёта по выдуманному ID с нулём ответов. Для явно выбранного неизвестного строкового ID используйтеperson:provider/account/id. В responses появилосьidentityKnown; ID без наблюдений получаетfalseиstatus: unknown. Ноль наблюдаемых ответов не доказывает отсутствие активности (статистика). -
Весь поиск переехал в
max search. Старых команд больше нет:Было Стало max messages searchmax search messagesmax messages search --source emailmax search mailmax conversations searchmax search conversationsmax bot messages searchmax bot search messagesДля агентов инструменты переехали так же:
search messages,search conversationsи новыйsearch all, с которого стоит начинать. -
max search messagesбольше не возвращает почту. Сохранённый поиск сin:emailтеперь проситmax search mail. -
Права со старыми путями (
messages.search,conversations.search) останавливаютmax search, покаmax config migrateне переименует их с теми же уровнями.
Исправлено
- Справка о заявках явно называет ограничения MAX. Она больше не предлагает
--allили--linkкак доступные операции и не обещает порядок по времени; проверки отказа остаются.
0.38.1 — 08.10.2026
Что нового
max chats requests list|accept|declineпоказывает и обрабатывает заявки на вступление в канал.--searchсужает список по имени. MAX не сообщает время заявки: в JSONrequestedAtравноnull. Фильтр--linkи массовое действие--allне поддерживаются и отклоняются до запроса.
Исправлено
- Общая библиотека обновлена до 0.205.0, чтобы MAX, Telegram и Memo использовали одну версию локального архива. Схема заметок и ссылки не меняются.
0.38.0 — 08.10.2026
Что нового
max store jobs list --state <состояние>показывает только фоновые задачи в этом состоянии:running,done,failed,cancelledилиdied.
Изменено — может сломать скрипты
-
Латинские слова ищутся по основам английского и испанского сразу. Раньше — только испанского, поэтому английские формы слов («budgets» → «budget») находились хуже. Что учесть: после обновления индекс основ строится заново сам. Небольшой архив — сразу при открытии, большой — понемногу:
max serveдостраивает его в фоне,max store migrate— сразу. Пока индекс не готов, поиск ищет точные формы слов и пишет об этом в stderr, а в JSONquery.stemming.appliedравноfalse. Индекс основ латинского текста примерно вдвое больше. Если вы задавалиsearchStemmers.latinсами, ваша настройка остаётся, и её по-прежнему применяетmax store reindex. Обновите иtg: старая версия, открыв перестроенный архив, на поиск по основам отвечает «обновите программу» (архив). -
Заметки о человеке (
max contacts notes) видны в каждом профиле, где виден этот человек. Раньше заметка была видна только в профиле, где её написали. Почему: заметки — ваши, а не одного аккаунта; общий архив теперь хранит их отдельно от сообщений, вместе с заметками изmemo. Что учесть: если у вас несколько профилей MAX, заметки о человеке из всех профилей теперь показываются вместе. Свои имена (contacts alias) по-прежнему действуют только в своём профиле.
Исправлено
max chats joinбольше не выдаёт заявку за вступление. Если канал одобряет, кто вступает, команда только отправляет заявку и теперь отвечаетrequested: trueвместо карточки канала, а при запущенномmax serveтакой канал не появляется в списке чатов, пока заявку не примут (группы).
0.37.0 — 08.10.2026
Что нового
-
Кнопки ботов.
messages listиmessages showпоказывают кнопки бота под сообщением, с номерами:[1 Да] [2 Нет].max messages press <чат> <сообщение> <кнопка>нажимает кнопку по номеру или по тексту; бот видит, кто нажал. Нажимаются только обычные кнопки бота. «Поделиться телефоном» и «поделиться местоположением» не нажимаются никогда; для ссылки, отправки текста, мини-приложения и копирования команда говорит, что сделать вместо этого. Кнопки видны, когда сообщение читается из MAX; в локальной копии их нет (использование). -
Запуск бота.
max chats start <бот> [--payload]делает то же, что кнопка «Начать». Принимает и ссылкуhttps://max.ru/<бот>?start=…— в том числе на бота, которому вы ещё не писали: чат с ним появится в списке. Ссылка на человека отклоняется. Бот получает запуск как сообщение от вас, поэтому запуск проходит те же проверки, что отправка. -
Мини-приложение бота.
max chats app <бот> [--start]печатает адрес мини-приложения. Адрес сразу входит в приложение от вашего имени — не пересылайте его.maxэтот адрес нигде не сохраняет. -
max account list— все профили на этом компьютере и аккаунт, в который вошёл каждый. В MAX команда не обращается. -
max bot messages listпоказывает кнопки и в сообщениях самого бота. -
max watch --eventsпоказывает прочтения и изменения чатов (появилось в 0.36.0, там не упомянуто): строкаread— кто-то прочитал чат, в том числе вы на другом устройстве; строкаchat— у чата сменились название, участники, или вы из него вышли. Пометка «непрочитанным» событием не считается.
Изменено — может сломать скрипты
-
contacts profile: вflagsпоявилосьbot—trueу бота,falseу человека. Раньшеflagsвсегда был пустым. -
watch --events: строкаchatприходит, только когда у чата правда что-то изменилось — название, описание, участники, статус, фото или владелец. Раньше при запущенномmax serveона могла приходить на каждую отправку.
Исправлено
-
Если MAX не ответил после запуска бота или нажатия его кнопки, результат считается неизвестным (
outcome_unknown, код 14), а не безопасной для повтора ошибкой. Автоматического повтора нет; проверьте ответ бота, прежде чем запускать действие снова. Журнал сохраняет неизвестный исход. -
При запущенном
max serveпросмотр группы по ссылке добавлял её в список чатов, хотя вы в ней не состоите (исправлено в 0.36.0, там не упомянуто). -
maxбез команды и группа команд без подкоманды (max chats) печатали только✗ (outputHelp). Теперь в терминале — справка этой команды; в скрипте и с--json— ошибка с подсказкойmax --help.
0.36.0 — 08.10.2026
Что нового
-
Файлы для удалённого агента:
attachments showпередаёт сохранённые байты порциями с SHA256. MCP возвращает целые изображения или бинарные ресурсы, с запасным JSON/base64. Передача не вызывает модель и не меняет индекс; агент читает файл сам и сохраняет текст (вложения). -
Обновление общей библиотеки также добавляет просмотр папки с названиями чатов,
metadata refresh --only-missing, повтор/очистку фоновых заданий, наблюдаемые когорты удержания и счётчики с явной свежестью; неизвестные значения не заменяются нулями.
Изменено — может сломать скрипты
-
max contacts profileзаполняетseenвременем последнего появления илиonline, когда MAX сообщает присутствие. Поле, которое прежде оставалось пустым, теперь может содержать значение (люди). -
JSON рейтингов и доказательств содержит наблюдения счётчиков и их свежесть; evidence также поддерживает когорты удержания. Проверяйте поля каждого счётчика и вид selection, прежде чем интерпретировать ответ; неизвестное значение или неполный архив не означают ноль.
0.35.0 — 08.10.2026
Что нового
-
max chats deleteиmax chats clear— удалить чат или все его сообщения только у себя. У остальных участников чат и сообщения остаются. Без--allow-dangerousкоманда спросит, а без человека у терминала — откажет. -
Текст вложений читается локально: ODT, ODS, XLSX, PPTX, EPUB, UTF-16 с BOM и уверенно определённые старые кодировки. Модель не вызывается; формулы не вычисляются, картинки остаются для агента. Дополнительные пакеты для этих форматов не нужны; PDF и DOCX используют прежние необязательные движки. Возможности и ограничения — в руководстве вложений.
-
Отчёты администратора читают сохранённый архив: вопросы без наблюдаемого ответа, время ответа выбранных людей, помощь новичкам с известной датой вступления и посты каналов с просмотрами и малым обсуждением. Выборки и evidence позволяют проверить исходные сообщения. Неполные данные остаются неизвестными, поэтому отсутствие ответа в отчёте не доказывает его отсутствие в MAX (рейтинги).
-
Стикеры:
max stickers listиmax messages send --sticker <id>. Список — ваши наборы, с--set <id>— стикеры набора с их id. Стикер уходит один, без текста и файлов, как в MAX. -
max chats muteиmax chats unmute— уведомления из чата: насовсем или--until 8h. Меняется только у вас, участники ничего не видят. -
max account privacy setменяет приватность:--find-by-phone,--phone-number,--calls,--chat-invites(everyone, contacts, nobody) и--hide-online on|off; остальные настройки не трогаются. Найти по номеру MAX позволяет всем или только контактам —nobodyкоманда отклонит. -
max chats mediaпоказывает медиа чата с сервера MAX — фото, видео, файлы, аудио и ссылки, как галерея;--type,--before-id(использование). -
max calls list— история звонков, новые сверху: входящие, исходящие, пропущенные, длительность. -
max account privacy show— настройки приватности: кто находит по номеру, видит номер, звонит, добавляет в чаты, скрыт ли статус «в сети». Читается из ответа на вход, лишних запросов нет.
0.34.0 — 08.10.2026
Что нового
max chats update --photoставит фото группы или канала (группы).max chats folders orderменяет порядок папок. После обязательной папки «Все чаты» идут названные папки, затем остальные в прежнем порядке (использование).- Свои имена и заметки о людях:
max contacts aliasиmax contacts notes. Хранятся только на этом компьютере, в MAX не уходят;contacts show --with-notesиcontacts list --search-notesих показывают и ищут (использование). - Автоматические метки групп и каналов:
max metadata refreshиmax tags auto— по названию и описанию, без сообщений; ваши метки не трогаются (поиск). max store fetch --allскачивает все чаты — последние 90 дней каждого;--background— в фоне. Поиск сообщает, сколько сообщений и чатов просмотрено, сколько чатов не скачано или отстаёт;coverage.nextв JSON подсказывает агенту команду, которую нужно выполнить перед выводом, что сообщения нет.- Метрики ответов и обсуждений используют сохранённые reply-связи MAX. Неполные данные оставляют связь неизвестной, вместо предположения о ней.
- Руководство рейтингов объясняет метрики, оценки, покрытие, сохранённые подборки и доказательства.
- Новые руководства объясняют вложения, распознавание голоса и настройку внешних моделей.
Изменено — может сломать скрипты
-
max session endвыходит из MAX, а не только забывает токен здесь — какtg session end.revokedOnServerтеперьtrue. Если токен скопирован из вкладки web.max.ru, вкладка тоже выйдет (сессии). -
max messages searchв одном чате спрашивает и сервер MAX. С--chatилиchat:и словами по умолчанию ищутся архив и сервер (--backend both): находится и то, что ещё не скачано. Ответ сервера проверяется тем же запросом, у каждого сообщения естьsource.--backend archive— только архив,--server-time— сколько ждать сервер (5 с). Без чата ищется только архив (поиск). Что учесть: поиск в одном чате теперь может подключаться к MAX;--backend archiveоставляет его локальным.
Исправлено
-
Готовые MCP-запросы используют доступные
max_readиmax_write, вместо старых названий отдельных инструментов. Поиск в них проверяетcoverage.nextперед выводом, что сообщения нет. -
Сохранённые подборки сохраняют исключительные границы дат при повторном запуске, чтобы сообщение на самой границе не попадало в результат. Недоступные операции с папками больше не предлагаются агенту в MCP.
-
max serve --timeoutзакрывает сервер. По истечении времени завершаются подключение, незаконченный вход и фоновые задачи; процесс выходит с кодом тайм-аута.
0.33.0 — 07.10.2026
Что нового
max stats messages topиmax stats contacts topранжируют сохранённые сообщения и их авторов, аevidenceу каждой показывает, из каких сообщений сложилось место в рейтинге. Всё считается по локальной копии, в MAX ничего не отправляется.searches create --selectionсохраняет такой рейтинг как поиск.
Изменено — может сломать скрипты
- У каждого профиля теперь один темп запросов к MAX, общий для всех процессов
max. Раньше две команды сразу, фоновыеstore fetch,mcpиserveвыдерживали паузы каждый сам по себе, и вместе обращались к MAX чаще. Теперь они делят один запас: 10 запросов подряд, дальше 20 в минуту. Почему: MAX блокирует аккаунт за слишком частые запросы, а параллельные задания умножали их. Что учесть: массовые скачивания, запущенные параллельно, идут дольше; команда, которой ждать очереди больше 5 минут, сразу завершается с кодом8. Темп меняетrequestsPerMinuteилиMAX_REQUESTS_PER_MINUTE,0выключает. Всё об ограничениях — странице об ограничениях. - У
max messages sendбольше нет ключа--comment-to. В 0.32.0 он появился вместе с общим кодом Telegram, но в MAX только отказывал с кодом 2. Что учесть: скрипт, который передаёт--comment-to, по-прежнему получает код 2, теперь с сообщением о неизвестном ключе.
0.32.0 — 07.10.2026
Что нового
- Фото и сканы вложений можно распознать пачкой через выбранную модель. По умолчанию агент по-прежнему
читает их сам и сохраняет текст через
attachments text set. Для массовой обработки естьattachments extract --ocrс моделью изmodels.ocrи--concurrency; распознанный текст попадает в прежний поиск поcontent:. Что учесть:--ocrотправляет файлы выбранному провайдеру модели, поэтому включается только явно. Кеш учитывает файл и модель; сбой API не затирает текст агента и прежний индекс.
Изменено — может сломать скрипты
max contacts profileпоказывает прежние имена человека в новом ключеaliases. Раньше локальная копия помнила только текущее имя: новое имя из сообщения или синхронизации контактов затирало старое. Почему: человека, который сменил имя, проще узнать по прежнему. Что учесть: в ответе--jsonпоявился ключaliases— список{ name, firstSeenAt, lastSeenAt, source }от старых к новым.source: messages— имя из сохранённых сообщений, оно приблизительное. Список пуст, пока копия не видела смены имени. Поискfrom:ищет только по текущему имени. Люди.- У
max messages sendпоявился ключ--comment-to, но в MAX он не работает: команда отказывает с кодом 2 и ничего не отправляет. Ключ общий с Telegram, где он пишет комментарий под постом канала. Что учесть: в MAX комментарии под постами каналов не поддерживаются; не используйте ключ в скриптах.
0.31.0 — 07.10.2026
Что нового
-
Подготовка поиска и ремонт архива. Извлечение текста через MCP,
attachments extract --from-dirиmessages download --extract; проверка изменившихся файлов по хешу.store fetch --catch-upподготавливает граф и установленные локальные векторы в заданных пределах; по умолчанию выключен.store gaps plan/repairи MCP показывают записанные внутренние разрывы и явно загружают их с лимитами и заданиями. Неизвестные края и неоднозначные страницы не считаются полным архивом. -
Состав отслеживаемых групп обновляется ежедневно, пока работает MAX server. Доступен
chats members fetch --track; tracking не продлевает idle timeout сервера. -
max setupпроще читать. Каждый шаг — заголовок[1/4] This computer, под ним с отступом то, что произошло; вопросы и QR-код стоят под своим шагом, вокруг кода пустая строка. Итог — выровненная таблица, первой строкой команда, с которой начать. Вывод--jsonи его ключи не изменились;--quietпо-прежнему скрывает шаги. -
Шаблоны автоответов используют Liquid и отдельные блоки
ai.models.repliesвыбирает провайдера;replies consentsвыдаёт согласие на профиль и endpoint с запретами для отдельных чатов. Обычныйreplies testне вызывает модель;--aiявно передаёт сохранённые данные. Старые шаблоны сохраняют запасной текст с предупреждением. Отправка остаётся ограниченнойtestersиreplies.send; руководство. -
max serveоткрывает задачи из правил автоответов. Просматривайте их черезmax tasks listили MCP-промптopen-tasks; создание задачи ничего не отправляет. -
Подключение из браузера описано для Windows, macOS и Linux. Руководство разделяет Tailscale и сервер, даёт команды PowerShell и объясняет временные права отправки, подключение Codex web, запуск двух мессенджеров и остановку отдельных туннелей. Подключение.
-
Настройки, права и профили объясняются отдельно. Руководства начинаются с обычных задач, расположения файла и примеров; полный справочник остаётся доступен.
Изменено — может сломать скрипты
-
Контракт SDK 0.161.0: headless-режим, пределы ввода/вывода и времени, схемы команд, выбор полей, previews и правила повторения записей. Статистика использует
stats <ресурс> <вид>без старых алиасов. -
MCP использует три инструмента поиска, чтения и записи вместо отдельных инструментов на команду; серверных форм подтверждения нет. Права профиля и отдельные правила модерации сохраняются.
-
Настройки разделены на краткое руководство и полный справочник; добавлена пользовательская страница о контракте CLI и проверка агентского навыка в CI.
-
Статистика вызывается через
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-инструменты теперь называютсяmax_stats_messages_show,max_stats_chats_show,max_stats_tasks_show. -
Ошибки синтаксиса возвращают код 2 и структурированную ошибку JSON. Скриптам, ожидающим прежний код 1 или обычный текст, нужно обновить обработку ошибок.
-
При первой загрузке настроек создаётся config.json. Существующий файл не перезаписывается; переменные и параметры команды в него не сохраняются. config show теперь может создать файл, а обычные значения показывают источник defaults файла.
-
Поиск слов и фраз находит формы слов. Запросы в скриптах могут вернуть больше сообщений. Для прежнего точного сопоставления используйте exact: или --exact; явно указанное text: продолжает искать формы. Настройки языка архива определяют сопоставление.
Исправлено
-
Подготовка поиска соблюдает запрет на запись связей.
conversations.links: readonlyилиdenyостанавливает catch-up после загрузки и при ремонте разрывов до подключения или запуска задания. Явный--no-catch-upпо-прежнему разрешает обычное чтение истории по правилам профиля. -
Контекст человека находит личную переписку без записанного состава участников, если ID диалога совпадает с ID человека; последние сообщения в обе стороны снова доступны.
-
Документация MCP использует текущие пути команд и права без удалённых форм подтверждения.
-
При прерывании записи сохраняются исходные
outcome_unknown,operationIdи сведения о повторении, возвращённые командой: обновлена общая библиотека до 0.161.0. -
Таймаут команды во время записи Bot API сохраняет неизвестный результат. Операция могла выполниться; перед повтором нужно проверить состояние.
-
MCP MAX не предлагает неподдержанные инструменты форумов. Поиск команд больше не предлагает изменение и порядок Telegram topics.
0.30.0 — 06.10.2026
Что нового
max stats charts --output activity.pngсохраняет график в PNG с тёмной темой. SVG остаётся доступен; изображения записываются только в новые файлы. MCPmax_stats_chartsсformat: "png"возвращает изображение вместе с JSON, без подключения к MAX и записи файлов. БезformatMCP по-прежнему возвращает JSON.- Правила автоответов можно редактировать через
max replies add|edit|on|offиaudience. Новое правило выключено до явного включения; изменения сохраняются только локально, без отправки сообщений. Ограничение автоответов тестовыми аккаунтами сохраняется; списокtestersпо-прежнему задаётся в файле. Автоответы. max tasks— что ждёт вашего ответа.max reviewведёт в локальной копии задачу на вопрос, на который никто не ответил, и на сообщение, где вас упомянули, и закрывает её, когда вы ответили; теперь их видно.max tasks listпоказывает их со ссылкой на сообщение;max tasks add <сообщение> --type promiseдобавляет то, чего правила не видят;max tasks close <задача> --as done|dismissedзакрывает навсегда;max tasks statsсчитает по чатам. Агенту то же дают MCPmax_tasks_list,max_tasks_add,max_tasks_close,max_tasks_stats. Всё остаётся на этой машине, в MAX ничего не уходит; запись — по правамtasks.addиtasks.close. Что учесть: в MCP стало на четыре инструмента больше;max serveв MAX задачи пока не открывает. Что ждёт вашего ответа.- Длинные сообщения ищутся по смыслу целиком. Сообщение длиннее примерно 1200 знаков перед эмбеддингом
делится на перекрывающиеся части, поэтому поиск по смыслу читает его полностью, а не только начало. Чаты,
собранные раньше, считаются устаревшими: их пересобирают
conversations buildилиsearch --refresh(cli-messaging 0.153.0; хранилище переходит на версию 21, которую старые сборки продолжают писать). - MCP выполняет разрешённые записи из веб-клиентов без серверных форм. Режим
--http-confirmation permissionsследует уровням прав:allowне требует серверную форму,askтребует её. По умолчанию форма остаётся обязательной для каждой записи. Повторяемый--permission ключ=уровеньпереопределяет права только на время работы сервера без изменения настроек. Подтверждение приложения отдельно и сервером не проверяется. Что учесть: в этом режиме всё, что профиль разрешает на уровнеallow, включая отправку сообщений, агент из браузера выполняет без формы; проверьте права перед включением. Подключение.
Исправлено
- Описания MCP-инструментов отслеживания участников учитывают ручной сбор в MAX.
Агенту больше не обещается ежедневное чтение списков через
serveи не предлагается недоступныйfetch --track. Список групп и сохранённые снимки по-прежнему читаются из локального хранилища.
0.29.0 — 06.10.2026
Что нового
-
max chats tracking list|show|add|removeуправляет списком групп для наблюдения за составом. Можно посмотреть сохранённые снимки числа участников, добавить группу без немедленного чтения или убрать её, сохранив историю. Для записи состава используйтеmax chats members fetch. В MAXserveпока не читает участников ежедневно: повторяйте сбор вручную или по своему расписанию. -
Профиль человека.
max contacts profile <человек>показывает, что MAX сообщает о человеке: имя, ссылку, описание, когда создан аккаунт (registered, по данным MAX), есть ли своё фото, — и для каждого общего чата, сколько его сообщений в локальной копии, первое и последнее. Телефон, если MAX его прислал, — последние четыре цифры, целиком с--show-phone. Один запрос к MAX сверхcontacts show. MCP:max_contacts_profile. -
Автоответы по правилам — только тестовым аккаунтам.
max serveотвечает на входящие сообщения по правилам из<профиль>.replies.json, но лишь тем, кто назван вtesters; отправка — только приpermissions.replies.send allow. Командыmax replies test,pause,resume,status. Страница — автоответы. -
max contacts context <человек> --chat <чат>(можно повторять) даёт его последние сообщения в каждом чате — только время и текст, чтобы агент пересказал;-vдобавляет номера и ссылки,--limit— на чат,--refreshсначала читает последнюю страницу чата у MAX. -
Использует cli-messaging 0.152.0.
-
max contacts check <человек>— похож ли человек на бота. Оценка по профилю и по сохранённым сообщениям (ничего не писал, первое сообщение — ссылка, один текст в нескольких чатах), у каждой причины — источник. Публичные списки спамеров ведут только Telegram, поэтому для MAX они не запрашиваются.max chats members audit --deep <n>так же проверяет первых n участников, по одному в секунду. -
max chats members fetchсохраняет снимки участников, аhistoryпоказывает изменения. Чтение истории доступно offline, с фильтром--since-time. Снимок ограничивается--budget; выходы фиксируются только после полного чтения. Ежедневное отслеживание ждёт поддержки фоновой службы MAX. Работа с участниками. -
max stats chartsстроит графики статистики чата. Команда возвращает нейтральное описание в JSON, а по--outputсохраняет SVG с тёмной темой: сообщения, активные авторы, вступления и выходы по дням или неделям. Пропущенные даты остаются разрывами, неполные данные отмечаются явно. Существующий файл не перезаписывается. MCPmax_stats_chartsвозвращает описание из локального хранилища; PNG появится отдельно. Новая библиотека добавляет около 61,6 MiB распакованных файлов до дедупликации; она загружается в процесс только при запросе изображения. Как пользоваться. -
Реакции на посты канала сохраняются и при
max store fetch. MAX присылает число реакций вместе с историей канала, и теперьmaxего не теряет:max chats statsможет ранжировать посты канала по реакциям без отдельного запроса. -
max chats stats <чат>— цифры группы или канала за период. Сообщения, сколько людей писало, ответы, реакции, лучшие посты, вопросы и как быстро на них отвечали, кто вошёл и вышел. Считается по локальному хранилищу; входы и выходы спрашиваются у MAX. Если в хранилище не вся история чата, числа — нижняя граница, и команда подсказывает, какойstore fetchеё дополнит. -
Поиск читает текст файлов.
attachments extractсохраняет текст TXT, DOCX и PDF с текстовым слоем;content:находит его. Для DOCX/PDF нужны необязательныеmammoth/unpdf; фото и сканы читает агент и сохраняет результат черезattachments text set. По умолчанию читаются только скачанные файлы;--download --output-dirявно скачивает их сначала. -
Поиск можно сначала обновить и показать цепочку ответов.
--sync-firstограничивает скачивание пятью чатами, 500 сообщениями и 30 секундами; неполное обновление не прячет локальную выдачу.--threadдобавляет ограниченный граф ответов с источниками связей; без графа используется контекст по времени. -
Поиск бесед принимает строгий фильтр и явный охват аккаунтов.
--filterограничивает беседы до ранжирования; весь фильтр должен совпасть хотя бы у одного сообщения.--sourceрасширяет охват явно. Агент может связать сообщения целиком через MCP: инструкцияlink-conversations, пачки, сохранение связей и перестройка графа. -
Модели векторов и анализа настраиваются отдельно по профилям. Локальные векторы и ваш агент остаются по умолчанию. Внешний сервис получает текст только при явном выборе;
build --analyze --chatспрашивает согласие и запоминает его для аккаунта, чата и сервиса до отзыва. -
Свои метки:
max tags add,removeиlist. Метку можно повесить на чат (--chat), человека (--contact) или одно сообщение (--message), аtag:<метка>в поиске находит помеченное. Метки хранятся только в архиве на этой машине и в MAX не уходят. Метка — от 1 до 32 латинских букв, цифр и дефисов. Агенту доступны те же действия через MCP. См. Поиск сообщений. -
Сохранённые запросы:
max searchesи--saved.max searches create <имя> [запрос]сохраняет запрос с его опциями,max messages search --saved <имя>иmax messages stats --saved <имя>запускают его. Слова, добавленные к--saved, сужают запрос, а опции в командной строке заменяют сохранённые.searches list,show,history,deleteиclearпоказывают и чистят сохранённое и историю. Поэтому запрос уmessages searchтеперь необязателен, если есть--saved. -
max contacts context <человек>— что архив знает об одном человеке. Общие чаты, последние сообщения в обе стороны, его недавние сообщения и где его упоминали. Команда читает только архив и ничего не отмечает прочитанным.max contacts linkзаписывает, что аккаунт в MAX и аккаунт в Telegram — один человек, тогдаcontextпоказывает обоих;max contacts unlinkотменяет это. Что учесть:contextвозвращает тексты сообщений, поэтомуpermissions.messages: denyего тоже запрещает. -
max store repairчинит структуру архива, ничего не удаляя. Таблицу другой формы он оставляет копией рядом с новой и называет её в ответе;--dry-runпоказывает, что будет сделано, и ничего не меняет.max store copies delete <имя>удаляет одну такую копию. См. Архив. -
Поиск учитывает основы слов, если включить.
max config set searchStemmers.cyrillic russianиsearchStemmers.latin spanish(илиenglish) — настройка одна на весь архив, все профили и оба мессенджера. После неё нуженmax store reindex. -
max flood clearзабывает запомненные ожидания и снимает удержание отправок. Их видно вmax server status, в новом полеflood. Что учесть: MAX пока не называет, сколько ждать, поэтому для личного аккаунта MAX там будет пусто; от частых входов по-прежнему защищает пауза входа, которую показываетmax doctor. В MCP этой команды нет намеренно: агент не должен снимать ограничение. -
У поиска три руководства. Поиск сообщений — поиск на каждый день по словам, людям, датам, файлам, ссылкам и меткам; поиск по темам — беседы, векторы и что уходит внешней модели; язык запросов — справка.
Изменено — может сломать скрипты
-
Поиск по смыслу у локальной e5-small отбрасывает слабые совпадения до объединения со словами. Косинусная близость должна быть выше 0,80; совпадения по словам остаются. Выдача может быть короче, а результат, найденный обоими способами, может стать только совпадением по словам.
-
Архив получает таблицы текста вложений и согласий на анализ. Это локальная миграция при первом открытии; старые сообщения сохраняются. Перед обновлением большого архива сделайте резервную копию.
-
Архив теперь хранит каждый удачный запрос
messages searchиmessages stats— и из командной строки, и из MCP. Хранятся сам запрос и опции, но не найденные сообщения; последние 1000 запусков. Почему: из этой истории работаютsearches historyи--saved. Что учесть: если запросы не должны оставаться на диске, запускайте с--no-recordили поставьтеmax config set record false;max searches clearстирает историю, сохранённые запросы остаются. -
При первом запуске архив переходит на новую схему. Появляются таблицы меток, сохранённых запросов и основ слов,
max store migrateдостраивает индекс основ для старых сообщений. Что учесть: на большом архивеstore migrateиstore reindexидут дольше прежнего. Архив общий сtg, и прежние версииmaxиtgпродолжают его открывать. -
max inbox,inbox --new,reviewиchats list --unread(а также--searchи--kind) смотрят все чаты, которые MAX прислал при входе, а не только 200 самых свежих. Раньше чат с непрочитанным ниже по списку пропускался молча. По-прежнему обрабатывается не больше 20 чатов за запуск, остальные названы в заметкеskipped N chats. Что учесть:partial: trueтеперь значит только одно — MAX прислал при входе не все чаты. -
max chats listговоритhasMore: trueна последней непустой странице, если MAX прислал не все чаты. Раньше список выглядел полным. Что учесть: скрипт, который листает доhasMore: false, остановится на пустой странице. -
max messages listиmax store fetchбольше не принимают короткую страницу за начало чата. MAX не сообщает, есть ли сообщения старше, а страница может прийти короче--limitи в середине переписки. Теперь после короткой страницыmaxзапрашивает одно более старое сообщение: если оно есть,hasMore: true, если нет — это начало чата. Что учесть: это один лишний запрос к MAX на каждую короткую страницу, иhasMoreчаще бываетtrue. -
max config setиconfig unsetпринимаютsearchStemmers.cyrillicиsearchStemmers.latin, аconfig show --jsonпоказывает их в новом полеstoreSettings. Эти настройки хранятся в архиве, а не в файле настроек, поэтому--defaults,--personalи--botс ними отказывают, а подMAX_PROFILE_LOCKих менять нельзя.
Исправлено
-
Ошибка в файле правил автоответов больше не выводит фрагменты этого файла в журнал службы.
-
max mcp --http: Claude и ChatGPT теперь могут завершить вход. Страница входа заставляла браузер отправлять форму как будто ниоткуда, иmaxотвечал «Origin not allowed». Теперь вход работает (cli-messaging 0.152.0). -
Ссылка на сообщение из другого аккаунта больше не открывает одноимённое сообщение текущего.
messages show/contextотказывает; MCP принимаетoffline: trueдля обычного локального контекста. -
Строгий поиск по регулярному выражению
text:/…/находит слова так же, как поиск по словам. Раньшеtext:/Квартир.*/илиtext:/счёт/не находили слова, которые есть в архиве, из-за регистра и буквы «ё».body:по-прежнему различает регистр. -
Ошибки строгого поиска говорят, что делать.
~подсказывает--language legacyислово*; слишком короткий префикс вродек*называет предел в 10 000 слов и просит префикс длиннее;index_not_readyговорит, сколько индекса готово, и точную командуmax store migrate. -
MCP не пишет историю поиска, если запись выключена. Раньше
record: falseвыключал историю только в командной строке.
0.28.0 — 04.10.2026
Что нового
-
MCP
max_chats_statsсчитает активность группы или канала из локального архива; вступления и выходы не запрашиваются.max chats members auditпоказывает признаки подозрительных участников, никого не удаляя. -
MCP
max_inboxиmax_reviewпринимаютkindsиnewс отдельными от CLI отметками по чатам. -
max messages statsсчитает сообщения из локального архива по чату, отправителю, дню или часу. Запрос использует строгий Lucene; без него считаются все сохранённые сообщения текущей учётной записи. Сеть не используется,--source maxявно включает другие профили. В неполном архиве результат остаётся нижней границей; проверьтеcoverageиcompleteness. -
max mcp --http --public-url https://<имя>.ts.netоткрываетmaxдля ChatGPT и Claude в браузере. Инструменты MCP отдаются на127.0.0.1за вашим собственным туннелем, со своим входом: приложению нужен одноразовый код, которыйmaxпечатает в терминале. Каждое изменение сначала спрашивает через форму в приложении. Вход действует 30 дней;max mcp --revokeзавершает все. Страница о подключении из браузера заменяет схему со сторонним прокси. -
Личный MCP использует общий с Telegram набор схем: устройства, поиск контакта по телефону, папки, участники, приглашения, настройки группы, опросы, локальные доказательства и беседы. Топики Telegram в MAX не поддерживаются. Старые имена проверки и правил группы сохранены.
-
Подтверждённая отложенная отправка использует время из формы, даже если ответ пришёл позже.
Изменено — может сломать скрипты
-
coverage.inventoryCompleteтеперь отражает получение полного списка чатов, аlastSyncedAt— старейшую загрузку в охвате; записиcompletenessсодержатfetchedAt. Существующий архив получает эти сведения после следующего полного списка и загрузки истории./catch-upпринимаетkindиmodeвместоsince. -
config set permissionsотклоняет неизвестные команды, в том числе опечатки внутри целого объекта, с кодом 2.config unsetпозволяет их удалить; чтение существующего файла предупреждает и продолжается. -
Аргументы MCP приведены к общим именам:
at_time,md,since_time,before_n,after_n,unanswered;send_idтеперь строка. Неизвестные аргументы отклоняются до выполнения. Обновите вызовы по схеме изtools/list. Уmax_inboxиmax_reviewпараметрall: trueвключает чаты без звука и архив; без него остаются упоминания владельца.
Исправлено
- Поиск и статистика показывают фактический охват локального архива и время последней загрузки.
wordsReadyбольше не обещает готовый словесный индекс для поиска только по фильтрам или regex.store fetchигнорирует отметку начала истории, если в архиве обнаружились более старые сообщения. server statusсообщает код штатного завершения службы и причину остановки без повторного запуска.
0.27.0 — 04.10.2026
Что нового
-
Глобальная установка через npm настраивает Windows PATH и навык агента. Пакет сохраняет существующие записи PATH и делает
maxдоступным в новых терминалах. Уже работающему агенту нужно обновить своё окружение. Навык устанавливается до входа;MAX_INSTALL_AGENT=noneотключает его установку. Локальная установка и npx окружение пользователя не меняют. -
max commands messages search --jsonописывает одну команду, аmax commands messages --json— группу. Агенту больше не нужно читать всё дерево перед каждой задачей; глобальные опции и коды завершения сохраняются. Слова послеcommandsзадают один путь, разные группы смотрите отдельными вызовами. Вызов без пути по-прежнему возвращает всё дерево. -
max messages linkи MCPmax_messages_linkвозвращают locator сообщения из локального архива. Сообщение проверяется в текущей учётной записи; locator другой учётной записи отклоняется. Личный MAX пока не предоставляет подтверждённый permalink:urlравенnull, причина указана в ответе.--offlineне подключается к MAX. См. сообщения.
Изменено — может сломать скрипты
-
CLI и MCP используют
permissionsс уровнямиdeny,readonly,ask,allow. Один набор прав действует для команд и агентов. Большинство записей через MCP теперь доступно по умолчанию; удаление сообщений и завершение других сессий требуют подтверждения, если не задан явныйallow. Например,messages: readonlyиmessages.delete: allowразрешают чтение и удаление без вопроса, запрещая другие записи в сообщения; остальные ресурсы не ограничиваются. Перед обновлением проверьте права агента и задайтеreadonlyилиdenyнужным ресурсам.--confirm-sendтребует форму перед каждой записью; в JSON-режимеaskтребует явного флага. -
config migrateпереводит старые настройки доступа и уровни правил модерации.--dry-runпоказывает изменения без записи; миграция сохраняет действовавшие уровни, настройки MAX и сохранённые места проверки групп. После появленияpermissionsменятьreadOnly,allowиmcpToolsнельзя. Старые MCP-флаги--allow-send,--allow-mark-read,--allow-delete,--allow-moderateпока принимаются с предупреждением, но не дают прав. Список получателей и лимит в час продолжают действовать. См. настройки и MCP.
Исправлено
- Параллельное открытие локального архива ждёт краткую блокировку SQLite при запуске. Раньше настройка журнала могла встретить занятую базу до включения ожидания и отказать сразу. Длительная блокировка по-прежнему завершается ошибкой; изменение не запускает загрузку истории.
0.26.0 — 03.10.2026
Что нового
-
max skill show link-conversationsпечатает общий навык связывания разговоров. Команда доступна без сессии; без имени по-прежнему выдаётся основной навык MAX. -
max messages evidenceвыдаёт ограниченный пакет из локального архива, с locator, сведениями о полноте и продолжением через--before-id. Команда не подключается к MAX.
Изменено — может сломать скрипты
-
Скачанные фото получают расширение по HTTP MIME, например
.webpдля WebP, а не JPEG по типу вложения. Исходные имена файлов сохраняются; лишних предварительных запросов нет. -
max account showиспользует общий формат аккаунта с Telegram. JSON добавляетusername: null; прежние поля MAX, маскирование номера и--show-phoneсохраняются. -
max sends listучитывает настроенныйlimit, как Telegram. Раньше без флага всегда выбирались 20 попыток. Поле JSONlimitсодержит выбранный предел;items,page,hasMoreсохраняются.--limitимеет приоритет над настройкой. -
max messages downloadподдерживает--all,--output-dirи--pause, как Telegram. Каталог создаётся автоматически; повторный обход всего чата продолжает сохранённый прогресс.--outputостаётся совместимым именем каталога. JSON одного сообщения теперь содержит{items}, без искусственныхpage,limit,hasMore; скриптам следует читатьitems. Для голосовых полеkindтеперьvoice, как Telegram, вместо прежнегоaudio. Файлы скачиваются потоком с прежними проверками адресов и размера; голосовые сохраняют предел 32 MiB.
Безопасность
max contacts lookupне повторяет номер, ошибочно переданный аргументом. Команда отказывает до запроса номера и подключения; номер следует вводить по запросу или через stdin.
Исправлено
-
messages list,inboxиreviewс--transcribeскачивают запись через соединение чтения. Раньше открывался второй вход в MAX. Запись скачивается до закрытия соединения, а локальное распознавание запускается после закрытия. Без явного--mark-readничего не отмечается прочитанным. -
review --unansweredучитывает сохранённые и новые расшифровки голосовых вопросов. Раньше вопрос с пустым текстом отбрасывался до расшифровки. То же исправление действует в MCP; исходный текст сообщения не меняется, а нераспознанные записи оставляют обзор неполным. -
max chats showобъясняет расхождение числа участников корректно. Список может исключать собственный аккаунт или быть неполным; команда показывает оба числа без утверждения об ошибке загрузки. JSON и исходный список участников сохраняются. -
Отказ
poll.already.votedобъясняет смену голоса. Если опрос разрешает её, сначала выполнитеpolls vote <chat> <message> --retractв том же профиле, затем выберите новый ответ. -
max messages download --timeoutзакрывает и HTTP-поток вложения. Раньше после таймаута команды он мог продолжать скачивание до отдельного лимита зависания; теперь adapter close отменяет свои потоки, а незавершённый файл удаляется.
0.25.0 — 03.10.2026
Что нового
bot apiиспользует общий с Telegram конструктор команд и проверку входных данных. Генераторы остаются в cli-core; параметры, нативные ответы и действующие разрешения MAX сохранены. Общая опция--store-token <profile>предназначена для операций, возвращающих учётные данные; остальные операции её отклоняют.
Исправлено
messages list,inboxиreviewс--transcribeскачивают запись через соединение чтения. Раньше открывался второй вход в MAX. Запись скачивается до закрытия соединения, а локальное распознавание запускается после закрытия. Без явного--mark-readничего не отмечается прочитанным.review --unansweredучитывает сохранённые и новые расшифровки голосовых вопросов. Раньше вопрос с пустым текстом отбрасывался до расшифровки. То же исправление действует в MCP; исходный текст сообщения не меняется, а нераспознанные записи оставляют обзор неполным.
Изменено — может сломать скрипты
-
max models audio list --jsonдобавляетdirectory: общий каталог моделей, который используют MAX и Telegram. Команды моделей, каталог и проверка скачивания теперь общие; существующие файлы, порядок моделей и настройкаtranscribeModelсохраняются. Повторно скачивать модели не нужно. JSONL по-прежнему выдаёт одну модель на строку. -
--mdразбирает собственный форматтер MAX для send/edit и подписей: вложенные стили,__жирный__,++подчёркнутый++, ссылки и код. Боты поддерживают выделение, заголовки и цитаты через безопасный HTML; личный протокол явно отказывает неподтверждённым типам. Telegram имеет другой синтаксис. Неизвестные wire-типы больше не отправляются молча.
0.24.0 — 03.10.2026
Что нового
max setupпроводит через первый запуск личного аккаунта: проверяет локальные каталоги, предлагает QR-вход, проверяет аккаунт и до пяти чатов и подключает навык выбранного агента. Повторный запуск использует существующую сессию. История скачивается отдельно; setup не запускает фоновый сервис. Справка, установка и инструкция для агента объясняют следующие шаги и запуск на Windows без PATH.max skill showдоступен до входа.
Изменено — может сломать скрипты
-
max chats checkзаменён наmax chats moderate: общие правила и модерация с Telegram.--since-timeпринимает время или30m/2h/1d, вместо прежнего--sinceс номером сообщения; JSON теперь{ chatId, rows }. За запуск читается до 1000 сообщений. Уровни правил —deny|readonly|ask|allow; старыеforbidиflag|confirmчитаются какdenyиask. Сохранённое место проверки переносится из сессии в прежний файл правил, поэтому первый запуск продолжает с него. CLI и личный MCP используют одно место; имена MCP-инструментов и их флаги сохранены. Событие вступления по ссылке вchats eventsназываетсяjoin. -
max upgrade --jsonвсегда содержит списокrestarted. В MAX это пустой массив: политика запуска серверов при обновлении сохранена. Проверка версии и отсутствие обновления возвращают ту же форму ответа, что установка; прежние поля остаются. Скриптам с точной проверкой набора ключей нужно учесть добавленное поле. -
Локальный поиск использует строгий профиль Lucene: скобки, поля, диапазоны дат и
--timezone, ограниченные шаблоны и regex. Префикс задаётся явно какслово*; прежний поиск с исправлениями доступен через--language legacy. JSON сообщает охват даже без результатов. Руководство и навык описывают миграцию; JS--regexвыполняется в отдельном worker с пределами размера и времени. -
max commands --jsonвозвращает версию JSON-контракта в полеcontract. Значение0совпадает с Telegram CLI; прежние поля справочника сохранены. Скриптам, сравнивающим весь JSON с сохранённой строкой, нужно учесть новое поле; выбор отдельных полей менять не требуется. -
Чтения групп используют общие опции и форматы.
chats eventsпринимает--since-timeвместо--sinceи--typeвместо--event; граница — время, а не id сообщения. Событие создания теперь называетсяcreateвместоnew.chats members listпоказывает страницу с--limit,--pageи--all; для прежнего объёма добавьте--all. JSON больше не содержитchatIdиrolesKnown, но роли, даты регистрации и последнего посещения остаются в строках.chats inspectвозвращаетid,kind,title,username,participantsCount,descriptionиmemberвместо карточки с доступом, ссылкой и настройками.memberиusernameравныnull, когда MAX их не сообщает. Это единые чтения MAX и Telegram; обновите скрипты и фильтры. Предупреждения о неполном списке и неизвестных ролях сохраняются; никакое чтение не отмечает сообщения прочитанными. Подробнее: группы. -
Команды управления группами отвечают общим JSON с
operationId.chats create,join,updateиlink resetкладут карточку вchat;leaveвозвращаетchatId. Уmembers addтеперь поляaddedиnotAdded, уmembers remove—removed; у командadmins—personId, а при добавлении ещё иrights. Это единый формат операций MAX и Telegram; скриптам нужно обновить разбор результата.link showсохраняет прежний формат. Название и настройки по-прежнему меняются двумя запросами: если название или описание уже изменено, а запрос настроек не завершился, команда сообщаетoutcome_unknownи отмечает неполный результат в журнале. Прочитайтеchats showперед повторной попыткой. Подробнее: управление группами. -
max account updateиmax account sessions endвозвращают общий формат сoperationId. Изменение профиля отвечает{operationId, account}с полямиid,name,username,phone, завершение сеансов —{operationId, sessions}вместо массива. Это единый формат операций MAX и Telegram; скриптам нужно читать данные изaccountлибоsessions. Описание профиля больше не возвращается после изменения: его показываетaccount show. Номер телефона остаётся замаскированным;sessions endпо-прежнему требует--others --yes. Для фото профиля теперь принимаются JPG, JPEG, PNG и WebP; GIF нужно преобразовать в один из этих форматов. Подробнее: профиль и сеансы. -
max chats folders create|update|deleteвозвращаютoperationIdвместе с результатом. Создание и изменение отвечают{operationId, folder}, удаление —{operationId, folderId}, вместо самой карточки папки. Это общий формат операций MAX и Telegram; скриптам нужно читать карточку изfolderи использоватьfolderIdпосле удаления.updateбез--title,--addили--removeтеперь отказывается вместо повторной записи той же папки. Список папок сохраняет прежний формат. Подробнее: папки. -
max contacts add|remove|block|unblock|rename|importвозвращают общий формат сoperationId. Добавление и переименование отвечают{operationId, person}, удаление и блокировка —{operationId, personId}, импорт —{operationId, sent, recognised}. Вrecognisedтеперь карточки людей (id,name,username), которые MAX вернул, вместо номеров телефонов; если карточек нет, список пуст.sentсчитает строки файла, включая повторяющиеся номера. Это единый формат операций MAX и Telegram; скриптам нужно обновить разбор ответа. Ошибка номера, отклонённого MAX, больше не указывает строку файла; ошибка структуры строки по-прежнему указывает её номер. Подробнее: контакты. -
Команда
max cache clearудалена. Все чтения и имена используют общую локальную копию;max store clear --left --allow-dangerousудаляет данные покинутых чатов. Удаления всей общей копии команда не предлагает. Старый файл не переносится и не открывается; его путь показываетmax doctor, а историю можно заново скачать черезmax store fetch.
Исправлено
-
max conversations embed statusточнее оценивает время для e5-small. Расчёт использует измеренные 31 фрагмент/с вместо 15; на ноутбуке из измерения прежняя оценка была вдвое длиннее. Реальное время зависит от компьютера и длины текста. Три рабочих потока дают измеренные 1,04–1,1× при заметном расходе памяти; распределение потоков не менялось. -
max_messages_searchчерез MCP сохраняет сведения об охвате архива и использует параметры того же поиска, что CLI. Доступныlanguage,timezone, versionedast, имя чата и фильтрыsource,newest,context. Запрос из одного символа допускается стандартным профилем. Раньше часть параметров отсутствовала, а ответ терялquery,coverageиcompleteness; пустая выдача не объясняла охват локальной копии. Прежние поля ответа и имя инструмента сохранены. -
max runs list --limitпредлагает увеличить лимит, если показаны не все записи. Подсказка не предлагает отсутствующую опцию--page. Чтение списка и отдельной записи не создаёт нового запуска; JSON-список по-прежнему содержитhasMore. -
chats showпоказывает записанную группу, даже если её нет в последней дельте входа. Раньше чтение могло закончиться ошибкой «нет чата». Неизвестные настройки и ссылка теперь остаются пустыми; чтение ничего не меняет в группе. -
max messages transcribeнаходит сохранённую расшифровку и по имени чата, когда модель не скачана. Раньше команда искала текст по введённому имени вместо id чата и предлагала скачать модель заново. Полное имя и его однозначный фрагмент теперь возвращают сохранённый текст без скачивания записи и повторного распознавания. Подробнее: голосовые сообщения. -
На Windows генератор использует Node вместо прямого запуска
.cmd; проверки документации распознают пути Windows. Тесты Unix-прав не требуют их от Windows, где доступ задаётся ACL. -
Ошибки
max botдо запуска действия учитывают настройки записи bot-профиля, даже если перед командой указан--timeout. Раньше при глобальной опции передbotмогли применяться настройки личного аккаунта. Если запись выключена для bot-профиля, ошибка разбора команды теперь не создаёт запись вопреки этой настройке.
0.23.0 — 03.10.2026
Что нового
-
max serveи команды управления чатами сохраняют имена и чаты в общей локальной копии. Старый кэш профиля больше не открывается. Полный список отмечает покинутые чаты; пустой ответ сохраняет предыдущий список. -
Команды контактов и общие команды чтения сохраняют данные в общей локальной копии. Поиск человека по имени и
contacts syncбольше не требуют старого кэша профиля; синхронизация по-прежнему возвращает только счётчики. Удаление старого файла не сбрасывает точку синхронизации; чтобы получить полный список заново, выполнитеmax contacts sync. -
max mcpотпускает модель поиска через 10 минут без поиска —conversations_searchу агента больше не держит около 1 ГБ памяти всю сессию. Следующий поиск загрузит модель снова, примерно за секунду (cli-messaging 0.110.0). -
Автодополнение чатов и людей берёт подсказки из общего хранилища выбранного аккаунта. Старый кэш больше не нужен. Tab по-прежнему не подключается к MAX; команды бота предлагают чаты из своего локального списка.
-
max mcp setup codex|claude-codeиmax mcp doctorдобавляют локальный MCP в выбранный клиент и проверяют запуск и список инструментов. Если профиль предлагает запись, установка требует--allow-writes; это подтверждение не меняет права и не проверяет вход в MAX. -
max <бот> bot store fetch <чат>— скачать историю чата в локальную копию бота, новые сначала; повторный запуск продолжает.--last,--since-time,--limit,--page-size,--pause— как уmax store fetch. -
--yesдля любой команды — согласие на вопрос, который уровеньaskзадаёт перед записью;max account sessions end --others --yesработает как раньше.
Изменено — может сломать скрипты
-
messages send --topicиpolls create --topicвозвращают понятный отказ для MAX. Это общая опция адресации тем Telegram, которых MAX не поддерживает; сообщение или опрос при таком вызове не отправляется. Обычные вызовы без--topicработают как прежде. -
max doctor --jsonсообщает об общем хранилище вstore, а старый файл — вlegacyCache. Проверка больше не открывает старую локальную копию и не проверяет её схему. Скриптам, которые читалиcache, нужно перейти наstore; старый файл можно удалить вручную, а историю снова получить черезmax store fetch. -
MCP читает общую локальную копию сообщений. Поиск, контакты, ресурсы чатов и расшифровки используют
messages.dbпод аккаунтом профиля; отдельный кэш профиля больше не открывается. Чтение истории сохраняет сообщения для последующего поиска. Голосовые вложения в ответах чтения имеютkind: "voice". Имена инструментов и их параметры прежние. -
inboxиreviewиспользуют общий формат команд и сообщений. Вместо--sinceукажите--since-time;review --unansweredпринимает длительность с единицей (4h,1d), а не число часов. Голосовые вложения в JSON имеютkind: "voice"вместо"audio"; есть--allдля тихих и архивных чатов. Проверка входящих переносит прежнюю точкуinbox --newпри первом запуске. Обзор читает историю страницами назад и показывает не больше 300 сообщений на чат, отмечая неполный результат. Обновите команды в скриптах и проверки JSON. -
Расшифровки личного аккаунта сохраняются в общей локальной копии сообщений.
messages transcribe,inbox,reviewи MCP используют тот же текст, чтоmessages list, под тем же аккаунтом. Старые расшифровки из отдельного кэша профиля не переносятся: при следующем явном запросе с--transcribeони создаются заново; модель должна быть скачана. -
max <бот> bot people showтеперьmax <бот> bot contacts show, инструмент MCP —max_bot_contacts_show. Вместе сbot messages search|betweenкоманды общие сtg; опции и ответы прежние. -
max <бот> bot chats checkтеперьmax <бот> bot chats moderate— имя и команда общие сtg.--sinceтеперь--since-time(ещё принимает2h,1d); ответ--json—{ chatId, rows }вместо списка; инструмент MCP —max_bot_chats_moderate. Правила и точка прошлой проверки остались в тех же файлах. Уровень согласияflagтеперь значит то же, чтоconfirm: спросить вас, а с--allow-dangerous— сделать. -
max <бот> bot mcpдаёт агенту то, что разрешает профиль бота, а не флаги. Без флагов агент теперь может и писать от имени бота, если у профиля нетreadOnly: trueилиallow; удаление — после вашей формы,--allow-dangerousеё убирает.--allow-send,--allow-deleteи--allow-moderateпринимаются с предупреждением и ничего не решают. Чтобы осталось только чтение, поставьте профилю ботаreadOnly: true. Сервер теперь общий сtg. -
max bot messages searchищет по словам, лучшие совпадения сверху — раньше искал кусок текста и показывал новые сверху; прежний порядок —--newest. Нужны все слова; работают"фраза",-слово,а OR би фильтрыfrom:,chat:,after:,before:,has:; опечатка исправляется (об этом — строка в stderr). Слова можно писать без кавычек.--fromпо-прежнему можно повторять.in:в поиске бота не работает: бот ищет только в своей копии и в копиях, разрешённыхreadOtherBots.
Исправлено
- При отказе в записи бот называет действующую команду настройки с
--bot. Если профиль только для чтения, подсказка предлагает выключитьreadOnly; если действие отсутствует вallow, предлагает добавить его, сохранив уже разрешённые действия. Раньше называла несуществующийbot config.
0.22.0 — 02.10.2026
Большая часть команд личного аккаунта теперь общая с tg: те же опции, те же ответы --json, одна
общая локальная копия. Поэтому многое переименовано — смотрите «Изменено — может сломать скрипты».
Прежняя локальная копия max в общую не переносится: после обновления запустите команды без
--offline, а историю скачайте заново через max store fetch.
Что нового
max conversations search "<запрос>"— разговоры, близкие по смыслу, в одном чате или во всех. Сначала один разmax models text download e5-small(135 МБ, общая папка сtg), потомmax conversations embed --chat <чат>считает векторы на этом компьютере;embed status— сколько осталось,embed clear— стереть. С--provider openaiи своим ключом (max models text key set openai) векторы считает внешний сервис —embedсначала называет число токенов и цену и ждёт «да».- У личного чата в
chats list --jsonестьproviderMetadata.partnerId— id собеседника. По нему общие команды узнают человека за личным чатом: у MAX id чата и id собеседника разные. max messages searchищет и в других аккаунтах общей копии:in:max,in:personal,in:bots,in:allв запросе или--source. Без них — как раньше, в аккаунте, от которого запущена команда.max conversations build|list|showиmax messages links— разговоры внутри группы, найденные в локальной копии по ответам, упоминаниям и тому, кто написал следом; MAX не спрашивается.conversations batches status|nextиconversations links add|clear— пачки для вашего агента и его ответы.max server logs,max server install,max server uninstall— как в tg.installпишет службу systemd (Linux) или launchd (macOS) для профиля и ничего не запускает; дальшеmax server startиstopидут через неё. Если MAX не принял вход, служба сервер не перезапускает: каждый повтор был бы новым входом в аккаунт.max server start --idleиrestart --idleостаются.max store status— сколько сообщений каждого чата хранится и какие куски скачаны целиком.store fetch --backgroundиstore jobs list|show|cancel— скачивание в фоне.store info|check|migrate|backup|restore|reindex— уход за файлом общей копии.store clear --left --allow-dangerousудаляет из неё чаты, из которых вы вышли, с их сообщениями.max bot auth,max bot list,max bot chats list,max bot recipientsиmax bot sends listтеперь общие с tg (cli-messaging): ответы и подсказки те же. Токен, список получателей и журнал лежат там же, где лежали.max cache clear --leftстирает из локальной копии профиля только чаты, из которых вы вышли, вместе с их сообщениями. Остальная копия не трогается.max messages search --regex— одно регулярное выражение по всему сохранённому тексту.messages show|context msg:…— сообщение по ссылке изsearch, без id отдельно.max polls show <чат> <сообщение>— опрос с id вариантов и числом голосов, ничего не меняя.max polls create --send-id— повторить создание опроса, ответ на которое не пришёл, без второго опроса.max messages send --photo <путь>— отправить.jpg .png .webpфотографией, как в tg.--no-previewуsendтоже есть, но MAX его не поддерживает, и команда откажет.max skill installставит навык для агентов одной командой: в~/.claude/skills/max-cli/для Claude Code и в~/.agents/skills/max-cli/для Codex и Gemini CLI, с номером версииmax.--for claudeили--for agents— только в одну папку.max skill showпечатает то же, что раньше.- Агент узнаёт о навыке сам. Если задана переменная
AI_AGENTилиCLAUDECODE, а навыка нет или он старшеmax, раз в сутки в stderr выходит одна строка проmax skill install. В stdout ничего не добавляется. Выключаетсяmax config set skillHint false --defaults. max mcpиmax bot mcpотдают навык ресурсомmax://skillи называют его в своих инструкциях для агента.max messages deleteотвечает сoperationId— номером этого удаления; тот же номер стоит в журнале отправок (max sends list). Инструмент MCPmax_messages_deleteотвечает так же. Сама команда и её опции не меняются.- У каждой записи в журнале отправок есть
operationId— номер одного действия. Все строки об одной отправке, правке, удалении или изменении чата несут один и тот же номер, так что по нему видно, чем действие кончилось. У отправки сообщения это еёsendId. - Установка легче примерно на 16 МБ: слой базы данных теперь встроен в пакет, а не ставится
отдельно. Команды
maxне меняются.
Изменено — может сломать скрипты
-
max messages searchищет по словам, лучшие совпадения первыми — раньше самые новые первыми, теперь для этого--newest. В запросе работают"фраза",-слово,ORи фильтрыfrom:,chat:,after:/before:иhas:. Опечатка исправляется, и об этом пишется в stderr.--context <n>показывает сообщения вокруг каждого совпадения. В JSON у каждого совпадения появилисьmatchиscore. -
max bot updates watchтеперьmax bot watch, как в tg и как личныйmax watch. Без--eventsпечатаются только новые сообщения, с--events— всё, и каждая строка называет своё событие ({ "event": "message" | "edit" | "delete" | "callback" | "joined" | … }) вместо сырого события MAX.--timeoutзавершает его обычным образом, с кодом0. Профилю бота «только чтение»watchтеперь разрешён: получать события — это чтение. Отметка, с которой продолжать, осталась прежней. -
bot webhooks listотвечает{ url, types }, а не полями MAX.bot callbacks answer --textбольше не читает текст из stdin по-.bot commands,bot callbacksиbot webhooksтеперь общие с tg; секретwebhooks set --secret-stdinспрашивается только после проверки прав. -
Нужен Node 22.16 или новее (или Bun, как раньше). Если Node на Linux взял системный SQLite, а тот слишком стар для локальной копии,
maxперезапускается на своём SQLite из@wirecat/cli-messaging-sqliteдо того, как что-то прочитать или отправить. Официальные сборки Node и Bun ничего не замечают. -
max store— общая группа команд tg и max.store fetchпишет в общую локальную копию, ту же, что у tg, и листает MAX как раньше: по 30 сообщений, 5–10 с между страницами, до 40 страниц за запуск. Почему: одна копия и одни команды для обоих мессенджеров;messages,conversationsиstoreчитают одно и то же. Что учесть: копия, которую max вёл раньше, не переносится — историю скачайте заново. Кроме того:store fetch --estimateдля MAX отказывает: id сообщений MAX не позволяют сосчитать, сколько не хватает;store fetch|export --sinceтеперь--since-time, и только время, не id сообщения;store fetch --max-pages <n>теперь--limit <сообщений>(по умолчанию 1200, то есть 40 страниц по 30); размер страницы —--page-size;store export --format mdтеперь--format markdown;jsonlкак был. Выгрузка больше не перечисляет в stderr куски, которых нет в копии, — их показываетstore status; существующий файл она не перезаписывает;store fetchв конце не печатает готовую команду выгрузки.- если два сообщения отправлены в одну и ту же миллисекунду и граница страницы прошла между ними,
store fetchможет пропустить более раннее из них. Это редкость.
-
max messages list|show|context|search— общие команды tg и max.--offlineиsearchотвечают из общей локальной копии, той же, что у tg. Почему: те же опции и ответы, что у tg, и одна копия для чтения. Что учесть: инструментыmax mcpдля чтения сообщений и чатов пока читают прежнюю копию max, так что агент через MCP и команда в терминале с--offlineмогут ответить по-разному. Копия заполняется с первого запуска без--offlineпосле обновления; прежняя копия max в неё не переносится — и с ней расшифровки голосовых, услышанных до обновления. Кроме того:- голосовое — вложение
"kind": "voice", а не"audio"(вinboxиreviewпока"audio"); messages list --beforeи--afterразделились на--before-id,--before-time,--after-id,--after-time, а уmessages context—--before-nи--after-n, как в tg. Скрипт со старым именем получит ошибку «неизвестный параметр»;messages list --before-idне включает само это сообщение; с--offlineгодится только--before-id, и только с id сообщения из локальной копии;messages list --transcribe --jsonбольше не отвечает полемtranscribeProblem: причина — в stderr; с--offlineunheardпуст. Голосовое скачивается на отдельном соединении — с--no-serveэто второй вход в MAX;- модели речи
maxищет в~/.cache/cli-common/models/audio, одной папке с tg; скачанную в~/.cache/max-cli/models/audioнужно скачать заново или перенести; messages searchищет слова и их начала (квартирнайдёт «квартира»), а не любые три буквы подряд;--chatпринимает и имя сохранённого чата.
- голосовое — вложение
-
max chats list|showиmax contacts list|show— общие команды tg и max. Их--offlineотвечает из общей локальной копии, той же, что у tg. Почему: те же опции и ответы, что у tg. Что учесть: копия заполняется с первого запуска без--offlineпосле обновления; прежняя копия max в неё не переносится, и до того--offlineответитnot_found. Кроме того:chats list --search|--kind|--unreadбез--offlineищет в 200 самых свежих чатах и пишет в stderr, если были старше; с--offline— во всех сохранённых;chats show --offlineотвечает безdescription,accessиsettings: их знает только MAX;- неверный
--kindотвергается другими словами:--kind is one of dialog, group, channel, saved; cache clearзабывает и то, что этот аккаунт хранит в общей копии, аcontacts syncзабирает всё и туда.
-
max messages send|edit|forward— общие команды tg и max. Ответы--json:send—{sendId, operationId, message}(сscheduledFor, если с--at-time),forward— тоже{sendId, operationId, message},edit—{operationId, message}, вместо сообщения без обёртки. Так же отвечают инструменты MCPmax_messages_send,max_messages_editиmax_messages_forward; уmax_messages_editбольше нетmarkdown, уmax_messages_forward—send_id. Почему: те же опции и ответы, что у tg, и номер действия, как в журнале отправок. Что учесть: скрипт, который читал сообщение из корня ответа, теперь берёт его изmessage. Уsendбольше нельзя приложить несколько--fileк одному сообщению: одно вложение из--fileи одно из--photo. Если отправка с--at-timeне получила ответа, ошибка советуетmessages scheduled, не называя чат. -
max polls— общие команды tg и max.polls vote|close --jsonотвечают{operationId, poll}, гдеpoll—{chatId, messageId, question, answers: [{id, text, voters, chosen}], closed, multiple, anonymous, voters};polls create—{sendId, operationId, message}. Так же отвечают инструменты MCPmax_polls_vote,max_polls_close,max_polls_create. Почему: те же ответы, что у tg. Что учесть: уmax_polls_createвместоrevoteтеперьsilent. -
Ответы
--jsonу реакций, закрепления и отметки прочитанным — общие с tg, и в каждом естьoperationId, номер этого действия, как в журнале отправок:reactions add|remove:{operationId, chatId, messageId, reaction}— ваша реакция илиnull, без счётчиков реакций на сообщении (их показываетmessages list);messages pin|unpin:{operationId, chatId, messageId, pinned}, гдеpinned—trueилиfalse;chats mark-read:{operationId, chatId, until}— до какого сообщения, илиnull, если до последнего.
Так же отвечают инструменты MCP
max_reactions_add,max_reactions_remove,max_messages_pin,max_messages_unpin,max_chats_mark_read. -
max messages unpin <чат> <сообщение>— теперь нужен номер сообщения, как уpinи в tg. В чате MAX закреплено одно сообщение, и открепляется оно, какой бы номер ни был указан. Инструмент MCPmax_messages_unpinтоже проситmessage. Что учесть:messages unpin <чат>без номера получит ошибку — добавьте любой номер сообщения этого чата. -
max serve --detachиmax serve --stopубраны: этоmax server startиmax server stop. Почему:serve— только работа на переднем плане, а фоновым сервером управляетmax server, как в tg. Что учесть: замените их в скриптах и службах, написанных вручную. -
max server status --jsonотвечает теми же полями, что tg:byHandсталby(hand— руками,command— его запустила команда,server—max server start,unit— служба); добавленыlog,unitиstale(сервер упал и оставил метку).max server start,stopиrestartотвечают как в tg:{ started, by, pid, startedAt, log }и{ stopped, by, pid }; поляsocketбольше нет. -
max messages send --atтеперь--at-time— как во всех командах tg и max, где опция принимает время. Скрипт с--atполучит ошибку «неизвестный параметр» — замените на--at-time. Параметрatуmax_messages_sendв MCP не меняется. -
--markdownбольше нет, только--md— вmessages send,messages editи везде, где разметка читается. Так названо во всех командах tg и max; скрипт с--markdownполучит ошибку «неизвестный параметр» — замените на--md. -
max sends list --json: полеcid→sendId, и это строка, а не число — то же имя, что в ошибкеoutcome_unknownи у--send-id. Строки, записанные раньше, показываются так же. -
Записи запусков (
--trace,--record,max runs show) — в общем формате tg и max. Номер отправки в событии называетсяsend, а неcid; ключ отказа MAX —providerError, а неmaxError, в событиях, вrun.jsonи вdetailsошибки--json. -
max botотвечаетoutcome_unknown(код14), если на отправку или другое изменение пришёл ответ 502, 503 или 504. Раньше это был отказprovider_unavailable(код12). Почему: такой ответ даёт шлюз перед MAX, и он не говорит, выполнил ли MAX запрос. Сообщение могло уйти. Что учесть: скрипт, который повторял изменение после кода12, мог отправить его дважды. После кода14сначала проверьте, выполнилось ли оно. Чтение по-прежнему повторяется само и отвечаетprovider_unavailable. -
Команды бота — под общими с tg именами, старых имён нет.
max bot messages get <сообщение>→messages show <чат> <сообщение>;messages edit|deleteтоже берут чат первым;bot chats get→chats show;bot chats pin|unpin→messages pin|unpin <чат> <сообщение>.--format markdown|html→--mdили--html;--typeбольше нет: картинку —--photo, голосовое —--voice, видео файлом —--as-file.chats actionберётtyping,photo,video,voice,file. Отправка и правка отвечают{ operationId, message }, а не сообщением. Удаление спрашивает подтверждение,--allow-dangerousотвечает «да». Инструменты MCP бота переименованы так же:max_bot_chats_show,max_bot_messages_show,max_bot_messages_pin,max_bot_messages_unpin. -
max bot membersиmax bot adminsтеперьmax bot chats membersиmax bot chats admins, как в tg.admins addберёт--canсо словамиmax chats admins add(read,members,admins,info,pin,link,edit,delete) вместо--permissions, и--titleвместо--alias. Прав «звонки» и «статистика» в--canнет.admins listотвечает{ id, name, username, role, rights, title }. Инструменты MCP:max_bot_chats_members_list|add|remove,max_bot_chats_admins_list. -
Команды, которые меняют только этот компьютер, теперь отмечены как записи.
config setиunset,chats rules setиunset,recipients add,removeиclear, а у ботаauth setиremove,chats rules setиunset,recipients add,removeиclearпишут файл настроек, файл правил групп, списки получателей или связку ключей — и ничего в MAX. В списке команд у них строка «Меняет что-то только на этом компьютере.», аmax commandsпоказывает их в колонкеwrites. Раньше они не были отмечены вовсе. Что учесть: агент или скрипт, который поmax commands --jsonотбирает только чтение, теперь не увидит их среди безопасных команд.
Исправлено
max store fetchпо времени больше не пропускает сообщение на границе страницы и останавливается, если MAX раз за разом отдаёт одну и ту же страницу.max messages list --before-timeне показывает сообщение, отправленное ровно в эту миллисекунду: «до» значит «раньше».max messages list --after-id(в 0.21.0 —--after <id>) говорит, что есть следующая страница, когда она есть. Раньше при чтении вперёд от сообщения команда всегда отвечала, что дальше ничего нет.max messages send --voiceтеперь уходит и черезmax serve. Раньше через сервер MAX отказывал (proto.payload, код11): полоска громкости голосового терялась по дороге. Без сервера (--no-serve) голосовое уходило и раньше.max chats listиmax chats showбольше не показывают чаты, из которых вы вышли. Раньше такой чат оставался в списке навсегда, с устаревшим числом участников. Теперь он исчезает при следующем входе, если max получил от MAX полный список ваших чатов; сообщения остаются в копии доmax cache clear --left.max serveузнаёт о выходе только при следующем полном входе.max serveбольше не путает ответы после долгой работы. Номер запроса занимает два байта и после 65 536 запросов начинается заново. Если запрос с тем же номером ещё ждал ответа, новый запрос мог получить чужой ответ. Теперь такой номер пропускается.
0.21.0 — 30.09.2026
Изменено — может сломать скрипты
Команды названы по одному правилу: сначала предмет, потом действие. Старые имена больше не
работают — max отвечает «unknown command» или «unknown option» с кодом 1 и ничего не делает.
max backup messages→max store fetch. Теперь команда скачивает сразу; только посчитать —--estimate(раньше наоборот: без--runтолько считала). Каждый запуск по-прежнему не больше--max-pagesстраниц (40) с той же паузой.--pauseпринимает длительность:5s,500ms— число без единицы теперь отказ.--sinceи--lastнеобязательны: без них запуски идут до начала чата, каждый — с места, где остановился прошлый.max export messages→max store export.--cid→--send-idуmessages sendиmessages forward. В ошибкеoutcome_unknownномер теперь в полеsendId; у инструментов MCPmax_messages_sendиmax_messages_forwardаргументcid→send_id.max chats read→max chats mark-read; инструмент MCPmax_chats_read→max_chats_mark_read.max chats settingsбольше нет. Настройки группы показываетmax chats show(поляsettings,description,access; ссылку-приглашение — по-прежнемуmax chats link show), меняетmax chats update <чат> --all-can-pin on|offи остальные флаги настроек.max update→max upgrade, и строка о новой версии называетmax upgrade.max recipients off→max recipients clear, в ответеoff→cleared;max bot recipients off→max bot recipients clear.max account sessions end-others→max account sessions end --others; без--others— отказ.
Что нового
max completeвиден вmax --help— чтобы найти, как включить дополнение по Tab.- Страница «ChatGPT или Claude в браузере» — через прокси со входом по паролю и публичный адрес Tailscale без своего домена. Схема собрана по документации этих инструментов и целиком не проверена.
0.20.0 — 30.09.2026
Изменено — может сломать скрипты
- Общее хранилище сообщений переходит на версию 6 (cli-messaging 0.49.0). Первый запуск
maxобновляетmessages.db; после этогоtgстарше выпущенного в тот же день отказывается открывать файл и просит обновиться —npm install -g @wirecat/tg-cli@latest. Командыmaxне меняются. --all-botsработает, только если боту разрешено читать других ботов. НастройкаreadOtherBotsв разделеbot:max <имя> config set --bot readOtherBots true— всех, или список профилей. Без неё команда отказывает с кодом5и называет, как разрешить.- Когда имя подходит нескольким людям, кандидаты перечислены по имени, люди без имени — первыми; раньше — в том порядке, в каком лежали в кэше. Текст ошибки тот же.
Что нового
--bots news,supportуbot messages search,bot people showиbot messages between— прочитать копии только этих ботов, еслиreadOtherBotsих разрешает.bot messages searchтеперь понимает и--all-bots.- Агент через
bot mcpполучаетall_botsиbotsу тех же трёх инструментов — только когда бот может читать других. - Люди — у каждого бота свои. Человек, которого видел один бот, не находится у другого без
--all-botsили--bots. - Поиск по тексту сообщений бота находит любые три буквы внутри слова (
вартирнаходит «квартиру»), как поиск личного аккаунта.
0.19.0 — 28.09.2026
Изменено — может сломать скрипты
- Агент через
max mcpзакрывает опрос, только если профилю разрешеноedit. Раньше хваталоreaction. Почему: закрытие правит сообщение с опросом, и командаmax polls closeвсегда требовалаedit— агент и человек получали на одно действие разные права. Что учесть: если вallowпрофиля естьreaction, но нетedit, агент больше не видит инструментmax_polls_close; чтобы он мог закрывать опросы, добавьтеedit. Еслиallowне задан, ничего не меняется. Подробнее — MCP-сервер.
Исправлено
max mcp --confirm-sendзапускается, когда изменения аккаунта включены только настройкойmcpTools. Раньше флаг требовал ещё одного из--allow-*, иначе сервер не запускался. Почему это важно: из-за этого сервер с однойmcpToolsработал без формы подтверждения — агент мог добавлять и удалять контакты, создавать группы и менять профиль, не спрашивая вас. Что учесть: без--confirm-sendвсё как раньше. Чтобы видеть форму перед каждым изменением, добавьте флаг в команду запуска сервера.max <бот> bot messages search --limit Nговорит, что найдено больше. Раньше в ответе всегда былоhasMore: false, а вlimit— значение из настроек, а не вашеN. Что учесть: скрипт или агент, который поhasMoreрешал, искать ли дальше, останавливался на первой странице и пропускал совпадения. Теперь он получитhasMore: true, когда совпадений большеN.
0.18.1 — 28.09.2026
Исправлено
- После
max contacts renameновое имя видно сразу — вcontacts showи в названии личного чата с этим человеком. Раньше там оставалось прежнее имя, пока фоновыйmax serveне входил в MAX заново: MAX присылает переименованный контакт в ответе, а сервер его не применял. Что учесть: если после переименования имя всё ещё старое, у вас работает сервер прежней версии — его заменит первая же команда 0.18.1.
0.18.0 — 28.09.2026
Что нового
- Агенту можно разрешить менять аккаунт через
max mcp. Появились инструменты для контактов (добавить, удалить, переименовать, заблокировать), для закрытия своего опроса, для групп (вступить, выйти, создать, назначить и снять админа) и для имени и описания профиля. Раньше агент через MCP мог только читать и писать сообщения. Почему только в настройках: эти действия видят другие люди, и включить их должен владелец, а не сам агент — дописав флаг в свою же команду запуска. Что учесть: всё выключено, пока группа не названа в настройкеmcpTools, напримерmax config set mcpTools contacts,polls. Флагом это не включается. Каждое действие проходит те же проверкиreadOnly,allowи журнал, что и команда. Подробнее — MCP-сервер. - Загрузка файла ботом видна в
--traceи в записи запуска.bot messages send --fileиbot uploads putпоказывают загрузку двумя строками: вид файла, размер, HTTP-код и время. Раньше загрузка в запись не попадала. Что учесть: адрес загрузки и имя файла не пишутся — ни на экран, ни в запись.
Исправлено
max contacts renameпереименовывает. Раньше MAX отвечал «успешно», а имя оставалось прежним. Почему: без поляlastNameMAX молча ничего не меняет. ТеперьlastNameуходит всегда (null, если фамилии нет) — так делает и веб-клиент. Что учесть: имена, «изменённые» через 0.17.x, на самом деле не изменились — переименуйте ещё раз.
0.17.1 — 28.09.2026
Исправлено
- Ошибка в
--limit,--lastи--max-pagesповторяет то, что вы набрали. Это касаетсяmessages list,inbox,backup,sends listи команд бота. Раньше на--limit abcони называли введённоеNaN; в 0.17.0 это исправили только у списков со страницами. runs listиsends list, обрезанные по--limit, говорятhasMore: true. Раньше в ответе былоhasMore: false, а вlimit— не то число, что вы просили. Что учесть: скрипт, который поhasMoreрешал, читать ли дальше, раньше останавливался на первой странице.- Контакт, которого вы переименовали, показывается под вашим именем, как в приложении MAX. Раньше
maxпоказывал имя, которое человек дал себе сам, даже если вы переименовали его вcontacts renameили в приложении.
0.17.0 — 28.09.2026
Изменено — может сломать скрипты
- Любой список в
--json— объект{items, page, limit, hasMore}, а не массив. Так теперь отвечаютaccount sessions list,chats members list,chats folders list,messages scheduled,messages download,messages context,models audio list,recipients list,sends list,runs list,chats check,chats eventsи все списки бота. Раньше часть из них отдавала массив, аchats events—{events, more}. Почему: списки приходили в трёх разных формах, и скрипту или агенту приходилось помнить форму каждой команды. Что учесть: скрипт, который читал массив, теперь должен брать.items. У списка без страницpageравен 1, аlimit— числу пришедших строк.bot members listиbot admins listкладут рядомmarker, аuser_idу них теперь строка.bot messages getотвечает самим сообщением, а не массивом из одного.--jsonlи таблица для человека не изменились. В MCP — то же самое.
Что нового
max doctorиmax config showвидят ботов. Список профилей — все профили на этом компьютере, с пометкой: личный аккаунт, бот или оба. Раньше профили ботов в нём не появлялись.doctorпоказывает, откуда взят токен бота (без самого токена), сколько чатов бот видел и где лежат файлы профиля;doctor --onlineспрашивает у Bot API, чей это токен. Что учесть: для профиля ботаdoctorи личные команды больше не советуютsession start, а называют нужную командуmax <имя> bot ….- Инструменты
max_statusиmax_bot_statusв MCP. Агент видит, за какой профиль говорит сервер, есть ли токен и какие пишущие инструменты включены. Они ничего не отправляют, аmax_statusдаже не входит в MAX. - Дополнение по Tab знает о ботах. Для команд бота оно предлагает чаты, которые видел бот, а не чаты личного аккаунта; в первом слове — все профили, в том числе профили ботов.
- Команды бота записываются, как личные.
max <имя> bot … --traceпоказывает в stderr каждый запрос к Bot API: операцию, чат или сообщение, HTTP-код и время.--recordсохраняет запуск, а упавший запуск бота сохраняется сам, вместе с запросами. Смотреть —max runs listиmax runs show. Что учесть: загрузка файлов (--file) в эту версию записи ещё не попадала — это добавлено в 0.18.0. - Настройки отдельно для личных аккаунтов и для ботов. В файле настроек появились разделы
personalиbot, у каждого своиdefaultsиprofiles.max config set --personal|--botпишет в раздел,max config show --botпоказывает настройки бота и называет ключ, из которого прочитано значение, напримерconfig file: bot.profiles.test. Почему: у одного человека бывают и личный аккаунт, и боты, и одни и те же правила им не подходят. Что учесть: побеждает самая точная запись — профиль в разделе, затем профиль, затем раздел, затем общиеdefaults. Прежний файл читается как раньше. Подробнее — руководство по настройке. - У бота может быть лимит отправок в час.
max <имя> config set --bot sendsPerHour 200задаёт его. По умолчанию лимита у бота по-прежнему нет. max config set defaultProfile <имя>— какой профиль берётся, если первое слово не профиль. Раньше это всегда былdefault.- Фото профиля, своё имя для контакта, блокировка.
max account update --photo <файл>ставит новое фото профиля.max contacts rename <кто> <имя> [фамилия]даёт человеку имя, которое видите только вы.max contacts block <кто>иunblockблокируют и разблокируют — даже того, кого нет в контактах. Что учесть: всё проходит те же проверки, чтоaccount updateиcontacts add. В этой версииcontacts renameна деле не менял имя — исправлено в 0.18.0. - Каналы.
max chats create <название> --channelсоздаёт закрытый канал. Что учесть: людей в канал зовут ссылкой-приглашением (max chats link show) — добавить человека напрямую MAX может не дать. - Права админа на чтение и на ссылку.
max chats admins add <чат> <кто> --can read,linkдаёт читать все сообщения группы и менять ссылку-приглашение. Что учесть: бот-админ без праваreadсообщений группы не видит. - Время можно задать как «столько назад».
--since,--beforeи--afterпонимают30m,2h,1d:max review --since 1d. Раньше нужно было писать точное время.
Исправлено
- Ваше же изменение чата видно сразу. После
max chats update,chats settingsиchats link resetкомандыchats showиchats listнесколько минут показывали старое название. Почему: MAX не присылает ваше изменение обратно, а фоновыйmax serveне применял чат из ответа MAX. Теперь применяет — как уже делал с отправленными сообщениями. max export messagesне предупреждает о пропуске «до 1970-01-01» после полногоbackup. Раньше выгрузка чата, прочитанного до самого начала, всё равно говорила, что начало не прочитано.- Ошибка в
--limitи--pageповторяет то, что вы набрали. Раньше на--limit abcона называла введённоеNaN. - Сброшенная ссылка-приглашение в
chats inspectиchats join— ошибка «ссылка никуда не ведёт» (not_found, код 6). Раньше это был непонятный отказ MAX с номером операции. Что учесть: скрипт, который ждал другой код выхода, теперь получит 6. max config showиmax doctorне показывают лишний профиль<имя>.moderation. Раньше они принимали файл правил модерации группы за профиль.- Ошибка в подкоманде называет неизвестное слово, а не профиль. Раньше
max work bot auth statusговорил, чтоworkпрочитано как имя профиля, хотя неизвестным было словоstatus. max config showпоказываетtranscribeModel— модель распознавания речи. Раньше эта настройка не выводилась.
Удалено
- Заявки на вступление:
max chats requests list|accept|decline, правилоrequestsи уровниconsent.acceptиconsent.declineв правилах группы. Почему: в MAX группа либо открытая, либо в неё входят по ссылке-приглашению; одобрять новых участников негде, поэтому заявок не бывает. Команды обещали то, чего MAX не делает. Что учесть: файл правил, где эти ключи остались, читается как прежде; при следующей записи они из него уходят. Скрипт, который вызывалchats requests, получит ошибку «нет такой команды».
0.16.0 — 27.09.2026
Что нового
- Люди и переписка бота.
max <имя> bot people show <кто>показывает, где человек писал, и его личный чат с ботом.bot messages search --from <кто>— что писал один или несколько человек.bot messages between <кто> <кто>— их переписка в чатах, где писал каждый. Что учесть: всё берётся из копии на этом компьютере, то есть только из того, что бот уже видел.--all-botsсмотрит копии всех ботов. - Бот проверяет группу по её правилам.
max <имя> bot chats check <чат>сверяет новое в группе с правилами (bot chats rules show|set|unset) и действует от имени бота: удаляет сообщения и удаляет людей. Вступления берёт изbot updates watch. Что учесть: удалённый человек не сможет вернуться по ссылке-приглашению, если не указан--no-ban; снять этот запрет через Bot API нельзя. Возраст аккаунта через Bot API не виден, и правила о нём здесь не срабатывают. - Опросы.
max messages listпоказывает опрос словами: вопрос, варианты с id в[скобках], голоса и ✓ у вашего варианта.max polls vote <чат> <сообщение> <вариант>…голосует,--retractснимает голос,max polls closeзакрывает свой опрос,max polls createсоздаёт новый. В MCP —max_polls_voteиmax_polls_create, только с--allow-send. Что учесть: что отказал бы веб-клиент — закрытый опрос, лишние варианты, второй голос без права переголосовать, —maxотказывает сам, ничего не отправляя. web.max.ru опросы не показывает, иpolls createоб этом напоминает. max <имя> bot mcp— MCP-сервер бота для агента. По умолчанию только чтение; запись — по флагам--allow-send,--allow-delete,--allow-moderate,--confirm-send. Что учесть: каждая запись идёт через ту же команду, что набрали бы вы, — со списком получателей и журналом. Действия проверки по правилам, которые нужно подтвердить, агент показывает вам одной формой. Подробнее — бот для агента.
Изменено — может сломать скрипты
- Параметр
timeoutуmax bot api get-updatesтеперь задаётся флагом--poll-timeout. Раньше флаг--timeoutэтой операции до MAX не доходил:--timeout— это общий срок самой команды. Что учесть: скрипт, который передавал--timeoutдля долгого опроса, должен перейти на--poll-timeout.
Исправлено
- Фоновый
max serveпрежней версии заменяется при первой же команде новой версии. Раньше, пока старый сервер отвечал, он оставался работать и отказывал в новых операциях — например, в голосе в опросе, — пока его не останавливали черезmax server stop. - Сервер из другой сборки с тем же номером версии тоже заменяется. Раньше он оставался работать.
Что учесть: сервер, запущенный вручную, на незнакомую операцию отвечает отказом с подсказкой
max server stop. max bot api get-updates --limit …работает. Раньше--limitоперации принимался за настройку самогоmax, и команда отказывала.
0.15.0 — 27.09.2026
Что нового
max chats check <чат>— модерация группы по её правилам. Команда читает, что пришло с прошлой проверки (сообщения и новых участников), сверяет с правилами группы (max chats rules) и делает то, что они разрешают: сообщает, удаляет сообщение, удаляет человека из группы. Что учесть: по умолчанию команда только сообщает;--dry-runтолько планирует; за раз — не больше 10 действий. Удаление и исключение проходят те же проверки, что любое другое изменение. Заявки на вступление в этой версии только планировались — в 0.17.0 их убрали совсем, потому что в MAX их нет. Подробнее — группы, которые вы ведёте.- Модерация через агента.
max mcp --allow-moderateдаёт инструментmax_chats_check— ту же проверку. Всегда доступны три инструмента только для чтения:max_chats_events,max_chats_members,max_chats_rules. Что учесть: без флага инструмента проверки нет. Действия, которые правила велят подтвердить, агент показывает вам одной формой. - Роли и ссылка.
max chats members listпомечает каждого участникаowner,adminилиmember.max chats link show <чат>печатает ссылку-приглашение. - Видео и голосовые с личного аккаунта.
max messages send <чат> --file ролик.mp4отправляет видео, которое смотрят прямо в чате (.mp4 .mov .webm .mkv).max messages send <чат> --voice заметка.oggотправляет голосовое с полоской громкости и длительностью. Что учесть: раньше видео уходило файлом; чтобы отправить его файлом и теперь, добавьте--as-file. Голосовое — только Ogg Opus; для другого звука команда подскажет строкуffmpeg. Подробнее — повседневная работа. - Голосовые текстом прямо в списке.
max messages list <чат> --transcribeиmax inbox --transcribeрасшифровывают показанные голосовые на этом компьютере; текст стоит под сообщением со значком 🎤, в--json— в полеtranscript. В MCP —transcribe: trueуmax_messages_listиmax_inbox. Что учесть: уже расшифрованные голосовые показывают текст и без флага. Для расшифровки нужна скачанная модель. - Остальные команды бота.
max <имя> bot messages send --file <путь>прикладывает картинку, видео, звук или файл, аbot uploads putтолько загружает его.bot members list|add|removeиbot admins list|add|remove— участники и админы чата;bot comments list|get|send|edit|delete— комментарии под постом канала;bot callbacks answer— ответ на нажатую кнопку;bot commands list|set|clear— меню команд бота;bot webhooks list|set|delete— вебхуки. Всё — в руководстве по боту. Что учесть:webhooks setотказывает, пока задан другой адрес: MAX не заменяет старый вебхук, а шлёт события на оба. - Локальная копия переписки бота. Всё, что бот прочитал, отправил или получил, сохраняется на
этом компьютере.
max <имя> bot messages list <чат> --offlineиmessages get --offlineчитают её без сети,bot messages search <текст>ищет по ней. Что учесть: сообщение, удалённое ботом или удаление которого заметилupdates watch, из копии пропадает. Копия содержит тексты сообщений. max <имя> bot updates watchпечатает события бота по мере прихода, до Ctrl-C, и сохраняет их сообщения в копию. Следующий запуск продолжает с того места, где остановился прошлый. Что учесть: пока у бота настроен вебхук, команда не работает. Она забирает события у других читателей бота — запускайте её, только если бот больше никому не нужен.- Люди в копии бота.
max <имя> bot people show <кто>— чаты, где человек писал, и последние сообщения из его личного чата с ботом;--refreshперечитывает этот чат у MAX.bot messages search --from <кто>— всё, что он написал.bot messages between <кто> <кто> …— переписка нескольких людей в чатах, где писал каждый.--all-botsсмотрит копии всех ботов. Кто — номер,@usernameили часть имени.
Изменено — может сломать скрипты
max bot messages listпечатает старые сообщения сверху, какmax messages list. Раньше сверху были новые. Отправленное ботом сообщение теперь помечено как своё. Что учесть: скрипт, который брал первую строку как самое новое сообщение, теперь получит самое старое.
Исправлено
max review --transcribeне держит соединение с MAX открытым, пока работает модель. Записи скачиваются заранее, соединение закрывается, и только потом идёт распознавание.max bot api edit-my-commands,subscribe,unsubscribeиget-upload-urlработают. Раньше они падали с «an account change without a known action» и ничего не отправляли.- Отправка ботом на положительный номер без
user:подсказывает, что это, скорее всего, человек, и что писать ему надо какuser:<номер>. - Примеры в руководстве по боту не содержат выдуманного номера чата, и там же сказано, как узнать настоящий.
0.14.0 — 27.09.2026
Что нового
max bot— работа с ботом через официальный Bot API.max bot auth setпроверяет токен бота у MAX и сохраняет его в ключнице, отдельно от личного аккаунта. Профиль — первое слово, как везде:max рабочий bot me.max bot meпоказывает бота, аmax bot api <операция>вызывает любую из 33 операций API с флагами для параметров и JSON-телом. Команды сгенерированы из официальной схемы (список). Что учесть: идентификатор больше 2^53 печатается строкой, чтобы не потерять цифры, — скрипт должен читать его как строку.- Удобные команды бота.
max <имя> bot messages send <чат> <текст>пишет в чат по номеру, человеку — какuser:<номер>, или по названию чата, который бот уже видел; есть иedit,delete,list,get.max <имя> bot chats list— чаты, которые бот видел, иchats get|pin|unpin|leave|action.max bot list— все имена с токеном бота. Почему «которые видел»: у MAX нет списка чатов бота, поэтомуmaxзапоминает чаты сам. - Список получателей и журнал отправок бота.
max <имя> bot recipients add|list|remove|offиmax <имя> bot sends list. Список проходит любая запись бота, в том числе черезbot api. Что учесть: лимита отправок в час у бота в этой версии нет (появился в 0.17.0). Всё о боте — руководство по боту. - Модерация групп: что происходит.
max review --unanswered [часы]— вопросы в группах, на которые ни вы, ни админы ещё не ответили;max review --chat <чат>— обзор одного чата.max chats events <чат>— кто вступил, вышел, кого добавили и удалили.max chats members list <чат>— все участники группы или канала, с датой регистрации и последним появлением.max chats rules show|set|unset <чат>— правила модерации группы, в одном файле, какconfig set.
Исправлено
- Когда MAX закрывает соединение, ошибка называет код и причину закрытия.
0.13.0 — 26.09.2026
Что нового
max review— кто кому что должен. Одним вызовом — все сообщения, ваши тоже, во всех чатах, где что-то было с прошлого обзора (без--since— за 3 дня).--transcribeрасшифровывает голосовые. В конце ответа — с какого момента начинать следующий обзор. Что учесть: если что-то не прочитано, ответ прямо говорит «неполный» — не принимайте такой обзор за полный (обзор: кто кому что должен).- Инструмент
max_reviewи команда/reviewв MCP. Агент раскладывает переписку на «я должен», «жду от других» и «нужно уточнить», проверяет рабочие группы, прежде чем назвать что-то просроченным, и готовит напоминания. Что учесть: напоминания уходят только после вашего «да» (готовые запросы MCP). max mcp configпечатает готовую запись для Claude Desktop, Cursor и других клиентов. Почему: запись содержит полные пути, поэтому работает и на Windows, и в приложениях, которые не видятPATHтерминала (подключение MCP).max doctorпроверяет установку: чем запущенmax, куда поставлен, найдёт ли его новый терминал, загружаются ли ключница и SQLite, скачана ли модель речи. Что учесть: если каталог команды не наPATH,doctorпечатает команду, которая это исправит, — для PowerShell на Windows иexportна Linux и macOS. Если самаmaxне находится, запуститеnpx @wirecat/max-cli doctor(max не находится после установки).max doctor --onlineпроверяет связь с MAX: один вход, один чат и запуск MCP-сервера. Ничего не отправляет.max models audio downloadпосле скачивания проверяет, что модель работает. Если модель не скачана, сообщение называет её язык и другие модели с размерами.
Изменено — может сломать скрипты
- MCP-инструмент
max_messages_attachmentпереименован вmax_messages_photo. Что учесть: если в клиенте MCP было сохранено разрешение на старое имя, дайте его заново. - Профиль больше нельзя назвать
review, потому что это теперь команда. Что учесть: профиль с таким именем придётся переименовать.
Безопасность
- Отчёт о проблеме на Windows скрывает домашний каталог в любом написании. Раньше имя пользователя оставалось в части путей.
0.12.0 — 26.09.2026
Что нового
- MCP-сервер умеет больше:
max_inbox— всё новое одним вызовом; ответ на сообщение и оформление текста при отправке; реакции; фото — как картинка, которую агент видит (инструменты MCP). - Команды
/catch-up,/reply,/findи чаты по@в Claude Code (готовые запросы MCP).
Исправлено
max serveработает на Windows. Там сервер теперь слушает именованный канал, а не файл.- Слишком длинный путь к сокету на macOS и Linux даёт понятную ошибку, а не
EINVAL. Путь становится длинным из-за длинного имени профиля илиMAX_STATE_DIR.
0.11.0 — 26.09.2026
Что нового
max watch --eventsпоказывает не только новые сообщения, но и правки, удаления и реакции; у каждой строки есть полеevent. Без флага вывод прежний (новые сообщения сразу).- Отчёт о проблеме уходит в задачу на GitHub, а не письмом.
max doctor report createпечатает ссылку на новую задачу с заполненным заголовком и заготовкой текста; файл отчёта прикладывается к задаче. Что учесть: задача на GitHub и приложенный файл видны всем (как сообщить о проблеме). - Любая ошибка любой команды сохраняется в запись запуска — и неверный флаг, и проверка до начала
работы, и команды, которые в MAX не ходят (
models,server,watch). Раньше сохранялись только ошибки команд, дошедших до MAX. Что учесть: сохраняются только слова команды, без того, что написано после них, — текст сообщения в запись не попадает (диагностика). max backup messages --runговорит, где сохранённое и что дальше. Сообщения лежат в локальной копии, а файл делаетmax export messages: готовая команда стоит в конце вывода и в полеexport.- Фоновый сервер
max serveсам проверяет ограничения на отправку и ведёт журнал отправок: профиль только для чтения, разрешённые действия, список получателей, лимит в час. Изменение черезconfig setдействует без перезапуска сервера. Что учесть: с переменнойMAX_TOKENсервер не запускается. max serveпосле входа запрашивает то же, что вкладка web.max.ru: папки, баннеры, историю звонков, наборы стикеров и реакций. И входит повторно так же: передаёт MAX время прошлого входа и спрашивает только изменившиеся чаты, а не весь список. Почему: чем меньшеmaxотличается от веб-клиента, тем меньше у MAX поводов его заметить. Что учесть: всё это только чтение; ответы не показываются и не сохраняются. Одноразовые команды это не делают (что уходит в сеть).- Фоновый сервер переживает повреждённое входящее сообщение от MAX: пропускает его, пишет об этом одну строку и работает дальше. Раньше такое сообщение могло остановить сервер.
Изменено — может сломать скрипты
-
Защиты для агентов строже.
max mcp --confirm-sendспрашивает перед любой записью — правкой, пересылкой, закреплением, отметкой о прочтении, удалением, — а не только перед отправкой. «Да» действует один раз и 5 минут.- В часовой лимит
sendsPerHourтеперь идут правки, закрепления с уведомлением и каждый добавленный человек. Отложенное сообщение считается в час, когда уйдёт. Две одновременные отправки у предела больше не проходят обе. - Если включён список получателей, группа создаётся и люди добавляются, только если личный чат с каждым из них есть в списке.
chats members addне показывает новичку старые сообщения без--history; флаг--hide-historyубран.MAX_PROFILE_LOCKзапирает процесс на одном профиле.--fileне берёт скрытые файлы и папки и папки самогоmaxбез--allow-any-file.
Что учесть: лимит в час теперь исчерпывается быстрее, чем раньше. Скрипт с
--hide-historyполучит ошибку — уберите флаг. Скрипт, который отправлял скрытый файл, должен добавить--allow-any-file.
Исправлено
max watchне выдаёт правку или удаление за новое сообщение. MAX присылает их тем же сообщением с пометкой, и раньше такое могло появиться в выводе как новое.- Точное название чата больше не выигрывает молча. Если оно входит и в название другого чата, команда покажет оба и попросит выбрать по id. Почему: отправку в не тот чат нельзя отменить.
Безопасность
- Токен из
MAX_TOKENостаётся только там. Если MAX выдаёт сессии новый токен,maxне пишет его ни в ключницу, ни в файл, а говорит об этом в stderr.max doctorназывает файлcredentials.json, если токен хранится в нём, а не в ключнице. max session startпоказывает номер телефона скрытым, какmax account show. Ctrl-C на вопросе о токене завершает команду с кодом130.- Фоновый сервер не отдаёт токен командам, которые спрашивают у него вход: им он не нужен, они сверяются с ключницей.
- Пределы для сети. Кадр MAX распаковывается не больше чем в 32 МиБ. Подключение к MAX и
скачивание файла не висят бесконечно, если сеть замолчала.
max messages downloadскачивает только по https, не ходит по ссылкам на этот компьютер и в локальную сеть — в том числе после перенаправления — и не качает больше 4 ГиБ; голосовое для расшифровки — не больше 32 МиБ. Почему: ссылка в сообщении приходит от чужого человека и может вести куда угодно. - Права на локальную копию. База и её журналы
-walи-shmсоздаются с правами0600, каталог —0700; права старых файлов выставляются так же при следующем открытии. В отчёте о проблеме номера чатов и сообщений заменены метками. - Чужой текст печатается в одну строку, а управляющие символы — видимыми — в ленте, таблицах,
списке кандидатов, выгрузке Markdown и путях
messages download. Из имени скачанного файла убираются управляющие символы и символы смены направления текста. В Markdown ссылками становятся только адресаhttpиhttps. - Автодополнение на месте чата или человека подставляет только номер, а название или имя
показывает рядом. Почему: название и
@имязадаёт кто-то другой, и оболочка не должна получать от него ничего, кроме цифр. max cache clearбез имени профиля очищает профиль по умолчанию и учитываетMAX_PROFILE.- Выпуск строже. Версии зависимостей закреплены точно; пакет собирается с нуля перед каждой упаковкой, без тестовых помощников; публикует отдельный шаг, который не ставит и не запускает зависимости.
0.10.0 — 25.09.2026
Что нового
max doctor reportиmax doctor report create— отчёт о проблеме для автора. Первая команда объясняет, что попадёт в отчёт; вторая пишет файл без текстов сообщений и печатает, что сделать по шагам. В этой версии отчёт отправлялся письмом; с 0.11.0 — задачей на GitHub (как сообщить о проблеме).max backup messages <чат> --since <дата> | --last <n>дочитывает историю чата в локальную копию. Что учесть: без--runкоманда только показывает расчёт и ничего не отправляет. С--runона листает назад по 30 сообщений с паузами, не больше 40 страниц за запуск, и при повторе продолжает с места (скачать историю).max doctorпоказывает, какой версией веб-клиента MAX представляетсяmax, и предупреждает, если её прочитали больше 60 дней назад. Почему: MAX может перестать принимать старую версию клиента (решение проблем).max server start|stop|status|restart— фоновый сервер как отдельная вещь, какmax session.statusпоказывает, работает ли сервер, с какого времени, какой версии и подключён ли к MAX, и подсказываетrestart, если версия сервера отстала отmax.max serve --detachи--stopпо-прежнему работают (новые сообщения сразу).- Чтение истории шлёт те же пять полей, что веб-версия, и вход просит у MAX 15 чатов, как вкладка
web.max.ru, а остальные дочитывает одним запросом. Раньше
maxдобавлял к запросу поле, которого веб-версия не шлёт, и просил 40 чатов за раз. Почему: чем меньшеmaxотличается от веб-клиента, тем меньше у MAX поводов его заметить. Что учесть: список чатов тот же. Проверено на канале с непрочитанными: чтение по-прежнему ничего не отмечает прочитанным. - Описание устройства берётся с вашего компьютера: часовой пояс, язык системы и операционная
система — свои у каждой установки, как у браузера. Раньше каждая установка
maxназывала себя одним и тем же Chrome на Linux в часовом поясе Мадрида. max serveшлёт MAX одно служебное событие, как скрытая вкладка веб-версии: «показан список чатов», через 20 секунд после входа. Что учесть: в событии номер аккаунта и время — ни сообщений, ни названий. Одноразовые команды его не шлют (что уходит в сеть).- Слишком длинное название папки
maxотклоняет сам — не длиннее 20 знаков, сколько принимает MAX. Раньше запрос уходил в MAX и возвращался с его отказом.
Изменено — может сломать скрипты
- Отказ MAX во входе из-за частых попыток больше не ведёт к новым попыткам. Команда выходит с
кодом
8, а профиль сам не входит какое-то время: 1 минуту после первого отказа, дальше 5 минут, 30 минут, час, 6 часов, сутки. Фоновый сервер на любом отказе во входе останавливается; раньше он пробовал снова раз в минуту без конца. Что учесть: скрипт, который повторял команду сразу после отказа, теперь получит тот же код8до конца паузы — ждите время из ошибки (решение проблем).
Исправлено
- Недоступная ключница больше не выдаётся за отсутствие входа. Если профиль уже входил на этом
компьютере, а токена не видно — например, из cron, —
maxиmax doctorговорят, что дело, вероятно, в ключнице. Раньше они советовали войти заново. Почему это важно: новый вход в этом случае — лишнее новое устройство в аккаунте (рецепты). - Запуск, который кончился ошибкой, сохраняется и без
--record. В записи теперь есть ключ ошибки MAX (напримерlogin.token), предупреждения кодом, место падения, версия среды и система. Тексты по-прежнему не пишутся. Лог фонового сервера — строками JSON со временем (диагностика). max chats read --untilотмечает прочитанным только до указанного сообщения. Раньше отметка уходила с текущим временем, и MAX считал прочитанным всё до «сейчас», включая более новые сообщения. То же исправлено уmessages list --mark-read. Что учесть: собеседники могли видеть «прочитано» у сообщений, которых вы не читали.
0.9.0 — 25.09.2026
Что нового
maxговорит с MAX так же, как веб-версия: тот же адрес, двоичные кадры и сжатие, что у web.max.ru, и то же описание устройства с обновлёнными версиями приложения и браузера. Раньшеmaxслал текстовые кадры в старом формате. Почему: по старому форматуmaxотличить от веб-клиента было проще всего. Кроме того, голосовым и кружкам нужно поле с байтами, которое старый формат передать не мог. Что учесть: команды и их вывод не изменились. Отправка голосовых — в следующих версиях. Пока при каждом входе MAX присылает список чатов целиком, а не только изменения: это работает, но даёт лишний трафик.- Фоновый
max serve, запущенный командой, после обновленияmaxперезапускается сам. Что учесть: сервер, запущенный вами вручную, продолжает работать по-старому, пока вы его не остановите:max serve --stop, затем запустите снова.
0.8.0 — 25.09.2026
Что нового
max messages transcribe <чат> <id>— голосовое в текст прямо на вашем компьютере. Запись никуда не уходит, её распознаёт локальная модель.max models audio listпокажет, какая модель подходит для каких языков,max models audio download <id>скачает её и сверит контрольную сумму. Для MCP —max_messages_transcribe(голосовые в текст). Что учесть: модель скачивается один раз и только по вашей команде. Текст сохраняется в локальной копии, так что повторно ни MAX, ни модель не нужны.- Одно подключение к MAX на профиль. Все команды,
max mcpиmax watchодного профиля ходят в MAX через один фоновыйmax serve, а не каждая своим подключением. Почему: меньше входов с одним токеном — меньше поводов для MAX завершить ваши сеансы. Что учесть:max session startостанавливает сервер, входит и запускает его снова (новые сообщения сразу). max serve --detachзапускает сервер в фоне и отвечает, когда он подключился;max serve --stopего останавливает. Что учесть: сервер, запущенный вами вручную, останавливается только Ctrl-C или--stop—max session endего не трогает.- Настройка
allow— что профилю можно.max work config set allow send,reactionразрешает профилю только писать и ставить реакции. Имён двенадцать, отsendдоsessions. Что учесть: без списка разрешено всё, как раньше. Запрещённое отказывает с кодом5ещё до подключения, и ошибка называет команду, которая это разрешит. Вmax mcpагент не видит инструментов, которых профиль не разрешает (что профилю можно). max messages send … --at <время>— отправить позже. Сообщение ждёт на сервере MAX и уйдёт, даже если компьютер выключен. Время —2026-09-25T09:00(местное) или30m,2h,1d.max messages scheduled <чат>— что ждёт отправки. Для MCP —atуmax_messages_sendиmax_messages_scheduled. Что учесть: отменить отложенное можно только в приложении MAX (отправить позже).max chats read <чат>иmax messages list … --mark-readотмечают чат прочитанным — только когда вы это попросили. Для MCP —max mcp --allow-mark-read. Что учесть: собеседник видит отметку. Без этих команд чтение по-прежнему ничего не отмечает (чтение).max export messages <чат> --format jsonl|mdвыгружает переписку из локальной копии в JSONL или Markdown, с--sinceи--output. В MAX не ходит. Что учесть: чего в копии нет, команда называет в stderr. Файл из--outputдоступен только вам (выгрузить в файл).max messages delete <чат> <id…> --allow-dangerousудаляет сообщения, до 10 за раз. По умолчанию только у вас; с--for-everyone— у всех в чате. Для MCP —max mcp --allow-delete, только «у меня». Что учесть: без--allow-dangerousкоманда отказывает. Каждое удалённое сообщение считается вsendsPerHour(удаление).
Исправлено
- Обновление
maxбольше не стирает прочитанную историю. Раньше каждая новая версия с другим устройством локальной копии выбрасывала все сохранённые сообщения. Теперь сообщения переносятся в новую копию. Что учесть: этот выпуск сам меняет устройство копии, и история сохранится. Чаты и люди, как и раньше, приходят заново при следующем входе. - Если MAX отказал фоновому серверу во входе, команды 10 минут не запускают новый сервер. Раньше
каждая команда поднимала сервер, который снова пытался войти и снова получал отказ.
max session startснимает это ожидание сразу. max watchвидит сообщения, которые отправил самmax. Раньше они проходили мимо: MAX не присылает сообщение обратно тому подключению, которое его отправило.- Несколько команд
maxразом больше не теряют вход в локальной копии. Раньше из трёх одновременных команд две писали «the local record did not take this login» и не сохраняли чаты, участников и отметку синхронизации. Теперь вторая ждёт, пока допишет первая.
Безопасность
- Текст ошибки тоже не управляет терминалом. В 0.7.0 это сделали для сообщений, имён и таблиц;
теперь управляющие символы показываются как
\x1bи в тексте ошибки. Почему: ошибка часто повторяет то, что вы ввели или что ответил MAX.
0.7.0 — 24.09.2026
Что нового
max reactions remove <чат> <id>снимает вашу реакцию.- Группы и каналы под
max chats: посмотреть ссылку, вступить, выйти, создать группу, добавить и удалить людей, назначить и снять админа, переименовать, поменять настройки, перевыпустить ссылку. Здесь же были заявки на вступление — их убрали в 0.17.0, потому что в MAX их нет. Что учесть: всё это видят другие люди, и каждое действие проходит те же проверки, что отправка (группы и каналы). max updateобновляетmaxтем же менеджером пакетов, которым он поставлен;--checkтолько говорит, есть ли версия новее. Что учесть: раз в сутки человек в терминале видит строку о новой версии; агент и скрипт — никогда. ВыключаетсяupdateCheck: falseвdefaults(обновление).- Дополнение по Tab в zsh, bash, fish и PowerShell:
source <(max complete zsh). Предлагает команды, флаги, их значения, а также чаты и людей из локальной копии — без подключения к MAX (справка поmax complete). max mcp— тот же профиль для агентов по MCP, для клиентов без терминала (Claude Desktop, Cursor). Подключение — MCP-сервер. Что учесть: сервер только читает, пока не запущен с--allow-send; отправка проходит те же проверки, чтоmax messages send.max mcp --allow-send --confirm-sendпоказывает форму перед каждой отправкой: в какой чат (название и id) и что. Что учесть: без вашего «да» ничего не уходит; клиент, который не умеет показывать формы, получает ошибку (что может агент).max messages send … --file <путь>отправляет фото и файлы; несколько фото уходят одним сообщением.
Безопасность
- Чужой текст больше не управляет терминалом. Сообщение, имя отправителя, название чата, имя
файла или реакция с управляющими символами могли стереть строку и напечатать поверх того, что
maxуже вывел. Теперь такие символы показываются как\x1b— в ленте, в таблицах, в сообщениях об ошибках и в подсказках по Tab. Что учесть: JSON не меняется — он и раньше их экранировал.
0.6.0 — 24.09.2026
Что нового
max commands --jsonописывает все команды, аргументы, флаги и коды выхода одним ответом. Команды, которые что-то меняют в MAX, помеченыmutates: true. Почему: агенту не нужно звать--helpдля каждой команды. Что учесть: работает без входа в MAX и даже со сломанным файлом настроек.max messages send … --reply-to <id>— ответ на сообщение.max messages send … --markdown(или--md) оформляет текст:**жирный**,_курсив_,~~зачёркнутый~~и`код`. Без флага текст уходит как набран.max reactions add <чат> <id> <эмодзи>ставит реакцию; прежняя ваша заменяется.- Реакции видны при чтении:
messages list,showиcontextпечатают под сообщением👍 3 🔥 1 (you: 🔥), в JSON — полеreactions. Что учесть: это один дополнительный запрос на страницу, только чтение. С--offlineреакций нет (null), потому что они не хранятся. - Журнал отправок и список разрешённых получателей. Каждая попытка отправки пишется в журнал без
текста —
max sends list. Необязательный список получателей —max recipients add|remove|list|off; отправка в чат не из списка отказывает с кодом7. Профиль только для чтения (readOnly) отказывает с кодом5. Что это защищает и что нет — безопасность. max session start qr | qr-chrome | sms | token— вход без копирования токена из браузера.qrрисует QR-код в терминале (в узком терминале откроет его в браузере);qr-chromeиsmsоткрывают настоящий web.max.ru в отдельном окне Chrome, Chromium, Edge или Brave. Без способа — как раньше: токен вручную или из трубы.
Изменено — может сломать скрипты
- Отправка ограничена лимитом в час: по умолчанию 30 сообщений (
sendsPerHour). Сверх лимитаmax messages sendотказывает с кодом8. Раньше лимита не было. Что учесть: скрипту, который шлёт больше, нужно поднятьsendsPerHourв настройках.
0.5.0 — 24.09.2026
Что нового
max messages download <чат> <id> [--output <каталог>]сохраняет фото, файлы, видео и аудио из сообщения. Существующий файл не перезаписывается.max config set <настройка> <значение>иmax config unset <настройка>меняют файл настроек без редактора; с--defaults— для всех профилей сразу. Новый разделdefaultsв файле действует на каждый профиль, у которого нет своей настройки.max chats list --unread— только чаты с непрочитанным.max messages list <чат> --after <id|время>читает вперёд — то, что пришло после сообщения или момента. Подсказка следующей страницы —--after <id самого нового>.max chats show <чат>— один чат с участниками;max contacts show <человек>— один человек по id, @username или части имени, с общими чатами. Что учесть: неоднозначное имя не угадывается — команда перечисляет подходящих.- Всё новое в этой версии только читает: ничего не отправляет и не отмечает прочитанным.
Исправлено
--offlineработает. Раньше флаг не доходил ни до одной команды: чтение всё равно шло в MAX, аmax --offline messages sendотправлял сообщение. Теперь чтение отвечает из записанного, а отправка и скачивание с--offlineотказываются. Что учесть: если вы запускали--offline messages sendна 0.4.0 или раньше, сообщение ушло.- Ошибка в файле настроек объясняется словами: какая настройка неизвестна и какие есть, что допускает значение. Раньше это было сообщение библиотеки проверки.
- Сломавшийся посреди команды журнал запуска (
--record) больше не роняет команду. Вместо этого — одна строка предупреждения в stderr, а ответ и код выхода прежние. Предупреждение видно и с--quiet.
Безопасность
- Версии публикуются из GitHub Actions, и npm прикладывает к ним подтверждение происхождения. По нему можно проверить, что пакет собран из этого репозитория.
0.4.0 — 23.09.2026
Что нового
max messages show <чат> <id>— одно сообщение по id;max messages context <чат> <id>с--beforeи--after— окно вокруг него. Искомое помечено◀в ленте и"anchor": trueв JSON. Что учесть: если сообщения нет, команда говорит «не найдено», а не показывает соседнее.max skill showпечатает инструкцию для агента из установленного пакета:max skill show > ~/.claude/skills/max-cli/SKILL.md.max config showпоказывает, какой профиль действует и что его выбрало, файл настроек и есть ли он, все профили — включая те, что есть только в состоянии и в файл настроек не записаны, — и каждую настройку с тем, откуда она взялась: флаг, переменная, файл или встроенное значение. Что учесть: если заданMAX_CONFIG_DIRили соседние переменные, команда предупреждает, что используется не та запись в ключнице, что обычно.- Текст сообщения можно передать через pipe:
echo "текст" | max messages send <чат>— без аргумента с текстом он читается из stdin. Почему: так текст не видятpsи история оболочки, и в нём могут быть переводы строк. --timeout <срок>ограничивает всю команду целиком — подключение, вход и сам запрос, а не ожидание одного ответа.max doctorпоказывает, от чего зависит каждая команда, без обращения к MAX: откуда берётся токен (сам токен не печатается), сколько было входов и когда последний, какие профили входили, схему локальной копии против той, что знает эта версия, и какая запись ключницы используется. Что учесть: команда отвечает и тогда, когда всё сломано: «сессии нет» — это поле ответа, а не ошибка.
Изменено — может сломать скрипты
- Флаг
--queryу списков переименован в--search. Изменение вошло ещё в 0.3.0, но в его описании его не было. Что учесть: скрипт с--queryполучит ошибку — замените на--search.
Исправлено
messages list --before <id>больше не требует, чтобы сообщение было прочитано раньше: время отправки берётся из самого id.- Участники групп показываются по имени, а не числом. Раньше имя было только у тех, кто есть в контактах, и в групповом чате почти все были номерами. Имена берутся одним запросом и сохраняются, так что следующее чтение их уже не спрашивает. То же — для авторов ответов и пересылок.
- Выпуск версии больше не останавливается сразу после публикации, не поставив тег. Так было дважды; теперь версия проверяется в обход кэша npm, с ожиданием до трёх минут.
0.3.0 — 22.09.2026
Что нового
- Переписка читается лентой: разделитель при смене дня, строка
время автори текст под ней, выровненный по колонке, с переносами по ширине терминала.вы— ваши сообщения; автор без имени показан номером.↳— на что ответ,↪— чья пересылка: MAX присылает их целиком, и они сохраняются в локальной копии. -vи-vv— подробнее: id сообщения, отправителя, чата и адреса вложений; затем всё, что известно о сообщении.--jsonl— по объекту JSON на строку, для потока иjq.- Вложения показываются ссылками:
📎 photo,📎 photo ×3 1 2 3,📎 файл.pdf · 24 MB. В JSON —url,width,height,title. Что учесть: ссылка на фото открывается без входа — кому её переслали, тот и увидит фото. senderColors: trueв настройках профиля — свой цвет у каждого автора. По умолчанию выключено.
Изменено — может сломать скрипты
-vтеперь означает подробность вывода, а версия —max -V. Строки о запросах на stderr включает--trace— это бывший--verbose. Что учесть: скрипт, который звалmax -vза версией или--verboseза трассировкой, должен перейти на-Vи--trace.- Флаг
--queryу списков переименован в--search(в описании этой версии изначально не был указан). - Локальная копия переходит на схему 4 и при первом запуске собирается заново. Что учесть: прочитанная история в этой версии не сохраняется — её придётся прочитать снова.
Исправлено
- Имя, подходящее к нескольким чатам, выводит их списком с id, а в JSON — полем
candidates. - Предупреждение о локальной копии называет схему и что делать. Раньше причина называлась словом
Error. - Подсказка о следующей странице у
messages listсоветует--before <id>. Раньше она советовала несуществующий--page.
0.2.0 — 22.09.2026
Что нового
max messages send --silent— отправить без уведомления у получателя. Что учесть: что именно MAX делает с этим флагом, пока не наблюдали — для этого пришлось бы написать живому человеку.- Токен обменивается при первом входе. MAX отвечает на вход своим токеном, и
maxсохраняет его в ключницу вместо вставленного из браузера. Это происходит один раз.
Исправлено
max session startбольше не портит рабочий токен. Раньше новый токен записывался до проверки, и опечатка заменяла рабочий токен мёртвым. Теперь сначала вход, потом запись.- Профиль привязан к своему аккаунту. Токен чужого аккаунта в профиле — отказ с объяснением. Почему: иначе команды профиля пошли бы от чужого имени.
- Подсказка после неясного исхода отправки называет существующую команду. Раньше она называла
несуществующую
max send. - Сообщения из ответа на вход больше не выбрасываются из-за неверно описанной формы ответа.
0.1.0 — 21.09.2026
Первая версия, которой можно поделиться.
Что нового
- Семь команд против настоящего MAX:
session start|end,account show,chats list,contacts list,messages list,messages send. - Профиль — первое слово:
max personal chats list. Несколько аккаунтов живут рядом, у каждого свой токен, своё состояние и своя локальная копия. То же задаётMAX_PROFILE. - Токен хранится в ключнице операционной системы, а не в файле и не в аргументе команды.
Что учесть: своего входа по номеру телефона пока нет —
max session startберёт токен из официального клиента. - Машинный режим:
--jsonкладёт на stdout ровно одно значение JSON и ничего больше; то же включается само, когда stdout не терминал. Ошибка уходит на stderr, stdout остаётся пустым. Ветвиться можно по коду выхода — таблица в справочнике команд. - Диагностика без содержимого:
--verboseпоказывает по строке на запрос,--recordкладёт их в каталог запуска на 30 дней,max runs list|show|pathчитает обратно. По умолчанию не записывается ничего. - Локальная копия: прочитанное сохраняется рядом;
--offlineотвечает из неё, не подключаясь, аmax cache clearеё забывает. - Настройки в
~/.config/max-cli/config.json, с порядком «флаг → переменная окружения → файл → встроенное значение». Опечатка в имени поля — ошибка с именем поля, а не молчаливое умолчание. - Два рантайма: Node 22+ и Bun 1.3+; собранная команда выполняется под обоими в CI.
- Чтение ничего не помечает прочитанным. «Получить историю» и «отметить прочитанным» — разные операции протокола; вторая не отправляется никогда, и это проверяется тестом.
- Отправка не врёт об исходе. Если ответ не пришёл —
outcome_unknown(код14), а не «ошибка» и не «отправлено». Что учесть: повторять такую отправку можно только с тем же--cid, иначе сообщение может уйти дважды. - Протокол MAX неофициальный и разобран обратной инженерией: это не Bot API. Что учесть: он может измениться без предупреждения; тогда команда скажет об этом одной строкой в stderr, а не сломается молча.
- Пока не умеет: входить по номеру телефона, работать с вложениями, реакциями, правками, группами, историями и звонками — только текст. Массовой рассылки не будет: это инструмент для личного аккаунта.