Команды

Справочник: каждая команда, каждая опция, каждый код возврата. Страница собирается из самой программы, поэтому описать версию, которой не существует, она не может.

Как устроена строка:

max [профиль] [опции] <команда> <действие> [аргументы]

Первое слово — профиль, если оно не совпадает с именем команды: max personal chats list читает чаты профиля personal, а max chats list — профиля по умолчанию. То же самое говорит переменная MAX_PROFILE; без неё профиль называется default.

Описания команд и параметров переведены. Сами команды, параметры и буквальные примеры вывода сохранены без изменений. max --help выводит исходную справку на английском.

Общие опции

Действуют на любую команду.

Опция	Что делает
`-V, --version`	показать номер версии.
`-v, --verbose`	подробности: -v — идентификаторы, -vv — все известные данные. По умолчанию: `0`.
`--json`	машиночитаемый вывод: единственное значение JSON в stdout.
`--jsonl`	машиночитаемый вывод: объект JSON на строку для потоковой обработки и jq.
`--quiet`	отключить диагностику.
`--trace`	строка на запрос в stderr: идентификаторы и время, без текста сообщений.
`--timeout <duration>`	ограничить время всей команды: 30s, 2m, 500ms.
`--offline`	читать сохранённое без подключения; ошибка, если данных нет.
`--yes`	выполнить изменение без подтверждения уровня ask.
`--record`	сохранить запуск в `max runs`: идентификаторы и время, без текста сообщений.
`--no-record`	не сохранять независимо от настроек.
`--serve`	запустить `max serve` в фоне, если не запущен (по умолчанию).
`--no-serve`	не запускать сервер; использовать своё подключение, если сервер не работает.

`max session`

сохранённая сессия MAX профиля

`max session start`

войти в MAX для профиля

max session start [method]

Аргумент		Что это
`method`	необязательный	token (вставка или stdin), qr, qr-chrome, sms. Одно из: `token`, `qr`, `qr-chrome`, `sms`. По умолчанию: `token`.

`max session end`

удалить сохранённую сессию профиля

max session end

`max setup`

настроить личный аккаунт MAX и подключить агента

Меняет что-то в MAX.

max setup [options]

Опция	Что делает
`--agent <agent>`	установить навык для этого агента; в терминале предлагает выбор, иначе не устанавливает. Одно из: `none`, `codex`, `cursor`, `claude`, `gemini`, `all`.
`--method <method>`	способ входа, если сессии ещё нет. Одно из: `token`, `qr`, `qr-chrome`, `sms`. По умолчанию: `qr`.

`max account`

аккаунт, под которым вошёл профиль

`max account show`

под каким аккаунтом вошёл профиль; последние четыре цифры телефона

max account show [options]

Опция	Что делает
`--show-phone`	показать полный номер телефона.

`max account update`

изменить видимые всем имя, описание или фото профиля

Изменяет данные MAX.

max account update [options]

Опция	Что делает
`--first-name <name>`	ваше имя.
`--last-name <name>`	ваша фамилия.
`--description <text>`	описание профиля.
`--photo <file>`	новое фото профиля: файл изображения.

`max account sessions`

другие сессии аккаунта; max session управляет только входом этого инструмента

`max account sessions list`

все устройства и приложения с входом в аккаунт; не завершает сеансы

max account sessions list

`max account sessions end`

завершить все другие сессии, включая телефон; текущая остаётся

Изменяет данные MAX.

max account sessions end [options]

Опция	Что делает
`--others`	все сеансы, кроме текущего.

`max chats`

чаты аккаунта

`max chats list`

чаты от новых к старым, включая архив

max chats list [options]

Опция	Что делает
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.
`--search <text>`	название содержит текст; минимум 3 символа.
`--kind <kind>`	тип чата: dialog, group, channel, saved.
`--unread`	только чаты с непрочитанными сообщениями.

`max chats show`

один чат: тип, число непрочитанных, время последнего сообщения и участники

max chats show <chat>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

`max chats events`

кто вступил, вышел, кого добавили или удалили и кем: по служебным сообщениям

max chats events <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--since-time <time>`	время ISO 8601 или 2h / 1d назад; по умолчанию 7 дней назад.
`--type <names>`	только указанные события через запятую: join, leave, add, remove, create, title, pin.

`max chats inspect`

куда ведёт приглашение или публичная ссылка, без вступления

max chats inspect <link>

Аргумент		Что это
`link`	обязательный	ссылка-приглашение или публичная ссылка.

`max chats join`

вступить в группу или канал по ссылке; участники видят вступление

Изменяет данные MAX.

max chats join <link>

Аргумент		Что это
`link`	обязательный	ссылка-приглашение или публичная ссылка.

`max chats mark-read`

отметить чат прочитанным; собеседник видит прочтение

Изменяет данные MAX.

max chats mark-read <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--until <message>`	до указанного идентификатора сообщения; по умолчанию до последнего.

`max chats leave`

выйти из группы или канала; участники видят выход

Изменяет данные MAX.

max chats leave <chat>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

`max chats create`

создать группу или канал; добавленные люди получают уведомление

Изменяет данные MAX.

max chats create <title> [person] [options]

Аргумент		Что это
`title`	обязательный	название группы.
`person`	необязательный	участники для добавления: идентификатор или часть имени.

Опция	Что делает
`--channel`	приватный канал вместо группы; вступление по ссылке.

`max chats members`

участники группы

`max chats members list`

участники группы по страницам, с ролями и временем последнего посещения

max chats members list <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.

`max chats members add`

добавить участников; они получат уведомление

Изменяет данные MAX.

max chats members add <chat> <person> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`person`	обязательный	идентификатор или часть имени.

Опция	Что делает
`--history`	добавленные участники также увидят предыдущие сообщения.

`max chats members remove`

удалить участников; сообщения сохраняются

Изменяет данные MAX.

max chats members remove <chat> <person>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`person`	обязательный	идентификатор или часть имени.

`max chats admins`

назначить или снять права администратора

`max chats admins add`

назначить участника администратором с заданными правами

Изменяет данные MAX.

max chats admins add <chat> <person> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`person`	обязательный	идентификатор или часть имени.

Опция	Что делает
`--can <rights>`	права через запятую: read, members, admins, info, pin, link, post, edit, delete.

`max chats admins remove`

снять права администратора; человек остаётся участником

Изменяет данные MAX.

max chats admins remove <chat> <person>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`person`	обязательный	идентификатор или часть имени.

`max chats update`

изменить название, описание или настройки группы либо канала

Изменяет данные MAX.

max chats update <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--title <title>`	новое название.
`--description <text>`	новое описание.
`--all-can-pin <on\|off>`	все участники могут закреплять сообщения.
`--only-admins-add <on\|off>`	только администраторы могут добавлять участников.
`--only-admins-call <on\|off>`	только администраторы могут начать звонок.
`--only-owner-edits-info <on\|off>`	только владелец может менять название и фото.
`--members-see-link <on\|off>`	участники могут видеть приглашение.

`max chats link`

приглашение в группу

`max chats link show`

ссылка-приглашение, если у вас есть право её видеть

max chats link show <chat>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

`max chats link reset`

заменить приглашение; старая ссылка перестаёт работать

Изменяет данные MAX.

max chats link reset <chat>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

`max chats folders`

ваши папки чатов

`max chats folders list`

ваши папки чатов в порядке приложения

max chats folders list

`max chats folders create`

создать папку чатов

Изменяет данные MAX.

max chats folders create <title> [options]

Аргумент		Что это
`title`	обязательный	название папки; приложение может отклонить слишком длинное.

Опция	Что делает
`--chat <chat>`	чат для добавления по идентификатору или названию; повторите для нескольких.

`max chats folders update`

переименовать папку или изменить её чаты

Изменяет данные MAX.

max chats folders update <folder> [options]

Аргумент		Что это
`folder`	обязательный	идентификатор папки или точное название.

Опция	Что делает
`--title <title>`	новое название.
`--add <chat>`	добавить чат; повторите для нескольких.
`--remove <chat>`	убрать чат; повторите для нескольких.

`max chats folders delete`

удалить папку; чаты сохраняются

Изменяет данные MAX.

max chats folders delete <folder>

Аргумент		Что это
`folder`	обязательный	идентификатор папки или точное название.

`max chats rules`

правила проверки группы командой chats moderate, сохранённые в файле профиля

`max chats rules show`

правила группы; если не сохранены, значения по умолчанию с отметкой

max chats rules show <chat>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

`max chats rules set`

изменить правило; первое изменение сохраняет все правила с исходными значениями

Меняет что-то только на этом компьютере.

max chats rules set <chat> <key> <value>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`key`	обязательный	одно из: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove.
`value`	обязательный	новое значение; элементы списка разделяются запятыми.

`max chats rules unset`

вернуть правило к значению по умолчанию

Меняет что-то только на этом компьютере.

max chats rules unset <chat> <key>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`key`	обязательный	одно из: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove.

`max chats moderate`

проверить новые сообщения и участников по правилам группы и выполнить разрешённые действия

Изменяет данные MAX.

max chats moderate <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--since-time <time>`	проверить после времени ISO 8601 или 2h / 1d назад; сохранённая позиция не меняется.
`--dry-run`	проверить и составить план без действий.
`--allow-dangerous`	подтвердить все действия с уровнем ask в правилах группы.
`--max-actions <n>`	максимум действий за запуск; по умолчанию 10.

