Instalación

Instala el CLI con tu agente local o en la terminal. Es un paquete npm para Windows, macOS y Linux. El agente puede comprobar el ordenador, instalarlo y ayudarte a iniciar sesión.

Instalar con tu agente

Abre el bloque de abajo y copia la petición en tu agente. Después de iniciar sesión, comprueba tu cuenta y algunos chats. Descargar el historial antiguo es un paso aparte.

Configura max en mi ordenador. Primero lee la guía: https://wirecat.dev/llms.mdx/docs/es/installation/content.md

Comprueba que tienes Node.js 22.16+ (rama 22.x) o 24+ y npm.

Instala con npm install -g @leemour/max-cli (usa npm.cmd en Windows PowerShell). Comprueba que max funciona por su nombre en tu terminal actual y en terminales nuevas. En Windows, consulta la carpeta de instalación con npm.cmd prefix -g; añádela al PATH del usuario si falta, conserva las entradas existentes y actualiza el PATH de tu propia terminal. No supongas que npm ha actualizado una terminal que ya estaba abierta. En macOS/Linux, comprueba npm prefix -g y su carpeta bin sin sobrescribir la configuración del shell. Si PowerShell bloquea el script generado, usa el ejecutable .cmd y la recuperación documentada sin cambiar la política de ejecución permanente.

Antes de iniciar sesión, ejecuta max skill install --for all. Lee max --help, max commands --json y max skill show; carga el skill instalado y verifica que tu agente lo utiliza.

Usa la configuración guiada si el cli instalado la admite; si no, sigue la guía de inicio de sesión. Dime que la configuración tarda unos cinco minutos y que descargar el historial es un paso separado. Introduciré los códigos y contraseñas localmente o escanearé el QR.

Comprueba max --version, ejecuta max doctor, verifica la cuenta conectada y muestra los primeros cinco chats.

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

Probar las primeras tareas → · Cómo formular peticiones

Instalación manual y detalles técnicos

max se instala como un paquete npm normal. Funciona con Node o Bun: no compila nada al instalarse ni inicia procesos por su cuenta. El servidor en segundo plano max serve se inicia después, cuando una orden normal lo necesita; setup no lo inicia (véase serve en configuración).

RequisitosCopy Anchor Link

• Node.js 22.16 o posterior, o Bun 1.3+.
• Linux, macOS o Windows.

El acceso al llavero del sistema usa un binario ya preparado: no tienes que compilarlo. Si el equipo no tiene llavero, el token se guarda en un archivo junto a la configuración y el comando lo indica en una línea.

Instalación habitualCopy Anchor Link

Ejecutar sin instalar:

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

Instalar de forma permanente:

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

El paquete se llama @leemour/max-cli y el comando que instala es max.

Comprobar la instalación:

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

Si la instalación termina pero no se encuentra max, ejecuta npx @leemour/max-cli doctor: explicará el motivo y qué comando usar (solución de problemas).

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              # список команд

Primer inicio e instrucciones para el agenteCopy Anchor Link

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

Reserva unos cinco minutos. setup comprueba la cuenta y hasta cinco chats; si ya hay sesión, la reutiliza. El historial se descarga aparte, tras elegir el chat y la cantidad. No inicia un servicio en segundo plano. Agentes disponibles: codex, cursor, claude, gemini, all, none. Para instalar solo el skill: max skill install --for all. Consulta métodos de acceso y recuperación en sesiones.

Windows. Después de instalar Node.js, abre un PowerShell nuevo. Si bloquea los scripts, usa npm.cmd y max.cmd. Si la orden no está en PATH:

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

El mismo prefijo sirve para --help, skill show y las demás órdenes. Diagnóstico: npm.cmd exec --yes --package=@leemour/max-cli -- max doctor --json.

Dónde se guardan los archivosCopy Anchor Link

Directorios de configuración y estado según cada sistema operativo:

max doctor muestra las rutas exactas de este equipo.

El token se guarda en el llavero del sistema operativo, no en un archivo. config.json no tiene un campo para él y su esquema no lo acepta.

Los directorios de max se cambian con MAX_CONFIG_DIR y MAX_STATE_DIR. La copia compartida se guarda aparte; MESSAGING_STORE indica su archivo. max doctor muestra la ruta exacta.

⚠ Estas variables también cambian la ubicación de la entrada del llavero. Una sesión guardada con MAX_CONFIG_DIR no es visible para un comando ejecutado sin ella: cambia el nombre del servicio bajo el que se guarda el token. Es útil para perfiles temporales y pruebas, pero puede parecer que no hay sesión aunque el token siga existiendo; al propietario le costó media hora encontrar el motivo. Usa siempre las mismas variables o no las uses.

Actualizar y desinstalarCopy Anchor Link

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

Respuesta JSON de actualizaciónCopy Anchor Link

max upgrade --check --json informa de la versión actual y disponible sin instalar. La respuesta común contiene current, latest, newer, installer, command, updated y restarted: perfiles cuyos servidores se reiniciaron tras actualizar. En una comprobación, sin versión nueva o sin reinicios, es un array vacío; los campos anteriores se conservan. MAX sigue sin reiniciar automáticamente sus servidores al actualizar. Los scripts que comprueban el conjunto exacto de claves deben admitir restarted.

Una vez al día, max consulta npm para comprobar si hay una versión nueva. Si la hay, escribe una línea en stderr después del comando, solo en una terminal interactiva: no con --json, una tubería, --quiet ni CI. Desactívalo con max config set updateCheck false --defaults. max nunca se actualiza por sí solo.

Desde el código fuente: git pull && pnpm install && pnpm build.

La desinstalación elimina el comando, pero conserva los datos:

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 y bot auth remove borran los tokens del llavero. Si desinstalas primero el comando, la entrada permanece en el llavero: no causa problemas, pero sigue guardada.

Siguiente pasoCopy Anchor Link

Uso cotidiano: iniciar sesión y ejecutar los primeros comandos.