МессенджерыMAX

История изменений 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-core 0.633.0. muted:false не учитывает чаты, где вы выключили уведомления, поэтому stats messages show -- 'date>=30d muted:false' считает только то, что синхронизация ещё читает. stats messages responses и stats messages waiting тоже его понимают.
  • store import, из @wirecat/cli-core 0.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 и выше не открывают max 0.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_dirs Hermes через 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: appVersion 26.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-sqlite 1.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/sdk 1.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. Для неверного JSON line и 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

Что нового

  • max --help называет max account list — список профилей и их вошедших аккаунтов.

Изменено — может сломать скрипты

  • Старые имена разрешений статистики и поиска больше не распознаются. Раньше ключи 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. Проверьте права профиля, если агент должен выполнять только чтение: в MCP ask допускает запрошенную запись без формы подтверждения.

  • Сырые операции 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 и MCP stats называют пояс в 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 не меняется, в ответах MCP line нет.

Изменено — может сломать скрипты

  • Узкий терминал больше не открывает 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_ONLY session 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}) и ресурс MCP max://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, чтобы открыть новую; через MCP tasks 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-core 0.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-core 0.270.0 и @wirecat/cli-base 0.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-core 0.262.0 (новое имя @wirecat/cli-messaging, следует за его 0.261.0; команда сверки — cli-core-parity) и @wirecat/cli-base 0.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-messaging 0.259.0 и @wirecat/cli-base 0.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-messaging 0.242.0: существующие ключи проектов и задач сохранены; новые проекты получают короткие ключи, общее хранилище поддерживает проверяемые зависимости задач.
  • max работает на @wirecat/cli-messaging 0.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-messaging 0.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-messaging 0.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 в MCP max_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-messaging 0.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 или MCP discover: 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 messages
    max messages search --source emailmax search mail
    max conversations searchmax search conversations
    max 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 не сообщает время заявки: в JSON requestedAt равно 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, а в JSON query.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 остаётся доступен; изображения записываются только в новые файлы. MCP max_stats_charts с format: "png" возвращает изображение вместе с JSON, без подключения к MAX и записи файлов. Без format MCP по-прежнему возвращает 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 считает по чатам. Агенту то же дают MCP max_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. В MAX serve пока не читает участников ежедневно: повторяйте сбор вручную или по своему расписанию.

  • Профиль человека. 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 с тёмной темой: сообщения, активные авторы, вступления и выходы по дням или неделям. Пропущенные даты остаются разрывами, неполные данные отмечаются явно. Существующий файл не перезаписывается. MCP max_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 и MCP max_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 попыток. Поле JSON limit содержит выбранный предел; 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, versioned ast, имя чата и фильтры 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). Инструмент MCP max_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; с --offline unheard пуст. Голосовое скачивается на отдельном соединении — с --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}, вместо сообщения без обёртки. Так же отвечают инструменты MCP max_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}. Так же отвечают инструменты MCP max_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 закреплено одно сообщение, и открепляется оно, какой бы номер ни был указан. Инструмент MCP max_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; у инструментов MCP max_messages_send и max_messages_forward аргумент cid → send_id.
  • max chats read → max chats mark-read; инструмент MCP max_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 отвечал «успешно», а имя оставалось прежним. Почему: без поля lastName MAX молча ничего не меняет. Теперь 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, а не сломается молча.
  • Пока не умеет: входить по номеру телефона, работать с вложениями, реакциями, правками, группами, историями и звонками — только текст. Массовой рассылки не будет: это инструмент для личного аккаунта.