<p align="center"> <img src="https://raw.githubusercontent.com/leemour/max-cli/main/docs/design/logo_text.png" alt="Max CLI" width="480"> </p>

max-cli

Ваши боты MAX и ваш личный аккаунт — в терминале и в ИИ-агентах. max — программа для терминала и MCP-сервер: пишите от имени бота через официальный Bot API, а в свои чаты — сами или руками Claude, Codex, Cursor и других агентов. В группах, которые вы ведёте, — следите за непрочитанным и сразу реагируйте на проблемы: спам, чужие ссылки, флуд, вопросы без ответа — по вашим правилам.

Работает в Windows, macOS и Linux. Документация — wirecat.dev/ru/docs/max.

max sales bot messages send "Команда продаж" "Сборка готова"   # от имени бота
max messages send "Иван Петров" "Опаздываю на 15 минут"         # от вашего имени

Бот

max bot работает с ботом через официальный Bot API MAX по токену бота. Ботов может быть несколько: каждый хранится под именем, которое вы выбираете, и это имя — первое слово команды.

Полный Bot API. Все методы официальной схемы MAX доступны из терминала через max <бот> bot api <операция>: параметры — флаги, тело запроса — JSON. Удобные команды для сообщений и чатов дополняются полным API для собственных сценариев и автоматизации. Руководство по Bot API и полный справочник команд.

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                                     # все боты на этом компьютере

Чат называют по номеру или, когда бот его уже видел, по названию; человеку пишут как user:<номер>. Где взять номер чата — 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; MAX выдаёт их подтверждённым организациям, ИП и самозанятым. Полностью — docs/bot.md.

Личный аккаунт

max без слова bot работает с вашим личным аккаунтом: как ещё одно ваше устройство, со всеми чатами, историей, группами и контактами.

⚠️ Для личного аккаунта max-cli использует неофициальный внутренний API MAX. API может измениться без предупреждения, а использование инструмента может нарушать условия сервиса. Вы используете max-cli на свой риск; авторы и контрибьюторы не несут ответственности за блокировки аккаунтов, потерю данных или другие последствия. Бот работает через официальный API, и к нему это не относится.

max chats list --limit 5
max messages list "Иван Петров"
max messages send "Иван Петров" "Опаздываю на 15 минут"

Всё ниже, до раздела «Установка», — про личный аккаунт. Полностью — docs/usage.md.

Как это использовать

Самое полезное — поручить переписку агенту: Claude, Codex или другому. Он читает чаты через max и делает то, что вы попросили словами.

• Проверка по расписанию. Утром и вечером агент смотрит, что пришло, и присылает короткую сводку: кто ждёт ответа, что срочно, что можно не читать.
• Отчёты. Итог недели по рабочему чату: что решили, кто что взял на себя, какие вопросы остались без ответа.
• Кто кому должен. max review одним вызовом отдаёт всё, что было в переписке с прошлого обзора, — ваши сообщения тоже, голосовые — текстом. Агент раскладывает это на «я должен», «жду от других» и «нужно уточнить», а прежде чем назвать что-то просроченным, проверяет рабочие группы: может, уже сделано.
• Напоминания. Кому вы обещали ответить и не ответили; чей вопрос висит третий день.
• Черновики ответов. Агент предлагает текст, а отправляете вы — или он сам, если вы разрешили писать в этот чат.
• Поиск. «Когда мы договорились о встрече с Иваном?» — ответ с датой и самим сообщением.
• Группа, которую вы ведёте. Какие вопросы висят без ответа, кто вступил за неделю и с каким аккаунтом, удалить приглашения в чужие чаты — по вашим правилам и с вашим «да» (ниже).

Как это выглядит:

Вы:     Что я кому обещал за последние три дня?
Агент:  (вызывает max review: 12 чатов, 3 голосовых расшифровано)
        Я должен
        · Ивану Петрову — прислать счёт до пятницы. «Иван Петров», 24.09
        Жду от других
        · Ольга — макет к 25.09. В группе «Дизайн» его пока нет
        Нужно уточнить
        · «Проект Альфа»: кто везёт образцы — договорились «потом решим», 25.09
        Следующий обзор — с 26.09, 14:05.
Вы:     Напомни Ольге про макет.
Агент:  Черновик: «Ольга, привет! Как там макет?» Отправить?
Вы:     Да.

Агент отправляет только по вашей просьбе; подтверждение вызовов настройте в своём ИИ-приложении. Чтение не ставит отметку «прочитано». Как настроить агента под каждую задачу — готовые запросы, расписание и ограничения: docs/recipes.md.

Группы, которые вы ведёте

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.

Как это работает

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).
• Контакты и аккаунт. Найти человека по номеру, добавить, удалить, переименовать для себя, заблокировать, импортировать из файла; изменить профиль и фото; посмотреть и завершить другие сеансы.
• Входить удобным способом. 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.
• Чужой текст не управляет вашим терминалом. Имена, названия чатов, имена файлов и сообщения пишут другие люди. Управляющие символы из них показываются как текст, имя всегда печатается в одну строку, а автодополнение подставляет только номер ча