WireCat MAX

MAX CLI для людей, ботов и агентов

Ваш аккаунт и ваши боты MAX — в терминале и в ИИ-агентах. Читайте, ищите и отвечайте сами или поручите это Claude, Codex и Cursor — по вашим правилам.

Документация · Примеры · WireCat

Пример разговора с агентом (люди и чаты вымышленные):

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

Быстрый старт

npm install -g @wirecat/max-cli
max skill install --for all         # навык для Claude Code, Codex и Gemini CLI
max personal setup                  # вход по QR-коду
max personal inbox                  # непрочитанное во всех чатах, ничего не отмечая

max personal setup за пять минут проводит через вход: вы сканируете QR-код в приложении MAX, и max становится ещё одним вашим устройством. Навык можно поставить и самим setup: --agent claude, codex, cursor, gemini, all или none. Войти можно и по SMS через web.max.ru — max personal setup --help.

Нужен Node 22.16+ (ветка 22.x) или 24+, либо Bun 1.3+; работает в Windows, macOS и Linux. Попробовать без установки — npx @wirecat/max-cli --help. Если max не находится, npx @wirecat/max-cli personal doctor скажет почему (personal — имя профиля, которое вы выбрали; у вас оно может быть другим).

Глобальная установка (npm install -g) навык агента не ставит: его ставит max personal setup или max skill install --for all. MAX_INSTALL_AGENT=all при установке ставит его сразу, в ~/.claude/skills и ~/.agents/skills, если npm запускает сценарий установки. npm 11.17 и новее по умолчанию его не запускает и пишет об этом (allow-scripts) — это безвредно. В Windows, если max не находится, откройте новый терминал или выполните восстановление из установки.

Подробнее: установка (wirecat.dev), вход и профили (wirecat.dev).

Что можно сделать

Разобрать, что пришло. «Используй max CLI: кто ждёт моего ответа и что срочно?»

max personal inbox

Найти что угодно. «Когда мы договорились о встрече с Алисой?» — ответ с датой и самим сообщением, по локальной копии и без запросов к MAX.

max personal search messages "встреча Алиса"

Понять, кто кому что должен. «Что я обещал и чего жду от других?» — вся переписка с прошлого обзора, ваши сообщения и голосовые текстом.

max personal review 'date>3d' --transcribe

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

Подробнее: рецепты для агентов (wirecat.dev).

面向 AI Agent

你的 Agent。你的 MAX。你的规则。

• 带终端的 Agent——Claude Code、Codex、Cursor、Gemini CLI。它会自行调用 max，而技能（skill）——即 Agent 的操作说明——会向它说明命令和限制。max personal setup 会自动安装技能；也可以单独运行 max skill install。
• 不带终端的应用——Claude Desktop、Cursor 和其他 MCP 客户端。连接 MCP 服务 max personal mcp serve；内置了现成的请求 /catch-up、/review、/reply 和 /find。
• 浏览器中的 ChatGPT 或 Claude——通过 HTTPS 隧道和代码登录。

max personal mcp add claude-code  # или codex
max personal mcp config             # запись для Claude Desktop, Cursor и других

默认配置文件可以发送消息，因此 mcp add 会先暂停。请检查配置文件的权限，然后使用 --allow-writes 重新运行命令。

使用 --json 时，每条命令只输出数据，错误则单独返回，并带有固定的退出代码。

了解详情：MCP 服务（wirecat.dev）、浏览器（wirecat.dev）、脚本接口规范（wirecat.dev）。

为什么选择 max

• 整个账号，而不只是机器人。 聊天、历史记录、群组、联系人、文件和语音消息——应用的大部分功能都支持；暂不支持圆形视频消息和两步验证的密码设置。此外，还支持通过官方 Bot API 操作机器人。
• 拥有自己的聊天记录副本。 所有已读取的内容都保存在你的电脑上：快速搜索和离线阅读（--offline），还可导出为 JSONL 或 Markdown。
• 专为 Agent 打造。 提供技能、MCP 服务、统一的 JSON 格式，以及可让脚本决定后续操作的错误代码。
• 默认安全。 阅读不会标记为“已读”。支持只读配置文件、可写入的聊天列表和每小时消息数限制。如果名称匹配两个聊天，max 不会自行选择。如果发送时连接中断，max 会明确告知；重试也不会产生重复消息。
• 管理好你负责的群组。 检查未回复的问题、新成员，以及是否符合你的规则：垃圾消息、外部链接、刷屏。默认情况下，检查只会标记问题。

与其他项目的区别

MAX 还有其他优秀项目；PyMax 是功能最完整的个人账号库，其代码也帮助我们分析了协议。下面简要比较针对个人账号的工具：

	max-cli	PyMax	max-mcp
类型	程序和 MCP 服务	Python 库	基于 PyMax 的 MCP 服务
面向 Agent 的现成命令、技能和 MCP	✅	—	MCP
Agent 限制：只读、聊天列表、每小时限额	✅	—	—
支持离线搜索的本地副本	✅	—	—
在你的电脑上转写语音消息	✅	—	—
表情回应、编辑、转发、投票、定时发送	✅	✅	—
群组管理员功能：未回复问题、按规则检查	✅	—	—

