Перейти к содержимому
MMW · Документация

Обновление агента

В настройках каждого клиента записана ссылка на конкретную версию агента, например mmw_agent-0.1.14-py3-none-any.whl. Поэтому сам по себе агент не обновляется: новая версия начинает работать, когда в настройках меняется эта ссылка. Сделать это можно одной командой.

  • Раз в сутки агент (с версии 0.1.13) проверяет, вышла ли новая версия. Проверка уходит на app.mmwhub.ru и занимает не больше полутора секунд. Если сервер не ответил, агент просто промолчит.
  • Если версия новее вашей, в начале сессии Claude Code одной строкой скажет об этом и предложит команду обновления.
  • В кабинете в разделе «Клиенты» у подключений через локальный агент видна версия агента. Устаревшая помечена словом «устарел», а при наведении на метку видна команда обновления.
  • Письмо на почту приходит только при важных исправлениях безопасности. Об обычных версиях писем нет.

Отключить ежедневную проверку можно переменной MMW_UPDATE_CHECK=off.

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

Окно терминала
uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.14-py3-none-any.whl mmw-agent update

Ссылка в команде всегда на новую версию: у агентов до 0.1.13 команды update нет.

Что делает команда:

  1. Узнаёт номер последней версии и проверяет, что он новее вашего.

  2. Скачивает новую версию и сверяет её контрольную сумму SHA-256 с той, что опубликована на сайте. Если сумма не совпала, ничего не меняется.

  3. Меняет ссылку на агента в настройках MMW у Claude Code, Codex, Cursor и Claude Desktop, а также в хуках Claude Code. Если хука начала сессии ещё не было, добавляет его.

  4. Печатает итог по каждому клиенту: обновлено, уже на этой версии или не найдено.

Ключ, адрес сервера и остальные ваши настройки остаются как были. Ключ команда не спрашивает и нигде не показывает. Клиенты, в которых MMW не подключён, она не трогает. Перед изменением каждого файла рядом сохраняется копия с именем вида <файл>.bak-mmw-update-<время>.

После обновления перезапустите приложения, у которых изменились настройки.

Чтобы только проверить, есть ли новая версия, ничего не меняя:

Окно терминала
uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.14-py3-none-any.whl mmw-agent update --check

Можно поменять номер версии в ссылке самостоятельно. Ссылка встречается в настройках MMW у каждого клиента (uvx --from …/mmw_agent-<версия>-py3-none-any.whl mmw-agent) и в хуках Claude Code в ~/.claude/settings.json. Где лежат настройки каждого клиента, описано на странице Настройка агента. Все опубликованные версии и их контрольные суммы перечислены в файле https://app.mmwhub.ru/downloads/mmw-agent/SHA256SUMS.

Окно терминала
uvx --from <ссылка из ваших настроек> mmw-agent status

Версия есть и в ответе инструмента mmw_sync_status: поле agent_version. Если агент уже знает о более новой версии, рядом будут latest_version и команда обновления.

Прежние версии остаются на сайте. Чтобы вернуться, верните в ссылке прежний номер версии вручную или восстановите файлы настроек из копий *.bak-mmw-update-*, которые сделала команда обновления. Затем перезапустите приложения.