`max contacts`

люди, с которыми у вас есть личный чат

`max contacts list`

люди, с которыми у вас есть личный чат

max contacts list [options]

Опция	Что делает
`--limit <n>`	количество результатов.
`--page <n>`	номер страницы, начиная с 1.
`--all`	все строки без страниц.
`--order <recent\|name>`	сначала недавние переписки или по алфавиту. По умолчанию: `recent`.
`--search <text>`	имя или @username содержит текст.

`max contacts show`

человек и общие с ним чаты

max contacts show <person>

Аргумент		Что это
`person`	обязательный	идентификатор, @username или часть имени.

`max contacts sync`

сбросить позицию синхронизации и загрузить весь список

max contacts sync

`max contacts lookup`

человек по номеру MAX: ввод по запросу или stdin

max contacts lookup

`max contacts add`

добавить контакт; contacts list по-прежнему показывает только личные чаты

Изменяет данные MAX.

max contacts add <person>

Аргумент		Что это
`person`	обязательный	идентификатор из `contacts lookup` или часть известного имени.

`max contacts remove`

удалить контакт; чат остаётся, заданное вами имя может исчезнуть

Изменяет данные MAX.

max contacts remove <person>

Аргумент		Что это
`person`	обязательный	идентификатор из `contacts lookup` или часть известного имени.

`max contacts block`

запретить человеку писать вам; контакт необязателен

Изменяет данные MAX.

max contacts block <person>

Аргумент		Что это
`person`	обязательный	идентификатор из `contacts lookup` или часть известного имени.

`max contacts unblock`

разрешить заблокированному человеку снова писать вам

Изменяет данные MAX.

max contacts unblock <person>

Аргумент		Что это
`person`	обязательный	идентификатор из `contacts lookup` или часть известного имени.

`max contacts rename`

задать своё имя контакта, которое он не видит

Изменяет данные MAX.

max contacts rename <person> <first-name> [last-name]

Аргумент		Что это
`person`	обязательный	идентификатор из `contacts lookup` или часть известного имени.
`first-name`	обязательный	имя, под которым вы хотите видеть человека.
`last-name`	необязательный

`max contacts import`

загрузить номера телефонов и добавить людей, которых мессенджер по ним найдёт

Изменяет данные MAX.

max contacts import <file>

Аргумент		Что это
`file`	обязательный	один человек на строку: номер, запятая, табуляция или точка с запятой, затем имя.

`max messages`

чтение и отправка сообщений чата

`max messages list`

сообщения чата от старых к новым

max messages list <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--limit <n>`	количество.
`--before-id <id>`	старше указанного идентификатора сообщения.
`--before-time <time>`	раньше времени ISO 8601 или 2h / 1d назад.
`--after-id <id>`	новее указанного идентификатора сообщения.
`--after-time <time>`	после времени ISO 8601 или 2h / 1d назад.
`--transcribe`	распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты.
`--model <id>`	скачанная модель для --transcribe; список в `models audio list`.
`--mark-read`	также отметить чат прочитанным до последнего показанного сообщения; собеседник видит это.

`max messages search`

поиск сохранённого чтением, загрузкой или serve; без запросов мессенджера

max messages search <query> [options]

Аргумент		Что это
`query`	обязательный	строгий запрос Lucene: слова, "фразы", AND/OR/NOT, группы полей и диапазоны дат; --language legacy сохраняет прежний поиск с исправлениями.

Опция	Что делает
`--chat <chat>`	только чат, как chat: в запросе; идентификатор или часть названия.
`--source <messenger>`	все аккаунты мессенджера в базе: personal, bots, all, как in: в запросе.
`--limit <n>`	количество.
`--newest`	сначала новые вместо наиболее подходящих.
`--context <n>`	контекст до и после результата: 2 сообщения в терминале, иначе 0.
`--language <lucene\|legacy>`	язык запроса: строгий Lucene или прежний поиск с исправлениями.
`--timezone <zone>`	часовой пояс IANA для границ календарных дат.
`--regex`	слова считаются одним регулярным выражением без учёта регистра для всех сохранённых текстов.

`max messages show`

одно сообщение по чату и идентификатору или указателю msg:

max messages show <chat> [message]

Аргумент		Что это
`chat`	обязательный	чат по идентификатору или части названия; либо msg: без следующего идентификатора сообщения.
`message`	необязательный	идентификатор сообщения.

`max messages context`

сообщение и соседние от старых к новым

max messages context <chat> [message] [options]

Аргумент		Что это
`chat`	обязательный	чат по идентификатору или части названия; либо msg: без следующего идентификатора сообщения.
`message`	необязательный	идентификатор сообщения.

Опция	Что делает
`--before-n <n>`	количество до него. По умолчанию: `5`.
`--after-n <n>`	количество после него. По умолчанию: `5`.

`max messages links`

причина отнесения сообщения к разговору: связи и цепочка ответов к началу

max messages links <chat> <message>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения.

`max messages download`

сохранить фото, файлы, видео и аудио сообщения в каталог

max messages download <chat> <message> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор или часть названия чата.
`message`	обязательный	идентификатор сообщения.

Опция	Что делает
`--output <dir>`	каталог сохранения. По умолчанию: `.`.

`max messages transcribe`

локальное распознавание голосового; запись никуда не отправляется

max messages transcribe <chat> <message> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор или часть названия чата.
`message`	обязательный	идентификатор голосового.

Опция	Что делает
`--model <id>`	скачанная модель; список `max models audio list`.

`max messages send`

отправить текст; без [text] читается из stdin

Изменяет данные MAX.

max messages send <chat> [text] [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`text`	необязательный	текст сообщения.

Опция	Что делает
`--topic <id>`	отправить в тему форума; недоступно мессенджерам без тем.
`--reply-to <message>`	ответить на сообщение по идентификатору в том же чате.
`--send-id <id>`	повторить отправку с неизвестным результатом без риска дубликата.
`--silent`	отправить без уведомления.
`--no-preview`	отключить карточку предпросмотра ссылки.
`--md`	читать Markdown этого мессенджера; поддерживаемый синтаксис — в руководстве по форматированию.
`--file <file>`	прикрепить файл; текст становится подписью.
`--photo <file>`	прикрепить .jpg, .png или .webp как фото; текст становится подписью.
`--as-file`	отправить --file как скачиваемый файл, включая видео.
`--voice <file>`	отправить Ogg Opus как голосовое без текста и других вложений.
`--allow-any-file`	разрешить файл из скрытого каталога, ~/.ssh или каталогов CLI.
`--at-time <time>`	отложить отправку в мессенджере даже при выключенном компьютере: 2026-09-25T09:00 (местное время) или через 30m, 2h, 1d.

`max messages scheduled`

отложенные сообщения от ближайших к поздним; отмена в приложении MAX

max messages scheduled <chat>

Аргумент		Что это
`chat`	обязательный	идентификатор или часть названия чата.

`max messages edit`

изменить своё сообщение; собеседник мог уже прочитать старый текст

Изменяет данные MAX.

max messages edit <chat> <message> [text] [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор своего сообщения.
`text`	необязательный	новый текст; без аргумента читается из stdin.

Опция	Что делает
`--md`	читать Markdown этого мессенджера; поддерживаемый синтаксис — в руководстве по форматированию.

`max messages delete`

удалить сообщения у себя; с --for-everyone — у всех

Изменяет данные MAX.

max messages delete <chat> <messages> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`messages`	обязательный	идентификаторы сообщений, максимум 10.

Опция	Что делает
`--for-everyone`	удалить у всех участников чата; восстановить нельзя.
`--allow-dangerous`	выполнить удаление без подтверждения уровня ask.

`max messages forward`

переслать сообщение в другой чат

Изменяет данные MAX.

max messages forward <chat> <message> [options]

Аргумент		Что это
`chat`	обязательный	исходный чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения.

Опция	Что делает
`--to <chat>`	чат назначения: идентификатор или часть названия.
`--silent`	отправить без уведомления.
`--send-id <id>`	повторить пересылку с неизвестным результатом без риска дубликата.

`max messages pin`

закрепить сообщение тихо, если нет --notify

Изменяет данные MAX.

max messages pin <chat> <message> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения.

Опция	Что делает
`--notify`	уведомить участников о закреплении.

`max messages unpin`

открепить сообщение

Изменяет данные MAX.

max messages unpin <chat> <message>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения.

`max store`

локальная база сообщений

`max store status`

по чатам: число сообщений, крайние даты, полностью сохранённые участки

max store status [chat]

Аргумент		Что это
`chat`	необязательный	чат: идентификатор или часть названия.

`max store fetch`

загрузить историю от новых к старым; повтор продолжает загрузку

max store fetch <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--limit <n>`	максимум сообщений запуска; по умолчанию 1200.
`--page-size <n>`	сообщений на запрос; по умолчанию 30.
`--pause <duration>`	минимальная пауза для лимитов; фактическая до удвоенного значения. По умолчанию: `5s`.
`--since-time <time>`	остановиться у сообщений старше ISO 8601 или 2h / 1d назад.
`--last <n>`	остановиться, когда сохранены последние n сообщений.
`--background`	фоновое задание после завершения команды; следить через `store jobs show`.
`--estimate`	только оценить оставшиеся сообщения, запросы и минуты полной загрузки; по базе, без запросов.

