MAX CLI для людей, ботов и агентов: личный аккаунт и Bot API MAX в терминале, MCP и навыки для Claude, Codex…
MAX CLI для людей, ботов и агентов
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
Ваш аккаунт и ваши боты MAX — в терминале и в ИИ-агентах. Читайте, ищите и
отвечайте сами или поручите это Claude, Codex и Cursor — по вашим правилам.
Документация · Примеры · WireCat
Пример разговора с агентом (люди и чаты вымышленные):
Быстрый старт
max personal setup за пять минут проводит через вход: вы сканируете QR-код в приложении MAX, и max
становится ещё одним вашим устройством. Вместо 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 doctor скажет почему.
Подробнее: установка (wirecat.dev), вход и профили (wirecat.dev).
Что можно сделать
**Разобрать, что пришло.** «Используй max CLI: кто ждёт моего ответа и что срочно?»
**Найти что угодно.** «Когда мы договорились о встрече с Алисой?» — ответ с датой и самим
сообщением, по локальной копии и без запросов к MAX.
**Понять, кто кому что должен.** «Что я обещал и чего жду от других?» — вся переписка с прошлого
обзора, ваши сообщения и голосовые текстом.
Ещё: сводки утром и вечером, итог недели по рабочему чату, кому вы обещали ответить, черновики
ответов, которые отправляете вы или агент с вашего разрешения.
Подробнее: рецепты для агентов (wirecat.dev).
Для ИИ-агентов
Ваш агент. Ваш MAX. Ваши правила.
- **Агент с терминалом** — Claude Code, Codex, Cursor, Gemini CLI. Он сам вызывает max, а навык
(skill) — инструкция для агента — объясняет ему команды и ограничения. max personal setup ставит навык
сам; отдельно — max skill install.
- **Приложение без терминала** — Claude Desktop, Cursor и другие клиенты MCP. Подключите
MCP-сервер max personal mcp; готовые просьбы /catch-up, /review, /reply и /find уже внутри.
- **ChatGPT или Claude в браузере** — через HTTPS-туннель и вход по коду.
С --json каждая команда отдаёт только данные, а ошибка приходит отдельно, с постоянным кодом
завершения.
Подробнее: MCP-сервер (wirecat.dev), браузер (wirecat.dev), контракт для скриптов (wirecat.dev).
Почему max
- **Весь аккаунт, а не только бот.** Чаты, история, группы, контакты, файлы и голосовые — как в
приложении. И отдельно бот через официальный Bot API.
- **Своя копия переписки.** Всё прочитанное хранится на вашем компьютере: быстрый поиск и чтение
без интернета (--offline), выгрузка в JSONL или Markdown.
- **Сделан для агентов.** Навык, MCP-сервер, одна форма JSON и коды ошибок, по которым скрипт
решает, что делать дальше.
- **Безопасен по умолчанию.** Чтение не ставит отметку «прочитано». Есть профиль только для чтения,
список чатов для записи и лимит сообщений в час. Если имя подходит к двум чатам, max не выбирает
сам. Если связь оборвалась при отправке, max так и скажет, а повтор не создаст второе сообщение.
- **Порядок в группах, которые вы ведёте.** Вопросы без ответа, кто вступил, проверка по вашим
правилам: спам, чужие ссылки, флуд. По умолчанию проверка только отмечает.
Чем отличается от других
Для MAX есть и другие хорошие проекты; PyMax — самая полная
библиотека для личного аккаунта, и её код помог разобрать протокол. Коротко, для личного аккаунта:
| | max-cli | PyMax | max-mcp |
|---|:-:|:-:|:-:|
| что это | программа и MCP-сервер | библиотека на Python | MCP-сервер на PyMax |
| готовые команды, навык и MCP для агентов | ✅ | — | MCP |
| ограничения для агента: только чтение, список чатов, лимит в час | ✅ | — | — |
| локальная копия с поиском без интернета | ✅ | — | — |
| расшифровка голосовых на вашем компьютере | ✅ | — | — |
| реакции, правка, пересылка, опросы, отложенная отправка | ✅ | ✅ | — |
| для админа группы: вопросы без ответа, проверка по правилам | ✅ | — | — |
Подробнее: полная таблица (wirecat.dev).
Личный аккаунт
max без слова bot работает с вашим аккаунтом как ещё одно ваше устройство.