了解详情：完整对照表（wirecat.dev）。 与其他 MAX 工具的比较：比较（wirecat.dev）。

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

max без слова bot работает с вашим аккаунтом как ещё одно ваше устройство.

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

• Читать. Чаты, история, сообщение вместе с соседними, непрочитанное во всех чатах (max personal inbox), разбор «кто кому должен» (max personal review), новые сообщения по мере прихода (max personal watch), вложения, голосовые — текстом на вашем компьютере.
• Писать. Текст и разметка, ответы, фото, видео, файлы и голосовые, правка, пересылка, закрепление, реакции, опросы, отложенная отправка, удаление — у себя или у всех.
• Группы и каналы. Создать, вступить по ссылке, выйти, участники и админы, настройки, ссылка-приглашение, папки.
• Контакты и аккаунт. Найти по номеру, добавить, переименовать, заблокировать, свои заметки о людях; профиль и фото; другие сеансы.

max personal inbox                                              # непрочитанное, ничего не отмечая
max personal messages list "Алиса Пример" --limit 20
max personal messages send "Алиса Пример" "Созвонимся в 15:00?" --reply-to <id>
max personal reactions add "Алиса Пример" <id> 👍
max personal messages send 0 "Позвонить Борису" --at-time 2h    # напоминание себе в «Избранное»
max personal chats mark-read "Алиса Пример"                     # отметить прочитанным, когда нужно

Подробнее: личный аккаунт (wirecat.dev), один человек (wirecat.dev), ответы (wirecat.dev).

Бот

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

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 moderate "Команда продаж" --dry-run  # что нарушает правила — без действий
max sales bot api get-updates --limit 10                 # любой метод Bot API
max sales 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 serve. Токен — в системном хранилище паролей, отдельно от вашего.

Подробнее: бот MAX (wirecat.dev).

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

max personal review chat:"Поход" --unanswered              # вопросы, на которые сутки никто не ответил
max personal chats events "Поход"                          # кто вступил и вышел
max personal chats members list "Поход" --all              # все участники: когда заведён аккаунт
max personal chats rules set "Поход" invites delete        # приглашения в чужие чаты — удалять
max personal chats moderate "Поход" --dry-run              # что нарушает правила — без действий

Проверка сверяет новое в группе с вашими правилами: заблокированные люди, приглашения, ссылки, пересланное, флуд, совсем новые аккаунты. По умолчанию она только отмечает. Для каждого действия вы решаете сами: никогда, только с флагом, с вашим подтверждением или сразу. Не больше 10 действий за раз, и ничего не следит за группой в фоне.

Подробнее: группы (wirecat.dev), рейтинги (wirecat.dev).

Локальная копия и поиск

Всё прочитанное сохраняется на вашем компьютере. По копии работают поиск и чтение без интернета; историю чата можно скачать глубже и выгрузить.

max personal search messages "договор"                        # только сообщения
max personal search all "договор"                             # шире, по просьбе: и заметки (для почты есть отдельный CLI memo)
max personal search messages 'договор chat:"Проект Альфа"'  # только один чат
max personal messages sync "Проект Альфа" --last 500            # последние 500 сообщений — в копию
max personal store export "Проект Альфа" --format markdown --output alfa.md
max personal chats list --offline                             # без подключения к MAX

Поиск понимает слова, людей, даты, файлы, ссылки и ваши метки; есть поиск по темам и сохранённые запросы. Текст из сохранённых вложений ищется через content:.

Подробнее: локальная копия (wirecat.dev), поиск (wirecat.dev), язык запросов (wirecat.dev), поиск по темам (wirecat.dev), вложения (wirecat.dev), голосовые (wirecat.dev).

Агенты: навык и MCP

Навык ставится одной командой и всегда той же версии, что и max: в ~/.claude/skills/max-cli/ для Claude Code и в ~/.agents/skills/max-cli/ для Codex, Gemini CLI и Cursor. После обновления max запустите установку ещё раз.

max skill show                  # прочитать до входа
max skill install --for all     # или --for claude, --for agents

MCP-сервер работает с тем же аккаунтом. Права профиля проверяются при каждом вызове; формы подтверждения на сервере нет — подтверждение вызовов настраивается в приложении агента. Навык доступен ресурсом max://skill.

max personal mcp check                                       # проверить локальный MCP
max personal mcp serve --http --public-url https://<имя>.ts.net     # для ChatGPT и Claude в браузере
max personal mcp serve --permission messages.send=deny              # запретить отправку этому серверу

Подробнее: MCP-сервер (wirecat.dev), браузер (wirecat.dev), внешние модели (wirecat.dev).

Для скриптов

С --json команда печатает только данные; так же она работает, когда её вывод читает другая программа (max … | jq). Любой список приходит в одной форме:

{ "items": [ … ], "page": { "limit": 20, "has_more": true }, "meta": { … } }

Ошибка приходит одной строкой JSON в stderr, stdout остаётся пустым. Код завершения говорит, что случилось: 4 — нужно войти, 5 — права не разрешают, 6 — чат или сообщение не найдены, 8 — лимит, 9 — MAX не ответил вовремя, 14 — неизвестно, ушло ли сообщение (повторять только с тем же --operation-id). Частичный результат может прийти с кодом 0: проверьте поля missing и next.