`max store jobs`

фоновые задания загрузки

`max store jobs list`

задания от новых к старым

max store jobs list

`max store jobs show`

задание (по умолчанию последнее) и сохранённые данные его чата

max store jobs show [job]

Аргумент		Что это
`job`	необязательный	идентификатор задания из `store fetch --background`.

`max store jobs cancel`

остановить после текущей страницы; следующая загрузка продолжит

max store jobs cancel <job>

Аргумент		Что это
`job`	обязательный	идентификатор задания.

`max store export`

сохранённые сообщения чата в JSON по строкам, от старых к новым; без запросов

max store export <chat> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.

Опция	Что делает
`--format <format>`	jsonl (по умолчанию): сообщение на строку; markdown: переписка с дневными заголовками и цитатами ответов и пересылок.
`--since-time <time>`	после времени ISO 8601 или 30m / 2h / 1d назад.
`--output <file>`	записать JSON по строкам или переписку в новый закрытый файл.

`max store clear`

удалить покинутые чаты из базы вместе с сообщениями

max store clear [options]

Опция	Что делает
`--left`	только покинутые этим аккаунтом чаты.
`--allow-dangerous`	подтвердить необратимое удаление; историю покинутого чата нельзя загрузить снова.

`max store info`

файл базы: путь, размер, структура, количество строк; без изменений

max store info

`max store check`

проверка целостности, поисковых индексов, диска и отстающих чатов

max store check

`max store migrate`

обновить структуру до текущей версии и нормализовать старые сообщения

max store migrate

`max store reindex`

перестроить словесный индекс и словарь опечаток из базы без потери сообщений

max store reindex

`max store backup`

скопировать работающую базу в новый файл без перезаписи

max store backup <file>

Аргумент		Что это
`file`	обязательный	новый файл.

`max store restore`

восстановить копию вместо базы; заменяемая база сохраняется рядом

max store restore <file>

Аргумент		Что это
`file`	обязательный	файл, созданный `store backup`.

`max conversations`

разговоры в чате по сохранённым ответам, упоминаниям и очередности авторов

`max conversations build`

построить разговоры из базы вместо прошлого результата; без запросов

