npm - @wirecat/max-cli - Versions diffs - 0.45.5 → 0.47.0 - Mend

@wirecat/max-cli 0.45.5 → 0.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md CHANGED Viewed

@@ -1,21 +1,13 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/WireCatLabs/max-cli/main/docs/design/logo_text.png" alt="Max CLI" width="480">
+  <img src="https://raw.githubusercontent.com/WireCatLabs/max-cli/main/docs/images/social-preview.png" alt="MAX CLI для людей, ботов и агентов" width="100%">
 </p>
-# max-cli
+# MAX CLI для людей, ботов и агентов
-Ваши боты [MAX](https://max.ru) и ваш личный аккаунт — в терминале и в ИИ-агентах. `max` —
-программа для терминала и MCP-сервер: пишите от имени бота через официальный Bot API, а в свои
-чаты — сами или руками Claude, Codex, Cursor и других агентов. В группах, которые вы ведёте, —
-следите за непрочитанным и сразу реагируйте на проблемы: спам, чужие ссылки, флуд, вопросы без
-ответа — по вашим правилам.
+Ваш аккаунт и ваши боты [MAX](https://max.ru) — в терминале и в ИИ-агентах. Читайте, ищите и
+отвечайте сами или поручите это Claude, Codex и Cursor — по вашим правилам.
-Работает в Windows, macOS и Linux. Документация — [wirecat.dev/ru/docs/max](https://wirecat.dev/ru/docs/max).
-```sh
-max sales bot messages send "Команда продаж" "Сборка готова"   # от имени бота
-max messages send "Иван Петров" "Опаздываю на 15 минут"         # от вашего имени
-```
+[Документация](https://wirecat.dev/ru/docs/max) · [Примеры](https://github.com/WireCatLabs/max-cli/blob/main/docs/recipes.md) · [WireCat](https://wirecat.dev/ru)
 [![npm](https://img.shields.io/npm/v/@wirecat/max-cli)](https://www.npmjs.com/package/@wirecat/max-cli)
 [![CI](https://github.com/WireCatLabs/max-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/WireCatLabs/max-cli/actions/workflows/ci.yml)
@@ -24,511 +16,370 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
 [![npm downloads](https://img.shields.io/npm/dm/@wirecat/max-cli)](https://www.npmjs.com/package/@wirecat/max-cli)
 [![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
-## Бот
+<!-- Слот для демо: GIF или видео на 30–45 секунд, файл в docs/images/, ссылка абсолютная
+     (https://raw.githubusercontent.com/WireCatLabs/max-cli/main/docs/images/…), чтобы картинка
+     открывалась и на npmjs.com. Только вымышленный аккаунт. -->
-`max bot` работает с ботом через **официальный** [Bot API MAX](https://dev.max.ru/docs-api) по токену
-бота. Ботов может быть несколько: каждый хранится под именем, которое вы выбираете, и это имя —
-первое слово команды.
+Пример разговора с агентом (люди и чаты вымышленные):
+```text
+Вы:     Что я кому обещал за последние три дня?
+Агент:  (вызывает max review: 12 чатов, 3 голосовых расшифровано)
+        Я должен
+        · Алисе Пример — прислать счёт до пятницы. Личный чат, 24.09
+        Жду от других
+        · Борис Образцов — макет к 25.09. В группе «Дизайн» его пока нет
+        Нужно уточнить
+        · «Проект Альфа»: кто везёт образцы — договорились «потом решим», 25.09
+Вы:     Напомни Борису про макет.
+Агент:  Черновик: «Борис, привет! Как там макет?» Отправить?
+Вы:     Да.
+```
-**Полный Bot API.** Все методы официальной схемы MAX доступны из терминала через
-`max <бот> bot api <операция>`: параметры — флаги, тело запроса — JSON. Удобные команды
-для сообщений и чатов дополняются полным API для собственных сценариев и автоматизации.
-[Руководство по Bot API](docs/bot.md) и [полный справочник команд](docs/commands.md).
+## Быстрый старт
 ```sh
-max sales bot auth set                                   # токен — в скрытом вводе, MAX его проверит
-max sales bot me                                         # какой это бот
-max sales bot api get-updates --limit 10                 # номер группы — в поле chat_id
-max sales bot messages send "Команда продаж" "Сборка готова" --file report.pdf
-max sales bot recipients add "Команда продаж"            # писать только сюда
-max bot list --check                                     # все боты на этом компьютере
+npm install -g @wirecat/max-cli
+max setup --agent claude   # вход по QR-коду и навык для Claude Code
+max inbox                  # непрочитанное во всех чатах, ничего не отмечая
 ```
-Чат называют по номеру или, когда бот его уже видел, по названию; человеку пишут как
-`user:<номер>`. Где взять номер чата — [docs/bot.md](docs/bot.md#где-взять-номер-чата).
-- **Сообщения и чаты.** Отправка в чат по номеру, человеку как `user:<номер>` или в чат по
-  названию; правка, удаление, чтение, закрепление. `chats list` — чаты, которые бот видел: списка
-  чатов бота у MAX нет.
-- **Файлы, участники, комментарии, кнопки, меню команд, вебхуки.** `messages send --file`,
-  `chats members`, `chats admins`, `comments`, `callbacks answer`, `commands`, `webhooks` — у каждой записи тот
-  же список получателей и журнал.
-- **Модерация от имени бота.** `bot chats moderate` сверяет новое в группе с правилами
-  (`bot chats rules`) и удаляет спам и людей — с запретом вернуться по ссылке. Вступления видит
-  `bot watch`, который печатает всё, что происходит в чатах бота.
-- **Копия переписки на этом компьютере.** `bot contacts show <кто>` — где человек писал и его личный
-  чат с ботом; `bot search messages --from <кто>` и `bot messages between <кто> <кто>` — без
-  запросов к MAX.
-- **Бот для агента.** `max sales bot mcp` — MCP-сервер бота: агенту доступно то, что разрешают
-  `permissions` профиля бота; `ask` и `allow` разрешают действие без формы, а `readonly` запрещает запись.
-- **Все методы Bot API.** Полное покрытие официальной схемы через `max bot api <операция>` — с флагами
-  для параметров и JSON-телом, которое сверяется со схемой до отправки.
-- **Бот не напишет лишнего.** У каждого бота свой список чатов, куда ему можно писать, и журнал
-  всего, что он отправил, — без текста. `permissions` ограничивает и бота.
-- **Токен не в файле.** Токен бота — в системном хранилище паролей, отдельно от вашего.
-Бота создают на [business.max.ru](https://business.max.ru/self); MAX выдаёт их подтверждённым
-организациям, ИП и самозанятым. Полностью — [docs/bot.md](docs/bot.md).
+`max setup` за пять минут проводит через вход: вы сканируете QR-код в приложении MAX, и `max`
+становится ещё одним вашим устройством. Вместо `claude` можно указать `codex`, `cursor`, `gemini`,
+`all` или `none`; войти можно и по SMS через web.max.ru — `max setup --help`.
-## Личный аккаунт
+Нужен Node 22.16+ (ветка 22.x) или 24+, либо Bun 1.3+; работает в Windows, macOS и Linux.
+Попробовать без установки — `npx @wirecat/max-cli --help`. Если `max` не находится,
+`npx @wirecat/max-cli doctor` скажет почему.
-`max` без слова `bot` работает с вашим личным аккаунтом: как ещё одно ваше устройство, со всеми
-чатами, историей, группами и контактами.
+Подробнее: [установка](https://github.com/WireCatLabs/max-cli/blob/main/docs/installation.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/installation)), [вход и профили](https://github.com/WireCatLabs/max-cli/blob/main/docs/sessions.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/sessions)).
-> ⚠️ **Для личного аккаунта max-cli использует неофициальный внутренний API MAX.** API может
-> измениться без предупреждения, а использование инструмента может нарушать условия сервиса. Вы
-> используете max-cli на свой риск; авторы и контрибьюторы не несут ответственности за блокировки
-> аккаунтов, потерю данных или другие последствия. Бот работает через официальный API, и к нему
-> это не относится.
+## Что можно сделать
+**Разобрать, что пришло.** «Используй max CLI: кто ждёт моего ответа и что срочно?»
 ```sh
-max chats list --limit 5
-max messages list "Иван Петров"
-max messages send "Иван Петров" "Опаздываю на 15 минут"
+max inbox
 ```
-Всё ниже, до раздела «Установка», — про личный аккаунт. Полностью — [docs/usage.md](docs/usage.md).
-## Как это использовать
-Самое полезное — поручить переписку агенту: Claude, Codex или другому. Он читает чаты через `max`
-и делает то, что вы попросили словами.
+**Найти что угодно.** «Когда мы договорились о встрече с Алисой?» — ответ с датой и самим
+сообщением, по локальной копии и без запросов к MAX.
-- **Проверка по расписанию.** Утром и вечером агент смотрит, что пришло, и присылает короткую
-  сводку: кто ждёт ответа, что срочно, что можно не читать.
-- **Отчёты.** Итог недели по рабочему чату: что решили, кто что взял на себя, какие вопросы
-  остались без ответа.
-- **Кто кому должен.** `max review` одним вызовом отдаёт всё, что было в переписке с прошлого
-  обзора, — ваши сообщения тоже, голосовые — текстом. Агент раскладывает это на «я должен», «жду от
-  других» и «нужно уточнить», а прежде чем назвать что-то просроченным, проверяет рабочие группы:
-  может, уже сделано.
-- **Напоминания.** Кому вы обещали ответить и не ответили; чей вопрос висит третий день.
-- **Черновики ответов.** Агент предлагает текст, а отправляете вы — или он сам, если вы разрешили
-  писать в этот чат.
-- **Поиск.** «Когда мы договорились о встрече с Иваном?» — ответ с датой и самим сообщением.
-- **Группа, которую вы ведёте.** Какие вопросы висят без ответа, кто вступил за неделю и с каким
-  аккаунтом, удалить приглашения в чужие чаты — по вашим правилам и с вашим «да»
-  ([ниже](#группы-которые-вы-ведёте)).
+```sh
+max search all "встреча Алиса"
+```
-Как это выглядит:
+**Понять, кто кому что должен.** «Что я обещал и чего жду от других?» — вся переписка с прошлого
+обзора, ваши сообщения и голосовые текстом.
-```text
-Вы:     Что я кому обещал за последние три дня?
-Агент:  (вызывает max review: 12 чатов, 3 голосовых расшифровано)
-        Я должен
-        · Ивану Петрову — прислать счёт до пятницы. «Иван Петров», 24.09
-        Жду от других
-        · Ольга — макет к 25.09. В группе «Дизайн» его пока нет
-        Нужно уточнить
-        · «Проект Альфа»: кто везёт образцы — договорились «потом решим», 25.09
-        Следующий обзор — с 26.09, 14:05.
-Вы:     Напомни Ольге про макет.
-Агент:  Черновик: «Ольга, привет! Как там макет?» Отправить?
-Вы:     Да.
+```sh
+max review --since-time 3d --transcribe
 ```
-Агент отправляет только по вашей просьбе; подтверждение вызовов настройте в своём ИИ-приложении. Чтение не ставит отметку «прочитано». Как настроить
-агента под каждую задачу — готовые запросы, расписание и ограничения:
-[docs/recipes.md](docs/recipes.md).
+Ещё: сводки утром и вечером, итог недели по рабочему чату, кому вы обещали ответить, черновики
+ответов, которые отправляете вы или агент с вашего разрешения.
-## Группы, которые вы ведёте
+Подробнее: [рецепты для агентов](https://github.com/WireCatLabs/max-cli/blob/main/docs/recipes.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/recipes)).
-```sh
-max review --chat "Поход" --unanswered            # вопросы, на которые сутки никто не ответил
-max chats events "Поход"                          # кто вступил и вышел за неделю
-max chats members list "Поход" --all              # все участники: когда заведён аккаунт
-max chats rules set "Поход" invites delete        # приглашения в чужие чаты — удалять
-max chats moderate "Поход" --allow-dangerous         # проверить группу и сделать, что разрешено
-```
+## Для ИИ-агентов
-Проверка сверяет новое в группе с вашими правилами: заблокированные люди, приглашения, ссылки,
-пересланное, флуд, совсем новые аккаунты. По умолчанию она только отмечает. Для каждого действия
-вы решаете сами: никогда, только с флагом, с вашим подтверждением или сразу. Сценарии с агентом,
-все правила и ограничения — [docs/groups.md](docs/groups.md).
-## Как это работает
-`max` работает от вашего имени, как ещё одно ваше устройство, а не как бот. Вы входите один раз
-по QR-коду, и дальше доступно то же, что в приложении: чаты, сообщения, файлы, группы, контакты и
-профиль.
-Агенту `max` подключается одним из двух способов:
-- **Агент с терминалом** — Claude Code, Codex, Gemini CLI. Он сам вызывает команды `max`. Дайте
-  ему навык (skill) — инструкцию, как работать с `max`: одна команда, см.
-  [ниже](#для-скриптов-и-агентов).
-- **Агент без терминала** — Claude Desktop, Cursor и другие клиенты MCP. Подключите `max mcp`:
-  готовую запись для их настроек печатает `max mcp config`. Там же есть команды `/catch-up` (что
-  нового), `/review` (кто кому должен), `/reply` (черновик ответа) и `/find` (поиск). По умолчанию
-  права агента задают `permissions`; большинство записей разрешено по умолчанию. `readonly`
-  запрещает запись, а `ask` и `allow` допускают вызванную запись без серверной формы.
-## Что умеет
-- **Читать.** Чаты, история, одно сообщение вместе с соседними, непрочитанное во всех чатах
-  сразу (`max inbox`), вся переписка с прошлого обзора для разбора «кто кому должен» (`max review`), новые сообщения по мере прихода (`max watch`), скачивание вложений,
-  расшифровка голосовых в текст на вашем компьютере, выгрузка переписки в JSONL или Markdown.
-- **Искать.** Сообщения — по тексту всего прочитанного, без подключения к MAX. Чаты и контакты —
-  по части названия или имени.
-- **Писать.** Текст и разметка, ответы, фото, видео, файлы и голосовые, правка, пересылка, закрепление, реакции,
-  опросы, отложенная отправка, удаление — у себя или у всех.
-- **Вести группы и каналы.** Создать группу, вступить по ссылке, выйти, участники и админы,
-  название и настройки, ссылка-приглашение, папки. Для админа — вопросы без
-  ответа, кто вступил и вышел, все участники с возрастом аккаунта, правила и проверка группы по ним
-  ([docs/groups.md](docs/groups.md)).
-- **Контакты и аккаунт.** Найти человека по номеру, добавить, удалить, переименовать для себя,
-  заблокировать, импортировать из файла; изменить профиль и фото; посмотреть и завершить другие
-  сеансы.
-- **Входить удобным способом.** QR-код прямо в терминале, QR-код или SMS через web.max.ru в
-  браузере, или готовый токен.
-## Чем он хорош
-- **Читает незаметно.** Чтение не ставит отметку «прочитано»: собеседник не видит, что вы открыли
-  чат. Отметить прочитанным можно, когда нужно: `max chats mark-read` или `--mark-read`.
-- **Агент не напишет лишнего.** Есть профиль только для чтения, список чатов, в которые можно
-  писать, и лимит сообщений в час. В MCP сервер проверяет права профиля; подтверждение действий настраивается в приложении агента.
-  Если имя подходит к двум чатам, `max` не выбирает сам, а показывает оба.
-- **Модерация по вашим правилам, а не по чужим.** Проверка группы по умолчанию только отмечает.
-  Удалить сообщение или человека она может, только если вы разрешили: для каждого действия —
-  никогда, с флагом, с вашим подтверждением или сразу. Не больше 10 действий за раз, и ничего не
-  следит за группой в фоне.
-- **Сообщение не уйдёт дважды.** Если связь оборвалась во время отправки, `max` прямо говорит, что
-  не знает, дошло ли сообщение, и даёт команду для повтора. MAX узнаёт повтор и второго сообщения не
-  создаёт.
-- **Своя копия переписки.** Всё прочитанное сохраняется на вашем компьютере. По ней работает
-  быстрый поиск по тексту сообщений, и её можно читать без интернета (`--offline`). При входе MAX
-  присылает только изменившихся людей. Полный список заново — `max contacts sync`; данные
-  покинутых чатов удаляет `max store clear --left --allow-dangerous`.
-- **Чужой текст не управляет вашим терминалом.** Имена, названия чатов, имена файлов и сообщения
-  пишут другие люди. Управляющие символы из них показываются как текст, имя всегда печатается в одну
-  строку, а автодополнение подставляет только номер чата — поддельную строку переписки или команду в
-  оболочке так не подсунуть.
-- **Пароль от аккаунта не лежит в файле.** Токен входа хранится в системном хранилище паролей:
-  Keychain в macOS, Secret Service (GNOME Keyring, KWallet) в Linux, диспетчер учётных данных в
-  Windows. В историю команд он не попадает.
-- **Скрипт и агент разбирают ответ без догадок.** С `--json` команда отдаёт только данные, в одной и
-  той же форме, без текста для человека вокруг. Ошибка приходит отдельно и с номером, поэтому
-  скрипт сразу понимает, что случилось: нет входа, чат не найден или MAX не ответил вовремя.
-- **Разбор проблем без вашей переписки.** `--trace` показывает каждый запрос к MAX, чтобы понять,
-  почему команда не сработала. В этой записи нет текстов, имён, телефонов и токена, поэтому её
-  можно приложить к сообщению об ошибке. Полностью удачный запуск без флага не записывается; ошибки и частичные результаты сохраняются по умолчанию без текстов, если запись явно не выключена.
-## Под заказ
-Делаем автоматизацию процессов и инструменты под вашу задачу: интеграции с MAX и другими
-мессенджерами, ИИ-агентов, внутренние сервисы. Пишите на [info@neirox.ai](mailto:info@neirox.ai).
-## Чем отличается от других
-Для MAX уже есть хорошие проекты, и max-cli многому у них научился.
-[PyMax](https://github.com/MaxApiTeam/PyMax) — самая полная библиотека для личного аккаунта; её код
-помог разобрать многие операции протокола. Выбирайте то, что подходит под задачу.
+Ваш агент. Ваш MAX. Ваши правила.
-| | max-cli | [PyMax](https://github.com/MaxApiTeam/PyMax) | [max-mcp](https://github.com/renosaza/max-mcp) |
-|---|:-:|:-:|:-:|
-| что это | программа для терминала и MCP-сервер | библиотека на Python | MCP-сервер на PyMax |
-| MCP-сервер и навык для агентов | ✅ | — | MCP |
-| ограничения для агента: только чтение, разрешённые действия, список чатов, лимит в час, подтверждение отправки | ✅ | — | — |
-| расшифровка голосовых в текст на вашем компьютере | ✅ | — | — |
-| готовые команды — не нужно писать свою программу | ✅ | — (библиотека для своего кода на Python) | — |
-| локальная копия с поиском и чтением без интернета | ✅ | — | — |
-| новые сообщения в реальном времени | ✅ `max watch` | ✅ обработчики событий | — |
-| отложенная отправка — уходит, даже если компьютер выключен | ✅ | ✅ | — |
-| выгрузка переписки в JSONL или Markdown | ✅ | — | — |
-| чтение, отправка текста, фото и файлов | ✅ | ✅ | ✅ |
-| реакции, правка, пересылка, закрепление | ✅ | ✅ | — |
-| удаление сообщений — у себя или у всех, с лимитом | ✅ | ✅ | — |
-| отметка «прочитано» по запросу | ✅ | ✅ | — |
-| группы и каналы: создать, вступить, участники, админы | ✅ | ✅ | чтение каналов |
-| для админа группы: вопросы без ответа, новенькие, проверка по правилам | ✅ | — | — |
-| контакты, профиль, другие сеансы | ✅ | ✅ | — |
-| отправка видео | ✅ | ✅ | — |
-| отправка кружков | — | ✅ | — |
-| отправка голосовых | ✅ | ⚠️ в 2.4.1 не проходит ([#102](https://github.com/MaxApiTeam/PyMax/issues/102), [#103](https://github.com/MaxApiTeam/PyMax/issues/103)) | — |
-| опросы: показать, проголосовать, создать, закрыть | ✅ | ✅ | — |
-| фото профиля | ✅ | ✅ | — |
-| вход с облачным паролем | ✅ по QR-коду | ✅ | — |
-| установить или снять облачный пароль | — | ✅ | — |
-Для бота есть `max bot` — через официальный Bot API, отдельно от личного аккаунта
-([docs/bot.md](docs/bot.md)). Таблица выше — про личный аккаунт.
-## Содержание
-- [Бот](#бот)
-- [Личный аккаунт](#личный-аккаунт)
-- [Группы, которые вы ведёте](#группы-которые-вы-ведёте)
-- [Установка](#установка)
-- [Вход](#вход)
-- [Использование](#использование)
-- [Для скриптов и агентов](#для-скриптов-и-агентов)
-- [Безопасность](#безопасность)
-- [Документация](#документация)
-- [Разработка](#разработка)
-- [Дорожная карта](#дорожная-карта)
-- [Лицензия](#лицензия)
-- [Участие](#участие)
-## Установка
-Пакет — **`@wirecat/max-cli`**, команда, которую он ставит, — **`max`**.
-Запустить, ничего не устанавливая:
+- **Агент с терминалом** — Claude Code, Codex, Cursor, Gemini CLI. Он сам вызывает `max`, а навык
+  (skill) — инструкция для агента — объясняет ему команды и ограничения. `max setup` ставит навык
+  сам; отдельно — `max skill install`.
+- **Приложение без терминала** — Claude Desktop, Cursor и другие клиенты MCP. Подключите
+  MCP-сервер `max mcp`; готовые просьбы `/catch-up`, `/review`, `/reply` и `/find` уже внутри.
+- **ChatGPT или Claude в браузере** — через HTTPS-туннель и вход по коду.
 ```sh
-npx @wirecat/max-cli --help
+max mcp setup claude-code  # или codex
+max mcp config             # запись для Claude Desktop, Cursor и других
 ```
-Поставить насовсем:
+С `--json` каждая команда отдаёт только данные, а ошибка приходит отдельно, с постоянным кодом
+завершения.
-```sh
-npm install -g @wirecat/max-cli
-max --version
-max setup --agent codex  # вход и подключение навыка агента
-```
+Подробнее: [MCP-сервер](https://github.com/WireCatLabs/max-cli/blob/main/docs/mcp.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/mcp)), [браузер](https://github.com/WireCatLabs/max-cli/blob/main/docs/remote.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/remote)), [контракт для скриптов](https://github.com/WireCatLabs/max-cli/blob/main/docs/cli-contract.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/cli-contract)).
-Глобальная установка через npm устанавливает навык агента, а на Windows сохраняет PATH
-для новых терминалов. Агенту в уже открытом терминале нужно обновить окружение и прочитать
-`max skill show` перед входом. `MAX_INSTALL_AGENT=none` отключает установку навыка.
+## Почему max
-Нужен **Node 22.16+ (ветка 22.x) или 24+**, либо **Bun 1.3+**. Работает на macOS, Linux и Windows. Подробности,
-переменные окружения и то, куда ложатся файлы, — [docs/installation.md](docs/installation.md).
+- **Весь аккаунт, а не только бот.** Чаты, история, группы, контакты, файлы и голосовые — как в
+  приложении. И отдельно бот через официальный Bot API.
+- **Своя копия переписки.** Всё прочитанное хранится на вашем компьютере: быстрый поиск и чтение
+  без интернета (`--offline`), выгрузка в JSONL или Markdown.
+- **Сделан для агентов.** Навык, MCP-сервер, одна форма JSON и коды ошибок, по которым скрипт
+  решает, что делать дальше.
+- **Безопасен по умолчанию.** Чтение не ставит отметку «прочитано». Есть профиль только для чтения,
+  список чатов для записи и лимит сообщений в час. Если имя подходит к двум чатам, `max` не выбирает
+  сам. Если связь оборвалась при отправке, `max` так и скажет, а повтор не создаст второе сообщение.
+- **Порядок в группах, которые вы ведёте.** Вопросы без ответа, кто вступил, проверка по вашим
+  правилам: спам, чужие ссылки, флуд. По умолчанию проверка только отмечает.
-Если после установки команда `max` не находится, `npx @wirecat/max-cli doctor` скажет почему и
-напечатает команду, которая это исправит.
+### Чем отличается от других
-## Вход
+Для MAX есть и другие хорошие проекты; [PyMax](https://github.com/MaxApiTeam/PyMax) — самая полная
+библиотека для личного аккаунта, и её код помог разобрать протокол. Коротко, для личного аккаунта:
-`max setup` проводит через первый запуск: проверяет локальные каталоги, показывает QR-код,
-проверяет аккаунт и до пяти чатов, затем предлагает подключить навык агента. Выделите около
-пяти минут. Скачивание истории — отдельный шаг после выбора чата и объёма; setup не запускает
-фоновый сервис. Повторный запуск проверяет существующую сессию без нового входа.
+| | max-cli | [PyMax](https://github.com/MaxApiTeam/PyMax) | [max-mcp](https://github.com/renosaza/max-mcp) |
+|---|:-:|:-:|:-:|
+| что это | программа и MCP-сервер | библиотека на Python | MCP-сервер на PyMax |
+| готовые команды, навык и MCP для агентов | ✅ | — | MCP |
+| ограничения для агента: только чтение, список чатов, лимит в час | ✅ | — | — |
+| локальная копия с поиском без интернета | ✅ | — | — |
+| расшифровка голосовых на вашем компьютере | ✅ | — | — |
+| реакции, правка, пересылка, опросы, отложенная отправка | ✅ | ✅ | — |
+| для админа группы: вопросы без ответа, проверка по правилам | ✅ | — | — |
-```sh
-max setup --agent codex                # QR-вход и навык Codex
-max setup --agent claude               # или Claude Code
-max setup --method qr-chrome           # QR через web.max.ru в Chromium
-max setup --method sms                 # номер телефона вводится в браузере
-max setup --method token               # скрытый ввод токена или stdin
-max setup --help                       # все способы и примеры
-```
+Подробнее: [полная таблица](https://github.com/WireCatLabs/max-cli/blob/main/docs/index.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max)).
-Вместо агента можно выбрать `cursor`, `gemini`, `all` или `none`. Агент перед входом читает
-`max skill show`; инструкция доступна без сессии. `max session start` остаётся отдельной
-командой импорта токена, а `max session start qr` — явного повторного входа при истёкшей сессии
-([docs/sessions.md](docs/sessions.md)).
+## Личный аккаунт
-Несколько аккаунтов — несколько профилей, и профиль называется **первым словом**, а не флагом:
+`max` без слова `bot` работает с вашим аккаунтом как ещё одно ваше устройство.
+> ⚠️ **Для личного аккаунта max-cli использует неофициальный внутренний API MAX.** API может
+> измениться без предупреждения, а использование инструмента может нарушать условия сервиса. Вы
+> используете max-cli на свой риск; авторы и контрибьюторы не несут ответственности за блокировки
+> аккаунтов, потерю данных или другие последствия. Бот работает через официальный API, и к нему
+> это не относится.
+- **Читать.** Чаты, история, сообщение вместе с соседними, непрочитанное во всех чатах (`max inbox`),
+  разбор «кто кому должен» (`max review`), новые сообщения по мере прихода (`max watch`), вложения,
+  голосовые — текстом на вашем компьютере.
+- **Писать.** Текст и разметка, ответы, фото, видео, файлы и голосовые, правка, пересылка,
+  закрепление, реакции, опросы, отложенная отправка, удаление — у себя или у всех.
+- **Группы и каналы.** Создать, вступить по ссылке, выйти, участники и админы, настройки, ссылка-приглашение, папки.
+- **Контакты и аккаунт.** Найти по номеру, добавить, переименовать, заблокировать, свои заметки о
+  людях; профиль и фото; другие сеансы.
 ```sh
-max chats list              # профиль default
-max personal chats list     # профиль personal
-export MAX_PROFILE=personal # или на всю сессию оболочки
+max inbox                                              # непрочитанное, ничего не отмечая
+max messages list "Алиса Пример" --limit 20
+max messages send "Алиса Пример" "Созвонимся в 15:00?" --reply-to <id>
+max reactions add "Алиса Пример" <id> 👍
+max messages send 0 "Позвонить Борису" --at-time 2h    # напоминание себе в «Избранное»
+max chats mark-read "Алиса Пример"                     # отметить прочитанным, когда нужно
 ```
-## Использование
+Подробнее: [личный аккаунт](https://github.com/WireCatLabs/max-cli/blob/main/docs/usage.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/usage)), [один человек](https://github.com/WireCatLabs/max-cli/blob/main/docs/people.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/people)), [ответы](https://github.com/WireCatLabs/max-cli/blob/main/docs/replies.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/replies)).
+## Бот
-**Бот пишет в группу, закрепляет объявление и следит за порядком:**
+`max bot` работает через **официальный** [Bot API MAX](https://dev.max.ru/docs-api) по токену бота.
+Ботов может быть несколько: каждый хранится под именем, которое вы выбираете, и это имя — первое
+слово команды. Бота создают на [business.max.ru](https://business.max.ru/self); MAX выдаёт их
+подтверждённым организациям, ИП и самозанятым.
 ```sh
+max sales bot auth set                                   # токен — в скрытом вводе, MAX его проверит
+max sales bot recipients add "Команда продаж"            # писать только сюда
 max sales bot messages send "Команда продаж" "**Сборка готова**" --md --file report.pdf
-max sales bot messages pin "Команда продаж" <mid>       # id сообщения — из ответа на send
-max sales bot watch --events                             # всё, что происходит в чатах бота, по мере прихода
-max sales bot chats rules set "Команда продаж" links delete
+max sales bot messages pin "Команда продаж" <mid>        # id сообщения — из ответа на send
+max sales bot watch --events                             # всё, что происходит в чатах бота
 max sales bot chats moderate "Команда продаж" --dry-run  # что нарушает правила — без действий
-max sales bot contacts show "Иван"                       # где человек писал и его личный чат с ботом
+max sales bot api get-updates --limit 10                 # любой метод Bot API
+max bot list --check                                     # все боты на этом компьютере
 ```
-**Разговор от своего имени:**
+- **Полный Bot API.** Каждый метод официальной схемы — `max <бот> bot api <операция>`: параметры —
+  флаги, тело — JSON, который сверяется со схемой до отправки.
+- **Сообщения и чаты.** Чат называют по номеру, по названию, если бот его видел, или человека как
+  `user:<номер>`. Файлы, участники, комментарии, кнопки, меню команд, вебхуки.
+- **Модерация.** `bot chats rules` и `bot chats moderate` удаляют спам и людей по вашим правилам.
+- **Копия переписки бота.** `bot contacts show`, `bot search messages --from`,
+  `bot messages between` — без запросов к MAX.
+- **Бот не напишет лишнего.** Свой список чатов для записи, журнал отправленного без текста,
+  `permissions` и MCP-сервер `max <бот> bot mcp`. Токен — в системном хранилище паролей, отдельно от вашего.
-```sh
-max inbox                                         # непрочитанное во всех чатах, ничего не отмечая
-max messages list "Иван Петров" --limit 20
-max messages send "Иван Петров" "Созвонимся в 15:00?" --reply-to <id>
-max reactions add "Иван Петров" <id> 👍
-max messages send 0 "Позвонить маме" --at-time 2h # напоминание себе в «Избранное» через два часа
-max review --since-time 1d                             # вся переписка за сутки: кто кому что обещал
-```
+Подробнее: [бот MAX](https://github.com/WireCatLabs/max-cli/blob/main/docs/bot.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/bot)).
-**Группа, которую вы ведёте:**
+## Группы, которые вы ведёте
 ```sh
-max chats create "Поход" "Аня" "Борис"            # создать и позвать людей
-max chats admins add "Поход" "Аня" --can pin,members
-max chats link reset "Поход"                      # старая ссылка-приглашение перестаёт работать
-max polls create "Поход" "Когда едем?" "Суббота" "Воскресенье"
 max review --chat "Поход" --unanswered            # вопросы, на которые сутки никто не ответил
-max chats moderate "Поход" --dry-run                 # спам, чужие ссылки, флуд — по вашим правилам
+max chats events "Поход"                          # кто вступил и вышел
+max chats members list "Поход" --all              # все участники: когда заведён аккаунт
+max chats rules set "Поход" invites delete        # приглашения в чужие чаты — удалять
+max chats moderate "Поход" --dry-run              # что нарушает правила — без действий
 ```
-**Найти и сохранить:**
+Проверка сверяет новое в группе с вашими правилами: заблокированные люди, приглашения, ссылки,
+пересланное, флуд, совсем новые аккаунты. По умолчанию она только отмечает. Для каждого действия вы
+решаете сами: никогда, только с флагом, с вашим подтверждением или сразу. Не больше 10 действий за
+раз, и ничего не следит за группой в фоне.
+Подробнее: [группы](https://github.com/WireCatLabs/max-cli/blob/main/docs/groups.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/groups)), [рейтинги](https://github.com/WireCatLabs/max-cli/blob/main/docs/rankings.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/rankings)).
+## Локальная копия и поиск
+Всё прочитанное сохраняется на вашем компьютере. По копии работают поиск и чтение без интернета;
+историю чата можно скачать глубже и выгрузить.
 ```sh
-max search all "договор"                          # сообщения, почта и заметки сразу, без сети
-max search messages "договор" --chat "Проект Альфа"  # только сообщения одного чата
-max store fetch "Проект Альфа" --last 500
+max search all "договор"                             # сообщения, почта и заметки сразу
+max search messages "договор" --chat "Проект Альфа"  # только один чат
+max store fetch "Проект Альфа" --last 500            # последние 500 сообщений — в копию
 max store export "Проект Альфа" --format markdown --output alfa.md
+max chats list --offline                             # без подключения к MAX
 ```
-Каждая команда отвечает JSON с `--json` и пишет в журнал, что отправила, — без текстов.
+Поиск понимает слова, людей, даты, файлы, ссылки и ваши метки; есть поиск по темам и сохранённые
+запросы. Текст из сохранённых вложений ищется через `content:`.
-Полностью: [docs/usage.md](docs/usage.md). Каждая команда и каждая опция:
-[docs/commands.md](docs/commands.md) — эта страница собирается из самой программы, поэтому описать
-версию, которой не существует, она не может.
+Подробнее: [локальная копия](https://github.com/WireCatLabs/max-cli/blob/main/docs/archive.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/archive)), [поиск](https://github.com/WireCatLabs/max-cli/blob/main/docs/search.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/search)), [язык запросов](https://github.com/WireCatLabs/max-cli/blob/main/docs/query-language.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/query-language)), [поиск по темам](https://github.com/WireCatLabs/max-cli/blob/main/docs/topic-search.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/topic-search)), [вложения](https://github.com/WireCatLabs/max-cli/blob/main/docs/attachments.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/attachments)), [голосовые](https://github.com/WireCatLabs/max-cli/blob/main/docs/audio-recognition.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/audio-recognition)).
-## Для скриптов и агентов
+## Агенты: навык и MCP
-### Навык для агентов с терминалом
-Навык (skill) — файл с инструкцией, который агент читает перед работой. В навыке `max` описано,
-какие команды есть, что агент делает только по вашей просьбе и как безопасно повторить отправку.
-Его понимают **Claude Code**, **Codex**, **Cursor** и **Gemini CLI**. Навык ставится одной командой и всегда
-той же версии, что и `max`:
+**Навык** ставится одной командой и всегда той же версии, что и `max`: в `~/.claude/skills/max-cli/`
+для Claude Code и в `~/.agents/skills/max-cli/` для Codex, Gemini CLI и Cursor. После обновления
+`max` запустите установку ещё раз.
 ```sh
-max skill show                         # прочитать перед входом
-max skill install --for all             # установить без входа
+max skill show                  # прочитать до входа
+max skill install --for all     # или --for claude, --for agents
 ```
-Команда кладёт навык в `~/.claude/skills/max-cli/` для Claude Code и в `~/.agents/skills/max-cli/`
-для Codex, Gemini CLI и Cursor (при поддержке обнаружения навыков); `--for claude` или `--for agents` — только в одну из папок. После
-обновления `max` запустите её ещё раз. Если навыка нет или он старше `max`, агент раз в сутки
-увидит об этом строку в stderr; выключается `max config set skillHint false --defaults`.
+**MCP-сервер** работает с тем же аккаунтом. Права профиля проверяются при каждом вызове; формы
+подтверждения на сервере нет — подтверждение вызовов настраивается в приложении агента. Навык
+доступен ресурсом `max://skill`.
+```sh
+max mcp doctor                                       # проверить локальный MCP
+max mcp --http --public-url https://<имя>.ts.net     # для ChatGPT и Claude в браузере
+max mcp --permission messages.send=ask               # временно изменить право
+```
-Как эти агенты находят навыки: [Codex](https://learn.chatgpt.com/docs/build-skills),
-[Gemini CLI](https://geminicli.com/docs/cli/skills/).
+Подробнее: [MCP-сервер](https://github.com/WireCatLabs/max-cli/blob/main/docs/mcp.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/mcp)), [браузер](https://github.com/WireCatLabs/max-cli/blob/main/docs/remote.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/remote)), [внешние модели](https://github.com/WireCatLabs/max-cli/blob/main/docs/external-models.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/external-models)).
-### MCP-сервер для агентов без терминала
+## Для скриптов
-Claude Desktop, Cursor и другие клиенты MCP подключаются к `max mcp` и работают с тем же
-аккаунтом. Права `deny`/`readonly` запрещают записи; `ask`/`allow` допускают запрошенное действие через MCP.
-Серверных форм подтверждения нет; подтверждение вызовов зависит от настроек вашего ИИ-приложения.
-Навык доступен ресурсом `max://skill`. Для браузерных клиентов есть
-`max mcp --http --public-url https://<имя>.ts.net`: HTTPS-туннель и вход по коду.
-`--permission ключ=уровень` временно переопределяет права процесса ([подключение](docs/remote.md)).
+С `--json` команда печатает только данные; так же она работает, когда её вывод читает другая
+программа (`max … | jq`). Любой список приходит в одной форме:
-```sh
-max mcp doctor                      # проверить локальный MCP
-max mcp setup codex                # Codex
-max mcp setup claude-code          # Claude Code
-max mcp config                      # запись для Claude Desktop, Cursor и других — с полными путями
+```json
+{ "items": [ … ], "page": 1, "limit": 20, "hasMore": true }
 ```
-Команды сервера — `/catch-up`, `/review`, `/reply`, `/find` — готовые просьбы: агент знает, какие
-инструменты вызвать и чего не делать.
+Ошибка приходит одной строкой JSON в stderr, stdout остаётся пустым. Код завершения говорит, что
+случилось: `4` — нужно войти, `5` — права не разрешают, `6` — чат или сообщение не найдены, `8` —
+лимит, `9` — MAX не ответил вовремя, `14` — неизвестно, ушло ли сообщение (повторять только с тем же
+`--send-id`). Частичный результат может прийти с кодом `0`: проверьте поле `complete`.
-### Ответы в JSON
+Подробнее: [контракт](https://github.com/WireCatLabs/max-cli/blob/main/docs/cli-contract.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/cli-contract)), [все команды и коды](https://github.com/WireCatLabs/max-cli/blob/main/docs/commands.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/commands)).
+## Вход и профили
 ```sh
-max chats list --json
+max setup --agent codex       # QR-код в терминале и навык Codex
+max setup --method qr-chrome  # QR через web.max.ru в браузере
+max setup --method sms        # номер телефона — в браузере
+max setup --method token      # готовый токен, скрытым вводом или через stdin
+max session start qr          # повторный вход, когда сессия истекла
 ```
-С `--json` команда печатает только данные в JSON, без таблиц, цвета и подсказок. Так же она
-работает, когда её вывод читает другая программа, — например, в конвейере `max … | jq`. Любой
-список — чаты, сообщения, участники, всё у бота — приходит в одной форме:
+Несколько аккаунтов — несколько профилей; профиль называется **первым словом**:
+`max personal chats list`, или `export MAX_PROFILE=personal` на всю сессию оболочки.
-```json
-{ "items": [ … ], "page": 1, "limit": 20, "hasMore": true }
-```
+Подробнее: [вход и сессии](https://github.com/WireCatLabs/max-cli/blob/main/docs/sessions.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/sessions)), [профили](https://github.com/WireCatLabs/max-cli/blob/main/docs/profiles.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/profiles)).
-Ошибка, завершающая команду, приходит отдельно от данных — одной строкой в stderr, а stdout остаётся пустым, поэтому её
-нельзя принять за пустой результат:
+## Настройки и права
-```json
-{"error":{"code":"authentication_error","message":"no session for profile \"default\" — run `max setup` in a local terminal; agents: read `max skill show`"}}
+У каждого профиля свои настройки и права; без файла настроек действуют встроенные значения.
+| Настройка | Что делает | По умолчанию |
+|---|---|---|
+| `permissions` | что можно: `deny`, `readonly`, `ask`, `allow` — для команды или группы команд | всё, кроме удаления и других необратимых действий: они спрашивают |
+| `sendsPerHour` | сколько сообщений профиль отправит за час | `30` |
+| `requestsPerMinute` | темп обращений к MAX | `20` |
+| `catchUpMarksRead` | `inbox` и `review` отмечают показанное прочитанным | `false` |
+| `limit` | сколько строк в списке | `20` |
+```sh
+max config set permissions.messages readonly  # профиль только для чтения
+max config set permissions.messages.send ask  # спрашивать перед отправкой
 ```
-У ошибки, завершающей команду, есть номер — код завершения программы. По нему скрипт решает, что делать дальше:
-`4` — нужно войти, `6` — чат или сообщение не найдены, `9` — MAX не ответил вовремя, `14` —
-неизвестно, выполнено ли изменение. Все коды — в [docs/commands.md](docs/commands.md).
+Подробнее: [настройки](https://github.com/WireCatLabs/max-cli/blob/main/docs/configuration.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/configuration)), [права](https://github.com/WireCatLabs/max-cli/blob/main/docs/permissions.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/permissions)), [все ключи](https://github.com/WireCatLabs/max-cli/blob/main/docs/configuration-reference.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/configuration-reference)).
+## Ограничения
-Частичное чтение или скачивание может вернуть JSON с кодом `0`: проверьте `complete` и `batch` или `issue`. JSONL частичной загрузки добавляет `batch_summary`. [Как продолжить](docs/attachments.md#если-часть-файлов-не-прочиталась).
+`max` держит каждый профиль в одном темпе: первые 10 запросов идут сразу, дальше — 20 в минуту, и
+две команды одновременно делят этот темп. Если MAX отвечает «слишком много запросов», `max`
+останавливается и не повторяет запрос сам. Фоновый `max serve` держит одно подключение для всех
+команд и сам останавливается, когда им 15 минут никто не пользуется.
+Подробнее: [ограничения и ожидания](https://github.com/WireCatLabs/max-cli/blob/main/docs/limits.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/limits)).
 ## Безопасность
-- Токен входа — в системном хранилище паролей, не в файле и не в строке команды.
-- Локальная копия переписки и все служебные файлы доступны только вашему пользователю; от кражи
-  диска защищает шифрование диска целиком.
+- Токен входа — в системном хранилище паролей, не в файле и не в истории команд.
+- Локальная копия и служебные файлы доступны только вашему пользователю; от кражи диска защищает
+  шифрование диска целиком.
 - Перед каждой отправкой, в том числе через фоновый сервер и MCP, `max` проверяет ограничения
   профиля и пишет строку в журнал — без текста сообщения.
-- Подтверждение MCP-вызовов настройте в приложении агента. `--file` защищает известные файлы
-  с учётными данными, папки CLI и хранилище. Обычные скрытые рабочие папки разрешены;
-  `--allow-any-file` доступен только в CLI. Ограничения профиля действуют при каждом вызове.
+- `--file` не отправит известные файлы с учётными данными, папки `max` и хранилище.
+- Чужой текст не управляет вашим терминалом: управляющие символы из имён и сообщений показываются
+  как текст.
 - Ограничения защищают от агента, которого уговорило прочитанное сообщение, но не от агента,
-  который хочет их обойти: против такого нужна граница снаружи — песочница или отдельный
-  пользователь.
+  который хочет их обойти: для этого нужна песочница или отдельный пользователь.
+Подробнее: [безопасность](https://github.com/WireCatLabs/max-cli/blob/main/docs/security.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/security)).
+## Когда не работает
+```sh
+max doctor               # где лежат файлы и есть ли вход; к MAX не подключается
+max chats list --trace   # каждый запрос к MAX — без текстов, имён и токена
+max runs list            # неудачные и частичные запуски сохраняются сами
+```
+Запись `--trace` можно приложить к сообщению об ошибке.
-Подробно — что пишется на диск, что уходит в сеть и чего инструмент не делает никогда:
-[docs/security.md](docs/security.md).
+Подробнее: [по симптому](https://github.com/WireCatLabs/max-cli/blob/main/docs/troubleshooting.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/troubleshooting)), [диагностика](https://github.com/WireCatLabs/max-cli/blob/main/docs/diagnostics.md) ([wirecat.dev](https://wirecat.dev/ru/docs/max/diagnostics)).
 ## Документация
-- [docs/installation.md](docs/installation.md) — установка, обновление, куда что ложится
-- [docs/bot.md](docs/bot.md) — бот: токен, несколько ботов, сообщения, чаты, список получателей, любая операция API
-- [docs/usage.md](docs/usage.md) — личный аккаунт: вход, чтение, отправка, машинный режим
-- [docs/sessions.md](docs/sessions.md) — токен, хранилище паролей, профили
-- [docs/configuration.md](docs/configuration.md) — настройка по шагам
-- [docs/configuration-reference.md](docs/configuration-reference.md) — все ключи, переменные и порядок разрешения
-- [docs/cli-contract.md](docs/cli-contract.md) — команды, JSON, ошибки, пределы и запуск агентом
-- [docs/mcp.md](docs/mcp.md) — MCP-сервер: подключение, отправка, соединение с MAX
-- [docs/remote.md](docs/remote.md) — ChatGPT или Claude в браузере
-- [docs/groups.md](docs/groups.md) — группы, которые вы ведёте: сценарии с агентом, правила, проверка
-- [docs/people.md](docs/people.md) — один человек: профиль, его сообщения по чатам, похож ли на бота
-- [docs/recipes.md](docs/recipes.md) — рецепты для агентов: сводки, отчёты, долги, напоминания, расписание
-- [docs/diagnostics.md](docs/diagnostics.md) — `--trace`, `--record`, `max runs`
-- [docs/roadmap.md](docs/roadmap.md) — что планируется
-- [docs/security.md](docs/security.md) — что пишется на диск, а что никогда
-- [docs/troubleshooting.md](docs/troubleshooting.md) — по симптому: что делать, когда не работает
-- [docs/commands.md](docs/commands.md) — каждая команда и опция — **генерируется** из программы
-- [docs/dev/protocol.md](docs/dev/protocol.md) — каждый опкод и откуда известна его форма — **генерируется**
-- [docs/dev/ARCHITECTURE.md](docs/dev/ARCHITECTURE.md) — как это устроено и какие швы нельзя пересекать
-- [docs/dev/BACKLOG.md](docs/dev/BACKLOG.md) — что осталось
-Оглавление целиком — [docs/README.md](docs/README.md).
+Каждая страница есть и на сайте — [wirecat.dev/ru/docs/max](https://wirecat.dev/ru/docs/max); ниже —
+исходники в этом репозитории.
+| Раздел | Страницы |
+|---|---|
+| Начало | [обзор и сравнение](https://github.com/WireCatLabs/max-cli/blob/main/docs/index.md) · [установка](https://github.com/WireCatLabs/max-cli/blob/main/docs/installation.md) |
+| Как пользоваться | [личный аккаунт](https://github.com/WireCatLabs/max-cli/blob/main/docs/usage.md) · [вход и сессии](https://github.com/WireCatLabs/max-cli/blob/main/docs/sessions.md) · [локальная копия](https://github.com/WireCatLabs/max-cli/blob/main/docs/archive.md) · [поиск](https://github.com/WireCatLabs/max-cli/blob/main/docs/search.md) · [вложения](https://github.com/WireCatLabs/max-cli/blob/main/docs/attachments.md) · [голосовые](https://github.com/WireCatLabs/max-cli/blob/main/docs/audio-recognition.md) · [внешние модели](https://github.com/WireCatLabs/max-cli/blob/main/docs/external-models.md) · [рейтинги](https://github.com/WireCatLabs/max-cli/blob/main/docs/rankings.md) · [поиск по темам](https://github.com/WireCatLabs/max-cli/blob/main/docs/topic-search.md) · [язык запросов](https://github.com/WireCatLabs/max-cli/blob/main/docs/query-language.md) · [бот MAX](https://github.com/WireCatLabs/max-cli/blob/main/docs/bot.md) · [группы](https://github.com/WireCatLabs/max-cli/blob/main/docs/groups.md) · [один человек](https://github.com/WireCatLabs/max-cli/blob/main/docs/people.md) · [ответы](https://github.com/WireCatLabs/max-cli/blob/main/docs/replies.md) · [MCP-сервер](https://github.com/WireCatLabs/max-cli/blob/main/docs/mcp.md) · [браузер](https://github.com/WireCatLabs/max-cli/blob/main/docs/remote.md) · [рецепты](https://github.com/WireCatLabs/max-cli/blob/main/docs/recipes.md) |
+| Справочник | [все команды](https://github.com/WireCatLabs/max-cli/blob/main/docs/commands.md) · [настройки](https://github.com/WireCatLabs/max-cli/blob/main/docs/configuration.md) · [права](https://github.com/WireCatLabs/max-cli/blob/main/docs/permissions.md) · [профили](https://github.com/WireCatLabs/max-cli/blob/main/docs/profiles.md) · [все ключи настроек](https://github.com/WireCatLabs/max-cli/blob/main/docs/configuration-reference.md) · [контракт для скриптов](https://github.com/WireCatLabs/max-cli/blob/main/docs/cli-contract.md) · [ограничения](https://github.com/WireCatLabs/max-cli/blob/main/docs/limits.md) |
+| Если что-то не так | [диагностика](https://github.com/WireCatLabs/max-cli/blob/main/docs/diagnostics.md) · [когда не работает](https://github.com/WireCatLabs/max-cli/blob/main/docs/troubleshooting.md) · [безопасность](https://github.com/WireCatLabs/max-cli/blob/main/docs/security.md) |
+| Проект | [дорожная карта](https://github.com/WireCatLabs/max-cli/blob/main/docs/roadmap.md) |
+| Изменения | [CHANGELOG.md](https://github.com/WireCatLabs/max-cli/blob/main/CHANGELOG.md) |
+Для разработчиков: [архитектура](https://github.com/WireCatLabs/max-cli/blob/main/docs/dev/ARCHITECTURE.md), [проверки](https://github.com/WireCatLabs/max-cli/blob/main/docs/dev/TESTING.md),
+[протокол](https://github.com/WireCatLabs/max-cli/blob/main/docs/dev/protocol.md) (генерируется), [что осталось](https://github.com/WireCatLabs/max-cli/blob/main/docs/dev/BACKLOG.md).
 ## Разработка
 ```sh
 pnpm install
 pnpm lint && pnpm typecheck && pnpm test
-pnpm build && pnpm smoke:bun          # собранная команда под вторым рантаймом
+pnpm build && pnpm smoke:bun          # собранная команда под Bun
 pnpm generate                         # переписать сгенерированные файлы
 ```
-Протокол MAX неофициальный и разобран обратной инженерией: это не Bot API. Каждый опкод и форма
-каждого сообщения объявлены один раз в `src/spec/`, а реестр, типизированный клиент и
-[docs/dev/protocol.md](docs/dev/protocol.md) из них генерируются — и CI падает, если дерево устарело.
-Половина, не имеющая отношения к MAX — потоки вывода, рендерер, коды ошибок, хранилище паролей, часы, —
-вынесена в [`@wirecat/cli-core`](https://github.com/WireCatLabs/cli-core) и общая с `braze-cli`.
-## Дорожная карта
-[docs/roadmap.md](docs/roadmap.md).
-## Лицензия
+Протокол MAX неофициальный и разобран обратной инженерией. Каждый опкод объявлен один раз в
+`src/spec/`, а реестр, типизированный клиент и `docs/dev/protocol.md` из него генерируются; CI
+падает, если дерево устарело. Общая часть — потоки вывода, коды ошибок, хранилище паролей — в
+[`@wirecat/cli-core`](https://github.com/WireCatLabs/cli-base).
-Apache License 2.0 — см. [LICENSE](LICENSE).
+## Часть WireCat
-## Участие
+max-cli — часть [WireCat](https://wirecat.dev/ru): открытого слоя контекста для ИИ-агентов, который
+хранит данные на вашем компьютере. Начните с MAX. Добавьте Telegram, почту и заметки, когда
+понадобится. Ваш контекст. Любой агент.
-Пулл-реквесты, сообщения об ошибках и предложения приветствуются —
-[issues](https://github.com/WireCatLabs/max-cli/issues). Как устроен код и как его проверять —
-[docs/dev/ARCHITECTURE.md](docs/dev/ARCHITECTURE.md) и [docs/dev/TESTING.md](docs/dev/TESTING.md).
+## Участие и лицензия
-### Private contact notes and automatic tags
+Пулл-реквесты, сообщения об ошибках и предложения —
+[issues](https://github.com/WireCatLabs/max-cli/issues).
-`max contacts alias set <person> <alias>` задаёт локальное имя для выбранного аккаунта;
-`contacts rename` меняет запись в адресной книге мессенджера. Собственные заметки:
-`contacts notes add <person> --file <path>`, затем `list`, `show`, `edit --revision <n>` и `remove`.
-`contacts show --with-notes` включает заметки явно; `contacts list --search-notes <text>` ищет в них.
-Заметка о контакте видна в каждом профиле, который видит этот контакт; псевдоним — только в своём.
-Обновление контактов сохраняет заметки и псевдонимы. Связывание людей не объединяет эти данные.
+Делаем автоматизацию и инструменты под задачу: интеграции с MAX и другими мессенджерами,
+ИИ-агентов, внутренние сервисы — [info@neirox.ai](mailto:info@neirox.ai).
-`max metadata refresh --chat <id>` сохраняет описание группы или канала локально;
-`metadata get --chat <id>` читает сохранённые данные. `tags auto --chat <id> --dry-run`
-показывает метки по ключевым словам. Для актуального описания добавьте `--refresh-metadata`
-без `--dry-run`. Команда обрабатывает не более 500 чатов за запуск, по умолчанию 50.
-Автоматические метки не удаляют ручные; `tags list|remove --source auto` выбирает только
-автоматические метки. Текст сообщений и внешние модели при классификации не используются.
+Apache License 2.0 — [LICENSE](LICENSE).

package/dist/bin/max.js CHANGED Viewed

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
+import { migrateFolders } from "@wirecat/cli-messaging/background";
 import { ensureSqlite } from "@wirecat/cli-messaging/sqlite-runtime";
+import { MAX_APP } from "../app.js";
 // `max chats --json | head` closes the pipe while we are still writing, and an unhandled EPIPE
 // makes Node print a stack trace over the output of the command that just worked. A reader that
 // stopped reading is not an error: leave quietly, as every other Unix tool does.
@@ -13,6 +15,8 @@ for (const stream of [process.stdout, process.stderr]) {
         throw error;
     });
 }
+// Before anything resolves a path: a write into a new folder first would strand the old one.
+migrateFolders(MAX_APP);
 await ensureSqlite();
 // A static import would load the whole program, and its SQLite, before ensureSqlite could swap it.
 const { run } = await import("../program.js");

package/dist/bin/max.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"max.js","sourceRoot":"","sources":["../../src/bin/max.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAA;~~AAEpE~~,+FAA+F;AAC/F,gGAAgG;AAChG,iFAAiF;AACjF,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACtD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACxD,OAAM;QACR,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,YAAY,EAAE,CAAA;AACpB,mGAAmG;AACnG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;AAC7C,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}
1	+ {"version":3,"file":"max.js","sourceRoot":"","sources":["../../src/bin/max.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAA;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,+FAA+F;AAC/F,gGAAgG;AAChG,iFAAiF;AACjF,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACtD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACxD,OAAM;QACR,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,6FAA6F;AAC7F,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,MAAM,YAAY,EAAE,CAAA;AACpB,mGAAmG;AACnG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;AAC7C,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/version.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.45.5";
+export declare const VERSION = "0.47.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js CHANGED Viewed

@@ -1,2 +1,2 @@
-export const VERSION = "0.45.5";
+export const VERSION = "0.47.0";
 //# sourceMappingURL=version.js.map

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/max-cli",
-  "version": "0.45.5",
+  "version": "0.47.0",
   "description": "MAX Messenger bots through the official Bot API, and a personal MAX account, from the terminal — built for agents and scripts",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -24,7 +24,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc --build",
+    "build": "tsc --build --force",
     "generate": "node --experimental-strip-types scripts/bot/generate.ts && pnpm build && node --experimental-strip-types scripts/generate.ts && node --experimental-strip-types scripts/commands.ts",
     "bot:spec:sync": "node --experimental-strip-types scripts/bot/sync-spec.ts",
     "bot:generate": "node --experimental-strip-types scripts/bot/generate.ts",
@@ -99,8 +99,8 @@
     "@modelcontextprotocol/server": "2.1.0",
     "@msgpack/msgpack": "3.1.3",
     "@valibot/to-json-schema": "1.8.0",
-    "@wirecat/cli-core": "0.19.4",
-    "@wirecat/cli-messaging": "0.233.0",
+    "@wirecat/cli-core": "0.20.0",
+    "@wirecat/cli-messaging": "0.248.0",
     "commander": "15.0.0",
     "lossless-json": "4.3.1",
     "ogg-opus-decoder": "1.7.5",