Установка

Установите CLI через локального агента или в терминале. Это npm-пакет для Windows, macOS и Linux. Агент поможет проверить компьютер, установить CLI и войти в аккаунт.

Установить с помощью агента

Раскройте блок ниже и скопируйте запрос агенту. После входа проверьте свой аккаунт и несколько чатов. Загрузка старой истории — отдельный шаг.

Настрой max на моём компьютере. Сначала прочитай инструкцию: https://wirecat.dev/llms.mdx/docs/ru/installation/content.md

Проверь, что установлены Node.js 22.16+ (ветка 22.x) или 24+ и npm.

Установи через npm install -g @leemour/max-cli (в Windows PowerShell используй npm.cmd). Проверь, что max запускается по имени в твоём терминале и будет доступен в новых терминалах. На Windows узнай папку установки через npm.cmd prefix -g; добавь её в PATH пользователя, если её там нет, сохрани прежние записи и обнови PATH своего терминала. Не предполагай, что npm обновил уже работающий терминал. На macOS/Linux проверь npm prefix -g и подпапку bin; сохрани существующие настройки терминала. Если PowerShell блокирует созданный скрипт, используй запуск через .cmd и восстановление из инструкции без изменения постоянной политики выполнения.

До входа выполни max skill install --for all. Прочитай max --help, max commands --json и max skill show, затем загрузи и проверь установленный skill для своего агента.

Используй пошаговую настройку, если она есть в установленном cli; иначе следуй инструкции входа. Скажи, что настройка займёт около пяти минут, а скачивание истории чатов — отдельный шаг. Коды и пароли я введу локально или отсканирую QR-код.

Проверь max --version, выполни max doctor, проверь аккаунт после входа и покажи первые пять чатов.

npm install -g @leemour/max-cli
max skill install --for all
max --version
max doctor

& ([scriptblock]::Create((Invoke-RestMethod 'https://wirecat.dev/install.ps1'))) -Tool max -Agent all

max setup --agent all

max account show
max chats list --limit 5
max inbox --limit 5

Попробовать первые задачи → · Как формулировать запросы

Самостоятельная установка и технические детали

max — одна команда. Ставится как обычный пакет npm, работает под Node и под Bun, ничего не компилирует при установке и сама ничего не запускает. Фоновый max serve появляется позже, когда его запустит первая обычная команда (setup его не запускает) (serve в configuration.md).

Что нужноCopy Anchor Link

• Node.js 22.16 или новее, либо Bun 1.3+.
• Linux, macOS или Windows.

Для доступа к ключнице (OS keyring) используется готовый бинарник — собирать ничего не нужно. Если ключницы на машине нет, токен ложится в файл рядом с настройками, и команда скажет об этом одной строкой.

Обычный способCopy Anchor Link

Запустить, ничего не устанавливая:

npx @leemour/max-cli --help
pnpm dlx @leemour/max-cli --help
bunx @leemour/max-cli --help

Поставить насовсем:

npm install -g @leemour/max-cli
pnpm add -g @leemour/max-cli
bun add -g @leemour/max-cli

Пакет называется @leemour/max-cli, а команда, которую он ставит, — max.

Проверка, что всё встало:

max --version
max --help              # список команд

Если установка прошла, а max не находится, — npx @leemour/max-cli doctor скажет почему и какую команду выполнить (troubleshooting.md).

git clone [email protected]:leemour/max-cli.git
cd max-cli
pnpm install
pnpm build

pnpm link --global      # теперь работает просто `max`

node dist/bin/max.js --help

max --version
max --help              # список команд

Первый запуск и инструкция для агентаCopy Anchor Link

max --help
max setup --help
max commands --json
max skill show                    # доступно до входа
max setup --agent codex            # QR-вход и навык агента

Выделите около пяти минут. setup проверяет аккаунт и до пяти чатов; повторно использует существующую сессию. История скачивается отдельно, после выбора чата и объёма. Команда не запускает фоновый сервис. Выбор агента: codex, cursor, claude, gemini, all, none. Установка навыка отдельно: max skill install --for all. Способы входа и восстановление — sessions.md.

Windows. После установки Node.js откройте новый PowerShell. Если выполнение скриптов блокируется, используйте npm.cmd и max.cmd. Когда команда не найдена на PATH:

npm.cmd exec --yes --package=@leemour/max-cli -- max setup --agent codex

Тот же префикс подходит для --help, skill show и остальных команд. Диагностика: npm.cmd exec --yes --package=@leemour/max-cli -- max doctor --json.

Куда всё ложитсяCopy Anchor Link

Каталоги настроек и состояния, по соглашениям операционной системы:

Точные пути на этой машине показывает max doctor.

Токен хранится в ключнице операционной системы, а не в файле. В config.json для него нет поля, и схема настроек его не примет.

Каталоги max переопределяются переменными MAX_CONFIG_DIR, MAX_STATE_DIR. Общая копия хранится отдельно; её файл задаёт MESSAGING_STORE. Точный путь показывает max doctor.

⚠ Переменные переносят и запись в ключнице. Сессия, сохранённая с MAX_CONFIG_DIR, не видна команде, запущенной без него: под капотом меняется имя службы, под которым лежит токен. Это ровно то, что нужно для временного профиля и для тестов, и ровно то, что однажды стоило владельцу получаса с «нет сессии» при живом токене. Либо ставьте переменные всегда, либо не ставьте никогда.

Обновление и удалениеCopy Anchor Link

max upgrade           # тем же менеджером пакетов, которым max поставлен: pnpm, npm или bun
max upgrade --check   # только сказать, есть ли новее; ничего не ставит

JSON-ответ обновленияCopy Anchor Link

max upgrade --check --json сообщает текущую и доступную версии без установки. Единый ответ содержит current, latest, newer, installer, command, updated и restarted — список профилей, серверы которых перезапущены после обновления. При проверке, отсутствии новой версии или перезапуска это пустой массив; прежние поля сохраняются. После обновления MAX автоматический перезапуск серверов по-прежнему не выполняется. Скриптам с проверкой точного набора ключей нужно учесть новое поле restarted.

Раз в сутки max сам спрашивает npm о новой версии и, если она есть, пишет после команды одну строку в stderr — только человеку в терминале: не в --json, не в трубу, не с --quiet, не в CI. Выключается max config set updateCheck false --defaults. Сам себя max не обновляет никогда.

Из исходников — git pull && pnpm install && pnpm build.

Удаление уносит команду, но не данные:

max session end                        # забыть токен ДО удаления команды
max <бот> bot auth remove              # и токен каждого бота
npm uninstall -g @leemour/max-cli
rm -rf ~/.config/max-cli ~/.local/share/max-cli ~/.cache/max-cli ~/.local/share/cli-messaging

max session end и bot auth remove стирают токены из ключницы. Если сначала удалить команду, запись в ключнице останется — безвредно, но лежать будет.

ДальшеCopy Anchor Link

usage.md — вход в аккаунт и первые команды.