Home

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

Полная документация — на wirecat.dev/ru/docs/max. Страницы этой вики копируются из папки docs/ при каждом изменении в main, поэтому правка здесь будет перезаписана. Чтобы исправить страницу, откройте pull request в docs/.

Вопросы и идеи — в Discussions. Что изменилось в каждой версии — в релизах. max — часть WireCat.

max подключает MAX к терминалу и к вашему ИИ-агенту (например, Claude Code, Codex, Cursor или Gemini CLI). Она работает с двумя вещами:

• с вашим личным аккаунтом — как ещё одно ваше устройство, со всеми чатами, историей и контактами;
• с ботом — через официальный Bot API MAX, по токену бота.

Она нужна, когда вы хотите читать, искать и отвечать в чатах без приложения MAX или поручить эту работу агенту — в границах, которые задаёте вы.

На этой странице — что умеет max, как начать за пять минут и какая страница отвечает на какой вопрос.

Три слова встречаются на каждой странице:

• Терминал (командная строка) — окно, где набирают команды: «Терминал» в macOS, PowerShell в Windows. max — одна команда, которую вы там набираете.
• ИИ-агент — программа, которая выполняет задачи за вас и умеет запускать команды, например Claude Code или Codex. Он пользуется max вместо вас.
• Навык (skill) — короткая инструкция для агента о том, как работать с max. Настройка ставит её сама.

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

Что умеет

Что нужно	Где
Читать чаты и непрочитанные сообщения других людей; по умолчанию ничего не отмечается прочитанным	Личный аккаунт
Найти, что было сказано, — по словам, людям, датам, файлам или теме	Поиск
Держать копию сообщений на этом компьютере, искать по ней и выгружать её	Локальная копия
Отвечать и отправлять — самому или через агента, в границах, которые вы задали	Личный аккаунт, Права
Видеть, на какие вопросы в ваших группах никто не ответил и кто вступил	Группы, которые вы ведёте
Вести бота MAX из терминала	Бот MAX
Работать с MAX из приложения без терминала (например, Claude Desktop или Cursor) или из чата в браузере	MCP-сервер, ChatGPT или Claude в браузере

Каждая команда делает одно дело, отвечает всегда в одном виде (один JSON на stdout) и имеет постоянный код возврата для каждого вида ошибки. Поэтому на неё могут опираться скрипты и агенты. Работает в Windows, macOS и Linux.

Начать

npm install -g @wirecat/max-cli
max setup                 # QR-вход и навык агента
max inbox                 # непрочитанные сообщения других людей во всех чатах
max chats list --limit 5  # пять последних чатов

Настройка занимает около пяти минут. Старая история чатов скачивается отдельным шагом. Чтобы выбрать агента, которому поставить навык, добавьте --agent со значением codex, cursor, claude, gemini или all (например, max setup --agent codex). max setup --help показывает способы входа.

С ботом (sales здесь — пример имени профиля бота):

max sales bot auth set                            # токен — в скрытом вводе
max sales bot api get-my-info --json

Для max нужен Node 22.16+ или 24+ либо Bun (что поставить заранее).

Чем max отличается от других инструментов — ниже.

Куда дальше

Страница	Отвечает
Установка	Что нужно, куда ложатся файлы, как обновить или удалить?
Личный аккаунт	Как читать, листать, отправлять и звать из скрипта?
Вход, сессии и профили	Как устроен вход, где лежит токен, как работают профили?
Локальная копия	Что хранится на компьютере и как её заполнить, искать по ней, выгрузить и сохранить?
Группы, которые вы ведёте	Как следить за группой, которую вы ведёте?
Бот MAX	Как вести бота MAX из командной строки?
MCP-сервер	Как подключить Claude Desktop, Cursor или другой клиент без терминала?
ChatGPT или Claude в браузере	Как достать до MAX из ChatGPT или Claude в браузере?
Рецепты	Что агент может делать для меня каждый день и как запускать это по расписанию?
Все команды	Каждая команда, опция и код возврата
Настройки	Что можно настроить и какое значение побеждает?
Диагностика	Что команда делала и что не записывается никогда?
Когда не работает	Что-то не работает: что написано на экране и что делать
Безопасность	Что попадает на диск и в сеть и что не даёт отправить не туда?
Дорожная карта	Что будет дальше?

Поиск: max search all — сразу сообщения, почта и заметки; search messages находит сообщения по словам, людям, датам, файлам и меткам; поиск по темам — обсуждения по тому, о чём они были; язык поисковых запросов — полная справка.

Рейтинги сообщений и авторов: метрики, оценки, качество архива и evidence.

Чем отличается от других

Для MAX уже есть хорошие проекты, и max-cli многому у них научился. PyMax — самая полная библиотека для личного аккаунта; её код помог разобрать многие операции протокола. Выбирайте то, что подходит под задачу. Таблица — про личный аккаунт; бот работает через официальный Bot API (бот MAX).

	max-cli	PyMax	max-mcp
что это	программа для терминала и MCP-сервер	библиотека на Python	MCP-сервер на PyMax
MCP-сервер и навык для агентов	✅	—	MCP
ограничения для агента: только чтение, разрешённые действия, список чатов, лимит в час, подтверждение отправки	✅	—	—
расшифровка голосовых в текст на вашем компьютере	✅	—	—
готовые команды — не нужно писать свою программу	✅	— (библиотека для своего кода на Python)	—
локальная копия с поиском и чтением без интернета	✅	—	—
новые сообщения в реальном времени	✅ max watch	✅ обработчики событий	—
отложенная отправка — уходит, даже если компьютер выключен	✅	✅	—
выгрузка переписки в JSONL или Markdown	✅	—	—
чтение, отправка текста, фото и файлов	✅	✅	✅
реакции, правка, пересылка, закрепление	✅	✅	—
удаление сообщений — у себя или у всех, с лимитом	✅	✅	—
отметка «прочитано» по запросу	✅	✅	—
группы и каналы: создать, вступить, участники, админы	✅	✅	чтение каналов
для админа группы: вопросы без ответа, новенькие, проверка по правилам	✅	—	—
контакты, профиль, другие сеансы	✅	✅	—
отправка видео	✅	✅	—
отправка кружков	—	✅	—
отправка голосовых	✅	⚠️ в 2.4.1 не проходит (#102, #103)	—
опросы: показать, проголосовать, создать, закрыть	✅	✅	—
фото профиля	✅	✅	—
вход с облачным паролем	✅ по QR-коду	✅	—
установить или снять облачный пароль	—	✅	—