max conversations build [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.

`max conversations list`

разговоры от новых к старым: время, количество сообщений и участников

max conversations list [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.
`--since-time <time>`	начавшиеся после ISO 8601 или 30m / 2h / 1d назад.
`--limit <n>`	количество.

`max conversations show`

сообщения разговора от старых к новым по его идентификатору или сообщению

max conversations show <conversation> [message]

Аргумент		Что это
`conversation`	обязательный	идентификатор из `conversations list` либо чат по идентификатору/части названия с сообщением.
`message`	необязательный	идентификатор сообщения чата для выбора разговора.

`max conversations search`

ближайшие разговоры по смыслу и словам, лучшие первыми, один или все чаты; смысл после conversations embed; локальное выполнение

max conversations search <query> [options]

Аргумент		Что это
`query`	обязательный	запрос своими словами на поддерживаемом моделью языке.

Опция	Что делает
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.
`--chat <chat>`	только чат: идентификатор или часть названия.
`--since-time <time>`	разговоры, продолжавшиеся после ISO 8601 или 30m / 2h / 1d назад.
`--limit <n>`	количество.

`max conversations batches`

пакеты переписки для вашего AI-агента: на какое раннее сообщение отвечает каждое

`max conversations batches status`

число ожидающих обработки сообщений, пакетов и объём текста

max conversations batches status [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.
`--size <n>`	сообщений на пакет: 10–200, по умолчанию 50.

`max conversations batches next`

следующий пакет с предыдущим контекстом; текст только в stdout

max conversations batches next [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.
`--size <n>`	сообщений на пакет: 10–200, по умолчанию 50.

`max conversations links`

связи агента: на какое раннее сообщение отвечает каждое сообщение пакета

`max conversations links add`

сохранить ответы агента из stdin JSON: { "model", "answers": [{ "message", "parent", "confidence" }] }; атомарно

max conversations links add [options]

Опция	Что делает
`--batch <id>`	идентификатор пакета из `conversations batches next`.

`max conversations links clear`

удалить связи агента для чата или модели без изменения сообщений

max conversations links clear [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.
`--model <model>`	только ответы данной модели.

`max conversations embed`

векторизовать фрагменты разговоров локально или через --provider со своим ключом; повтор продолжает работу

max conversations embed [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.
`--workers <n>`	локально: параллельные сессии с отдельной моделью (~0.7 ГБ каждая).
`--threads <n>`	локально: общее число потоков (по умолчанию min(8, cores)).
`--concurrency <n>`	удалённо: параллельные запросы (по умолчанию 4).
`--max-tokens <n>`	удалённо: не запускать задачу, превышающую лимит токенов.

`max conversations embed status`

число готовых и оставшихся векторов модели и стоимость остатка

max conversations embed status [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.

`max conversations embed clear`

удалить векторы чата или модели без изменения сообщений и разговоров

max conversations embed clear [options]

Опция	Что делает
`--chat <chat>`	чат: идентификатор или часть названия.
`--model <model>`	локально: идентификатор из `models text list` (по умолчанию e5-small); удалённо: модель сервиса.
`--provider <provider>`	векторизация через сервис со своим ключом вместо локальной: openai.
`--base-url <url>`	сервер с OpenAI /v1/embeddings: Gemini, Jina, локальные Ollama или LM Studio.
`--dims <n>`	размер вектора сервиса; нужен с --base-url, уменьшает вектор модели OpenAI.

`max models`

модели, работающие на компьютере

`max models audio`

модели распознавания голосовых сообщений

`max models audio list`

модели распознавания, сначала наиболее подходящие; какие скачаны и какая выбрана по умолчанию

max models audio list

`max models audio download`

однократно скачать модель с проверкой ожидаемого текущей версией sha256

max models audio download <model>

Аргумент		Что это
`model`	обязательный	идентификатор из `models audio list`.

`max models text`

модели векторизации для поиска разговоров по смыслу

`max models text list`

модели от наиболее подходящих, наличие загрузки и выбор по умолчанию

max models text list

`max models text download`

однократно скачать модель с проверкой ожидаемого sha256

max models text download <model> [options]

Аргумент		Что это
`model`	обязательный	идентификатор из `models text list`.

Опция	Что делает
`--accept-terms`	принять собственные лицензионные условия модели.

`max models text key`

ключ сервиса векторизации для conversations embed --provider

`max models text key set`

сохранить ключ через скрытый ввод или stdin, никогда аргументом

max models text key set <provider>

Аргумент		Что это
`provider`	обязательный	openai или хост сервера --base-url, требующего ключ.

`max models text key remove`

удалить сохранённый ключ

max models text key remove <provider>

Аргумент		Что это
`provider`	обязательный	openai или хост сервера.

`max polls`

прочитать опрос, проголосовать, закрыть свой или создать

`max polls show`

опрос и идентификаторы ответов из текущего сообщения

max polls show <chat> <message>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения с опросом.

`max polls vote`

проголосовать или отозвать голос; виден другим, если опрос не анонимный

Изменяет данные MAX.

max polls vote <chat> <message> [answers] [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения с опросом.
`answers`	необязательный	идентификаторы ответов из `polls show`.

Опция	Что делает
`--retract`	отозвать голос.

`max polls close`

закрыть свой опрос; больше нельзя голосовать или открыть его снова

Изменяет данные MAX.

max polls close <chat> <message>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор своего сообщения с опросом.

`max polls create`

отправить опрос отдельным сообщением; публичный без --anonymous

Изменяет данные MAX.

max polls create <chat> <question> <answers> [options]

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`question`	обязательный	вопрос.
`answers`	обязательный	минимум два ответа.

Опция	Что делает
`--topic <id>`	отправить в тему форума; недоступно мессенджерам без тем.
`--multiple`	разрешить несколько вариантов.
`--anonymous`	скрыть, кто как голосовал.
`--revote`	разрешить менять голос.
`--silent`	отправить без уведомления.
`--send-id <id>`	повторить создание с неизвестным результатом без второго опроса.

`max reactions`

реакции на сообщения

`max reactions add`

поставить реакцию, заменив предыдущую

Изменяет данные MAX.

max reactions add <chat> <message> <emoji>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения.
`emoji`	обязательный	один эмодзи, например 👍.

`max reactions remove`

убрать свою реакцию

Изменяет данные MAX.

max reactions remove <chat> <message>

Аргумент		Что это
`chat`	обязательный	чат: идентификатор или часть названия.
`message`	обязательный	идентификатор сообщения.

`max recipients`

чаты, куда профилю разрешено отправлять при включённом списке

`max recipients list`

разрешённые чаты; пусто и отключено до первого добавления

max recipients list

`max recipients add`

разрешить отправку в чат; первое добавление включает ограничения

Меняет что-то только на этом компьютере.

max recipients add <chat>

Аргумент		Что это
`chat`	обязательный	идентификатор или часть названия чата.

`max recipients remove`

запретить чат; список остаётся включённым

Меняет что-то только на этом компьютере.

max recipients remove <chat>

Аргумент		Что это
`chat`	обязательный	идентификатор или название из списка.

`max recipients clear`

очистить и отключить список: снова разрешены все чаты

Меняет что-то только на этом компьютере.

max recipients clear

`max sends`

все попытки отправки профиля, без текста

`max sends list`

попытки от новых к старым: отправлено, отклонено, ошибка, неизвестно

max sends list [options]

Опция	Что делает
`--limit <n>`	количество результатов.

`max inbox`

чужие непрочитанные во всех чатах; --new — после последней проверки

max inbox [options]

Опция	Что делает
`--new`	новые после проверки, каждое один раз; для расписания.
`--since-time <time>`	после времени ISO 8601 или 2h / 1d назад; позиция не меняется.
`--limit <n>`	максимум на чат, самые новые.
`--all`	включить чаты без уведомлений и архив; иначе только упоминания и ответы вам.
`--transcribe`	распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты.
`--model <id>`	скачанная модель для --transcribe; список в `models audio list`.

`max review`

все сообщения, включая ваши, в чатах с изменениями после границы; для анализа обязательств

max review [options]

Опция	Что делает
`--since-time <time>`	конец прошлой проверки: ISO 8601 или 2h / 1d назад; по умолчанию три дня.
`--chat <chat>`	только чат: идентификатор или часть названия.
`--unanswered [duration]`	вопросы вам или администраторам без ответа старше срока: 4h, 1d; по умолчанию 24h.
`--all`	включить чаты без уведомлений и архив; иначе только упоминания и ответы вам.
`--transcribe`	распознать ещё не обработанные голосовые через мессенджер или локальную модель; может занять минуты.
`--model <id>`	скачанная модель для --transcribe; список в `models audio list`.

`max serve`

соединение MAX и поток сообщений в max watch до Ctrl-C

max serve [options]

Опция	Что делает
`--idle <duration>`	остановка при отсутствии клиентов: 15m, 1h равно 60m.

`max server`

max serve в фоне: запуск, остановка, перезапуск, состояние, журнал; install добавляет systemd или launchd

`max server start`

запустить serve в фоне, через установленную службу, и ответить после подключения

max server start [options]

Опция	Что делает
`--idle <duration>`	остановка при отсутствии клиентов: 15m, 1h.

`max server stop`

остановить serve профиля, через службу, если используется

max server stop

`max server restart`

остановить и запустить снова

max server restart [options]

Опция	Что делает
`--idle <duration>`	остановка при отсутствии клиентов: 15m, 1h.

`max server status`

работает ли serve, с какого времени, кто запустил и какая служба используется

max server status

`max server logs`

последние строки serve из журнала systemd или файла

max server logs [options]

Опция	Что делает
`-n, --lines <n>`	количество строк. По умолчанию: `50`.

`max server install`

создать службу systemd или агент launchd профиля; ничего не запускает

max server install

`max server uninstall`

удалить службу профиля; сначала остановите

max server uninstall

`max watch`

новые сообщения от работающего max serve

max watch [options]

Опция	Что делает
`--events`	также правки, удаления и реакции; строка содержит тип события.

`max config`

действующие настройки и источники значений

`max config show`

профиль, существующие профили, настройки и их источники

max config show [options]

Опция	Что делает
`--bot`	настройки `max bot` профиля вместо личного аккаунта.

`max config set`

сохранить настройку в файл

Меняет что-то только на этом компьютере.

max config set <setting> <value> [options]

Аргумент		Что это
`setting`	обязательный	одно из: limit, timeoutMs, color, record, keepRunsForDays, readOnly, allow, sendsPerHour, senderColors, serve, mcpTools, readOtherBots, updateCheck, skillHint, transcribeModel, defaultProfile.
`value`	обязательный	число, true, false или список allow, например send,reaction.

Опция	Что делает
`--defaults`	общая настройка всех профилей вместо текущего.
`--personal`	только личные аккаунты: соответствующий раздел файла.
`--bot`	только боты: раздел bot файла.

`max config unset`

удалить настройку из файла

Меняет что-то только на этом компьютере.

max config unset <setting> [options]

Аргумент		Что это
`setting`	обязательный	одно из: limit, timeoutMs, color, record, keepRunsForDays, readOnly, allow, sendsPerHour, senderColors, serve, mcpTools, readOtherBots, updateCheck, skillHint, transcribeModel, defaultProfile.

Опция	Что делает
`--defaults`	общая настройка всех профилей вместо текущего.
`--personal`	только личные аккаунты: соответствующий раздел файла.
`--bot`	только боты: раздел bot файла.

`max doctor`

состояние установки без подключения к MAX, кроме --online

max doctor [options]

Опция	Что делает
`--online`	войти один раз, прочитать чат и запустить MCP; без отправки.

`max doctor report`

содержимое и расположение отчёта без записи

`max doctor report create`

записать отчёт и показать способ отправки

max doctor report create [options]

Опция	Что делает
`--run <id>`	запуск для отчёта; по умолчанию последний неудачный.
`--output <file>`	путь записи; по умолчанию новый файл здесь.

`max runs`

записи запусков: действия инструмента и время

`max runs list`

записи от новых к старым

max runs list [options]

Опция	Что делает
`--limit <n>`	количество результатов. По умолчанию: `20`.

`max runs show`

один запуск: что выполнялось, с отдельной строкой для каждой операции

max runs show <run-id>

Аргумент		Что это
`run-id`	обязательный	идентификатор из `max runs list`.

`max runs path`

каталог запуска

max runs path <run-id>

Аргумент		Что это
`run-id`	обязательный	идентификатор из `max runs list`.

`max skill`

инструкции агенту по инструменту

`max skill show`

вывести SKILL.md; max skill install устанавливает для Claude Code, Codex и Gemini CLI

max skill show [name]

Аргумент		Что это
`name`	необязательный	один из навыков для отдельной задачи: link-conversations.

`max skill install`

записать SKILL.md в ~/.claude/skills/tg-cli/ (Claude Code) и ~/.agents/skills/tg-cli/ (Codex, Gemini CLI)

max skill install [options]

Опция	Что делает
`--for <agents>`	агенты: `claude`, `agents`, `all`. По умолчанию: `all`.

`max commands`

команды, параметры и коды JSON для агента вместо --help

max commands

`max upgrade`

обновить tg установившим его менеджером пакетов; --check только проверяет

max upgrade [options]

Опция	Что делает
`--check`	проверить новую версию без установки.

`max complete`

автодополнение: max complete zsh выводит подключаемый скрипт

max complete [words]

Аргумент		Что это
`words`	необязательный

`max mcp`

доступ агента к профилю через MCP по stdin/stdout: claude mcp add max -- max mcp

max mcp [options]

Опция	Что делает
`--allow-send`	добавить отправку; без параметра сервер только читает.
`--confirm-send`	форма перед всеми предлагаемыми изменениями: отправками, правками, реакциями, mcpTools.
`--allow-mark-read`	инструмент отметки прочитанным; собеседник видит прочтение.
`--allow-delete`	инструмент необратимого удаления только у себя.
`--allow-moderate`	разрешить max_chats_check действовать по правилам группы: удалять чужие сообщения/участников, если разрешено.

`max mcp config`

вывести mcpServers для Claude Desktop, Cursor и других с полными путями; без записи

max mcp config [options]

Опция	Что делает
`--allow-send`	добавить отправку; без параметра сервер только читает.
`--confirm-send`	форма перед всеми предлагаемыми изменениями: отправками, правками, реакциями, mcpTools.
`--allow-mark-read`	инструмент отметки прочитанным; собеседник видит прочтение.
`--allow-delete`	инструмент необратимого удаления только у себя.
`--allow-moderate`	разрешить max_chats_check действовать по правилам группы: удалять чужие сообщения/участников, если разрешено.

`max mcp setup`

подключить локальный MCP профиля к Codex или Claude Code

Меняет что-то только на этом компьютере.

max mcp setup <client> [options]

Аргумент		Что это
`client`	обязательный	codex или claude-code.

Опция	Что делает
`--allow-writes`	подтвердить наличие инструментов изменения у профиля.
`--allow-send`	добавить отправку; без параметра сервер только читает.
`--confirm-send`	форма перед всеми предлагаемыми изменениями: отправками, правками, реакциями, mcpTools.
`--allow-mark-read`	инструмент отметки прочитанным; собеседник видит прочтение.
`--allow-delete`	инструмент необратимого удаления только у себя.
`--allow-moderate`	разрешить max_chats_check действовать по правилам группы: удалять чужие сообщения/участников, если разрешено.

`max mcp doctor`

проверить локальное соединение MCP и список инструментов

max mcp doctor [options]

Опция	Что делает
`--allow-send`	добавить отправку; без параметра сервер только читает.
`--confirm-send`	форма перед всеми предлагаемыми изменениями: отправками, правками, реакциями, mcpTools.
`--allow-mark-read`	инструмент отметки прочитанным; собеседник видит прочтение.
`--allow-delete`	инструмент необратимого удаления только у себя.
`--allow-moderate`	разрешить max_chats_check действовать по правилам группы: удалять чужие сообщения/участников, если разрешено.

`max bot`

бот MAX через официальный Bot API и токен, отдельно от личного аккаунта

`max bot auth`

токен бота профиля

`max bot auth set`

проверить токен в MAX и сохранить: скрытый ввод или stdin

Меняет что-то только на этом компьютере.

max bot auth set

`max bot auth show`

источник токена и сведения о боте

max bot auth show

`max bot auth remove`

удалить токен профиля

Меняет что-то только на этом компьютере.

max bot auth remove

`max bot list`

имена ботов на компьютере; --check запрашивает сведения MAX

max bot list [options]

Опция	Что делает
`--check`	запросить сведения о каждом боте в мессенджере с его токеном.

`max bot chats`

чаты бота; MAX не предоставляет список, поэтому list показывает увиденные

`max bot chats list`

чаты, увиденные на компьютере; список MAX может быть неполным

max bot chats list

`max bot chats show`

получить чат MAX и запомнить

max bot chats show <chat>

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.

`max bot chats leave`

вывести бота из чата; вернуть сможет только администратор

Изменяет данные MAX.

max bot chats leave <chat>

Аргумент		Что это
`chat`	обязательный	идентификатор или название увиденного чата.

`max bot chats action`

показать действие бота на несколько секунд: печатает, отправляет фото

Изменяет данные MAX.

max bot chats action <chat> <action>

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.
`action`	обязательный	действие: `typing`, `photo`, `video`, `voice`, `file`.

`max bot chats admins`

администраторы чата, где бот администратор

`max bot chats admins list`

администраторы и их права

max bot chats admins list <chat>

Аргумент		Что это
`chat`	обязательный	идентификатор или название увиденного чата.

`max bot chats admins add`

назначить участника администратором с заданными правами

Изменяет данные MAX.

max bot chats admins add <chat> <person> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор или название увиденного чата.
`person`	обязательный	идентификатор пользователя.

Опция	Что делает
`--can <rights>`	права через запятую: read, members, admins, info, pin, link, edit, delete.
`--title <title>`	титул рядом с именем.

`max bot chats admins remove`

снять права администратора; человек остаётся участником

Изменяет данные MAX.

max bot chats admins remove <chat> <person>

Аргумент		Что это
`chat`	обязательный	идентификатор или название увиденного чата.
`person`	обязательный	идентификатор пользователя.

`max bot chats members`

участники чата, где бот администратор

`max bot chats members remove`

удалить участника; сообщения сохраняются

Изменяет данные MAX.

max bot chats members remove <chat> <person> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор или название увиденного чата.
`person`	обязательный	идентификатор пользователя.

Опция	Что делает
`--block`	также запретить возвращение по ссылке.

`max bot chats members list`

участники постранично; --marker принимает marker предыдущей страницы

max bot chats members list <chat> [options]

Аргумент		Что это
`chat`	обязательный

Опция	Что делает
`--limit <n>`	количество, максимум 100.
`--marker <marker>`	продолжить отсюда.

`max bot chats members add`

добавить по идентификаторам; бот должен быть администратором с правом добавления

Изменяет данные MAX.

max bot chats members add <chat> <users>

Аргумент		Что это
`chat`	обязательный
`users`	обязательный

`max bot chats rules`

локальные правила модерации чата для бота

`max bot chats rules show`

правила чата; если не сохранены, исходные значения с отметкой

max bot chats rules show <chat>

Аргумент		Что это
`chat`	обязательный	идентификатор группы или название увиденной группы.

`max bot chats rules set`

изменить правило: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove

Меняет что-то только на этом компьютере.

max bot chats rules set <chat> <key> <value>

Аргумент		Что это
`chat`	обязательный	идентификатор группы или название увиденной группы.
`key`	обязательный	правило.
`value`	обязательный	новое значение.

`max bot chats rules unset`

вернуть правило к значению по умолчанию

Меняет что-то только на этом компьютере.

max bot chats rules unset <chat> <key>

Аргумент		Что это
`chat`	обязательный	идентификатор группы или название увиденной группы.
`key`	обязательный	правило.

`max bot chats moderate`

проверить новые сообщения и вступления по правилам группы и выполнить разрешённое от бота

Изменяет данные MAX.

max bot chats moderate <chat> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор группы или название увиденной группы.

Опция	Что делает
`--since-time <time>`	проверить после времени ISO 8601 или 2h / 1d назад; сохранённая позиция не меняется.
`--dry-run`	проверить и составить план без действий.
`--allow-dangerous`	подтвердить все действия с уровнем ask в правилах группы.
`--no-ban`	удалить без блокировки; по умолчанию возвращение по ссылке запрещено.
`--max-actions <n>`	максимум действий за запуск; по умолчанию 10.

`max bot messages`

сообщения в чатах бота

`max bot messages send`

отправить от бота; без [text] — stdin

Изменяет данные MAX.

max bot messages send <chat> [text] [options]

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.
`text`	необязательный	текст сообщения.

Опция	Что делает
`--reply-to <message>`	ответить на сообщение по идентификатору в том же чате.
`--silent`	отправить без уведомления.
`--md`	читать Markdown этого мессенджера; поддерживаемый синтаксис — в руководстве по форматированию.
`--html`	HTML-текст: , , , .
`--file <file>`	прикрепить файл; текст становится подписью.
`--photo <file>`	прикрепить .jpg, .png или .webp как фото; текст становится подписью.
`--as-file`	отправить --file как скачиваемый файл, включая видео.
`--voice <file>`	отправить Ogg Opus как голосовое без текста и других вложений.
`--allow-any-file`	разрешить файл из скрытого каталога, ~/.ssh или каталогов CLI.

`max bot messages list`

последние сообщения; без истории MAX или с --offline — увиденное ботом на компьютере

max bot messages list <chat> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.

Опция	Что делает
`--limit <n>`	количество последних.

`max bot messages show`

одно сообщение по идентификатору в чате

max bot messages show <chat> <message>

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.
`message`	обязательный	идентификатор сообщения.

`max bot messages edit`

заменить текст сообщения бота

Изменяет данные MAX.

max bot messages edit <chat> <message> <text> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.
`message`	обязательный	идентификатор сообщения.
`text`	обязательный	новый текст.

Опция	Что делает
`--md`	читать Markdown этого мессенджера; поддерживаемый синтаксис — в руководстве по форматированию.
`--html`	HTML-текст: , , , .

`max bot messages delete`

удалить сообщения в доступном боту чате; необратимо

Изменяет данные MAX.

max bot messages delete <chat> <messages> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.
`messages`	обязательный	идентификаторы сообщений.

Опция	Что делает
`--allow-dangerous`	удалить без подтверждения.

`max bot messages pin`

закрепить тихо, если нет --notify

Изменяет данные MAX.

max bot messages pin <chat> <message> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.
`message`	обязательный	идентификатор сообщения.

Опция	Что делает
`--notify`	уведомить участников.

`max bot messages unpin`

открепить сообщение

Изменяет данные MAX.

max bot messages unpin <chat> <message>

Аргумент		Что это
`chat`	обязательный	идентификатор чата, user: или название увиденного чата.
`message`	обязательный	идентификатор сообщения.

`max bot messages search`

поиск локально прочитанного, отправленного и полученного ботом; лучшие совпадения первыми, все слова; "фраза", -слово, a OR b, from: chat: after: before: has:; текст, --from или оба

max bot messages search [query] [options]

Аргумент		Что это
`query`	необязательный	искомые слова.

Опция	Что делает
`--all-bots`	также копии всех других ботов, разрешённые readOtherBots.
`--bots <profiles>`	также копии указанных через запятую ботов с разрешением readOtherBots.
`--limit <n>`	количество.
`--newest`	сначала новые вместо наиболее подходящих.
`--from <who>`	только автор: идентификатор, @username или часть имени; повторите для нескольких.

`max bot messages between`

сообщения двух и более людей в чатах, где писали все, из локальной базы по чатам от старых к новым; --limit для каждого чата. Общие чаты определяются по сообщениям, а не списку участников MAX

max bot messages between <people> [options]

Аргумент		Что это
`people`	обязательный	два или более человека по идентификатору, @username или части имени.

Опция	Что делает
`--all-bots`	также копии всех других ботов, разрешённые readOtherBots.
`--bots <profiles>`	также копии указанных через запятую ботов с разрешением readOtherBots.
`--limit <n>`	число последних сообщений каждого чата.

`max bot recipients`

разрешённые чаты бота; без списка — все; clear удаляет список

`max bot recipients list`

разрешённые чаты или пусто без списка

max bot recipients list

`max bot recipients add`

разрешить чат: идентификатор, user:<id> или название увиденного чата

Меняет что-то только на этом компьютере.

max bot recipients add <chat>

Аргумент		Что это
`chat`	обязательный

`max bot recipients remove`

убрать чат из списка

Меняет что-то только на этом компьютере.

max bot recipients remove <chat>

Аргумент		Что это
`chat`	обязательный

`max bot recipients clear`

удалить список: снова разрешены все чаты

Меняет что-то только на этом компьютере.

max bot recipients clear

`max bot sends`

отправки, правки и удаления бота с компьютера: идентификаторы и результат, без текста

`max bot sends list`

max bot sends list

`max bot watch`

выводить и сохранять новые сообщения до Ctrl-C или --timeout; оба завершают штатно

max bot watch [options]

Опция	Что делает
`--events`	также правки, удаления, нажатия кнопок, вступления и выходы; строки имеют тип события.
`--types <types>`	типы обновлений через запятую в обозначениях мессенджера.

`max bot callbacks`

ответы на нажатия кнопок под сообщениями бота

`max bot callbacks answer`

ответить по callback: --notification — разовое уведомление человеку, --text — замена сообщения кнопки

Изменяет данные MAX.

max bot callbacks answer <callback> [options]

Аргумент		Что это
`callback`	обязательный	идентификатор callback из `bot watch`.

Опция	Что делает
`--text <text>`	новый текст сообщения.
`--notification <text>`	уведомление только нажавшему кнопку.

`max bot commands`

меню команд бота после /

`max bot commands list`

текущие команды меню

max bot commands list

`max bot commands set`

заменить меню: команда как name=description, например start=Begin

Изменяет данные MAX.

max bot commands set <commands>

Аргумент		Что это
`commands`	обязательный	name=description для каждой команды.

`max bot commands clear`

очистить меню

Изменяет данные MAX.

max bot commands clear

`max bot webhooks`

адрес обновлений бота; пока задан, bot watch ничего не получает

`max bot webhooks list`

вебхуки бота

max bot webhooks list

`max bot webhooks set`

передавать обновления на HTTPS-адрес; запрещено при другом вебхуке

Изменяет данные MAX.

max bot webhooks set <url> [options]

Аргумент		Что это
`url`	обязательный	HTTPS-адрес.

Опция	Что делает
`--types <types>`	типы обновлений через запятую в обозначениях мессенджера.
`--secret-stdin`	секрет для каждого обновления; ввод по запросу или stdin.
`--add`	сохранить прежние вебхуки и добавить ещё один.

`max bot webhooks delete`

отключить адрес; без вебхуков bot watch снова работает

Изменяет данные MAX.

max bot webhooks delete <url>

Аргумент		Что это
`url`	обязательный	адрес.

`max bot contacts`

увиденные ботом авторы из локальной базы; MAX запрашивается только явно

`max bot contacts show`

человек: чаты, где писал, последнее сообщение там, недавние сообщения личного чата с ботом

max bot contacts show <who> [options]

Аргумент		Что это
`who`	обязательный	идентификатор, @username или часть имени.

Опция	Что делает
`--all-bots`	также копии всех других ботов, разрешённые readOtherBots.
`--bots <profiles>`	также копии указанных через запятую ботов с разрешением readOtherBots.
`--limit <n>`	количество сообщений личного чата.
`--refresh`	сначала перечитать личный чат через мессенджер одним запросом.

`max bot store`

локальная копия бота

`max bot store fetch`

загрузить историю от новых к старым; повтор продолжает

max bot store fetch <chat> [options]

Аргумент		Что это
`chat`	обязательный	идентификатор или название увиденного чата.

Опция	Что делает
`--limit <n>`	максимум сообщений за запуск; по умолчанию 1000.
`--page-size <n>`	сообщений за запрос; по умолчанию 100.
`--pause <duration>`	пауза между страницами для соблюдения лимитов. По умолчанию: `1s`.
`--since-time <time>`	остановиться у сообщений старше ISO 8601 или 2h / 1d назад.
`--last <n>`	остановиться, когда сохранены последние n сообщений.

`max bot mcp`

доступ агента к боту через MCP по stdin/stdout: claude mcp add sales-bot -- max sales bot mcp

max bot mcp [options]

Опция	Что делает
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-delete`	устарел: решение принимает профиль.
`--allow-moderate`	устарел: решение принимает профиль.

`max bot mcp config`

вывести mcpServers для Claude Desktop, Cursor и других с полными путями; без записи

max bot mcp config [options]

Опция	Что делает
`--confirm-send`	показывать владельцу каждое изменение формой сервера.
`--allow-dangerous`	без формы перед удалением уровня ask.
`--allow-send`	устарел: решение принимает профиль; сохранён для запуска старых настроек.
`--allow-delete`	устарел: решение принимает профиль.
`--allow-moderate`	устарел: решение принимает профиль.

`max bot me`

бот текущего токена: имя, идентификатор, описание, команды

max bot me

`max bot comments`

комментарии к посту канала; первый аргумент — идентификатор поста mid.…

`max bot comments list`

комментарии от старых к новым

max bot comments list <message> [options]

Аргумент		Что это
`message`	обязательный

Опция	Что делает
`--limit <n>`	количество, максимум 100.

`max bot comments get`

комментарий к посту

max bot comments get <message> <comment>

Аргумент		Что это
`message`	обязательный
`comment`	обязательный

`max bot comments send`

написать комментарий ботом; - читает stdin

Изменяет данные MAX.

max bot comments send <message> <text> [options]

Аргумент		Что это
`message`	обязательный
`text`	обязательный

Опция	Что делает
`--format <format>`	разметка. Одно из: `markdown`, `html`.

`max bot comments edit`

изменить свой комментарий; - читает stdin

Изменяет данные MAX.

max bot comments edit <message> <comment> <text> [options]

Аргумент		Что это
`message`	обязательный
`comment`	обязательный
`text`	обязательный

Опция	Что делает
`--format <format>`	разметка. Одно из: `markdown`, `html`.

`max bot comments delete`

удалить комментарий

Изменяет данные MAX.

max bot comments delete <message> <comment>

Аргумент		Что это
`message`	обязательный
`comment`	обязательный

`max bot uploads`

загруженные в MAX файлы для вложений

`max bot uploads put`

загрузить локальный файл и вывести объект для attachments; messages send --file делает оба шага

Изменяет данные MAX.

max bot uploads put <file> [options]

Аргумент		Что это
`file`	обязательный

Опция	Что делает
`--type <type>`	явный тип вместо определения по расширению. Одно из: `image`, `video`, `audio`, `file`.

`max bot api`

все операции официального Bot API из его схемы; docs/dev/bot-api-coverage.md

max bot api [options]

Опция	Что делает
`--store-token <profile>`	сохранить возвращённый токен аутентификации только в ключнице ОС этого профиля бота; никогда не печатать его.

`max bot api get-my-info`

Сведения о боте — чтение (GET /me)

max bot api get-my-info

`max bot api edit-my-commands`

Изменить команды бота — запись (PATCH /me/commands)

Изменяет данные MAX.

max bot api edit-my-commands [options]

Опция	Что делает
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api get-chat`

Получить чат — чтение (GET /chats/{chatId})

max bot api get-chat [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор запрашиваемого чата или канала.

`max bot api edit-chat`

Изменить чат или канал — запись (PATCH /chats/{chatId})

Изменяет данные MAX.

max bot api edit-chat [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api send-action`

Показать действие — запись (POST /chats/{chatId}/actions)

Изменяет данные MAX.

max bot api send-action [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api get-pinned-message`

Получить закреплённое сообщение — чтение (GET /chats/{chatId}/pin)

max bot api get-pinned-message [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата для получения закрепления.

`max bot api pin-message`

Закрепить сообщение — запись (PUT /chats/{chatId}/pin)

Изменяет данные MAX.

max bot api pin-message [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата для закрепления.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api unpin-message`

Открепить сообщение — запись (DELETE /chats/{chatId}/pin)

Изменяет данные MAX.

max bot api unpin-message [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата для удаления закрепления.

`max bot api get-membership`

Получить членство в чате или канале — чтение (GET /chats/{chatId}/members/me)

max bot api get-membership [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.

`max bot api leave-chat`

Выйти из чата — необратимое действие (DELETE /chats/{chatId}/members/me)

Изменяет данные MAX.

max bot api leave-chat [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.

`max bot api get-admins`

Получить администраторов — чтение (GET /chats/{chatId}/members/admins)

max bot api get-admins [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.

`max bot api post-admins`

Назначить администраторов — запись (POST /chats/{chatId}/members/admins)

Изменяет данные MAX.

max bot api post-admins [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api delete-admins`

Снять права администратора — запись (DELETE /chats/{chatId}/members/admins/{userId})

Изменяет данные MAX.

max bot api delete-admins [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.
`--user-id <value>`	Идентификатор пользователя.

`max bot api get-members`

Получить участников — чтение (GET /chats/{chatId}/members)

max bot api get-members [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.
`--user-ids <value>`	Идентификаторы пользователей через запятую. При наличии этого параметра `count` и `marker` игнорируются.
`--marker <value>`	Маркер.
`--count <value>`	Количество.

`max bot api add-members`

Добавить участников — запись (POST /chats/{chatId}/members)

Изменяет данные MAX.

max bot api add-members [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api remove-member`

Удалить участника — запись (DELETE /chats/{chatId}/members)

Изменяет данные MAX.

max bot api remove-member [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала.
`--user-id <value>`	Идентификатор удаляемого участника чата или канала.
`--block <value>`	`true` блокирует пользователя в чате.

`max bot api get-subscriptions`

Получить подписки — чтение (GET /subscriptions)

max bot api get-subscriptions

Подписаться — запись (POST /subscriptions)

Изменяет данные MAX.

max bot api subscribe [options]

Опция	Что делает
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api unsubscribe`

Отписаться — запись (DELETE /subscriptions)

Изменяет данные MAX.

max bot api unsubscribe [options]

Опция	Что делает
`--url <value>`	URL удаляемой подписки WebHook.

`max bot api get-upload-url`

Получить URL загрузки — запись (POST /uploads)

Изменяет данные MAX.

max bot api get-upload-url [options]

Опция	Что делает
`--type <value>`	Тип файла: image, audio, video, file.

`max bot api get-messages`

Получить сообщения — чтение (GET /messages)

max bot api get-messages [options]

Опция	Что делает
`--chat-id <value>`	Идентификатор чата или канала для получения сообщений.
`--message-ids <value>`	Идентификаторы сообщений через запятую.
`--from <value>`	Начальное время; используйте after.
`--to <value>`	Конечное время; используйте before.
`--before <value>`	Сообщения до временной метки.
`--after <value>`	Сообщения после временной метки.
`--count <value>`	Максимум сообщений в ответе.

`max bot api send-message`

Отправить сообщение — запись (POST /messages)

Изменяет данные MAX.

max bot api send-message [options]

Опция	Что делает
`--user-id <value>`	Задайте для отправки пользователю.
`--chat-id <value>`	Задайте для отправки в чат или канал.
`--disable-link-preview <value>`	`false` отключает предпросмотр ссылок в тексте.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api edit-message`

Изменить сообщение — запись (PUT /messages)

Изменяет данные MAX.

max bot api edit-message [options]

Опция	Что делает
`--message-id <value>`	Идентификатор редактируемого сообщения.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api delete-message`

Удалить сообщение — необратимое действие (DELETE /messages)

Изменяет данные MAX.

max bot api delete-message [options]

Опция	Что делает
`--message-id <value>`	Идентификатор удаляемого сообщения.

`max bot api get-message-by-id`

Получить сообщение — чтение (GET /messages/{messageId})

max bot api get-message-by-id [options]

Опция	Что делает
`--message-id <value>`	Идентификатор сообщения (`mid`) для чтения в чате или канале.

`max bot api get-comments`

Получить комментарии — чтение (GET /messages/{messageId}/comments)

max bot api get-comments [options]

Опция	Что делает
`--message-id <value>`	Идентификатор комментируемого сообщения (`mid`).
`--comment-ids <value>`	Идентификаторы комментариев через запятую.
`--before <value>`	Комментарии до временной метки.
`--after <value>`	Комментарии после временной метки.
`--count <value>`	Максимум комментариев в ответе.

`max bot api send-comment`

Отправить комментарий — запись (POST /messages/{messageId}/comments)

Изменяет данные MAX.

max bot api send-comment [options]

Опция	Что делает
`--message-id <value>`	Идентификатор комментируемого сообщения (`mid`).
`--disable-link-preview <value>`	`false` отключает предпросмотр ссылок в тексте.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api edit-comment`

Изменить комментарий — запись (PUT /messages/{messageId}/comments)

Изменяет данные MAX.

max bot api edit-comment [options]

Опция	Что делает
`--message-id <value>`	Идентификатор комментируемого сообщения (`mid`).
`--comment-id <value>`	Идентификатор редактируемого комментария.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api delete-comment`

Удалить комментарий — необратимое действие (DELETE /messages/{messageId}/comments)

Изменяет данные MAX.

max bot api delete-comment [options]

Опция	Что делает
`--message-id <value>`	Идентификатор комментируемого сообщения (`mid`).
`--comment-id <value>`	Идентификатор удаляемого комментария.

`max bot api get-comment-by-id`

Получить комментарий — чтение (GET /messages/{messageId}/comments/{commentId})

max bot api get-comment-by-id [options]

Опция	Что делает
`--message-id <value>`	Идентификатор комментируемого сообщения (`mid`).
`--comment-id <value>`	Идентификатор комментария (`mid`) для чтения в канале.

`max bot api get-video-attachment-details`

Получить сведения о видео — чтение (GET /videos/{videoToken})

max bot api get-video-attachment-details [options]

Опция	Что делает
`--video-token <value>`	Токен вложения видео.

`max bot api answer-on-callback`

Ответить на callback — запись (POST /answers)

Изменяет данные MAX.

max bot api answer-on-callback [options]

Опция	Что делает
`--callback-id <value>`	Идентификатор нажатой кнопки, полученный ботом в `MessageCallbackUpdate`.
`--disable-link-preview <value>`	`true` отключает предпросмотр ссылок в обновлённом тексте.
`--body <json>`	тело запроса JSON; - читает stdin.
`--body-file <path>`	тело из JSON-файла; - означает stdin.

`max bot api get-updates`

Получить обновления — запись (GET /updates)

Изменяет данные MAX.

max bot api get-updates [options]

Опция	Что делает
`--limit <value>`	Максимум обновлений в ответе.
`--poll-timeout <value>`	Таймаут долгого опроса в секундах.
`--marker <value>`	`null` запрашивает ещё не полученные обновления.
`--types <value>`	Типы обновлений через запятую.

Коды возврата

Скрипт ветвится по коду, а не по тексту: текст меняется, код — нет.

Код	Когда
`0`	получилось
`2`	`validation_error`
`3`	`configuration_error`
`4`	`authentication_error`
`5`	`permission_error`
`6`	`not_found`
`7`	`confirmation_required`
`8`	`rate_limited`
`9`	`timeout`
`10`	`network_error`
`11`	`provider_error`
`12`	`provider_unavailable`
`13`	`invalid_response`
`14`	`outcome_unknown`
`130`	`cancelled`
`1`	всё остальное

0 и только 0 означает, что операция выполнена. 14 — outcome_unknown — означает, что сообщение могло уйти: не отправлено и не провалено, и повторять его можно только с тем же --send-id.

Общие опцииCopy Anchor Link

max sessionCopy Anchor Link

max session startCopy Anchor Link

max session endCopy Anchor Link

max setupCopy Anchor Link

max accountCopy Anchor Link

max account showCopy Anchor Link

max account updateCopy Anchor Link

max account sessionsCopy Anchor Link

max account sessions listCopy Anchor Link

max account sessions endCopy Anchor Link

max chatsCopy Anchor Link

max chats listCopy Anchor Link

max chats showCopy Anchor Link

max chats eventsCopy Anchor Link

max chats inspectCopy Anchor Link

max chats joinCopy Anchor Link

max chats mark-readCopy Anchor Link

max chats leaveCopy Anchor Link

max chats createCopy Anchor Link

max chats membersCopy Anchor Link

max chats members listCopy Anchor Link

max chats members addCopy Anchor Link

max chats members removeCopy Anchor Link

max chats adminsCopy Anchor Link

max chats admins addCopy Anchor Link

max chats admins removeCopy Anchor Link

max chats updateCopy Anchor Link

max chats linkCopy Anchor Link

max chats link showCopy Anchor Link

max chats link resetCopy Anchor Link

max chats foldersCopy Anchor Link

max chats folders listCopy Anchor Link

max chats folders createCopy Anchor Link

max chats folders updateCopy Anchor Link

max chats folders deleteCopy Anchor Link

max chats rulesCopy Anchor Link

max chats rules showCopy Anchor Link

max chats rules setCopy Anchor Link

max chats rules unsetCopy Anchor Link

max chats moderateCopy Anchor Link

max contactsCopy Anchor Link

max contacts listCopy Anchor Link

max contacts showCopy Anchor Link

max contacts syncCopy Anchor Link

max contacts lookupCopy Anchor Link

max contacts addCopy Anchor Link

max contacts removeCopy Anchor Link

max contacts blockCopy Anchor Link

max contacts unblockCopy Anchor Link

max contacts renameCopy Anchor Link

max contacts importCopy Anchor Link

max messagesCopy Anchor Link

max messages listCopy Anchor Link

max messages searchCopy Anchor Link

max messages showCopy Anchor Link

max messages contextCopy Anchor Link

max messages linksCopy Anchor Link

max messages downloadCopy Anchor Link

max messages transcribeCopy Anchor Link

max messages sendCopy Anchor Link

max messages scheduledCopy Anchor Link

max messages editCopy Anchor Link

max messages deleteCopy Anchor Link

max messages forwardCopy Anchor Link

max messages pinCopy Anchor Link

max messages unpinCopy Anchor Link

max storeCopy Anchor Link

max store statusCopy Anchor Link

max store fetchCopy Anchor Link

max store jobsCopy Anchor Link

max store jobs listCopy Anchor Link

max store jobs showCopy Anchor Link

max store jobs cancelCopy Anchor Link

max store exportCopy Anchor Link

max store clearCopy Anchor Link

max store infoCopy Anchor Link

max store checkCopy Anchor Link

max store migrateCopy Anchor Link

Общие опции

`max session`

`max session start`

`max session end`

`max setup`

`max account`

`max account show`

`max account update`

`max account sessions`

`max account sessions list`

`max account sessions end`

`max chats`

`max chats list`

`max chats show`

`max chats events`

`max chats inspect`

`max chats join`

`max chats mark-read`

`max chats leave`

`max chats create`

`max chats members`

`max chats members list`

`max chats members add`

`max chats members remove`

`max chats admins`

`max chats admins add`

`max chats admins remove`

`max chats update`

`max chats link`

`max chats link show`

`max chats link reset`

`max chats folders`

`max chats folders list`

`max chats folders create`

`max chats folders update`

`max chats folders delete`

`max chats rules`

`max chats rules show`

`max chats rules set`

`max chats rules unset`

`max chats moderate`

`max contacts`

`max contacts list`

`max contacts show`

`max contacts sync`

`max contacts lookup`

`max contacts add`

`max contacts remove`

`max contacts block`

`max contacts unblock`

`max contacts rename`

`max contacts import`

`max messages`

`max messages list`

`max messages search`

`max messages show`

`max messages context`

`max messages links`

`max messages download`

`max messages transcribe`

`max messages send`

`max messages scheduled`

`max messages edit`

`max messages delete`

`max messages forward`

`max messages pin`

`max messages unpin`

`max store`

`max store status`

`max store fetch`

`max store jobs`

`max store jobs list`

`max store jobs show`

`max store jobs cancel`

`max store export`

`max store clear`

`max store info`

`max store check`

`max store migrate`

`max store reindex`