Подробнее: контракт (wirecat.dev), все команды и коды (wirecat.dev).

Вход и профили

max personal setup --agent codex       # QR-код в терминале и навык Codex
max personal setup --method qr-chrome  # QR через web.max.ru в браузере
max personal setup --method sms        # номер телефона — в браузере
max personal setup --method token      # готовый токен, скрытым вводом или через stdin
max personal session start qr          # повторный вход, когда сессия истекла

Профиль называется первым словом в каждой команде — max personal chats list, — или export MAX_PROFILE=personal на всю сессию оболочки. max никогда не выбирает профиль сам, даже единственный: без имени команда останавливается и перечисляет профили этого компьютера. Имя personal — пример: любое подойдёт.

Подробнее: вход и сессии (wirecat.dev), профили (wirecat.dev).

Настройки и права

У каждого профиля свои настройки и права; без файла настроек действуют встроенные значения.

Настройка	Что делает	По умолчанию
permissions	что можно: deny, readonly, ask, allow — для команды или группы команд	всё, кроме удаления и других необратимых действий: они спрашивают
sends_per_hour	сколько сообщений профиль отправит за час	30
requests_per_minute	темп обращений к MAX	20
limit	сколько строк в списке	20

max personal config set permissions.messages readonly  # профиль только для чтения
max personal config set permissions.messages.send ask  # спрашивать перед отправкой

Подробнее: настройки (wirecat.dev), права (wirecat.dev), все ключи (wirecat.dev).

Ограничения

max держит каждый профиль в одном темпе: первые 10 запросов идут сразу, дальше — 20 в минуту, и две команды одновременно делят этот темп. Если MAX отвечает «слишком много запросов», max останавливается и не повторяет запрос сам. Фоновый max personal serve держит одно подключение для всех команд и сам останавливается, когда им 15 минут никто не пользуется.

Подробнее: ограничения и ожидания (wirecat.dev).

Безопасность

• Токен входа — в системном хранилище паролей, не в файле и не в истории команд.
• Локальная копия и служебные файлы доступны только вашему пользователю; от кражи диска защищает шифрование диска целиком.
• Перед каждой отправкой, в том числе через фоновый сервер и MCP, max проверяет ограничения профиля и пишет строку в журнал — без текста сообщения.
• --file не отправит известные файлы с учётными данными, папки max и хранилище.
• Чужой текст не управляет вашим терминалом: управляющие символы из имён и сообщений показываются как текст.
• Ограничения защищают от агента, которого уговорило прочитанное сообщение, но не от агента, который хочет их обойти: для этого нужна песочница или отдельный пользователь.

Подробнее: безопасность (wirecat.dev).

Когда не работает

max personal doctor               # где лежат файлы и есть ли вход; к MAX не подключается
max personal chats list --trace   # каждый запрос к MAX — без текстов, имён и токена
max personal runs list            # неудачные и частичные запуски сохраняются сами

Запись --trace можно приложить к сообщению об ошибке.

Подробнее: по симптому (wirecat.dev), диагностика (wirecat.dev).

Документация

Каждая страница есть и на сайте — wirecat.dev/ru/docs/max; ниже — исходники в этом репозитории.

Раздел	Страницы
Начало	обзор и сравнение · установка
Как пользоваться	личный аккаунт · вход и сессии · локальная копия · поиск · вложения · голосовые · внешние модели · рейтинги · поиск по темам · язык запросов · бот MAX · группы · один человек · ответы · MCP-сервер · браузер · рецепты
Справочник	все команды · настройки · права · профили · все ключи настроек · контракт для скриптов · ограничения
Если что-то не так	диагностика · когда не работает · безопасность
Проект	дорожная карта
Изменения	CHANGELOG.md

Для разработчиков: архитектура, проверки, протокол (генерируется), что осталось.

Разработка

pnpm install
pnpm lint && pnpm typecheck && pnpm test
pnpm build && pnpm smoke:node         # собранная команда: бандл, который ставит пользователь
pnpm build && pnpm smoke:bun          # то же под Bun
pnpm generate                         # переписать сгенерированные файлы

Протокол MAX неофициальный и разобран обратной инженерией. Каждый опкод объявлен один раз в src/spec/, а реестр, типизированный клиент и docs/dev/protocol.md из него генерируются; CI падает, если дерево устарело. Общая часть — потоки вывода, коды ошибок, хранилище паролей — в @wirecat/cli-base.

Часть WireCat

max-cli — часть WireCat: открытого слоя контекста для ИИ-агентов, который хранит данные на вашем компьютере. Начните с MAX. Добавьте Telegram, почту и заметки, когда понадобится. Ваш контекст. Любой агент.

Участие и лицензия

Пулл-реквесты, сообщения об ошибках и предложения — issues.

Делаем автоматизацию и инструменты под задачу: интеграции с MAX и другими мессенджерами, ИИ-агентов, внутренние сервисы — [email protected].

Apache License 2.0 — LICENSE.