MensajeríaMAX

Historial de cambios de la CLI de MAX

Consulta las notas de versión de la CLI de MAX, con correcciones, cambios y nuevas capacidades.

Consulta lo que cambió en las versiones: capacidades, correcciones y cambios que afectan a comandos. Empieza por tu versión instalada y abre la guía de la función que quieras probar.

Cambios destacados de @wirecat/max-cli, con una sección por versión, recientes primero. Se utiliza versionado semántico; antes de 1.0.0, la interfaz de comandos todavía puede cambiar.

0.111.0 — 12.11.2026

Novedades

  • El registro de ejecución guarda el progreso de la sincronización. Cada línea de progreso de messages sync es ahora también un evento sync.progress con contadores, en cualquier formato de salida, así que max <profile> runs show <run> muestra qué vio WireCat Desktop y cuándo.
  • Parte de un nombre en from: y chat:. from:Ярослав* y chat:*Квестор* encuentran por parte del nombre, del alias o del @username, sin importar mayúsculas ni ё/е. Si nadie encaja con el patrón, la respuesta es not_found con los nombres más cercanos. Si encajan más de 50, es query.too-large: precisa el patrón. Un número y un nombre exacto funcionan como antes. Si varias personas tienen exactamente ese nombre, el error ahora propone también a quienes lo tienen solo dentro de su nombre: para «Ярослав», también «Ярослав Орлов».
  • Parte de una palabra en el texto de los mensajes. *договор* sin campo encuentra «Договор», «ДОГОВОРЫ» y «переговоры», también en un archivo grande, dentro de AND, OR, NOT y junto con chat: y date:. Hacen falta tres letras seguidas.
  • El comienzo de una palabra busca donde busca la palabra entera. счет* sin campo ahora encuentra la palabra también en las transcripciones de mensajes de voz, en el texto y en los nombres de archivo, y matched_in dice dónde exactamente.

Cambios que pueden romper scripts

  • Compilado sobre cli-core 0.642.0 (antes 0.638.0). El almacén sigue en la versión 66. Detalles en el historial de cambios de cli-core.
  • *часть* en el texto de los mensajes se busca tal como está escrito. Antes *мои* también encontraba «мой», y *cafe* también «café». Ahora solo se ignoran las mayúsculas y ё/е. Qué tener en cuenta: escribe la letra tal como aparece en el texto, o busca la palabra entera (мой), que sigue encontrando todas sus formas.
  • Embeddings remotos por http simple solo en este ordenador. --base-url o embedding_base_url con una dirección http:// en otra máquina ahora se rechaza con model.address-refused: los mensajes viajarían por la red sin cifrar. Qué tener en cuenta: usa https:// o ejecuta el modelo en este ordenador (localhost, 127.0.0.1). Un ajuste guardado se sigue leyendo, y los demás comandos no fallan.
  • list: en la búsqueda de mensajes ahora se rechaza. Es un campo del correo, y antes una consulta con él no encontraba nada sin decir por qué. Ahora la respuesta es query.unsupported-field con una explicación.
  • Los datos de prueba se ocultan en las listas de personas. Una persona cuyas direcciones son todas de prueba (example.com, .test y similares) o que se creó como ejemplo ya no aparece en ninguna vista, tampoco en all.

Corregido

  • messages sync --all muestra el progreso dentro de un chat. MAX entrega un chat de 30 en 30 mensajes con una pausa de 5–10 segundos, y la línea de progreso solo salía al terminar el chat: en un chat grande, WireCat Desktop mostraba «Чат 1 из 36 · 0» durante minutos. Ahora el contador fetched crece después de cada página, como mucho dos veces por segundo.
  • La pista sobre el almacenamiento de contraseñas ya no remite a cron. Si el perfil ya inició sesión pero el token no se puede leer, el error y max <profile> doctor ahora dicen que lo más probable es que el almacenamiento esté bloqueado: justo después de arrancar el equipo se abre al iniciar sesión en el sistema, y una ejecución programada lo espera por sí sola. El consejo sobre XDG_RUNTIME_DIR se mantiene para cron y ssh.
  • Las programaciones diarias y únicas esperan cuando MAX pide esperar. Si una de esas ejecuciones por temporizador recibe rate_limited, espera lo que pidió MAX, si no pasa de seis horas, y vuelve a intentarlo en lugar de perderse hasta el día siguiente. Qué tener en cuenta: una programación con --every y una ejecución manual siguen terminando con error en el acto.
  • *слово* en el texto sugiere una salida. Si ese patrón recorre demasiadas palabras, el error ahora propone слово*, que también encuentra las formas de la palabra.

0.110.0 — 11.11.2026

Novedades

  • participants_count en la búsqueda y las estadísticas. participants_count<10 encuentra mensajes en chats de menos de diez personas, así que stats messages show -- 'kind:private OR (kind:group participants_count<10)' cuenta las conversaciones privadas sin los grupos grandes.

Cambios que pueden romper scripts

  • Compilado sobre cli-core 0.638.0 (antes 0.633.0) y cli-base 0.96.0 (antes 0.93.0). Al abrirse por primera vez, el almacén pasa a la versión 66. contacts unlink ahora exige --from person:<uid> o --from person:me: la persona de la que se desvincula la cuenta. Sin él, el comando se niega y dice qué añadir. Una cuenta ya registrada para otra persona no se mueve. Detalles en el historial de cambios de cli-core.

Corregido

  • Atrasar el reloj del sistema ya no detiene la sincronización durante horas. Si el reloj del ordenador iba adelantado y se corrigió, max creía que MAX le había pedido esperar y rechazaba cada sincronización, aunque ni siquiera se había conectado a MAX. Ahora la espera se recalcula según el tamaño del desfase, y el rechazo ya no dice que MAX pidió esperar.

0.109.0 — 10.11.2026

Novedades

  • muted: en la búsqueda y las estadísticas, de @wirecat/cli-core 0.633.0. muted:false deja fuera los chats en los que desactivaste las notificaciones, así que stats messages show -- 'date>=30d muted:false' cuenta solo lo que la sincronización todavía lee. stats messages responses y stats messages waiting también lo entienden.
  • store import, de @wirecat/cli-core 0.633.0. Carga chats, personas y mensajes inventados desde un archivo marcado como synthetic en un almacén de prueba, por ejemplo el entorno de pruebas de Desktop. No toca el almacén real del propietario.

0.108.0 — 10.11.2026

Cambios que pueden romper scripts

  • Compilado sobre cli-core 0.630.0 (antes 0.624.0). Al abrirse por primera vez, el almacén pasa a la versión 63. La vista de cada persona se guarda con ella, y guardar los miembros de un chat no toca las filas de quienes siguen en él, así que people list en memo filtra, cuenta y pagina en SQL. Quien escribió en un chat privado o en un grupo pequeño cuenta ahora como persona del propietario, ninguna regla une a nadie con el propio propietario, y un nombre coincide en cirílico y en latino. Una herramienta con un cli-core antiguo que guarda miembros borra las vistas guardadas, así que max, tg y memo se actualizan juntos. Qué cambió entre versiones, en el historial de cambios de cli-core.

0.107.0 — 09.11.2026

Cambios que pueden romper scripts

  • Compilado sobre cli-core 0.624.0 (antes 0.618.0). Al abrirse por primera vez, el almacén pasa a la versión 61 (vínculos de las personas con el propietario, solo añadidos). Qué cambió entre versiones, en el historial de cambios de cli-core.
  • search messages --timeout 30s busca hasta 29 segundos. Antes la búsqueda se detenía a los 2 segundos, sin importar cuánto tiempo se diera a la ejecución, y una consulta correcta sobre un almacén grande fallaba en WireCat Desktop. Sin --timeout, el límite sigue siendo de 2 segundos, también para agentes y MCP.
  • schedule pause <имя> y schedule resume <имя>: la programación se quita del temporizador y se conserva, y schedule run la sigue ejecutando. --at se puede dar varias veces: --at 08:30 --at 18:00.

0.106.0 — 09.11.2026

Novedades

  • Un pull request escribe sus líneas del historial de cambios en un archivo aparte, changes/<ветка>.md. Los pull requests abiertos ya no entran en conflicto en la sección «Sin publicar». pnpm docs:check comprueba cada uno de esos archivos, y bin/release los reúne en la sección de la versión. Durante la transición, una entrada en «Sin publicar» también funciona.

Corregido

  • max serve termina cuando su versión está desactualizada, y el servicio inicia la nueva. Una vez por minuto comprueba si el almacén compartido pasó a un formato en el que esta versión ya no puede escribir, y si hay instalada una versión más reciente de max. Si es así, escribe serve.outdated en el registro y sale con el código 3, y el servicio de systemd (Restart=on-failure) inicia la versión instalada. Por qué: antes serve podía seguir funcionando con una versión antigua sin guardar nada.
  • Después de max store recover run, la sincronización normal vuelve a cargar lo que pudo perderse con el daño. La recuperación marca como no cargado todo lo que el chat guardaba desde un día antes de la última comprobación profunda superada. De cli-core 0.618.0 (antes 0.616.0).

0.105.0 — 09.11.2026

Novedades

  • max <профиль> account remove --keep-data|--delete-data cierra la sesión del perfil en MAX y lo borra de este ordenador. El comando cierra la sesión en el servidor de MAX y después elimina el token del llavero y los archivos del perfil: el estado, el socket y el registro de max serve, y con ellos lo que la capa compartida guarda para el perfil. --keep-data conserva los mensajes en el almacén, y la búsqueda los encuentra. --delete-data también los elimina. Los demás perfiles no se ven afectados. Por qué: hasta ahora session end olvidaba solo el token y el resto del perfil quedaba. Qué tener en cuenta: mientras max serve funciona para el perfil, el comando se niega, igual que session end: primero max <профиль> server stop. El token del bot (bot:<профиль>) se conserva: un bot es una cuenta aparte. Una ejecución con carpetas movidas olvida solo su propia copia y no cierra la sesión del propietario en MAX.

0.104.0 — 08.11.2026

Cambios que pueden romper scripts

  • max abre un almacén que memo y otras herramientas de WireCat ya actualizaron, y él mismo lo pasa a la versión 57. Un almacén en la versión 56 o posterior no lo abren max 0.103.0 y anteriores ni ninguna herramienta con cli-core anterior a 0.606.0: piden actualizar. Qué tener en cuenta: actualiza max, tg y memo juntos (cli-core 0.606.0, 0.607.0).
  • --offline en un comando que necesita MAX responde permission_error (offline.refused) con el código de salida 5. Antes chats inspect, chats events, chats folders … y upgrade respondían validation_error con el código 2. Qué tener en cuenta: un script que espera ahí el código 2 debe esperar el 5 (cli-core 0.607.0).
  • contacts context y contacts prepare leen solo las cuentas del mismo ámbito que el perfil. Un perfil personal ya no muestra el correo, los mensajes, los eventos y las reuniones de una persona desde cuentas de trabajo, ni uno de trabajo desde cuentas personales. La respuesta tiene un campo nuevo, accounts: cada cuenta leída y su ámbito (cli-core 0.605.0).
  • Un nombre escrito con «е» encuentra un chat o una persona con «ё». Un nombre que antes coincidía con un solo chat o persona ahora puede coincidir con dos (Алена y Алёна). Entonces max se niega y nombra a ambos, como con cualquier nombre ambiguo (cli-core 0.601.0).
  • La búsqueda lee la consulta como palabras normales más a menudo. ? al final de una palabra es un signo de interrogación: счёт? encuentra «счёт». Un texto con dos puntos, un enlace, un paréntesis o unas comillas sin cerrar (встреча в 10:30) se busca como palabras, cuando antes la búsqueda se negaba (cli-core 0.602.0, 0.604.0).

Corregido

  • Un archivo de almacén dañado detiene la escritura y menciona max store recover. Antes, un comando que recibía de SQLite «database disk image is malformed» fallaba con internal_error. Ahora la respuesta es configuration_error (store.damaged), y los comandos siguientes que escriben se niegan hasta que pase una comprobación profunda o una recuperación. La lectura funciona (cli-core 0.605.0).
  • Nada vuelve a unir a las personas que separaste. Un tercer contacto con la misma dirección de correo podía volver a unir a dos personas después de que las separaras (cli-core 0.605.0).

0.103.0 — 07.11.2026

Cambios que pueden romper scripts

  • max schedule agent y max schedule command aceptan --deliver-to <маршрут> en lugar de --to <маршрут>, y schedule list llama al campo deliver_to (cli-core 0.600.0). Las programaciones guardadas con --to entregan el resultado como antes.

Corregido

  • Abrir el almacén ya no suelta los bloqueos del archivo SQLite. Antes el archivo se abría truncándolo, y eso liberaba los bloqueos POSIX que tenían otros procesos, así que dos escrituras podían cruzarse (cli-core 0.599.0).
  • max mcp serve --permission <ключ>=deny ahora también se aplica a los comandos propios de max. Antes, los niveles dados al servidor MCP no llegaban a las comprobaciones de max: un agente podía ejecutar contacts sync, messages transcribe, watch y los comandos de max bot (por ejemplo, bot comments send) con los niveles guardados del perfil, y la petición llegaba a MAX. Ahora ese comando recibe permission_error antes de conectarse. Qué tener en cuenta: un agente con esos niveles ya no pasa por el max serve compartido (que solo conoce los niveles guardados), sino que abre su propia conexión, igual que una ejecución con --permission en la terminal.

0.102.0 — 05.11.2026

Corregido

  • max bot list y max bot list --check vuelven a funcionar sin nombre de perfil. En 0.101.0, en un ordenador sin perfiles respondían con el error name a profile, y la lista de bots solo se obtenía poniendo cualquier palabra delante: max personal bot list. El comando lee todos los bots de este ordenador, así que no necesita perfil, igual que en tg y wa. Qué tener en cuenta: los demás comandos max bot … siguen necesitando un perfil, y max no lo elige por ti.

0.101.0 — 05.11.2026

Corregido

  • Una petición al Bot API y la subida de un archivo ya no retienen en memoria un comando terminado hasta el final de su tiempo límite. El temporizador del límite seguía hasta el final aunque MAX ya hubiera respondido, y retenía todo lo que el comando había cargado. Un proceso que hace muchas peticiones seguidas, como max bot mcp o max bot updates watch, crecía con cada petición. Lo mismo se corrige para --timeout de los comandos max bot.

0.100.0 — 05.11.2026

Novedades

  • max config migrate añade al archivo cada configuración que falta, con su valor integrado, y cualquier escritura de max en el archivo hace lo mismo. En config.json se ven y se editan todas las configuraciones, también serve y transcribe_model, sin consultar la documentación. Tus valores, su orden y las claves desconocidas se conservan; config unset no vuelve a escribir lo eliminado, y una simple lectura no reescribe el archivo (cli-core 0.563.0).
  • max config show muestra para cada configuración su valor integrado y lo que hace, y también keep_successful_runs_for_days y runs_size_limit_mb, que faltaban en la lista.
  • De cli-core 0.563.0: config repair repara la sintaxis JSON del archivo de configuración; stats messages responses y stats messages waiting; tasks status, tasks review y tasks acknowledge.
  • De cli-core 0.564.0–0.566.0: store chats status cuenta los chats que el archivo guarda desde el primer mensaje, en parte o nada; stats tasks show acepta una consulta y cuenta las tareas abiertas y cerradas en un periodo (-- created>=30d); has:transcript encuentra mensajes de voz con transcripción.

Cambios que pueden romper scripts

  • Una escritura en una tarea que cambió después de que la leyeras ahora termina con el código conflict, salida 15, y no con configuration_error, salida 3. El motivo sigue siendo task.stale (cli-core 0.567.0, cli-base 0.77.1).
  • max account list ya no muestra un bot como una cuenta sin sesión. Un nombre que solo tiene un bot no se muestra; un nombre que es a la vez tu cuenta y un bot lleva bot: true (cli-core 0.567.0).
  • El nuevo código de error conflict (código de salida 15) aparece en max commands --json y en el esquema de errores de las herramientas MCP (cli-base 0.77.1). Significa que una escritura se rechazó porque lo que cambia cambió después de leerlo. Lo devuelve una escritura en una tarea desde una copia desactualizada (ver arriba).
  • search all ordena todas las fuentes en una sola lista, busca también el correo por significado y encuentra registros para una pregunta escrita como frase (cli-core 0.564.0). Antes, los resultados de cada fuente iban uno tras otro, y una pregunta solo encontraba los registros que tenían todas sus palabras.

0.99.0 — 03.11.2026

Novedades

  • wcat max ejecuta el programa, y wcat --help lo muestra. El paquete instala el comando wcat-max junto a max, y wcat-max --wcat-describe imprime para wcat el nombre, la versión y la descripción del programa.

0.98.0 — 02.11.2026

Novedades

  • projects evidence y projects status leen los chats vinculados por finalidad: --purpose sales,work o --purpose all. Sin la opción se usan las finalidades por defecto (la integrada es work). Un chat que queda fuera de la selección no desaparece en silencio: es una fila missing con la finalidad, el número de mensajes y el comando que lo lee (cli-core 0.553.0).
  • projects evidence --include-proposed lee también los chats con personas propuestas para el proyecto pero aún no confirmadas; todo lo que aportan va marcado como proposed (cli-core 0.553.0).
  • projects evidence --compact imprime una línea por cada hallazgo, chat vinculado, chat omitido y miembro (cli-core 0.553.0).

Cambios que pueden romper scripts

  • El JSON de projects status tiene un campo nuevo, purposes, y un chat omitido por finalidad lleva la cuenta, el id del chat y los contadores (cli-core 0.553.0).

0.97.0 — 02.11.2026

Novedades

  • max serve recupera lo que llegó mientras no funcionaba. 30 segundos después de conectarse, lee los chats que tienen mensajes más nuevos que los que había en la copia cuando arrancó: no más de 7 días atrás, hasta 500 mensajes por chat y durante 5 minutos como máximo. Si estuvo parado más de una semana, ejecuta una vez max <profile> messages sync --all (cli-core 0.552.0).
  • server install habilita el servicio, y serve arranca en cada inicio de sesión y después de reiniciar el equipo. Para habilitar un servicio que instaló una versión anterior de max, repite max <profile> server install; server status muestra starts_at_login. Un servicio de una copia de trabajo del código de max se escribe, pero no se habilita (cli-core 0.552.0).
  • messages sync respeta los límites del historial: por defecto no lee un grupo de más de 50 personas (history_group_members_max), lee un grupo 365 días atrás y un chat personal 1095 (history_group_days, history_dialog_days), e indica lo que omitió en limited. --full-history lee más atrás en una ejecución; para leer siempre los grupos grandes, sube la configuración. Los mensajes nuevos nunca se pierden (cli-core 0.551.0).
  • max <profile> projects status <проект> muestra en qué punto está un proyecto, solo a partir de la copia local (cli-core 0.551.0).
  • --compact imprime una línea por elemento para un agente, a partir de la misma respuesta que --json (cli-core 0.550.0).
  • messages list lee una ventana por ambos lados, también sin red: 'date>=2026-10-01 date<2026-10-20' lee hacia delante desde el inicio y se detiene en el final. Antes, esa consulta se rechazaba (cli-core 0.547.0).
  • Un comando que necesita un chat o un mensaje acepta también la referencia que imprimen otros programas de WireCat (msg:…, chat:…) (cli-core 0.546.0).

Cambios que pueden romper scripts

  • Una búsqueda que se quedó sin tiempo termina con timeout y el motivo query.time-limit en unos 2 segundos, y no con validation_error / query.too-large tras mucho rato. La consulta es correcta; añade chat: o date: para buscar en una parte menor de la copia (cli-core 0.552.0).
  • Un texto de la forma <вид>:<без пробелов> en lugar de un chat se lee como referencia, y una referencia a otra cuenta o mensajero se rechaza con su propio motivo. Una clave después de -- se lee como clave (cli-core 0.546.0).

Corregido

  • Una sincronización cuya salida se cerró termina su trabajo. Antes, un canal cerrado (EPIPE) la cortaba (cli-core 0.552.0).
  • messages delete sin número de mensaje se rechaza antes de conectarse (cli-core 0.551.0).
  • page.next de messages list se ejecuta tal como está escrito, y un inicio «inclusivo» conserva el mensaje enviado justo en ese momento (cli-core 0.547.0).
  • Si el llavero está bloqueado, max serve y una ejecución programada lo vuelven a intentar en lugar de pedir que inicies sesión de nuevo. Un perfil que ya había iniciado sesión en este ordenador pero no podía leer su token respondía authentication_error (código 4). El servicio serve con RestartPreventExitStatus=4 ya no se reiniciaba hasta un server start manual, y un temporizador que saltaba al arrancar, antes del inicio de sesión, perdía su ejecución de todo el día. Ahora max serve y una ejecución bajo temporizador (MAX_SCHEDULED) responden provider_unavailable (código 12) con el motivo credentials.unreachable: systemd reinicia el servicio, y schedule exec (cli-core) repite la ejecución hasta que el inicio de sesión abre el llavero. Un comando escrito a mano responde como antes.

0.96.0 — 02.11.2026

Novedades

  • max <profile> messages download --offline copia un archivo que ya está en este ordenador, sin conectarse; --attachment <n> elige un archivo del mensaje, y en lugar del chat y el mensaje se puede pasar una referencia msg: (cli-core 0.532.0).
  • La primera ejecución de una versión nueva actualiza las instrucciones para agentes que instaló una versión antigua. Una copia desactualizada de SKILL.md (Claude Code, ~/.agents/skills, Hermes) se reescribe una vez, con una línea en stderr; el comando no toca una copia que no existe, que no tiene versión o que es un enlace. MAX_NO_SKILL_REFRESH=1 lo desactiva (cli-core 0.544.0).

Seguridad

  • Un agente ya no puede relajar los permisos desde su propio shell. max <profile> config set|unset permissions… ejecutado por un agente (Hermes, OpenClaw, Claude Code y otros que marcan su shell) solo puede endurecer un nivel, no relajarlo, y solo el propietario cambia mcp.authority y bot.api. Así el modo de solo lectura que pone la aplicación WireCat se mantiene aunque un mensaje en un chat convenza al agente de ejecutar config set. Cambia los permisos en una terminal fuera del agente (cli-core 0.544.0).

0.95.0 — 01.11.2026

Novedades

  • projects evidence --json da un comando de descarga para cada chat vinculado en linked_chats[].sync_command: la misma línea que en el texto, o null si el chat está cargado por completo (cli-core 0.517.0).

Corregido

  • projects evidence ya no escribe «held from only» sobre un chat que llegó a su primer mensaje: ahora es «held from its first message, behind since » o «with gaps». El progreso de messages sync muestra hasta dónde llegó con una fecha («back to »), y no con la clave del mensaje, que en MAX era un número de milisegundos (cli-core 0.517.0).

0.94.0 — 01.11.2026

Novedades

  • max <profile> projects evidence <project> (projectsCommand de cli-core). Muestra lo que los mensajes guardados de esta cuenta dicen de un proyecto: nombre, clave, otros nombres, palabras, contactos, miembros confirmados y chats vinculados. --sync-first (desactivado por defecto, no está en MCP) primero descarga los chats vinculados que el almacén no tiene hasta --since-time, de uno en uno, dentro de --sync-time (3 minutos para todos). Un chat para el que no alcanzó el tiempo queda parcial, con missing y next. Si la descarga falla (por ejemplo, hace falta un serve en marcha), el chat se marca failed con el motivo, y la lectura sigue. El acceso lo cierra el permiso messages (cli-core 0.511.0).

Cambios que pueden romper scripts

  • El registro de llamadas MCP nombra al agente que hizo la llamada, no max-mcp (cli-core 0.509.0): el nombre con el que se presentó el cliente (clientInfo.name, por ejemplo claude-code), si no el agente que arrancó el servidor, si no max-mcp. Un filtro por max-mcp no encuentra las llamadas nuevas. El nombre lo dice el propio cliente, es solo una etiqueta.

0.93.0 — 31.10.2026

Novedades

  • messages sync --json escribe el progreso de la sincronización en stderr (cli-core 0.507.0): una línea JSON cada vez, solo contadores, sin ids ni nombres de chats. stdout sigue llevando una sola respuesta.

Cambios que pueden romper scripts

  • search messages --discover busca por significado también cuando la consulta tiene -, NOT, OR, paréntesis, frases o exact: (cli-core 0.506.0). Antes, esa consulta solo hacía una búsqueda estricta. Ahora las palabras se siguen buscando con la consulta entera (discovery.method: "lexical-strict"), y se añaden mensajes cercanos en significado a sus palabras. Cada mensaje encontrado por significado, y cada respuesta o continuación añadida, cumple todos los campos de la consulta y no contiene ninguna palabra excluida.

Corregido

  • La descripción de doctor es la misma que en los demás CLI: «the state this installation is in, without connecting unless --online» (cli-core 0.507.0). Antes, max la sustituía por la suya, y el resumen no coincidía con el común.
  • search messages --discover con un filtro estrecho (chat:, date:) ordena por significado los mensajes del propio filtro, si no son más de 100 000, y no los 100 más cercanos de todo el archivo, así que la página se llena (cli-core 0.506.0).
  • search messages --discover funciona con una base de datos abierta solo para lectura (cli-core 0.506.0).
  • Una reconstrucción larga en un proceso ya no rompe una escritura en otro con el error "database is locked" (cli-core 0.506.0).
  • El archivo de reserva para el token ahora lo gestiona cli-base 0.68.0, sin código propio en max (cli-core 0.507.0). Un token del archivo privado se lee de ahí, y la rotación lo deja ahí; session start lo devuelve al llavero y borra la copia del archivo, como en 0.92.0. El aviso de llavero no disponible sigue siendo uno por ejecución.

0.92.0 — 31.10.2026

Novedades

  • search messages dice cuántos mensajes coinciden en total: page.total (cli-core 0.501.0). En --json aparece page.total: { value, relation } con la forma de hits.total de Elasticsearch: eq es un número exacto, gte significa «como mínimo» (el conteo se detiene en 10 000). En la terminal, debajo de los resultados: showing 1–20 of 144.
  • session start --credential-storage keyring|file. Por defecto el token va al almacén de contraseñas del sistema, y si no está disponible, a un archivo que solo tú puedes leer, sin preguntas y con un aviso. file elige el archivo directamente; no lo recomendamos. Un token del archivo se lee primero, así que ya no se toca un almacén bloqueado para él; el siguiente inicio de sesión con el almacén devuelve el token allí. La respuesta dice dónde quedó el token: credential_storage. Requiere cli-core 0.503.0.

Cambios que pueden romper scripts

  • max requiere cli-base 0.67.0 (cli-core 0.501.0).

0.91.0 — 31.10.2026

Novedades

  • messages list --offline, tasks agenda y search all avisan cuando la copia local tiene un chat solo en parte (cli-core 0.493.0). Un chat no descargado hasta el principio, o nunca descargado, da meta.complete: false, missing y next con el paso messages sync <чат> (primero para la ventana de la respuesta, si la tiene). En tasks agenda cada fila tiene completeness y held, y en el texto ese chat va marcado [partial] o [never fetched]. El código de salida sigue siendo 0.

Cambios que pueden romper scripts

  • search messages, search all, tasks agenda y messages list --offline responden meta.complete: false si un chat que leyeron está en la copia solo en parte (cli-core 0.493.0). Antes era true, y el hueco solo se veía en missing y next. Un script que tomaba meta.complete como señal de que «ninguna fuente falló» debe leer el motivo en missing. El código de salida sigue siendo 0.
  • Las continuaciones en search messages --discover --json llegan como fragmento de hasta 240 caracteres, igual que el propio resultado: items[].follow_ups[].excerpt en lugar de text (cli-core 0.496.0). En 0.90.0 la continuación llegaba como mensaje entero, y en un archivo real un solo mensaje largo añadía 7 KB a una respuesta de cinco resultados. messages context <ref> muestra el mensaje entero. La salida en la terminal no cambió.

Corregido

  • search messages --discover con fecha y hora entre comillas ya no falla con query.invalid-date (cli-core 0.496.0). La corrección de «22:00» en 0.90.0 reemplazaba los dos puntos entre cifras también dentro de las comillas, así que date:["2026-08-21T21:30:00Z" TO "…"] con --discover no funcionaba.
  • search notes y las notas de search all respetan los campos de la consulta también en lo encontrado por significado (cli-core 0.496.0). date:today o tag:work sin --exact devolvían unas 20 notas que no cumplían ningún campo. Ahora por significado solo se buscan las palabras de la consulta, y cada campo y cada palabra excluida (-draft) se aplican a todos los resultados.
  • En un documento de Drive, date: y el updated_at mostrado son el mismo momento, el de la edición en Drive (cli-core 0.496.0). Antes, date: leía el momento en que cambió la copia, y de 20 resultados para date>=30d, 16 mostraban una fecha más antigua.
  • Una ejecución con carpetas movidas ya no puede borrar del llavero el inicio de sesión del propietario ni cerrar su sesión en MAX (cli-base 0.65.5, WC-SECR-24). Antes, solo se consideraba movida una ejecución con MAX_*_DIR; una ejecución con otro HOME o carpeta XDG tocaba la entrada real max-cli, y session end en ella la borraba. Ahora esa ejecución lee el inicio de sesión del propietario, pero no lo cambia ni lo borra, y un inicio de sesión nuevo se escribe en una entrada temporal. session end sobre el inicio de sesión del propietario no cierra nada y responde kept: "owners-sign-in".
  • bin/max en una copia de trabajo del código ya no copia tokens: la copia lee el inicio de sesión del propietario, y scripts/seed-worktree.ts solo traslada el estado del perfil.
  • max requiere cli-base 0.65.5 y cli-core 0.496.0.

0.90.0 — 31.10.2026

Novedades

  • max <профиль> search messages '<вопрос>' --discover muestra continuaciones: mensajes posteriores que pueden cancelar o cambiar lo encontrado (cli-core 0.492.0). A los cinco primeros resultados se añaden hasta dos mensajes posteriores, de cualquier chat que lea la búsqueda, que comparten con él una palabra poco común (su raíz aparece en no más de tres mensajes del archivo): así se ve si una decisión se canceló después y la cancelación no fue una respuesta. En --json es items[].follow_ups, en la terminal las líneas later, shares a rare word. Qué tener en cuenta: las continuaciones aparecen cuando las raíces de las palabras ya están construidas.

Corregido

  • search messages --discover ya no falla con una pregunta que lleva una hora o una proporción («antes de las 22:00», «1:1») (cli-core 0.492.0). Los dos puntos entre cifras se leían como filtro de campo, y la búsqueda terminaba con el error query.invalid-syntax.
  • Corrección a 0.89.0: en esa misma versión, una escritura en el almacén dejó de fallar con «database is locked» mientras otro programa de WireCat escribe en él (cli-core 0.485.0). La entrada de 0.89.0 no lo dice.
  • max requiere cli-core 0.492.0 (cli-base sigue en 0.65.0).

0.89.0 — 31.10.2026

Novedades

  • contacts list notes: encuentra parte de una palabra sin importar mayúsculas o minúsculas, también en cirílico (cli-core 0.490.0). Antes, notes:КВАРТ no encontraba una nota con la palabra «квартира»: la comparación sin distinguir mayúsculas solo funcionaba con letras latinas, y la búsqueda leía todas las notas. Ahora las notas se buscan con un índice de tres caracteres y responden en milisegundos. Qué tener en cuenta: una consulta de menos de tres caracteres se rechaza con el error «search needs at least three characters» (una consulta vacía sigue sin seleccionar nada). El almacén se actualiza a la versión 40 la primera vez que se abre; las notas guardadas antes reciben el índice por partes durante search notes o store migrate, y mientras tanto se buscan con el método anterior. Una compilación de otro programa de WireCat con un cli-core antiguo no escribe el índice en un almacén ya actualizado, así que actualiza todos los programas de WireCat a la vez.

Corregido

  • Corrección a 0.88.0: los campos de la tarjeta de contacto se llaman firstName, lastName y userId. La entrada de 0.88.0 sobre el adjunto CONTACT los llama first_name, last_name y user_id; #874 los renombró, y la entrada se quedó como estaba.
  • max requiere cli-core 0.491.0 (cli-base sigue en 0.65.0). En 0.491.0 solo se corrige la sincronización del correo, que max no usa.

0.88.0 — 31.10.2026

Novedades

  • Una tarjeta de contacto en un mensaje (CONTACT) se lee como contacto: el adjunto tiene contact con el nombre, first_name, last_name y user_id. Antes ese adjunto llegaba solo con el tipo contact, sin nombre. Qué tener en cuenta: MAX no envía el teléfono en la tarjeta, así que no hay campo phone.

Corregido

  • La búsqueda por título de chat y por nombre de contacto no distingue mayúsculas en ningún alfabeto (cli-core 0.484.0). Antes, max <профиль> chats list 'title:СТАС*' --offline no encontraba el chat «Стас»: el almacén local solo comparaba sin distinguir mayúsculas las letras latinas. Ahora lo encuentra; name: en tags list funciona igual para títulos de chats y nombres de contactos. Qué tener en cuenta: el almacén se actualiza a la versión 38 la primera vez que se abre, sin que tengas que hacer nada. Si una compilación más antigua de otro programa de WireCat abre el mismo almacén y renombra algo, la búsqueda por el nombre nuevo funcionará cuando una compilación nueva vuelva a abrir el almacén.
  • max --help muestra gcal en la lista "Works with" (cli-core 0.482.0). Es Google Calendar junto a los demás datos de WireCat; max setup ofrece instalar @wirecat/gcal-cli. Si un script comprueba el texto de la primera pantalla, ahora tiene una línea más.
  • max requiere cli-core 0.484.0 (cli-base sigue en 0.65.0).

0.87.0 — 30.10.2026

Corregido

  • Los chats personales del almacén local reciben un título con el nombre de la otra persona, y max <профиль> chats list 'title:Стас*' --offline los encuentra. Antes, un chat personal no tenía título en el almacén, y cada inicio de sesión en MAX borraba lo que chats list había llegado a escribir, así que una búsqueda sin red por título no encontraba ningún chat personal, y los agentes tenían que recorrerlos todos. Ahora, tras iniciar sesión, el título se toma del nombre de la otra persona (el mismo que muestra contacts), también en los chats personales guardados antes. Qué tener en cuenta: un chat personal cuya otra persona no está en los contactos ni entre los miembros de los chats se queda sin título hasta que se ejecute chats list con red.

0.86.0 — 29.10.2026

Cambios que pueden romper scripts

  • max contacts info se sustituye por max contacts show (cli-core 0.477.0). Muestra el contacto completo, y el número de teléfono ahora se imprime entero, sin máscara. Qué hacer: en los scripts, cambia contacts info por contacts show. La forma antigua del comando ya no existe.
  • max requiere cli-core 0.478.0 (cli-base sigue en 0.65.0).

Corregido

  • sender_is_me en inbox, review, search messages y search all (cli-core 0.478.0). Estas respuestas no marcaban tus propios mensajes; ahora tienen el campo, como messages list.

0.85.0 — 29.10.2026

Cambios que pueden romper scripts

  • max mcp serve sin perfil ya no sirve todos los perfiles (cli-core 0.470.0). Termina con código 2 (validation_error) y enumera los perfiles de este ordenador. Nombra un perfil como primera palabra (max work mcp serve), una lista (max mcp serve --profiles work,personal) o todos (--profiles all). --http, mcp server start|stop|status, mcp revoke y mcp config funcionan igual. A quién afecta: una entrada de cliente MCP de 0.83.0–0.84.0 con max mcp serve sin perfil deja de arrancar; imprímela de nuevo con max mcp config --profiles all o añade el perfil. Un servidor en segundo plano de todos los perfiles iniciado por esas versiones se reinicia con max mcp server start --profiles all. La entrada del MCP Registry ya ejecuta mcp serve --profiles all, la imagen de Docker el perfil glama y doctor --online el perfil que comprueba.
  • Cada mensaje en las respuestas de messages list, show, context, la búsqueda e inbox tiene sender_is_me (cli-core 0.473.0). Es verdadero para tus propios mensajes, también en MAX, donde el propietario no tiene id de remitente. Un script que compara la respuesta con una copia estricta del esquema rechazará el campo nuevo.
  • max requiere cli-core 0.473.0 (cli-base sigue en 0.65.0). max --help ahora también nombra mail en "Works with".
  • La habilidad para agentes se publica en ClawHub como wirecat-max. Instalación: openclaw skills install @wirecat/wirecat-max. La entrada max-cli ya no se actualiza. max skill install sigue escribiendo skills/max-cli/.

0.84.0 — 27.10.2026

Cambios que pueden romper scripts

  • cli-core 0.469.0 y cli-base 0.65.0. cli-core 0.469 solo acepta cli-base 0.65, por eso ambas versiones cambian juntas. cli-base 0.65 incluye los verbos serve y revoke, así que sus entradas en la línea base del linter se eliminaron, y su cli-dev bundle encuentra un servidor iniciado con una opción antes de mcp serve. Desde cli-core 0.468, el servidor MCP ofrece un comando que solo carga datos en el almacén a través de la herramienta de lectura.

0.83.0 — 27.10.2026

Cambios que pueden romper scripts

  • El servidor MCP se inicia con max mcp serve, y max mcp solo muestra la ayuda (cli-core 0.463.0). Lo mismo para el bot: max <бот> bot mcp serve. Los inicios de sesión de las apps del navegador los termina max mcp revoke en lugar de max mcp --revoke. Las entradas que imprimen mcp config y mcp add, mcp server start, doctor --online, la entrada en el MCP Registry y la imagen de Docker ya ejecutan mcp serve. Qué hacer: en tu entrada del cliente MCP o en un script, sustituye max <профиль> mcp por max <профиль> mcp serve, y mcp --revoke por mcp revoke. La forma antigua del comando ya no existe.
  • skill show, skill status y skill install con --json imprimen { item, meta } (cli-core 0.462.0). Los campos que estaban en el nivel superior (name, content, written) ahora están dentro de item. El instalador de Windows ya lee la forma nueva.
  • max account list indica si el perfil tiene sesión iniciada en este equipo (signed_in), y los resultados de búsqueda de cualquier tipo nombran los campos que el agente lee como datos (untrusted). Un script que compara la respuesta con una copia estricta antigua del esquema rechazará el campo nuevo (cli-core 0.464.0 y 0.466.0).
  • Cada ejecución se registra de forma predeterminada, también la correcta (cli-core 0.467.0). Las correctas se guardan 7 días (keep_successful_runs_for_days), las fallidas 30 (keep_runs_for_days); la carpeta de ejecuciones no supera runs_size_limit_mb (200). Con record_input predeterminado, un envío correcto deja el texto escrito en el registro local con permisos 0600 durante 7 días. record: false ahora conserva las ejecuciones fallidas (antes, nada), record_input: false oculta lo escrito en todas partes, --no-record no conserva nada. kept_because_failed ya no se pone en run.json.
  • max requiere cli-core 0.467.0 y cli-base 0.64.0.

Novedades

  • Una solicitud en el registro de ejecución se marca como de red y conoce su intento. Cada trama del protocolo personal y cada solicitud de la Bot API en events.jsonl recibe "level": "wire" y transport (max-ws o http). Una solicitud de la Bot API recibe además attempt, y un reintento tras 429 o un fallo, wait_ms: cuánto esperó el cliente antes. Igual se numeran los reintentos de messages send mientras el archivo no está listo (attachment.not.ready). Requiere un cli-core que registre cada ejecución.
  • max upgrade reinicia el servidor MCP del navegador que inició max mcp server start, en el mismo puerto, con la misma dirección y restricciones (mcp_servers, versión antigua → nueva); un servidor iniciado a mano se queda y se nombra. Las sesiones de agentes por stdio en la versión antigua se enumeran (stale_sessions): reinícialas desde la app del agente. Funciona a partir de la próxima actualización (cli-core 0.464.0).

Corregido

  • max mcp serve sin perfil marca los perfiles sin sesión iniciada. Antes la lista tenía todos los perfiles, y la app podía elegir un perfil sin sesión y recibir un error. Ahora en el menú de la app y en la descripción ese perfil lleva «— not signed in», los perfiles solo de bot no se muestran (el bot tiene su propio bot mcp serve), y una llamada para un perfil sin sesión responde cómo entrar: max <профиль> setup o desde WireCat Desktop.
  • La página de inicio de sesión del servidor MCP del navegador explica que un código sirve para un solo inicio de sesión. Tras el inicio de sesión de una app, el código nuevo aparece en WireCat Desktop y en max mcp server status (cli-core 0.466.0).
  • El skill max-cli ya no envía al agente a search all ni a messages sync --all. La búsqueda empieza por search messages; las notas y Drive, solo si el propietario lo pide. Si no se encuentra nada, el agente lo dice y propone una descarga limitada de un chat, que inicia tras el consentimiento del propietario. Los mismos cambios en README y en docs (search, usage, index, troubleshooting).

0.82.0 — 27.10.2026

Novedades

  • Sin sesión, el error también propone WireCat Desktop. no session, has not logged in yet y un token caducado ahora dicen: un comando en el terminal o el inicio de sesión en WireCat Desktop (Tools → MAX → Manage). Por MCP se indica al agente que no pida códigos ni contraseñas (cli-core 0.452.0; con él también 0.451.0: búsqueda por significado con ONNX Runtime nativo también en Windows).
  • max mcp sin perfil atiende todos los perfiles, por stdio y con --http (cli-core 0.450.0). En la app de IA basta un conector para MAX, no uno por perfil. Cada herramienta (max_tools_search, max_read, max_write) tiene el campo obligatorio profile (todos los perfiles de este equipo, sin valor por defecto), y se indica al agente que pregunte si no nombraste la cuenta. La llamada va al propio max <profile> mcp de ese perfil: se inicia con la primera llamada y se cierra tras 10 minutos de inactividad, así que los permisos, la sesión y el registro del perfil funcionan como antes. max mcp --revoke, max mcp config y max mcp server start|stop|status funcionan sin perfil, con su propio inicio de sesión. --public-url acepta una ruta, https://<name>.ts.net/max. La entrada en el MCP Registry ejecuta max mcp. max <profile> mcp no cambió.

Cambios que pueden romper scripts

  • max requiere cli-base 0.63.0 (cli-core 0.450.0). Nada de lo que usa max cambió en ella.

Corregido

  • Cada comando tarda menos en prepararse (cli-base 0.62.0, cli-core 0.449.0). La comprobación de los comandos comunes describe cada comando una vez, no de nuevo para cada grupo por encima. En tg, un run(["--version"]) ya calentado es más rápido: 29 ms en lugar de 49. Por qué: la comprobación ocupaba cerca del 60 % de la preparación de cada comando. Qué tener en cuenta: nada, la comprobación detecta los mismos cambios.
  • La búsqueda por significado y --discover funcionan con ONNX Runtime nativo también en Windows (cli-core 0.451.0). Después de max <профиль> models download, los modelos de texto y el reordenador usan la biblioteca nativa en Windows x64 y arm64, como ya en Linux y macOS: de 2 a 3 veces más rápido que WebAssembly. La descarga toma onnxruntime.dll del paquete npm onnxruntime-node (113,5 MB, una vez, verificado por sha256). Los modelos de imágenes (CLIP, SigLIP2) también usan la biblioteca nativa donde está instalada: aproximadamente el doble de rápido. Los resultados son los mismos.

0.81.0 — 26.10.2026

Novedades

  • La búsqueda por significado y el reordenamiento de search messages --discover son de 2 a 3 veces más rápidos en Linux y en Mac con Apple Silicon (cli-core 0.448.0). Los modelos ahora se calculan con la biblioteca nativa ONNX Runtime en lugar de WebAssembly: en un mismo archivo, --discover pasó de 4,6 a 3,2 s, con las mismas respuestas. La biblioteca (10–42 MB, versión oficial de Microsoft, verificada por sha256) la instala max <профиль> models download; la búsqueda no descarga nada por sí sola. Qué tener en cuenta: en una máquina ya configurada, la mejora aparece tras el próximo models download e5-small o models download mmarco. Windows, los Mac con Intel y Alpine siguen funcionando con WebAssembly.

Corregido

  • El reordenamiento de --discover ve el propio mensaje encontrado, no solo aquel al que responde (cli-core 0.447.0). Antes el modelo leía primero el mensaje original completo y cortaba el texto en 512 tokens, así que con un original largo la respuesta quedaba fuera de su ventana. Ahora del original se toman los primeros 300 caracteres.

0.80.0 — 26.10.2026

Novedades

  • max <профиль> session start qr --json --answer-stdin inicia sesión sin terminal, para WireCat Desktop (cli-core 0.443.0). La contraseña en la nube de MAX se pide con una línea needs en stderr ({"event":"needs","field":"password","secret":true,"prompt","hint"}), y la respuesta se lee como una línea de stdin; session start token pide el token del mismo modo. Sin --answer-stdin, una ejecución sin terminal sigue rechazándose, para que el shell de un agente nunca espere una pregunta. La respuesta no se imprime ni llega a los registros de ejecución.
  • max <профиль> mcp server start|stop|status mantiene el servidor MCP HTTP en segundo plano (cli-core 0.445.0). start acepta --public-url, --port y --permission, como mcp --http, y vuelve cuando el servidor escucha; status muestra el puerto, la dirección, el código de acceso de un solo uso y las apps conectadas; stop detiene solo su propio servidor. WireCat Desktop lo inicia y lo detiene desde el panel Manage.
  • max <профиль> tasks list claimed_by:<кто> muestra las tareas que tomó ese ejecutor (cli-core 0.441.0). claimed_by:*: todas las tareas tomadas; NOT claimed_by:*: las que nadie tomó; un patrón como claimed_by:claude-code:* también funciona. Solo cuentan las tomas vigentes: una toma caducada no retiene nada.

Cambios que pueden romper scripts

  • La ayuda de --record dice lo que de verdad guarda el registro de ejecución. Antes: «ids and timings, never message content», aunque desde 0.79.0 el registro guarda la línea de comandos tal como la escribiste. Ahora: «with the command as typed and secrets hidden; record_input false leaves the typed words out». Qué tener en cuenta: cambia el texto de max --help y de docs/commands.md; una comprobación que compara la ayuda verá la línea nueva.

Corregido

  • El código de acceso para una app del navegador de mcp --http se renueva cuando caduca (cli-core 0.445.0), no solo tras una entrada errónea o tardía. La página de inicio de sesión dice que el código se muestra en WireCat Desktop o en el terminal. Un segundo mcp --http para el mismo perfil ahora se niega a iniciarse.
  • search messages --discover con reordenamiento lee solo los primeros 300 caracteres del mensaje al que responde el resultado (cli-core 0.447.0). Por qué: un mensaje original largo ocupaba toda la ventana del modelo, y este evaluaba el original en lugar de la respuesta. Qué tener en cuenta: el orden de los resultados de --discover con un modelo de reordenamiento puede cambiar; el modelo hace cerca de un 40 % menos de trabajo.

Seguridad

  • El registro de ejecución oculta más secretos por su forma, no solo por el nombre de la opción (cli-core 0.440.0–0.444.0). Se sustituyen por [redacted] los tokens de formatos conocidos (GitHub, OpenAI y Anthropic, Slack, AWS, Google, Stripe, npm, token de bot de Telegram, JWT, clave privada PEM), Bearer y Basic, el valor tras un nombre «secreto» (password=…, пароль 1234, pin 1234, код 123456), las cadenas aleatorias largas y las claves hex; las demás palabras se quedan. Un número de teléfono con «+» o de 11 a 15 cifras seguidas se oculta dondequiera que se escriba, incluso en el texto de un mensaje. Qué tener en cuenta: un hash de commit completo y un id positivo de 11 a 15 cifras también se convierten en [redacted]; un número sin «+» escrito por grupos (8 912 345-67-89) no se reconoce.
  • Si los ajustes no se cargaron, el registro de ejecución oculta las palabras escritas (cli-core 0.442.0). Antes, en ese caso record_input se consideraba activado aunque los ajustes tuvieran record_input: false.

0.79.0 — 26.10.2026

Novedades

  • max skill install --for hermes instala el skill para Hermes Agent, y max skill status dice qué copia lee Hermes (cli-base 0.59.0). El comando añade ~/.agents/skills a skills.external_dirs de Hermes con hermes config set, sin tocar las carpetas ya escritas, y si eso no funciona, copia el archivo a la carpeta personal de Hermes. Si Hermes no está instalado, el comando falla con not_found y no escribe nada. max skill install sin más y --for all siguen escribiendo solo las copias para Claude Code y ~/.agents/skills. En skill status --json aparece hermes junto a targets.
  • Una ejecución iniciada por OpenClaw o Hermes Agent nombra a ese agente (cli-core 0.437.0). En runs show, un comando que ejecutó el agente de OpenClaw tiene agent igual a openclaw, y si lo inició un mensaje de un chat, también from_chat: true; una ejecución de Hermes tiene su sesión, así que una tarea tomada por Hermes la retiene una sola sesión.
  • Nuevo ajuste record_input (cli-core 0.439.0). max personal config set record_input false oculta en los registros de ejecución lo que escribiste; config set y config show lo muestran.
  • El skill max-cli declara a OpenClaw y ClawHub que necesita el programa max y cómo instalarlo (metadata.openclaw: requires.bins y el paquete npm @wirecat/max-cli). Si max no está en el PATH, OpenClaw marca el skill como no listo y propone instalar el paquete. Claude Code y Codex no leen este bloque.

Cambios que pueden romper scripts

  • El registro de ejecución guarda la línea de comandos tal como la escribiste (cli-core 0.439.0). En argv de run.json y en runs show ahora se ven el nombre del chat, la consulta de búsqueda y el texto del mensaje; antes aparecía [redacted] en su lugar. Los secretos siempre se ocultan: valores de opciones como --token y --password, la contraseña en una dirección, una cadena larga que parece una clave, el cuerpo de bot api … --body, un número de teléfono escrito después de contacts lookup. Por qué: el registro debe mostrar qué se ejecutó exactamente. Qué tener en cuenta: max personal config set record_input false devuelve la ocultación anterior para un perfil, max config set record_input false --defaults, para todos; un script o una comprobación que espere solo [redacted] en argv verá las palabras escritas. doctor reports create sigue ocultándolas en el informe.

Seguridad

  • La primera palabra que no puede ser un perfil no llega al registro de ejecución (cli-core 0.438.0). Antes, esa ejecución la guardaba como profile, aunque podía ser el texto de un mensaje o el nombre de una persona.
  • Un error que cita --token=… o password=… ya no guarda el valor (cli-core 0.439.0).

Corregido

  • El skill max-cli ya no propone al agente npx @wirecat/max-cli si no encuentra max. Ejecuta el max ya instalado por su ruta completa: "$(npm prefix -g)/bin/max" personal doctor o "$(pnpm bin -g)/max" personal doctor. Por qué: npx descarga código, y los catálogos de plugins pueden prohibir esa ejecución; normalmente max está instalado, pero no está en el PATH del agente. Los agentes leen el skill con max skill show.

0.78.0 — 26.10.2026

Corregido

  • max se presenta como el cliente web actual de MAX: appVersion 26.10.7 y Chrome 154 (antes 26.9.8 y Chrome 151, leído el 25.09). MAX rechaza las versiones de cliente que ya no admite; max doctor muestra la fecha 2026-10-26.
  • npx skills add WireCatLabs/max-cli ofrece solo el skill max-cli. Antes también mostraba cuatro skills para desarrolladores de max (add-command, parity-audit, release, test-live): estaban en .claude/skills, y skills.sh también busca skills ahí. Ahora están en docs/dev/skills.
  • Un vector se elimina en cuanto ningún texto de la base lo usa (cli-core 0.435.0). Antes, tras cambiar la imagen de una foto, cambiar el texto de la transcripción de una reunión o limpiar un chat (store clear --left, la fusión de un chat con otro), los vectores se quedaban. conversations embeddings clear --chat ahora quita también los vectores de los mensajes del chat, no solo los de sus conversaciones; conversations embed --chat los vuelve a crear. Qué tener en cuenta: store rebuild elimina los vectores que quedaron de versiones anteriores e informa su número en unused_vectors_dropped; store check los cuenta en vectors.unused.
  • La instalación tiene una sola copia de sherpa-onnx, no dos (cli-core 0.433.0). En 0.77.0, max pasó a sherpa-onnx 2.0 antes que cli-core, y la instalación creció unos 15 MB; ahora cli-core también usa 2.0. Los comandos y su salida no cambian.

Cambios que pueden romper scripts

  • La base común pasa a la versión 34: los CLI con cli-core 0.433.0 o anterior ya no la abrirán (cli-core 0.434.0). La búsqueda por significado toma los candidatos del índice sqlite-vec de la base, en lugar de recorrer todos los vectores; la respuesta es la misma que la del recorrido. La primera apertura de la base con esta versión construye el índice con los vectores ya guardados, en porciones cortas. Por qué: recorrer todos los vectores es más lento con cada mensaje que tiene vector. Qué tener en cuenta: actualiza junto con max todos los CLI que leen la misma base (tg, wa, memo, zm, drive); los antiguos la rechazarán y pedirán actualizarse. La extensión forma parte de la instalación (@wirecat/cli-core-sqlite 1.1.0); si no se cargó, el comando que necesita la base termina con el error store.vector-extension-missing o store.vector-extension-failed: reinstala max. store check muestra vector_indexes y no pasa checks.vector_indexes cuando el índice no coincide con los vectores.
  • La ayuda de max upgrade muestra solo el ejemplo max upgrade --check (cli-core 0.433.0). Por qué: el ejemplo max upgrade sin opción, copiado y ejecutado, actualizaba el programa de inmediato. Qué tener en cuenta: en la salida de max upgrade --help y max commands --json solo cambia esa línea.
  • El modelo de Anthropic recibe la clave en la cabecera Authorization: Bearer, no en X-Api-Key (cli-core 0.433.0, @anthropic-ai/sdk 1.3). Por qué: así envía la clave la nueva versión de la biblioteca de Anthropic. Qué tener en cuenta: afecta solo a models.<назначение>.base_url con el proveedor anthropic, es decir, a una pasarela propia en lugar de la dirección de Anthropic: esa pasarela debe leer la clave de Authorization.

Novedades

  • search messages --discover reordena los primeros 50 resultados con un modelo reordenador cuando está descargado (max models download mmarco, 136 MB; cli-core 0.435.0). El modelo lee la pregunta junto con cada resultado, su chat, autor, fecha y el mensaje al que responde; su puntuación se mezcla con la de la búsqueda, y los demás resultados mantienen su orden. Cada resultado reordenado tiene discovery.reranker_score, y score sigue siendo la puntuación de la búsqueda. Sin el modelo el orden es el de antes, y la búsqueda lo dice: la nota not reranked: … en el terminal, missing/next (models.download) en --json y MCP. El reordenamiento tiene 15 segundos además de la búsqueda por palabras; si no le da tiempo, los resultados quedan sin él. El nuevo ajuste de perfil search_reranker elige bge-reranker-v2-m3 (588 MB) o desactiva el reordenamiento (off). Nada se descarga solo, y el texto no sale del equipo. models list muestra los reordenadores con el tipo reranker.
  • search all también busca mensajes por significado, cuando el modelo e5-small está descargado y los mensajes tienen vectores (cli-core 0.435.0). Las coincidencias por palabras y por significado se combinan en una lista de mensajes, y foundBy de cada uno dice qué búsqueda lo encontró. Una consulta con NOT o con un filtro dentro de OR y grupos, así como --exact y --backend server, buscan solo por palabras. Sin modelo o sin vectores, search all busca por palabras como antes y dice por qué: la nota messages: meaning search not used: …, missing/next en --json y MCP.

0.77.0 — 25.10.2026

Cambios que pueden romper scripts

  • El reconocimiento de mensajes de voz funciona con sherpa-onnx 2.0, y la instalación creció unos 15 MB. Antes max y cli-core usaban una sola copia de sherpa-onnx 1.13.8. Por qué: todas las dependencias se actualizaron a sus últimas versiones; en 2.0 solo se quitaron partes de síntesis de voz, el reconocimiento funciona como antes. Qué tener en cuenta: hasta que cli-core pase a sherpa-onnx 2.0, la instalación tiene dos copias de este paquete. Los comandos y su salida no cambian. string-width y wrap-ansi, que no se usaban, ya no se instalan con max; si tu script los cargaba desde la instalación de max, instálalos aparte.
  • Una ejecución de un comando bot que falló nombra la llamada de la Bot API en la que ocurrió. En runs show y runs list, error.http tiene junto al código HTTP method y endpoint_template, por ejemplo { "method": "GET", "endpoint_template": "/chats/:id", "status": 403 }; antes solo había el código. Por qué: con el código solo no se ve cuál de las llamadas del comando falló. Qué tener en cuenta: los id de chat, usuario y mensaje en la ruta se escriben como :id, el token de vídeo como :token, y los parámetros de la consulta no entran en la plantilla, así que los id y el token reales no llegan al registro. Los mismos dos campos están en las solicitudes del bot en --trace y en el registro de ejecución, y la línea de --trace los muestra tras el nombre de la operación (← getMyInfo GET /me 200 …). Un script que analiza el texto de --trace verá una columna más.

Novedades

  • store reset --dry-run enumera lo que vaciaría el reinicio y no borra nada (cli-core 0.429.0): los archivos de la base y su tamaño, cada tabla con datos y su número de filas, si se hará antes una copia y si serve u otro proceso tiene el archivo abierto.
  • search messages --discover también encuentra mensajes cercanos por significado, cuando el modelo e5-small está descargado y conversations rebuild dio a los mensajes sus propios vectores (cli-core 0.432.0). En cada resultado, discovery.found_by dice qué búsqueda lo encontró. Hasta entonces la búsqueda es por palabras, como antes, y explica por qué. Nada se descarga, y el texto no sale del equipo.

Corregido

  • Un --version sin más responde antes de cargar el programa: el bin se inicia con @wirecat/cli-core/cli/start (cli-core 0.429.0).

0.76.0 — 25.10.2026

Corregido

  • Un fallo a mitad de un comando ahora se informa como cualquier otro error. En lugar de una traza de pila de Node, se imprime un error internal_error (command.crashed): una línea en el terminal y un objeto JSON de error en los demás casos; el código de salida sigue siendo 1. Por qué: la traza no le dice nada a un script y puede mostrar en pantalla texto que no debe estar ahí. Qué tener en cuenta: si un script analizaba la traza en stderr, que lea el objeto de error.

Novedades

  • max doctor --json enumera todos los errores del archivo de ajustes en config.issues (cli-core 0.423.0). Cada error es { kind, file, profile?, key?, line?, column?, what, fix? }; kind es invalid_json, unknown_setting, unknown_permission, missing_setting o invalid_value. Si el JSON no es válido, line y column indican dónde se detuvo el análisis; en los demás casos, fix es un comando config unset que quita la clave y se ejecuta tal como está escrito. El valor del ajuste no aparece en la respuesta. Con errores en el archivo, doctor responde y termina con el código 0, y sin nombre de perfil responde con profile: null.
  • config show funciona con un archivo que tiene errores y nombra cada uno con el comando que lo quita. config unset también elimina una clave que ningún esquema conoce, incluso en la raíz del archivo (max config unset <clave>).
  • max skill status y max skill show --for claude|agents (cli-core 0.427.0). status dice si el SKILL.md instalado coincide con esta versión; show --for imprime la copia instalada.
  • max store tables list enumera las tablas del archivo común, y store info muestra más datos del archivo (cli-core 0.427.0).
  • El registro de una ejecución dice quién la inició y qué salió mal (cli-core 0.425.0). En run.json, runs list, runs show y search runs aparecen cli_command, argv (el contenido y los secretos son [redacted]), agent y, para una ejecución fallida, error.

Cambios que pueden romper scripts

  • npm install -g elige el agente para el skill solo según MAX_INSTALL_AGENT. TG_INSTALL_AGENT ya no se lee.
  • La respuesta de doctor tiene la lista config.issues en lugar de la cadena config.error. Si los ajustes no se pudieron resolver por un bloqueo del perfil, una opción o una variable de entorno, el mensaje está en settings.error.
  • Los nombres antiguos de ajustes ya no se reconocen. default_profile, analysis_provider, analysis_model, analysis_base_url con las variables MAX_ANALYSIS_* y los nombres en camelCase (sendsPerHour y otros) son ajustes desconocidos como cualquier otro: el comando se niega y nombra el config unset que quita la clave. El modelo de análisis se configura en models.analysis.provider, models.analysis.model y models.analysis.base_url.
  • messages sync y bot messages sync se comprueban con sus propias claves messages.sync y bot.messages.sync (cli-core 0.421.0). Un nivel en messages o bot.messages sigue aplicándose a ellos, y una denegación escrita directamente en messages.sync o bot.messages.sync ahora detiene el comando. Los comandos del bot comprueban la denegación de lectura antes de conectarse.
  • Una clave de permiso guardada que ningún comando comprueba detiene tanto los comandos del bot como --dry-run. El error nombra la clave y el config unset que la quita; config show, set y unset funcionan para que se pueda reparar el archivo.
  • Los nombres antiguos de comandos reciben la respuesta habitual «unknown command», sin pista. max personal search mail ya no nombra memo: el correo lo busca memo search mail.
  • Una ejecución sin perfil nombrado se registra sin profile, no con "profile": "default" (cli-core 0.424.0).
  • En el registro de una ejecución, la pila de un comando fallido empieza por el nombre del paquete y no tiene líneas de Node (cli-core 0.425.0). Una línea de la pila es MaxClient.connect @wirecat/max-cli/client.js:1497, no client.js:1497; ya no hay líneas node:internal.
  • config set escribe config.json con permisos 0600, no 0644 (cli-base 0.57.0). El archivo contiene los perfiles, cuentas y rutas del propietario. Un programa que lee los ajustes como otro usuario no podrá leerlos después del siguiente config set.

Seguridad

  • max doctor nombra config.json y su carpeta si otros usuarios pueden leerlos, y el comando chmod que lo corrige. En --json es files: { checked, ok, problems: [{ path, mode, want }] }; el archivo debe ser 0600 y la carpeta 0700. Por cada problema, stderr recibe una línea to make it private: chmod 600 '<ruta>'; doctor no cambia los permisos. La carpeta se comprueba también cuando la fija MAX_CONFIG_DIR. El bloque está presente sin nombre de perfil y cuando los ajustes no se resolvieron; también entra en el informe de doctor reports create. En Windows los permisos no se comprueban: files es { checked: false, reason }.

0.75.0 — 25.10.2026

Novedades

  • max --help nombra max account list: la lista de perfiles y sus cuentas con sesión iniciada.

Cambios que pueden romper scripts

  • Los nombres antiguos de los permisos de estadísticas y búsqueda ya no se reconocen. Antes, las claves messages.stats, chats.stats, tasks.stats, messages.search, conversations.search y topics.search detenían el comando con una pista para renombrarlas; ahora esa clave simplemente no tiene efecto, y una denegación guardada con el nombre antiguo ya no se aplica. Renómbralas a stats.messages.show, stats.chats.show, stats.tasks.show, search.messages, search.conversations y search.topics.
  • La base de datos común pasa a la versión 33 (cli-core 0.420.0). Cuando esta versión abra la base, un CLI con un cli-core más antiguo se negará a trabajar con ella y pedirá actualizarse, así que actualiza juntos todos los CLI de WireCat que comparten la base.

0.74.0 — 25.10.2026

Cambios que pueden romper scripts

  • bot store fetch ahora es bot messages sync; el grupo bot store ya no existe. El comando hace lo mismo que el messages sync personal, así que ahora se llama igual; store es la base de datos local. El nombre antiguo responde con una pista que indica el nuevo. Si tus ajustes guardan permissions.bot.store.fetch, los comandos se niegan a ejecutarse hasta que la clave se renombre a permissions.bot.messages.sync.

0.73.0 — 25.10.2026

Novedades

  • chats requests confirm|reject <chat> --all responde a todas las solicitudes de un canal a la vez. Primero se comprueba el número de solicitudes con los permisos del perfil y el límite de acciones por hora; después se envía una sola petición a MAX. Úsalo solo en un canal donde todas las solicitudes pendientes deban recibir la misma respuesta. No se puede filtrar con --link: la interfaz actual de MAX no indica por qué enlace llegó la solicitud.

  • Las listas de miembros, comentarios y destinatarios permitidos del bot aceptan una consulta por campos. Los identificadores de miembros y comentarios se pasan a la Bot API antes de aplicar el límite de página; la lista de destinatarios se filtra al leerla y no cambia los permisos de envío. Un comentario también muestra su id de texto cuando la API lo envió en body.mid.

Correcciones

  • watch --jsonl imprime registros item y un end final. Un fallo del origen termina el flujo con un resumen incompleto; --json se niega antes de suscribirse. La lista de destinatarios permitidos usa la consulta nativa común.

  • El archivado ya no se detiene ante un evento de llamada junto a un archivo. El archivo se guarda y se verifica su suma de comprobación; los mensajes que solo contienen una llamada no requieren descarga.

  • El informe de diagnóstico usa el módulo común de WireCat. Se mantienen el formato de MAX y los campos técnicos de los eventos; el contenido de los mensajes se excluye y los identificadores reciben etiquetas dentro del informe.

  • Una denegación de permisos no oculta el comando. Los catálogos de la CLI y de MCP conservan los comandos y muestran su disponibilidad actual con el motivo de la denegación; la llamada sigue comprobando los permisos. El MCP del bot también muestra los comandos de configuración dentro del perfil del bot.

  • El cambio de ajustes usa la implementación común de WireCat. config set|unset mantiene el formato de respuesta, los ajustes de MAX y los límites de permisos; el módulo común comprueba y escribe el archivo.

Cambios que pueden romper scripts

  • Una segunda dirección de webhook se añade con --append. --add <chat> sigue siendo la opción para cambiar carpetas. La composición desconocida de un chat y la lista de tipos de webhook ahora se omiten en lugar de ser null.

  • Los contratos comunes de los comandos no pueden cambiar en silencio. commands info --json muestra las definiciones de origen, los esquemas, los motivos de error y las diferencias explícitas de MAX. Los eventos de contacto usan at: y scope: en lugar de opciones de tiempo y ámbito, y los registros de diagnóstico usan started_at:.

Seguridad

  • La resolución de dependencias excluye las versiones vulnerables de Vite. Las dependencias de producción se comprueban tanto en la resolución guardada como en una nueva.

0.72.0 — 24.10.2026

Novedades

  • Tras iniciar sesión, max serve realiza más peticiones de las que hace web.max.ru: fichas y estado en línea de contactos de chats personales; tras el primer inicio, también historias para la lista, chats que faltan en carpetas y la siguiente página de chats. Reduce las diferencias respecto al cliente web, aunque MAX aún puede distinguir la herramienta. Son lecturas cuyas respuestas no se muestran. No se suscribe a notificaciones push (peticiones de red).

  • El primer inicio normal de max en el terminal hace tres preguntas comunes: idiomas de búsqueda, instalación de otras herramientas WireCat y permiso para hacer cambios. Elegir solo lectura limita todos los perfiles, incluido MCP, incluso con un allow más específico. No pregunta a agentes, tuberías, modo JSON ni CI. Cambia las respuestas con max setup.

Cambios que pueden afectar a scripts

  • Los comandos comunes adoptan nombres canónicos; se eliminan los anteriores (cli-core 0.406.0): contacts profile → contacts info, contacts timeline → contacts events, contacts alias → contacts aliases, chats link → chats links, metadata refresh → metadata sync, store reindex → store rebuild, commands schema → commands info, stats messages counters refresh → stats messages counters sync, models text key → models keys, models audio list → models list kind:audio, doctor report → doctor reports show. El comando antiguo se niega a ejecutarse e indica el nuevo; también se eliminan los alias ocultos de opciones. Actualiza scripts, horarios y llamadas MCP guardadas. Una ruta de permisos antigua como permissions.metadata.refresh detiene la ejecución con configuration_error e indica la nueva.

  • max <profile> watch --json emite registros { "type": "item", "data": … } y uno final { "type": "end" } (cli-core 0.400.0). Los campos de mensajes y eventos usan snake_case y valores canónicos con referencias. La parada normal y el tiempo agotado producen un end completo; un fallo del origen, uno incompleto y un código de error. Actualiza los lectores de las antiguas líneas sin envoltura.

  • La búsqueda de ejecuciones es max <profile> search runs (search runs), en lugar de runs search. Escribe status:, error_code:, operation: y profile: en la consulta: search runs status:failed error_code:timeout. No hay alias; migra las peticiones MCP guardadas.

  • Las estadísticas seleccionan filas mediante términos de consulta. Sustituye --chat y --exact por chat: y exact:; los rankings usan message_kind: y min_messages:, las discusiones min_views: y max_replies:, las preguntas sin respuesta older_than:. Actualiza CLI y MCP; --source y --timezone siguen siendo opciones.

  • Los comandos que cambian lo que podrán hacer futuras ejecuciones requieren permissions.mcp.authority: allow o ask en MCP, con deny por defecto: config set|unset, recipients add|remove|clear, replies …, schedule command|agent|remove, skill install, flood clear, claves de modelos y operaciones similares. El agente no puede cambiar esta clave mediante config set. Consulta qué no ofrece MCP.

  • El mantenimiento del archivo, el control del servidor, la descarga de modelos y la creación de informes están disponibles mediante MCP. Tienen claves propias como store.backup, server.start, models.download, doctor.reports.create, con ask por defecto. Revisa los permisos si el agente debe limitarse a leer: MCP permite una escritura solicitada con ask sin formulario de confirmación.

  • bot api requiere un permissions.bot.api: allow o ask explícito para el agente. El valor predeterminado es deny; un bot: allow general no lo habilita. El agente no puede cambiar mcp ni bot.api en los ajustes ni sustituir todo permissions; puede cambiar otras claves individuales si lo permite mcp.authority. En max se mantienen las comprobaciones de permisos, destinatarios y registro de escrituras.

  • Lee pares de tareas similares mediante tasks duplicates list [query...]. El grupo tasks duplicates ya no muestra la lista. Migra las llamadas CLI y MCP guardadas al list explícito.

  • events list devuelve fechas ISO 8601 e identificadores de texto. starts_at, ends_at, deleted_at, created_at, updated_at dejan de ser números de milisegundos; id y event_series_id dejan de ser números. Actualiza los lectores JSON que dependían de esos tipos.

  • doctor reports create comprueba los permisos antes de crear un archivo. Una configuración inválida devuelve el código 3 porque no se puede comprobar el permiso de escritura. Lee el motivo con doctor y corrige primero el ajuste. Con una configuración válida, la creación segura de informes también está disponible con MAX_READ_ONLY.

Corregido

  • attachments download omite eventos de servicio y teclados integrados. No contienen archivos; antes detenían la copia del chat con el código 13. Comprueba las copias existentes con attachments check; repetir la descarga las conserva.

0.71.0 — 23.10.2026

Novedades

  • Las transcripciones de voz coinciden con formas de palabras y distorsiones del reconocimiento (cli-core 0.396.0). max <profile> search messages риелтор encuentra tanto «риелтору» como «реелтора» en transcripciones. Un resultado encontrado solo por distorsión lleva match: "corrected" y corrections. No se amplían números, frases, exact: ni texto escrito. El texto que guarda un agente para un mensaje de voz también es una transcripción. El almacén migra a la versión 29 al iniciarse.

  • MCP ofrece más comandos dentro de los permisos del perfil (cli-core 0.398.0): config show, doctor report, runs list|show|path, store status|info|check|export|reindex, store jobs cancel|retry|clear, attachments move, attachments jobs status, commands schema, guide, skill show, listas de modelos, replies status|test|consents show, schedule list, server status|logs; para bots, list, chats leave, chats admins add|remove, commands set|clear, webhooks list|set|delete. Consulta qué no ofrece MCP para las exclusiones y sus motivos. Son los nombres de esta versión histórica.

  • max <profile> review --offline responde desde el archivo local en vez de negarse (cli-core 0.398.0). Solo muestra lo sincronizado y advierte de los datos ausentes (missing en JSON).

  • Copias de archivos verificadas. attachments download <dir> guarda archivos disponibles de varios chats con tamaño y SHA-256; attachments check <dir> comprueba copias sin red. attachments jobs controla las copias diarias de Linux habilitadas explícitamente. Las copias completas sobreviven a interrupciones y al borrado del historial. attachments move <dir> <archive-dir> --before-time <time> mueve imágenes antiguas a otro archivo verificado y registra la nueva ubicación para comprobarlas y evitar descargas repetidas.

  • La búsqueda de transcripciones guardadas encuentra formas de palabras y grafías distorsionadas por el reconocimiento. text: busca solo texto escrito; exact: desactiva la ampliación para esa palabra.

Corregido

  • Los ejemplos de --help se pueden pegar y ejecutar: Example: incluye el perfil personal (max personal review "date>2h") en vez de fallar con «name a profile» (cli-core 0.398.0).
  • Las búsquedas de reuniones guardadas ya no se muestran ni eliminan mediante comandos de búsqueda de mensajes.
  • Las sugerencias de corrección mantienen el perfil elegido; la ayuda muestra descripciones breves y ejemplos.

Cambios que pueden afectar a scripts

  • En argumentos MCP, borrar mensajes acepta message, exportar chats acepta chat y las operaciones con tareas duplicadas aceptan task y, para un par, other_task. Actualiza peticiones guardadas con messages, chats o dup. El orden posicional de CLI no cambia.
  • Los comandos de referencia commands y commands schema rechazan --jsonl: usa --json para un documento.

0.70.0 — 23.10.2026

Novedades

  • contacts prepare <person> prepara un resumen antes de conversar a partir de mensajes, tareas, hechos y notas guardados, con enlaces a fuentes. Es común con tg y wa y no conecta a MAX (cli-core 0.394.0).
  • La ayuda incluye ejemplos de invocación de cli-core 0.394.0.

Cambios que pueden afectar a scripts

  • Leer ya no marca chats como leídos. messages list ya no acepta --mark-read; inbox y review ya no aceptan --mark-read ni --no-mark-read; catch_up_marks_read deja de ser válido. Envía una confirmación explícita con chats mark-read.
  • Las claves de permisos anidadas desconocidas se rechazan como errores de configuración antes de conectar. Corrige la clave en vez de depender del antiguo aviso.

0.69.0 — 22.10.2026

Novedades

  • Las respuestas JSON filtradas por fecha identifican la zona usada y el intervalo UTC (cli-core 0.385.0): meta.timezone indica la zona si faltaba en la entrada; meta.window da los límites UTC since y until. Afecta a stats chats show, stats chats retention, stats messages unanswered, stats messages discussion, stats contacts responses, stats chats newcomers, contacts context, search conversations, runs search, messages sync, store export, replies test, y a inbox, review, chats events, chats members history con time: o date: en la consulta. Hace visible el intervalo elegido. Son campos nuevos y opcionales; los anteriores no cambian. search conversations interpreta una fecha sin hora en --timezone cuando se indica.
  • El JSON del chat incluye muted_until (fin del silencio en UTC) y marked_unread (chat marcado sin leer), desde cli-core 0.382.0.

Cambios que pueden afectar a scripts

  • inbox y review basados en el archivo omiten chats silenciados y archivados (cli-core 0.382.0). El archivo guarda esas marcas de MAX y sus resultados coinciden con MAX. Usa chats list si un script esperaba esos chats en la bandeja.
  • Un almacén sin permiso de escritura devuelve permission_error, código 5 y motivo store.not-writable (cli-core 0.381.0), en lugar de internal_error con «this is a bug». Actualiza los scripts que gestionaban el antiguo código.

Corregido

  • Los nombres copiados con emojis encuentran el chat o persona (cli-core 0.381.0). Un emoji copiado puede contener un selector invisible ausente al escribirlo; antes «Семья❤️» no encontraba «Семья❤».

0.68.0 — 22.10.2026

Cambios que pueden afectar a scripts

  • Las fechas y horas sin zona en --since-time, --until-time, --at-time y chats mute --until usan la zona del ordenador; una fecha sola significa medianoche local (cli-core 0.379.0, cli-base 0.48.0). Antes 2026-09-01 significaba medianoche UTC. Una zona explícita (…Z, +02:00) sigue prevaleciendo; --timezone del comando prevalece sobre la del ordenador. Un límite superior sin hora incluye todo el día local. Así se respeta el día del propietario. Los scripts que esperen UTC deben indicarlo, por ejemplo 2026-09-01T00:00:00Z; las horas JSON siguen en UTC con Z.
  • stats chats retention y chats stats show interpretan --since-time y --until-time en --timezone; el límite superior de retención sin hora incluye el día local completo (cli-core 0.380.0). stats charts, contacts timeline y MCP stats identifican la zona en meta.timezone y el intervalo UTC en meta.window.

Corregido

  • max watch muestra las horas de mensajes en la zona del ordenador, anunciada como times in <пояс> antes del primer mensaje. Antes no se indicaba. Las líneas --jsonl no cambian en esta versión.
  • max doctor y los rechazos de inicio tras demasiados intentos muestran horas como 2026-10-21 16:03 Europe/Madrid, en lugar de la forma UTC 2026-10-21T14:03:00.000Z, fácil de confundir con hora local. max doctor --json mantiene UTC.

0.67.0 — 21.10.2026

Corregido

  • Un llavero Linux bloqueado o no disponible avisa y recurre al archivo de credenciales (cli-base 0.47.5). El llavero se lee solo mediante Secret Service. Antes un fallo podía guardar silenciosamente en memoria del núcleo, que se pierde al cerrar sesión o reiniciar.

0.66.0 — 20.10.2026

Novedades

  • El almacén guarda el historial de un chat (versión 25 del almacén, cli-core 0.366.0). Un cambio de id, título, pertenencia o visibilidad de un chat se escribe en chat_revisions con el valor anterior y el nuevo; una lectura por el id antiguo de un chat que recibió uno nuevo lo encuentra. El almacén pasa a la versión 25 al abrirse por primera vez; no se envía nada.

Correcciones

  • Un chat que abandonaste se encuentra por cualquiera de sus ids (cli-core 0.368.0): store export, store status, messages thread, --chat y chat: en la búsqueda, etiquetas, tareas y las demás lecturas de su historial guardado. chats track y store gaps plan rechazan un chat abandonado: «you left chat ».
  • max guide catch-up y la primera pantalla de max --help ponen el filtro entre comillas: max review 'date>1d' --unanswered 4h. Sin comillas, la shell leía > como una redirección: creaba un archivo llamado 1d y review se ejecutaba sin el filtro. Con cli-core 0.370.0, la comprobación de escenarios en las pruebas detecta esos caracteres fuera de comillas.
  • «Works with» escribe el título del escenario de memo igual que memo y las demás herramientas: «One person across every tool», con mayúscula.

0.65.0 — 19.10.2026

Novedades

  • store clear --left nombra los chats que elimina (cli-core 0.353.0–0.362.0). El rechazo sin --allow-dangerous enumera los primeros 20 por id, título y número de mensajes; el nuevo --dry-run los muestra todos en left y no elimina nada; la respuesta tras eliminar también incluye left.

Cambios — pueden romper scripts

  • Sin terminal, session start qr y setup imprimen el código QR como texto, y --qr-file desaparece. El propietario iniciaba sesión con un PNG que el agente abría en un visor de imágenes, una ventana aparte fácil de perder. Ahora el código va a stderr como texto plano (caracteres █▀▄, sin color, legible en un tema oscuro) y el agente lo pega en el chat como bloque de código. Con --json el código también es una línea {"event":"qr","qr":{"text","expires_at","scan"}} en stderr. En una terminal el código se dibuja como antes. Un script con --qr-file recibe ahora un error de opción desconocida. Cómo inicia sesión un agente: sessions.md.

Correcciones

  • Un chat al que el propietario volvió ya no queda marcado como «abandonado» (cli-core 0.352.0). Una lista de chats incompleta y el inicio de sesión quitan esa marca de los chats que nombran; «archivado» y otros estados se mantienen. Antes, ese chat podía desaparecer de max chats list, y store clear --left lo eliminaba con sus mensajes. Una lista completa sigue marcando como «abandonados» los chats que no contiene.

0.64.0 — 19.10.2026

Novedades

  • session start qr --qr-file <png> y setup --qr-file <png>, como en tg y wa: el código QR se escribe en un PNG para el agente, sin terminal. El archivo se crea desde el principio con modo 0600 y se elimina tras el acceso. El acceso por QR pasa ahora por loginQr de cli-core 0.347.0, uno para los tres CLI.
  • El siguiente paso en la salida --json y en un error incluye line, el comando completo con el perfil (cli-core 0.348.0): "line": "max personal mcp config" junto a "command": "mcp config". Un command copiado solo fallaba con «name a profile». command no cambia; las respuestas MCP no tienen line.

Cambios — pueden romper scripts

  • Una terminal estrecha ya no abre el código QR en un navegador. El código no se dibuja y max indica ensanchar la ventana o pasar --qr-file. Por qué: el acceso por QR es ahora común a tg, max y wa, y un navegador que se abre solo no se podía llevar a cli-core para los tres. MAX emite un código por ejecución, así que en una ventana estrecha no hay nada que esperar: interrumpe el comando y ejecútalo de nuevo más ancho o con --qr-file.
  • Sin terminal, session start qr y setup responden igual que tg y wa: «shows a QR code to scan — run it in a terminal, or pass --qr-file ».

Correcciones

  • El paso de acceso en setup se llama «Link this device» y ya no pide escanear un código QR antes de dibujarlo. La línea bajo el propio código dice dónde escanear; en una terminal estrecha, solo la sugerencia de ensancharla.
  • Una terminal estrecha ya no pide escanear un código QR que no está (cli-core 0.350.0). session start qr y setup escribían «scan this code with the MAX app on your phone» antes del código; si el código no cabía, solo seguía la sugerencia de ensanchar la ventana o pasar --qr-file. Ahora la línea «scan in the MAX app on your phone» va tras el código dibujado o la nota sobre --qr-file, y una terminal estrecha muestra solo la sugerencia.
  • Las sugerencias en errores y notas nombran el perfil: «the store is behind this build — max personal store migrate» en lugar de max store migrate, que al copiarse fallaba con «name a profile». Lo mismo con la sugerencia para descargar el modelo de voz: max personal models audio download gigaam-v3.

0.63.0 — 19.10.2026

Novedades

  • max --help y max sin comando muestran una primera pantalla corta (cli-core 0.345.0): qué sabe hacer max, las otras herramientas de WireCat y adónde ir después — max commands, max guide, max help options, max skill show. Ya no imprime la lista completa de comandos ni todas las opciones generales.
  • max guide — escenarios: qué comandos ejecutar, en orden, para una tarea frecuente. Cuatro escenarios: catch-up (ponerse al día con lo acumulado), find-what-was-said (encontrar lo que alguien escribió), agent-on-a-timer (un agente programado que no puede enviar) y post-as-a-bot (escribir en nombre de un bot). max guide <имя> imprime los pasos, --json lo mismo como datos. El escenario memo guide person-brief aparece en la sección «Works with».
  • max help options imprime las opciones de todos los comandos, max --help-all la ayuda completa de antes.
  • max commands sin --json imprime la lista de comandos por secciones (Read, Write, Organise, Automate, Set up), una línea por comando; max commands <путь> la acota.
  • La ayuda de cada comando termina con las líneas Returns, Next usually y Example, y las mismas líneas están en la referencia de comandos.

Cambios — pueden romper scripts

  • npm install -g ya no instala por sí solo la habilidad del agente. Escribía sin avisar en ~/.claude/skills y ~/.agents/skills, y npm oculta la salida del script de instalación. Ahora la habilidad la instala max <профиль> setup o max skill install --for all; MAX_INSTALL_AGENT=all (o el nombre de un agente) durante la instalación la instala en el acto, como antes. El instalador de Windows pasa all él mismo y se comporta como antes.
  • max --help ya no enumera los comandos ni las opciones generales. Un script que los buscaba ahí necesita max --help-all o max help options.
  • max commands sin --json imprime texto, incluso hacia una tubería. Antes imprimía el documento JSON completo (cientos de kilobytes); un script que lo analizaba tiene que añadir --json.
  • Una errata en una opción de una lista con consulta es un error de opción desconocida (unknown option '--limt' (Did you mean --limit?)), no una palabra de la consulta. Una negación como -kind:channel sigue siendo parte de la consulta.

Correcciones

  • inbox y review declaran su salida (cli-core 0.345.0): max commands schema inbox da los campos del resumen del mensaje, y --json=<поля> con un nombre que no tiene se rechaza con la lista de campos en lugar de devolver registros vacíos.
  • --brief y --full ya no mencionan el correo en la ayuda de max.
  • Una errata en el nombre del perfil ya no crea un perfil. max typoprofile chats list se negaba, pero dejaba el archivo profiles/typoprofile.json, y después el error «name a profile» y max complete ofrecían typoprofile como perfil de este equipo. Ahora el archivo solo aparece al iniciar sesión; session end con un nombre así tampoco lo crea. Los archivos que quedaron de erratas anteriores se pueden borrar de ~/.local/share/max-cli/profiles/.
  • max <профиль> doctor sin token aconseja max <профиль> setup, como el README y el error «no session», y no session start.

Seguridad

  • La prohibición de escribir actúa antes de conectarse a MAX (cli-core). Con MAX_READ_ONLY=1 o con el nivel readonly o deny, messages send, messages edit, messages delete --for-everyone, reactions add y otras escrituras primero se conectaban a MAX y solo después recibían la negativa; con el inicio de sesión roto salían con el código 10. Ahora es el código 5, sin conexión, como promete la página de seguridad. La negativa queda en sends list como una línea corta: la clave del comando y el tipo, y el chat solo si se indicó su id.
  • --dry-run con MAX_READ_ONLY ya no responde «se puede» a una escritura que la ejecución real prohibiría.
  • max mcp con MAX_READ_ONLY no ofrece escrituras en MAX, y la llamada a un comando así mediante max_write recibe la negativa de la prohibición, no «no existe ese comando».

0.62.0 — 18.10.2026

Novedades

  • Por max mcp el agente recibe todos los comandos que permiten los niveles del perfil (cli-core 0.341.0). Antes el servidor ofrecía 141 herramientas escritas a mano; ahora las herramientas se construyen a partir de los propios comandos, y el agente dispone de 181 comandos, entre ellos messages sync, contacts sync, chats members fetch, chats tracking add/remove, contacts link/unlink, mentions confirm/reject/rebuild, conversations embed, images embed, tasks reject, contacts import, account privacy set y chats app. Lo que el agente no puede hacer lo deciden los niveles del perfil: pon readonly o deny en el área que quieras. La lista completa está fijada en contracts/mcp-catalogue.json.
  • conversations rebuild vuelve a construir las conversaciones de los chats que cambiaron y calcula sus vectores con el modelo de este equipo; no consulta a MAX, no descarga ningún modelo y no envía texto a ninguna parte. Sustituye a la herramienta de agente conversations_refresh.

Cambios — pueden romper scripts

  • Los argumentos de las herramientas de max mcp se llaman como las opciones de los comandos, en snake_case: chat, limit, query, sync_first, etc. Un agente que recordaba los nombres antiguos tiene que volver a consultar max_tools_search.
  • search messages de un agente ya no acepta la consulta estructurada ast: solo el texto de la consulta, como en la línea de comandos.
  • Un agente no puede marcar como leído ni actuar en nombre del propietario: no se le ofrecen --mark-read en messages list, inbox y review, --as-owner ni messages send --allow-any-file, y el ajuste catch_up_marks_read no se aplica a sus ejecuciones. Sus puntos de control --new son distintos de los tuyos.

Correcciones

  • max mcp responde a todas las llamadas recibidas antes de que se cierre stdin, en lugar de salir y abandonar la que seguía en curso. max bot mcp aún no lo hace.
  • max tasks --help ya no promete que serve abra tareas. La ayuda decía "review and serve add them". Ahora dice que las tareas las abren review, inbox y messages sync, y serve solo las peticiones de las reglas de respuesta automática. Por qué: serve en MAX no revisa preguntas ni menciones al recibirlas. Quien mantenía serve en marcha y esperaba tareas veía la lista vacía hasta el siguiente review o messages sync. Qué tener en cuenta: el comportamiento no ha cambiado. Un tasks list vacío ahora dice lo mismo (cli-core 0.341.0).
  • max mcp --help sugiere claude mcp add max -- max <profile> mcp (cli-core 0.341.0). La sugerencia anterior, sin perfil, siempre fallaba con "name a profile", y el agente recibía un servidor que no funcionaba.
  • En Node 22, los comandos que abren el archivo ya no imprimen ExperimentalWarning: SQLite is an experimental feature (cli-core 0.341.0). Los agentes tomaban esas dos líneas de stderr por un error. Los demás avisos se imprimen como antes.
  • tags remove con un alias de etiqueta la quita igual que tags add la pone (cli-core 0.341.0).
  • El arranque es un poco más rápido (cli-base 0.45.0): las tablas de vocabulario y de reglas ya no se analizan en cada arranque, solo cuando se inicia el servidor para el agente.

Seguridad

  • attachments extract --output-dir rechaza las carpetas de claves, las carpetas del propio max y la carpeta del archivo (cli-core 0.341.0), como ya hacía la herramienta del agente.

0.61.0 — 18.10.2026

Novedades

  • tasks agenda muestra lo que otros te deben (cli-core 0.328.0): las tareas abiertas que hace otra persona, en una sección aparte y como assigned en --json, las más antiguas arriba.
  • Un agente puede silenciar y reactivar el sonido de un chat (cli-core 0.338.0): chats mute y chats unmute están ahora entre las herramientas de max mcp. Cada una se comprueba con su propia clave (chats.mute, chats.unmute); nadie en el chat se entera.
  • Ejemplos en la ayuda de account privacy show, account privacy set, chats mute, chats unmute, messages pin, messages unpin, metadata get y metadata refresh (cli-core 0.336.0, 0.339.0).

Cambios — pueden romper scripts

  • bot messages send --reply-to solo acepta un id de mensaje de MAX, mid.…, y lo mismo un agente con reply_to. Cualquier otro valor se rechaza antes de enviar (código 2). Antes se enviaba a MAX tal cual.
  • bot messages show, edit, delete, pin y unpin también aceptan solo mid.…, y lo mismo un agente. Cualquier otro valor se rechaza antes de la primera petición (código 2). Antes, delete con varios id borraba los mensajes hasta el primero incorrecto y solo fallaba en él (not_found).
  • Un comando sin terminal que espera a una persona tiene 5 minutos, no 30 segundos (cli-core 0.328.0), por ejemplo el session start de un agente. --timeout y MAX_TIMEOUT siguen decidiendo si se indican.
  • Una ruta de comando dada como un solo argumento es un error (cli-core 0.328.0): max 'chats list' --help imprimía la ayuda general con código 0; ahora responde validation_error y muestra cómo escribirlo bien.
  • Un agente ya no ve offline en bot me, bot comments list, bot comments get y bot chats members list. Estos comandos siempre consultan a MAX y rechazaban offline; ahora el argumento no está en la descripción de la herramienta (cli-core 0.335.0).
  • conversations build y conversations embed se marcan como comandos que cambian algo fuera de este equipo (cli-core 0.334.0, 0.336.0): con --analyze y --provider envían el texto de las conversaciones a un servicio externo, y search conversations con un modelo remoto envía allí la consulta. Con MAX_READ_ONLY los tres se niegan antes de enviar; un modelo en este equipo o en un servidor local funciona como antes. No se ejecutan a través de max serve. En docs/commands.md esa marca dice ahora "fuera de este equipo: en MAX o en un servicio externo", no "en MAX".
  • Con MAX_READ_ONLY, session start, session end y setup se niegan antes de empezar (código 5, "it cannot log in or out"), no desde dentro del comando.
  • Con MAX_READ_ONLY se rechazan las escrituras locales que borran o sobrescriben lo que guardaste (cli-core 0.336.0, 0.337.0): searches create, searches delete, searches clear, contacts alias set, contacts alias rm, contacts notes add, contacts notes edit, contacts notes remove, contacts link, contacts unlink, tags add, tags auto, tags remove, mentions confirm, mentions reject, attachments text set, chats tracking add, chats tracking remove, conversations links add, conversations links clear, conversations consents revoke, tasks reject y sus herramientas de agente salen con código 5, permission_error. Sigue funcionando lo que el archivo reconstruye por sí mismo (images embed, mentions rebuild, conversations embed clear, store jobs …), la sincronización, serve y el registro de tareas (tasks add, scan, close y otros). Con el bloqueo, tasks close solo propone cerrar la tarea, y --as-owner se rechaza.
  • Mientras MAX restringe la cuenta, no sale ninguna escritura (cli-core 0.334.0): también se rechazan una reacción, marcar un chat como leído, un fijado silencioso y los cambios de título y de perfil (permission_error); la lectura funciona. Un bloqueo sin plazo retiene las escrituras hasta que ejecutes flood clear o doctor --online vea que la cuenta está bien; en --json ese bloqueo tiene until: null.
  • Un envío que no consiguió el cerrojo de archivo de otro proceso sale con código 9 (timeout), no con 1 (cli-core 0.338.0): no se envió nada, así que es seguro reintentarlo. Lo mismo con flood clear.
  • upgrade --offline sale con código 2 (cli-core 0.338.0): upgrade consulta npm, así que con --offline (y con --check) ahora se niega en lugar de ir a la red contra lo que pide la opción.
  • La herramienta de agente messages list ya no ofrece topic: (cli-core 0.340.0): MAX no tiene temas, y esa condición se rechaza, como ya ocurría en la línea de comandos.

Correcciones

  • Un archivo que no se pudo abrir se cierra (cli-core 0.332.0): en Windows se puede borrar la carpeta con ese archivo.
  • doctor report create vuelve a funcionar con MAX_READ_ONLY. cli-core 0.337.0 prohíbe con ese bloqueo cualquier escritura local no marcada como segura; el informe solo añade un archivo nuevo, y ahora está marcado.
  • El cerrojo de archivo de otro proceso ya no detiene max serve (cli-core 0.340.0): antes serve lo esperaba hasta 5 segundos, y durante ese tiempo se paraban todos los comandos que pasaban por él y el mantenimiento de la conexión con MAX.
  • Dos cambios a la vez en la lista de destinatarios ya no se anulan entre sí (cli-core 0.338.0): recipients add, remove y clear leen y escriben la lista bajo un mismo cerrojo.
  • store gaps repair --background ejecuta su tarea en lugar de fallar al instante (cli-core 0.339.0).
  • Las pistas de server status, server … y del mantenimiento del archivo nombran el perfil: max <profile> session start, no max session start (cli-core 0.339.0).
  • upgrade --check funciona con MAX_READ_ONLY (cli-core 0.338.0): solo pregunta a npm por una versión nueva.
  • Las descargas de modelos no pasan por max serve (cli-core 0.336.0): models … download e images models download descargan del servidor de modelos, no de MAX.
  • Con serve en marcha, images embed lee las imágenes a través de su conexión, como las demás lecturas (cli-core 0.337.0).
  • Se recuerda una restricción o un bloqueo que detuvo watch o serve (cli-core 0.334.0): el siguiente comando espera, como tras el mismo error en un comando normal.

Seguridad

  • session end ya no cierra la sesión de la cuenta que usa max serve. Si serve se inició a mano o con un servicio, session end cerraba la misma sesión de MAX en la que trabaja serve y borraba su token. Ahora el comando se niega (código 2) y pide ejecutar antes max <profile> server stop. Un serve iniciado por otro comando lo sigue deteniendo él mismo. session start, session end y setup nunca se ejecutan a través de serve (cli-core 0.333.0, logsInOrOut).
  • chats.unmute: readonly ahora detiene chats unmute (cli-core 0.336.0). Antes, reactivar el sonido se comprobaba con la clave chats.mute, y su propia clave no tenía efecto. Una configuración que solo tiene chats.mute funciona como antes mientras no se defina chats.unmute.

0.60.0 — 17.10.2026

Novedades

  • stats messages top --measure reactions muestra las reacciones por emoji (cli-core 0.324.0): junto al total, 👍 4 · 😂 3 (hasta cinco emoji, después +N), y en --json cada fila tiene reactions: [{reaction, count}].
  • max <profile> contacts link <person> me (cli-core 0.323.0): marca que un contacto eres tú, para una cuenta tuya que el archivo no reconoce por sí solo, como zoom:<id>.

Cambios — pueden romper scripts

  • Las herramientas de max bot mcp se construyen ahora a partir de los propios comandos max bot (cli-core 0.325.0) y se ejecutan a través de ellos. Los argumentos se llaman como en el comando: messages send y messages edit aceptan md / html en lugar de format, messages delete una lista messages, search messages query, chats members remove person. Se añaden chats rules show, offline en los comandos que leen MAX y los argumentos page, newest, notify, no_block, sync_first. Una escritura con nivel ask está permitida al agente: no hay nadie que responda a la pregunta.
  • No se ofrecen al agente: session, setup, config, doctor report, bot uploads, ni --allow-dangerous en bot comments delete y en bot api. Solo el propietario sigue ejecutándolos.

Correcciones

  • Las menciones encuentran menos nombres falsos (cli-core 0.323.0). Una palabra del nombre de un contacto cuenta por sí sola solo como nombre o apellido; un contacto con nombre de empresa («Smart Agents») se encuentra solo por el nombre completo, y los corteses «Ваш», «Вам», «Вас» nunca cuentan. El nombre de un santo en el nombre de un lugar («Saint Michael's Bridge») y una ciudad después de «в»/«во» («во Владимире») tampoco son nombres.
  • Tus cuentas eres tú (cli-core 0.323.0): la identidad propia de una cuenta se vincula contigo en la siguiente sincronización, y tu nombre en tus mensajes ya no pertenece a otra persona.
  • Una dirección conserva su ciudad (cli-core 0.323.0): una misma calle en dos ciudades son dos lugares; una dirección sin ciudad sigue encontrando su lugar en esa calle.
  • En un grupo con la etiqueta watch-tasks, la respuesta de cualquier miembro cierra una pregunta (cli-core 0.325.0). Una respuesta directa a la pregunta (una respuesta con cita) de alguien que no sea quien preguntó cierra la tarea con la marca «answered in the group». Antes solo la cerraba tu respuesta, y las preguntas que otros ya habían respondido seguían abiertas. Un mensaje que no responde a la pregunta no cierra nada. En los chats individuales y en los grupos sin la etiqueta sigue contando solo tu respuesta.

Después de actualizar, vuelve a leer una vez los mensajes antiguos: max <profile> mentions rebuild person-name place.

Seguridad

  • MAX_READ_ONLY ahora impide iniciar y cerrar sesión, escribir como bot y modificar el archivo: session start, session end y setup se niegan con permission_error antes de conectarse. También se niegan bot api (cada operación que cambia algo, y get-updates), bot comments send|edit|delete, bot chats members add, bot uploads put, así como store reset, restore, clear, migrate, repair, copies delete y decrypt. Antes, session end bajo esta restricción cerraba la sesión en MAX y la olvidaba, y estos comandos del bot enviaban una solicitud a MAX. store repair --dry-run bajo la restricción sigue mostrando lo que se repararía.
  • Una escritura en la Bot API que max no sabe registrar en el diario se rechaza con configuration_error, en lugar de llegar a MAX sin pasar por la lista de destinatarios ni el diario de envíos. Así, una operación que añada una futura actualización del esquema de la Bot API no se salta las comprobaciones. Sin diario solo pasa get-updates: no envía nada a nadie.

0.59.0 — 17.10.2026

Novedades

  • Una tarea tiene responsable (cli-core 0.320.0): tasks add --assignee, tasks plan --assignee y el filtro assignee: en tasks list; una tarea también puede ser algo que alguien te debe. Un grupo con la etiqueta watch-tasks recibe una tarea por cada pregunta sin respuesta, se le haya hecho a quien se le haya hecho.

Cambios — pueden romper scripts

  • Ya no se elige un perfil por defecto (cli-core 0.319.0). El ajuste default_profile no se lee: si sigue en el archivo de configuración, un comando sin nombre de perfil se detiene e indica qué escribir. Nombra el perfil como primera palabra (max <perfil> …) o define MAX_PROFILE, y elimina el ajuste antiguo: max config unset default_profile. max config set default_profile ahora se niega.
  • Un perfil llamado default es un nombre normal. max default mcp config llama al servidor MCP max-default, no max; una entrada escrita antes funciona hasta que mcp setup la reescriba con el nuevo nombre.
  • tasks apply ahora es tasks scan (cli-core 0.320.0). La herramienta MCP es tasks_scan y la clave de permiso, tasks.scan. Funciona igual: muestra qué tareas abriría el historial de un chat y las crea solo con --yes.
  • Un agente ya no puede borrar un mensaje para todos (cli-core 0.321.0). La herramienta MCP messages delete no acepta for_everyone: ese argumento se rechaza como desconocido. El propietario sigue borrando para todos con max <perfil> messages delete --for-everyone.
  • mcp --permission solo endurece los permisos (cli-core 0.321.0). Una anulación que aflojaría el nivel del perfil, como messages.send=allow para un perfil con readonly, se rechaza al iniciar el servidor indicando la clave. Para permitir más, cambia los permisos del perfil; --permission messages.send=deny y otras restricciones funcionan como antes.

Correcciones

  • Prohibir al agente chats members list ahora surte efecto (cli-core 0.321.0). Por MCP, el comando tomaba su nivel de la clave chats.members, y una prohibición en chats.members.list no le llegaba.
  • tasks show HRB-12 muestra una tarea de proyecto (cli-core 0.320.0). Antes, una tarea de un proyecto, y no de una cuenta, se daba por no encontrada.
  • Las tareas se abren solo donde se te ha preguntado algo (cli-core 0.317.0). En un chat individual, como antes, cada pregunta sin respuesta; en un grupo, solo una respuesta a tu mensaje y una mención tuya; en un canal y en Mensajes guardados, nada. Antes, cualquier pregunta sin respuesta en cualquier chat se convertía en tu tarea.
  • Editar un mensaje no borra lo que la edición no incluye (cli-core 0.317.0): la hora de envío, las reacciones y los campos de servicio del mensaje guardado se mantienen.
  • Las herramientas de max bot mcp respetan el entorno del servidor. Antes, una llamada ignoraba las variables con las que se inició el servidor: por ejemplo, con MAX_READ_ONLY=1 el bot enviaba el mensaje igualmente. Ahora una llamada por MCP se comporta igual que el mismo comando en el terminal.

0.58.0 — 17.10.2026

Seguridad

  • Los datos internos de los adjuntos quedan fuera de la salida, incluido el flujo de eventos del bot (cli-core 0.315.0). Las claves multimedia y el token permanecen dentro del cliente.

  • Los archivos de estado de WhatsApp no se pueden enviar como adjuntos (cli-core 0.314.0). La protección comprueba los directorios predeterminados, las variables de entorno y los enlaces simbólicos; los archivos normales contiguos siguen permitidos.

Novedades

  • Los nombres y las direcciones se pueden revisar como menciones (cli-core 0.311.0). mentions rebuild person-name y mentions rebuild place los encuentran en el texto guardado; mentions places muestra las direcciones confirmadas.
  • tasks apply <chat...> muestra las tareas del historial guardado seleccionado. --yes las crea con comprobación de duplicados.

Cambios — pueden romper scripts

  • La primera sincronización no abre tareas de mensajes antiguos por defecto (cli-core 0.311.0). task_first_pass_per_chat activa su creación; tasks apply permite revisar los chats elegidos por separado. Las siguientes sincronizaciones siguen procesando mensajes nuevos.

Correcciones

  • max doctor report create escribe un informe incluso con ajustes incorrectos. Antes se detenía con configuration_error y no dejaba ningún informe que compartir. Ahora el informe muestra el error de ajustes en lugar de la comprobación del perfil, nombra el ajuste incorrecto sin su valor e incluye la última ejecución fallida.

0.57.0 — 17.10.2026

Novedades

  • Los documentos de Drive aparecen en la búsqueda local compartida (cli-core 0.301.0), con su enlace de Google y fecha de modificación. --source drive:<профиль> elige el perfil importado. chats documents list <чат> muestra los documentos compartidos en mensajes guardados sin consultar MAX.

  • El servidor MCP solo se carga cuando max se ejecuta como MCP (cli-core 0.300.0): las demás órdenes cargan aproximadamente una décima parte menos de archivos al arrancar.

  • La ficha de una tarea muestra las tareas que apuntan a ella (cli-core 0.304.0): tasks show imprime task:<id> follow-up-of this task, mientras que --json y MCP devuelven linked_from. Antes solo la tarea nueva mostraba el vínculo, no la cerrada.

  • max arranca aproximadamente un cuarto más rápido después de la primera ejecución. El código compilado de Node se guarda en la carpeta temporal del sistema, configurable con NODE_COMPILE_CACHE: max --help tarda unos 0,42 segundos en lugar de 0,56.

Cambios — pueden romper scripts

  • Los errores de ajustes ocupan una línea sin repetir el valor (cli-core 0.304.0): el primer campo incorrecto, el motivo y el número de errores adicionales, como config.json: profiles.default.limitt is an unknown setting (and 2 more problems). Un campo antiguo (clientId) indica su nuevo nombre (rename it to client_id, cli-core 0.307.0). Antes se enumeraban todos los errores y campos admitidos y se citaba el valor, que podía contener un token por accidente.
  • search notes selecciona notas mediante source:internal o source:file en la consulta (cli-core 0.303.0). Se eliminan la opción --type y el campo type de MCP search_notes. El nombre coincide con el campo source de la nota. --source notes:<папка> sigue eligiendo qué cuentas leer.
  • El aviso diario de actualizaciones también queda en silencio con --timeout=5, --help=… y otros argumentos separados por =, como ya ocurría con --timeout 5. La comprobación ahora procede de cli-core compartido.
  • Se ocultan las órdenes que MAX no admite (cli-core 0.299.0). messages send, chats mark-read y polls create no tienen --topic, porque MAX no tiene temas de foro. messages list no acepta topic:; chats requests accept y decline no tienen --all ni --link, por lo que siempre requieren una persona. Antes se mostraban esas opciones, pero se rechazaban.
  • max doctor responde incluso con ajustes incorrectos. Antes devolvía configuration_error y código 3; ahora devuelve config: {error: …}, nombra el ajuste incorrecto y sale con código 0. doctor se usa precisamente cuando los ajustes fallan. Los scripts que detectaban ajustes incorrectos por su código de salida deben consultar config.error.

0.56.0 — 16.10.2026

Añadido

  • tasks reject rechaza el cierre sugerido por un agente, y tasks list close:suggested encuentra esas tareas (cli-core 0.295.0). tasks agenda indica el motivo close-suggested; el propietario confirma con tasks close <задача>, sin necesitar --as. Los ajustes compartidos task_agent_close (on por defecto) y task_agent_close_min (0.8) controlan los cierres del agente; config show los muestra.
  • Una tarea nueva sobre otra cerrada en los últimos 14 días es su seguimiento (cli-core 0.295.0): review y tasks add la vinculan a la cerrada mediante follow-up-of. La cerrada permanece cerrada y no entra en tasks duplicates; tasks show muestra el vínculo.
  • 59 categorías predeterminadas en lugar de 7, con hasta 80 en la lista (cli-core 0.295.0 y 0.296.0): bills, health, travel, fitness, subscriptions y otras. tasks categories muestra el significado y las palabras de la regla en inglés, ruso y español. Un almacén cuya lista se guardó con config set task_categories.* conserva la suya; config unset task_categories adopta los nuevos valores.
  • Las categorías quitadas de la lista siguen visibles (cli-core 0.296.0): tasks categories las nombra y cuenta sus tareas abiertas/totales (unlisted en JSON); tasks agenda indica las categorías que aún tienen tareas abiertas (unlisted_categories).
  • Español en las tareas (cli-core 0.296.0): un activador es: reconoce otras formas de la palabra (pagues — pagar) en mensajes en español; la comprobación de duplicados entiende fechas como mañana, el viernes, 15 de noviembre.
  • Los duplicados se comprueban de nuevo tras vincular un mensaje (cli-core 0.295.0): después de tasks link <задача> msg:…, tasks add --into y tasks merge, las tareas similares aparecen en tasks duplicates; el campo review de la respuesta las cuenta. El vínculo se conserva y nada se une automáticamente.
  • commands --json indica cuánto vive cada comando (cli-base 0.38.0): serve y watch tienen lifetime — persistent; setup y session start son interactive. Antes se deducía por sus nombres.

Cambios — pueden romper scripts

  • Un agente solo cierra una tarea con --certainty <0..1>; un cierre incierto espera al propietario (cli-core 0.295.0). AI_AGENT o CLAUDECODE identifica al agente; --as-owner cierra como propietario. Un agente puede equivocarse y una tarea cerrada desaparece de tu agenda. tasks close del agente sin --certainty se rechaza con task.certainty-required; MCP tasks_close requiere el nuevo argumento certainty. Por debajo de task_agent_close_min (0.8 por defecto), o con task_agent_close off, la respuesta contiene state: open y close_suggestion, y la tarea queda abierta.
  • tasks add ya no se niega si solo coinciden tareas cerradas (cli-core 0.295.0): abre una nueva con follow-up-of (follow_up_of en la respuesta). El código 2 se mantiene si coincide una abierta. Un script que esperaba código 2 para una tarea cerrada ahora recibe una nueva.
  • La regla elige categorías más precisas: la luz va a bills, no a money, y el médico a health, no a personal (cli-core 0.295.0 y 0.296.0). Las siete categorías originales conservan nombre y significado; las tareas guardadas no cambian. Un filtro como tasks agenda category:personal encuentra menos tareas nuevas. Algunas palabras pasan a categorías más precisas: gym a fitness, restaurant a food, переезд a moving.
  • La comprobación de duplicados lee los mensajes de la tarea (cli-core 0.295.0): el original y los cinco últimos vinculados. Una tarea de regla sin texto propio se compara por las palabras del mensaje, así que tasks add puede rechazar con código 2 donde antes abría una tarea.
  • max mcp y max <бот> bot mcp usan ahora el servidor MCP compartido, como tg. Las herramientas siguen siendo max_read, max_tools_search y max_write. chats check en max_write se sustituye por chats moderate; desaparece el alias chats rules y queda chats rules show. max bot mcp ya no acepta --allow-send, --allow-delete, --allow-moderate, --confirm-send ni --allow-dangerous. MAX y TG comparten comportamiento y código probado. Esas opciones de bot mcp antes no habilitaban nada; ahora impiden iniciar el servidor con código 2 y “unknown option”. Quítalas de la configuración; max <бот> bot mcp config muestra la entrada nueva. Los agentes que usaban chats check o chats rules necesitan los nombres nuevos. max mcp config ya no incluye --yes: las escrituras MCP con ask ya se ejecutan sin preguntar. El audio por MCP se descarga y después se transcribe en este ordenador, como en tg. chats moderate solo lee la posición guardada del archivo de reglas; ya no migra posiciones de sesiones muy antiguas.
  • setup --json coloca los siguientes comandos en next del sobre, no en item.next. El objeto item.next con instructions, chats, history y skill se sustituye por dos pasos de lectura de nivel superior: skill show y chats list --limit 5. Todos los comandos ofrecen los siguientes pasos en el mismo lugar. Los scripts deben leer next en vez de item.next. La descarga de historial y la instalación de la habilidad solo aparecen en la salida para personas.
  • chats media devuelve mensajes con la misma forma que el historial. El audio de voz es ahora voice, no audio, como en messages list. Los identificadores de archivo y vídeo MAX están dentro de provider_ref del adjunto (provider_ref.file_id, provider_ref.video_id), no en su nivel superior. Antes chats media devolvía adjuntos con una forma propia de MAX. Los scripts que esperaban audio deben buscar voice y leer file_id/video_id dentro de provider_ref; --type audio sigue eligiendo mensajes de voz.
  • max watch representa mensajes con el mismo código que messages list. Las encuestas muestran pregunta, respuestas y número de votos. JSON y --jsonl no cambian. La salida para personas puede variar un poco respecto a 0.55.0; los scripts deben usar --jsonl.

Corregido

  • doctor report create también sustituye por etiquetas los identificadores del mensaje respondido y de los intentos de escritura. Las etiquetas relacionan registros dentro de un informe y cambian al crear otro.

Seguridad

  • Cada escritura pasa por una sola protección compartida, desde la terminal, max serve y MCP. Envíos, ediciones, eliminaciones, reacciones, marcar como leído, reenvíos, moderación y cambios de chats/contactos/cuenta comparten niveles de permisos, MAX_READ_ONLY, lista de destinatarios y registro de envíos. Las escrituras visibles para otras personas (mensajes, reenvíos, ediciones, eliminaciones, grupos nuevos y añadir personas) también comparten el límite por hora. deny y readonly impiden escribir. Con ask, la terminal pregunta o espera --yes (--allow-dangerous para eliminar); --json sin indicador se rechaza. Por MCP, ask funciona como antes: deciden los permisos del perfil, incluidos los del servidor mediante --permission. MAX_READ_ONLY=1 prohíbe toda escritura, también por MCP. Antes MCP seguía otra ruta dentro de MAX; ahora la comparte con tg. Los comandos de terminal mantienen su comportamiento. Para impedir que el agente elimine o envíe sin ti, usa deny o readonly en vez de ask: esas herramientas no se ofrecen al agente.

0.55.0 — 15.10.2026

Cambios — pueden romper scripts

  • Las opciones de los comandos comunes siguen el vocabulario común; los nombres antiguos ya no se aceptan (cli-core 0.288.0): --budget → --max-pages; messages sync --estimate → --dry-run (max lo sigue rechazando: los id de mensaje de MAX no dicen cuántos faltan); contacts context --refresh, bot contacts show --refresh y tags auto --refresh-metadata → --sync-first; search conversations --refresh → --catch-up; attachments show --if-sha256 → --expected-fingerprint; en replies edit, --chats, --not-chats, --people, --not-people → --allow-chats, --deny-chats, --allow-people, --deny-people (el archivo de reglas no cambia); schedule --once → --at-time; bot chats moderate --no-ban → --no-block; chats mark-read --until → --until-id; tasks add|plan --check → --remind-time; tasks add --attach → --into; tasks claim --for → --lease; tasks agenda --due → --due-within; server logs --lines → --limit (-n se mantiene); en chats start, --payload → --start, como en chats app; store export --to/--kind → --output-dir/--include. Por qué: en max, tg y las demás CLI de WireCat una palabra significa una sola cosa, y un agente no tiene que recordar el nombre de la opción en cada programa. Qué tener en cuenta: un nombre antiguo termina el comando con código 2 («unknown option») antes de conectar con MAX; revisa los scripts y las programaciones (schedule list). En MCP el argumento es el nombre nuevo en snake_case, por ejemplo max_pages, until_id, expected_fingerprint, output_dir, allow_chats, at_time. En search conversations no cambies --refresh por --sync-first: esa opción ya existía y primero lee los mensajes nuevos de MAX; la antigua preparación de la búsqueda es ahora --catch-up.
  • tasks similar es ahora tasks related, y tasks duplicates unsure es tasks duplicates defer, sin los nombres antiguos. Por qué: el mismo vocabulario común. Qué tener en cuenta: en MCP busca los comandos tasks related y tasks duplicates defer con max_tools_search. La clave de permisos es tasks.duplicates.defer. La clave antigua tasks.duplicates.unsure en el archivo de ajustes ahora solo avisa en stderr y no tiene efecto, así que el comando recibe el nivel de tasks: quítala con config unset y da el mismo nivel a la clave tasks.duplicates.defer. En la base de datos la decisión sigue llamándose unsure.
  • tasks agenda y tasks duplicates filtran con campos de consulta, no con opciones: tasks agenda --tag <имя> → tag:<имя>, --category <имя> → category:<имя>, --claimed → claimed:any (también none, mine, others; por defecto, como antes, las sin reservar y las tuyas); tasks duplicates --unsure → decision:unsure (por defecto decision:review). Por qué: la lista la filtra la base de datos, como las demás listas, y no el programa después de leer. Qué tener en cuenta: un OR o NOT que mezcla campos de tarea con chat_kind: se rechaza (query.unsupported-placement). En MCP estos comandos aceptan query en lugar de tag, category, claimed y unsure.
  • Toda respuesta --json es un sobre: item para una cosa, o items + page para una lista, y meta. Ahora responden así también los que devolvían un objeto suelto: la vista previa --dry-run --json (bajo item, claves en snake_case: business_rules, action_invoked, write_reserved, messenger_contacted, configuration_read), mentions confirm|reject e images embed --json, max_tools_search en MCP ({items, more} → {items, page, meta}) y el recurso MCP max://chat/<id> (el chat y los mensajes bajo item), además de bot me, bot api … (la respuesta de la Bot API va dentro de item sin cambios; una respuesta vacía es null), contacts sync, contacts lookup (displayName → display_name, lastMessagedAt → last_messaged_at), doctor report, doctor report create (sendTo → send_to) y setup (chats.hasMore → chats.has_more). Por qué: un agente lee cualquier respuesta de la misma forma. Qué tener en cuenta: lee los campos de .item; en lugar de more, usa page.has_more.
  • Una copia local de los mensajes dañada es un error, no una copia vacía (cli-core 0.286.0). Antes, un comando que conecta con MAX seguía sin ella en silencio. La copia solo se omite si no existe, si la cuenta aún no está registrada o si otro proceso (serve) la retiene más de 5 segundos. Por qué: una respuesta sin la copia parecía completa, aunque le faltaba lo guardado. Qué tener en cuenta: ese error es motivo para max <профиль> store repair --dry-run.

Correcciones

  • La sugerencia del siguiente paso incluye el perfil (cli-core 0.286.0): después de max personal … la línea → … también empieza por max personal, y pegada tal cual funciona en lugar de pedir que elijas un perfil.

Eliminaciones

  • Abrir la base de datos ya no borra el archivo antiguo messages.db ni lo anuncia en stderr (cli-core 0.286.0). Si el archivo quedó de versiones antiguas, bórralo tú.

0.54.0 — 15.10.2026

Novedades

  • Las tareas se pueden reservar, etiquetar y repartir en categorías: tasks claim <задача> [--for 30m], tasks release, tasks categories, tags add|remove --task, tasks agenda --claimed (cli-core 0.282.0).
  • Tareas que pueden ser el mismo trabajo (cli-core 0.285.0): tasks similar <задача> valora las tareas parecidas; tasks duplicates [--unsure] muestra los pares que encontraron las reglas, tasks merge <задача> --into <другая> los fusiona, tasks unmerge deshace la fusión, tasks duplicates reject|unsure resuelve un par. tasks agenda acepta --category y --tag, y config set task_categories.<имя> cambia la lista de categorías de toda la base.
  • Menciones (cli-core 0.285.0): mentions domains muestra los sitios a los que llevan los enlaces; mentions list --new, lo encontrado desde la última consulta; mentions confirm|reject <id> --all-in-chat resuelve un nombre en todo el chat. config set phone_countries es,ru lee los números escritos sin +.
  • Versión de la base 16: las reglas de menciones leen el texto de las notas y de los documentos guardados, y un único mentions rebuild lee los guardados antes; mentions list sigue mostrando solo las menciones en mensajes. La actualización añade solo disparadores, así que una versión anterior de max sigue abriendo la base.

Cambios — pueden romper scripts

  • Los ajustes se nombran solo en snake_case (cli-core 0.283.0): config set y config unset ya no entienden camelCase, y una clave en camelCase en el archivo de ajustes se considera desconocida. Los ajustes comunes del almacén ahora son search_stemmers.cyrillic, search_stemmers.latin y account_groups.<имя>.
  • tasks add exige --category <имя> de la lista de tasks categories (money, documents, meeting y otras); si ninguna encaja, usa --category other.
  • MAX_READ_ONLY ahora prohíbe también escribir en max: antes esta variable no llegaba a la comprobación de escritura.
  • tasks add se niega si la tarea puede ser el mismo trabajo que una abierta o cerrada en los últimos 14 días (cli-core 0.285.0): salida 2, motivo task.duplicate-candidates, candidatas en details.candidates. Repite con --attach <задача> para vincularle el mensaje, o con --new para abrir una nueva; por MCP, tasks add se comporta igual.
  • phone: y value: también encuentran un número guardado que termina en las cifras nacionales del escrito (desde 8; cli-core 0.285.0), así que un número guardado antes de phone_countries se encuentra en cualquier forma. Un número urbano ruso escrito en grupos, (812) 000-00-01, ahora se guarda como +78120000001, no como cifras sueltas.
  • max search mail ya no existe: el correo lo busca memo (decisión del propietario del 14.10.2026, cli-core 0.285.0, cli-core#1121). MCP no tiene search_mail. max search all busca mensajes y notas (y reuniones, si --source las nombra), pero nunca correo; --only mail se rechaza. En lugar de «unknown command», max search mail … responde con una pista: mail is memo's: install @wirecat/cli-memo, then `memo search mail …` . Las tareas, las notas de contactos, las etiquetas, search notes y search all se quedan en max.

Correcciones

  • Un título con letras cirílicas mayúsculas se encuentra con una consulta en minúsculas (cli-core 0.285.0).
  • El HTML dañino en un adjunto ya no cuelga la lectura (cli-core 0.285.0): una página de etiquetas o comentarios sin cerrar se lee en un tiempo lineal respecto a su tamaño.

Seguridad

  • messages send --file, el envío desde MCP y las fotos de perfil o de grupo no toman archivos de lugares con credenciales (cli-core 0.283.0): la misma lista que bot uploads put desde 0.53.0: claves SSH y de la nube, .netrc, .git-credentials, ajustes de gh, docker y kube, credenciales de Claude y Codex, llaveros, perfiles de navegador, almacenes de contraseñas y carpetas de las aplicaciones de WireCat; en macOS y Windows sin distinguir mayúsculas. Antes se negaban solo con .ssh, .gnupg, .aws, .env y similares, y con las carpetas de max. Si necesitas justo ese archivo, usa --allow-any-file.
  • La lista de lugares de los que no se envía un archivo ahora es una para todas las aplicaciones de WireCat: max la toma de cli-core y ya no guarda su propia copia. Si el archivo aún no existe, también se resuelven los enlaces en las carpetas que lo contienen.
  • Con MAX_READ_ONLY no se puede cambiar lo que permitiría escribir más tarde (cli-core 0.281.0): schedule command|agent|remove, config set|unset, recipients add|remove|clear, flood clear, server install|uninstall, mcp setup, skill install, upgrade, las claves de modelos y bot auth responden permission_error. Un agente programado se ejecuta con esta variable y antes podía programarse un envío para después; ahora no puede, y una programación guardada bajo ella también se ejecuta solo en lectura. La lectura, la sincronización, las tareas y las notas funcionan como antes.

Eliminaciones

  • Código de compatibilidad. max mcp y mcp config|setup|doctor ya no aceptan --allow-send, --confirm-send, --allow-mark-read, --allow-delete, --allow-moderate, --allow-dangerous y --http-confirmation; el acceso se define con permissions. Se quita messages download --output; queda --output-dir. El comando config migrate ya no existe. Los ajustes read_only, allow y mcp_tools se eliminan: un archivo que los contenga no se lee; en su lugar define permissions.<ресурс> readonly. doctor no busca el antiguo archivo de caché (legacy_cache), e inbox ya no traslada la antigua marca lastCheckAt.
  • Traslado de carpetas al arrancar (desde ~/Library y a la carpeta de WireCat): ya está hecho.
  • El antiguo lenguaje de búsqueda: search messages y searches create ya no tienen --language ni --regex. Guarda de nuevo una búsqueda guardada en el lenguaje antiguo.
  • conversations embed --workers.

0.53.0 — 15.10.2026

Novedades

  • config set y config unset aceptan nombres de ajustes en camelCase (cli-core 0.279.0): max <профиль> config set senderColors false escribe sender_colors, y max <профиль> config set readOtherBots true --bot escribe read_other_bots. Las rutas después de permissions. conservan su escritura.

Correcciones

  • max bot uploads put y las subidas desde código rechazan archivos de carpetas de credenciales, llaveros y perfiles de navegador, como las demás subidas; en macOS y Windows los nombres se comparan sin distinguir mayúsculas.
  • Un envío rechazado por MAX por su límite se puede repetir: si messages send, messages forward o polls create recibe ese rechazo, retry.safe es true: el mensaje no se envió. Si el límite llega durante un reintento tras perder la respuesta, sigue siendo outcome_unknown y retry.safe: false.

0.52.0 — 14.10.2026

Novedades

  • La sincronización continúa donde se detuvo: store jobs show muestra progress, y messages sync --all ya no tropieza con un chat que ya está ocupado (cli-core 0.276.0).
  • max watch ya no se cae con una traza si un manejador de eventos lanza un error: la suscripción termina con ese error y la conexión con el servidor se mantiene.
  • Los archivos y vídeos se leen del disco a medida que se suben (cli-core 0.272.0). max messages send --file, --photo, las fotos de perfil y de grupo y max bot ya no cargan el archivo entero en memoria antes de enviarlo, y desaparece el rechazo de archivos de 2 GiB o más. Un mensaje de voz se sigue leyendo entero (de él se calculan la duración y la forma de onda), hasta 256 MiB.
  • Búsqueda de imágenes: max <профиль> images embed y max <профиль> images models download|list. Se activa con max <профиль> config set picture_search true (desactivada por defecto); el modelo clip-b32 se descarga una vez (unos 155 MB) e images embed calcula un vector para cada imagen del almacén local. La búsqueda de mensajes por palabras devuelve entonces pictures junto a los resultados. Por qué: encontrar una imagen por lo que muestra. Qué tener en cuenta: la consulta de imágenes solo admite inglés; el agente la traduce por su cuenta. Más en búsqueda.

Cambios — pueden romper scripts

  • max store export --format jsonl escribe en archivos y carpetas los mismos registros que en pantalla: snake_case, chat_id; la línea de borrado es { "id", "chat_id", "deleted": true } (cli-core 0.276.0). Qué tener en cuenta: la nueva versión no añade datos a una carpeta exportada antes; exporta a una carpeta nueva.
  • max watch --jsonl escribe los mensajes con la misma forma que messages list: snake_case, con ref (chat_id, chat_title, sender_name). Las líneas de --events también van en snake_case: chat_id, message_id, user_id, up_to_time, unread_count. Una persona ve lo mismo que antes. Qué tener en cuenta: los scripts que leían chatId usan chat_id.
  • Un mensaje de voz sin texto aparece en missing en review, inbox, messages list y en MCP, para que el agente vea que todavía hay que transcribirlo (cli-core 0.275.0).
  • El siguiente paso hacia un comando que solo cambia este ordenador no se ejecuta solo (cli-core 0.273.0): los pasos server restart y store reindex llevan safe_to_auto_execute: false.
  • mentions rebuild recibe el tipo como argumento: max <профиль> mentions rebuild person-name, no --kind (cli-core 0.272.0).
  • max doctor --json, session start y session end responden con un sobre en snake_case: {item, meta}, claves legacy_cache, keyring.moved_by_environment, session.state_file, revoked_on_server. Una persona sigue viendo líneas de texto. Qué tener en cuenta: los scripts que leían estas respuestas toman los campos de item, en snake_case.
  • max bot chats members list --cursor en lugar de --marker, sin alias; la herramienta MCP del bot también recibe cursor. La respuesta indica el siguiente paso en page.next. Los comandos propios de max (recipients, config, mcp, messages transcribe, bot comments, bot uploads) responden igual que los comunes: una línea final en --jsonl y sugerencias en stderr.

0.51.0 — 14.10.2026

Novedades

  • Cada max watch tiene su propia cola. Un observador lento ya no retrasa a los demás; el búfer es de 64 MiB por observador y 256 MiB en total, max serve --max-subscriber-buffer-bytes y --max-subscriber-total-buffer-bytes los cambian, 0 quita el límite.
  • max mentions: teléfonos, correo, enlaces y documentos de Google de los mensajes guardados (cli-core 0.264.0, versión de la base 7). mentions list kind:phone, mentions list domain:google.com; una palabra sin campo es un valor en cualquier registro, 89001234567 encuentra +79001234567. mentions show <id> muestra el texto que la rodea. Los mensajes guardados antes los lee un único max <профиль> mentions rebuild; los nuevos se leen al guardarse.
  • max mentions confirm|reject, menciones en archivos y mensajes de voz, búsqueda por phone:, email:, url:, domain: (cli-core 0.269.0, versión de la base 11). mentions confirm <id> [person:<uid>|organization:<id>] registra de quién es el teléfono o la dirección (también de organizaciones), mentions reject <id> descarta el valor para siempre; el autor del registro es el agente o el dueño (--as-owner). El texto de los archivos y las transcripciones de voz también dan menciones (campo file_text o transcript); las guardadas antes las lee un único mentions rebuild. La búsqueda de mensajes las encuentra por phone:"8 900 000-00-01", domain:docs.google.com, email:"[email protected]". Las versiones anteriores leen la base como antes.

Cambios — pueden romper scripts

  • Compilado sobre @wirecat/cli-core 0.269.0: contacts timeline se pagina como las demás listas. Una lista recortada por --limit responde page.has_more: true, page.cursor y el paso page.next (--cursor continúa con los mismos --scope, --since-time y --until-time); antes era has_more: false y meta.truncated. meta.truncated se mantiene para los cambios que aún esperan en la cola. La nota «cut at --limit» en stderr desaparece. Qué tener en cuenta: los scripts que leían meta.truncated de contacts timeline leen page.has_more.
  • Las claves de error están en snake_case también en max bot y en el envío sin respuesta. El código de rechazo de MAX en el bot ahora es error.details.max_code (era maxCode); outcome_unknown al enviar un mensaje devuelve send_id (era sendId).
  • Sobre @wirecat/cli-core 0.270.0 y @wirecat/cli-base 0.27.2.
  • --json=<поля> sustituye a --fields y --agent-json, que ya no existen. --json=id,text conserva esos campos de cada elemento. El JSON de la CLI conserva el texto tal cual; las respuestas MCP siguen mostrando los caracteres invisibles.
  • tags list, tasks list y conversations list aceptan una consulta en lugar de flags de filtro. tags list tag:work type:chat, tags list sources:auto; tasks list state:open kind:promise chat:<id>; conversations list <чат> started_at>=7d. Estas listas ya no tienen --tag, --type, --source, --state, --chat, --before-time ni --since-time. Los elementos son entidades comunes: una etiqueta nombra sobre qué está como target, una conversación devuelve messages_count, started_at, first_message.

Correcciones

  • max serve ya no pierde el inicio de sesión si se cerró justo cuando respondía MAX. El estado del perfil y el token renovado se guardan antes de comprobar el cierre: MAX ya contó ese inicio de sesión y la siguiente ejecución no vuelve a iniciar sesión.
  • Un búfer común de max watch lleno desconecta a quien más retiene, no a quien le toca recibir a continuación. El rechazo llega a watch con el código invalid_response y el motivo output.too-large, no provider_error.
  • El registro de una ejecución fallida vuelve a guardar el código de rechazo de MAX (providerError, por ejemplo proto.payload). Desde cli-core 0.263.0 se lee de error.details.provider_error, pero max escribía providerError y el código se perdía; también la comprobación de encuesta «ya votada» y el reintento tras not.found miran la clave nueva.
  • MaxClient llama por su nombre a un archivo de 2 GiB o más, en vez de «it cannot be read». Un archivo por ruta en send({ files }) y la foto de un grupo o perfil se comprueban primero por tamaño: Node no lee archivos de 2 GiB o más, y el error ahora lo dice.
  • max <бот> bot chats members add acepta como máximo 100 personas a la vez. La Bot API de MAX acepta hasta 100 ids por solicitud; una lista más larga ahora se rechaza antes de la solicitud, pidiendo dividirla en varias ejecuciones.

0.50.0 — 14.10.2026

Cambios — pueden romper scripts

  • Compilado sobre @wirecat/cli-core 0.262.0 (nuevo nombre de @wirecat/cli-messaging, sigue a su 0.261.0; el comando de comparación es cli-core-parity) y @wirecat/cli-base 0.26.0. Las claves de la salida para máquinas están en snake_case: en error.details, operation_id, send_id, retry_after_ms; en commands --json, global_options, inherited_options, exit_codes, takes_value y contract: 1. El árbol de consulta del argumento MCP ast escribe lower_inclusive, upper_inclusive y must_not.
  • Los archivos HTML se leen como texto principal (cli-core 0.262.0): se descartan menús, pies de página y banners; se conservan títulos, listas, tablas y enlaces. El texto ya guardado de los adjuntos HTML se vuelve a leer en el siguiente attachments extract y cambia. title:, site:, lang:, author: y keyword: buscan en notas y archivos.

Correcciones

  • max config set defaultProfile <имя> y config unset defaultProfile funcionan sin indicar un perfil. Antes, el comando exigía primero un perfil y fallaba si había varios (cli-core 0.262.0).

0.49.0 — 13.10.2026

Novedades

  • Compilado sobre @wirecat/cli-messaging 0.259.0 y @wirecat/cli-base 0.24.0. El comando store fetch ahora se llama messages sync (mismos argumentos, opciones y JSON); el nombre antiguo queda oculto y obsoleto.
  • --debug: ante un fallo, el registro completo —causa y pila— sigue al error: en la terminal, tras la línea ✗; en otro caso, como segunda línea JSON.
  • runs list y runs search leen un índice por días y responden en milisegundos incluso con miles de ejecuciones.

Cambios — pueden romper scripts

  • La copia compartida de mensajes y los modelos de voz se mudan una vez a la carpeta WireCat, ~/.local/share/WireCat/ (Windows: %LOCALAPPDATA%\WireCat\Data\), en la primera ejecución, desde ~/.local/share/cli-messaging/ y ~/.cache/cli-common/models/. La mudanza no sobrescribe nada: si en ambos sitios hay copias distintas, max se detiene con el código 3 y nombra los dos archivos. WIRECAT_STATE_DIR sustituye a CLI_COMMON_CACHE_DIR y traslada toda la carpeta. Actualiza tg y memo junto con max: un CLI antiguo creará una copia nueva en el sitio anterior. Dónde están los archivos.
  • Un único objeto de error: {"error":{"code","reason","message","details"}}. Lo que estaba directamente en error —candidates, sendId, operationId, permission— ahora está en error.details. reason es un identificador con puntos (output_limit → output.too-large, input_limit → input.too-large); retryable aparece solo si lo fijó el propio fallo, y actions solo en los elementos fallidos de un resultado parcial. El código 1 se llama internal_error (antes generic_failure), y su mensaje ya no incluye el texto del fallo: lo muestra --debug. Las claves que no están en la lista común de cli-messaging desaparecen de details: providerError queda solo en el texto del mensaje, y los ID de los mensajes que messages delete no eliminó también se enumeran en el mensaje.
  • runs show muestra solo lo que salió mal (respuestas fallidas, advertencias, un cierre inesperado) y añade eventCount; todos los eventos, con -v, como antes.
  • max ya no elige el perfil por su cuenta. Si ni la primera palabra, ni MAX_PROFILE, ni el ajuste defaultProfile nombran un perfil, un comando que necesita una cuenta termina con el código 2 y enumera los perfiles de este ordenador, aunque solo haya uno. Antes trabajaba en silencio con el perfil default. El primer inicio de sesión también lleva nombre: max personal setup (cualquier nombre en lugar de personal); en un ordenador sin perfiles, el error sugiere justo este comando. Sin perfil siguen funcionando --help, --version, commands, skill show, account list y config show. Las sugerencias de los errores ahora siempre nombran el perfil (max default setup, no max setup), y max mcp config siempre se lo pasa al servidor. Por qué: qué cuenta escribe y lee lo decide el propietario, y lo decide de forma explícita; si no, un agente o un script podía actuar desde la cuenta equivocada. Qué tener en cuenta: para quien usaba el perfil default sin nombrarlo, max chats list y los scripts sin perfil dejarán de funcionar. El error nombra los perfiles; elige una de tres opciones: max default chats list, export MAX_PROFILE=default en el perfil de tu shell o max config set defaultProfile default. Las entradas MCP creadas con max mcp config, vuelve a crearlas con ese mismo comando. Perfiles.

0.48.0 — 12.10.2026

Novedades

  • --brief y --full en cualquier comando. --brief deja de cada mensaje encontrado la referencia, el chat, la hora, el autor, un fragmento y la puntuación; --full lo devuelve todo.

  • max search all nombra al autor de cada resultado y cómo se encontró (por palabras o por significado).

  • max schedule: un comando o un agente programados, mediante systemd (Linux), launchd (macOS) o el Programador de tareas (Windows). max schedule command <имя> --every 2h -- messages list <чат> ejecuta un comando de max; la lectura guarda lo leído en el almacén. max schedule agent <имя> claude "<задание>" --at 08:30 inicia un agente (claude o codex), como mucho una vez por hora. El agente trabaja con MAX_READ_ONLY=1 y no puede enviar nada; su respuesta queda en latest.md junto a la programación, y una notificación de escritorio avisa cuando está lista. --once 2h es una sola ejecución; después, la programación se elimina sola. max schedule list, run, remove.

  • max server install indica cómo activar la revisión diaria de compromisos, y no activa nada por su cuenta.

  • MAX_READ_ONLY=1 prohíbe al proceso cualquier envío, por encima del archivo de configuración y de --permission.

Cambios — pueden romper scripts

  • max search messages devuelve un fragmento, no el texto completo. Cada resultado tiene excerpt en lugar de text: unos 240 caracteres alrededor de la primera palabra de la consulta; el texto completo, con --full o max messages show <ссылка>. Los campos vacíos editedAt, replyTo, forwardedFrom y reactions ya no se imprimen en la salida para máquinas. Un script que leía text de los resultados de búsqueda debe leer excerpt o añadir --full.

0.47.0 — 11.10.2026

Novedades

  • Las tareas tienen plan, enlaces y agenda (almacén compartido 0.247.0, versión 4). max tasks add acepta --title, --description, --due y --check; max tasks plan <задача> los cambia después, y none borra una fecha. La fecha de revisión indica cuándo el agente debe volver a mirar la tarea; no es un recordatorio: el propietario no recibe nada. max tasks link vincula a la tarea mensajes, chats, personas, documentos y enlaces; max tasks show muestra el plan con sus enlaces. max tasks agenda, sin el texto de los mensajes, enumera las tareas vencidas y próximas, los chats donde el propietario debe una respuesta (owed), donde espera una respuesta (waiting) y los chats cuyo último mensaje aún no está guardado (unsynced). max skill show follow-ups es una revisión diaria para el agente: solo borradores, no envía nada.
  • La búsqueda entiende comparaciones con dos puntos. date:>=2026-01-01 (y :>, :<, :<=) equivale a date>=2026-01-01; antes esa forma daba invalid_syntax. Un after: o before: rechazado ahora sugiere el reemplazo: ante after:2026-09-01, la respuesta es usar date>=2026-09-01.

Cambios — pueden romper scripts

  • Almacén compartido 0.247.0: el contexto de una reunión registra hechos con la acción fact.add; memory.add ya no acepta el tipo fact.
  • El almacén compartido 0.246.0 comprueba las etiquetas nuevas antes de crearlas. Un nombre parecido requiere la revisión del propietario; puedes usar la etiqueta existente o su alias explícito. Los registros existentes se conservan; las coincidencias automáticas de nombre y alias se unen en una sola etiqueta.

0.46.0 — 11.10.2026

Cambios — pueden romper scripts

  • En macOS, max guarda sus archivos en los mismos sitios que en Linux: ~/.config/max-cli, ~/.local/share/max-cli y ~/.cache/max-cli en lugar de ~/Library/…. La primera ejecución traslada allí las carpetas antiguas junto con el almacén compartido y los modelos de voz, y cambia el registro del agente instalado de max server a la nueva carpeta. Mientras max serve o el servidor MCP estén en marcha, max muestra una advertencia, esa vez trabaja con las carpetas antiguas y lo vuelve a intentar en la siguiente ejecución. En Linux y Windows no cambia nada.
  • max funciona sobre @wirecat/cli-messaging 0.242.0: se conservan las claves existentes de proyectos y tareas; los proyectos nuevos reciben claves cortas, y el almacén compartido admite dependencias verificables entre tareas.
  • max funciona sobre @wirecat/cli-messaging 0.238.0; el archivo pasa a la versión 2. Al abrirse por primera vez, el archivo se actualiza: los recuerdos del tipo fact se convierten en hechos (lo que ocurrió, separado de las conclusiones), y los vínculos «asignado» se copian a las asignaciones de tareas. Las compilaciones anteriores de max abren el archivo actualizado como antes.
  • El correo para la búsqueda por significado se divide en fragmentos por conversación, no por mensaje. Las citas, saludos y firmas no entran en los fragmentos. En la primera indexación se eliminan los fragmentos antiguos y todo el correo se vectoriza de nuevo: una sola vez, y llevará tiempo. El texto de los correos y la búsqueda por palabras no cambian.

Novedades

  • --source en search messages, search mail y search conversations acepta una lista de cuentas y grupos: --source group:work,max:default,email:[email protected]. Un grupo se guarda con max config set accountGroups.<имя> <список> y lo ven todas las aplicaciones que trabajan con el archivo.
  • max search conversations encuentra correos de los buzones también por palabras, no solo por significado.

0.45.5 — 11.10.2026

Cambios — pueden romper scripts

  • Unirse a un chat e importar contactos cuentan para sendsPerHour. Unirse cuenta como una acción; importar, una por número; max contacts import envía los números de 10 en 10 por solicitud. Si el límite detuvo una importación a medias, el error dice cuántos números se enviaron, y volver a importar es seguro.

Novedades

  • max search all --backend archive|server|both y --server-time, como en search messages; solo afecta a los mensajes: el correo y las notas se buscan localmente. Por defecto, both.
  • max search mail --account <адрес> busca en el correo de un solo buzón; sin él, en todos.
  • El correo se busca por destinatarios, carpeta y asunto (to:, cc:, bcc:, mailbox:, subject:), y los adjuntos de los correos, por significado.

Seguridad

  • La búsqueda ya no devuelve mensajes de otra cuenta. search messages --backend server con --source all o in:all podía mostrar un mensaje ajeno con los mismos ID de chat y de mensaje; ahora se rechaza buscar en un chat sin cuenta. De @wirecat/cli-messaging 0.233.0.

0.45.4 — 11.10.2026

Novedades

  • max search messages sin chat también consulta al servidor de MAX, como la barra de búsqueda de web.max.ru: una solicitud para todos los chats y la mejor coincidencia de cada chat. Lo encontrado se guarda en el archivo y se comprueba con tu consulta. Con --chat, el servidor busca en un chat, como antes. --backend archive deja solo el archivo; con --json, estas búsquedas tienen ahora un bloque server.

Cambios — pueden romper scripts

  • max search messages con palabras y sin chat ahora se conecta a MAX (antes respondía solo el archivo) y puede esperar al servidor hasta 5 segundos. Lo mismo se aplica a la búsqueda por MCP. Para buscar solo en el archivo, como antes, añade --backend archive (en MCP, backend: "archive").

Correcciones

  • Funciona con @wirecat/cli-messaging 0.231.0, que incluye cli-meetings 0.3.0 y los paquetes SQLite y ONNX 1.0.1 con archivo de licencia; para max no cambia nada.

0.45.3 — 11.10.2026

Cambios — pueden romper scripts

  • La búsqueda en el archivo con --discover admite preguntas como «¿Pueden los contratistas conectarse al proyecto?»: el signo de interrogación ya no se convierte en un patrón de búsqueda. La búsqueda estricta y los filtros funcionan como antes.
  • La búsqueda de correo y las conversaciones de una persona vinculada también leen el almacenamiento de correo separado, junto con la importación anterior. El correo admite filtros de remitente y de cadena. En los resultados, un correo con la misma referencia aparece una sola vez.

0.45.2 — 11.10.2026

Cambios — pueden romper scripts

  • Una descarga de historial cuya primera página falla sin posibilidad de reintento vuelve a terminar con error (código de salida 2), como antes de 0.45.1. Una espera que pide MAX y un fallo después de varias páginas siguen dando un resultado parcial con complete: false y código 0.

Correcciones

  • max store fetch --background ya no se detiene a los 30 segundos. La tarea en segundo plano recibía el límite de 30 segundos común a los comandos y se detenía tras unos cien mensajes. Ahora llega hasta el final; un --timeout explícito sigue limitándola.
  • max store fetch --all espera una pausa breve que pide la lista de chats (hasta 5 minutos, como ya hacían las páginas de mensajes), en lugar de terminar enseguida con rate_limited.

Seguridad

  • Se elimina el antiguo messages.db al abrir el almacén en su ruta predeterminada (así desde 0.45.1): el archivo sin cifrar anterior a wirecat.db, junto con sus -wal y -shm. Una línea en stderr lo indica. El archivo se conserva si está definido MESSAGING_STORE y mientras otro proceso lo tenga abierto.

0.45.1 — 11.10.2026

Correcciones

  • Las referencias a paquetes, la documentación y los ejemplos usan el espacio de nombres WireCat.
  • La descarga HTTP distingue un rechazo 429 de un fallo de red normal: detiene los archivos nuevos e indica la pausa Retry-After cuando existe. Un rechazo 413 sugiere reducir los datos de entrada en vez de aumentar el límite local.

Cambios — pueden romper scripts

  • El fallo de un archivo o una página de historial conserva el trabajo completado y devuelve complete: false, batch o issue con código de salida 0. Los scripts deben comprobar la integridad; el JSONL de descarga parcial añade batch_summary. Los errores incluyen actions para recuperarse. Reanudar las descargas reintenta los ID fallidos del checkpoint.
  • Después de diez intentos, el lote detiene las solicitudes nuevas si la tasa de errores supera el 50%; MESSAGING_BATCH_MAX_ERROR_PERCENT cambia el porcentaje y 100 desactiva esa parada porcentual. Los límites de frecuencia y los fallos de autenticación detienen antes; nunca se repiten automáticamente escrituras de resultado desconocido.

Novedades

  • Configura el tamaño para extracción y transferencia de archivos guardados mediante MESSAGING_ATTACHMENT_MAX_MIB (por defecto 50). Las vistas previas PDF permiten ahora 4000 píxeles por lado y 8 MiB por página; MESSAGING_PDF_PREVIEW_MAX_PIXELS y MESSAGING_PDF_PREVIEW_MAX_MIB ajustan esos valores. Aumentarlos requiere más memoria; el OCR externo y la descompresión mantienen límites independientes.
  • max runs search, también el comando runs search en MCP max_read, busca registros seguros por texto, estado, código de error y tiempo sin conectar con MAX.

0.45.0 — 11.10.2026

Cambios — pueden romper scripts

  • El almacén limpia sus registros crecientes al abrirse, como máximo una vez al día: elimina llamadas de herramientas del agente de más de 90 días y conserva las filas de actualizaciones de bot procesadas de más de 30 días, eliminando su contenido. Actualiza tg-cli y cli-memo a la vez: comparten el almacén.

Novedades

  • max store reset sirve para un almacén que esta compilación no puede migrar: crea una copia junto a él, lo elimina y empieza uno vacío. Pregunta primero; --yes omite la pregunta y --no-backup omite la copia.
  • max search all --meetings [provider:account] también busca transcripciones, chat y resúmenes de una cuenta de reuniones; --max-meetings <n|all> establece cuántas consultar (100 por defecto).

Seguridad

  • Se elimina el antiguo messages.db al abrir el almacén predeterminado: el archivo sin cifrar anterior a wirecat.db, junto con sus -wal y -shm. Una línea en stderr indica el archivo. Se conserva si está definido MESSAGING_STORE o mientras otro proceso lo tenga abierto. De @wirecat/cli-messaging 0.222.0.

0.44.0 — 10.10.2026

Cambios — pueden romper scripts

  • El almacén local es un archivo nuevo, wirecat.db, y empieza vacío. Está junto al antiguo messages.db, que max deja intacto: no lo lee, convierte ni elimina. Ejecuta max store fetch --all para recuperar mensajes de MAX. Los datos que solo existen en este ordenador, como notas, alias, etiquetas, tareas y transcripciones, permanecen en messages.db. El inicio de sesión se conserva. Actualiza tg-cli al mismo tiempo o verán archivos diferentes.

Novedades

  • max contacts timeline <человек>, también el comando contacts timeline en MCP max_read, muestra la actividad de una persona en todos los mensajeros vinculados, de más reciente a más antigua, desde el almacén local. --scope personal|work, --since-time, --until-time y --limit acotan los resultados.

0.43.1 — 10.10.2026

Corregido

  • Las descargas de adjuntos usan HTTP(S) normal y el transporte configurado, sin validación DNS independiente ni restricciones de direcciones locales. Esto mantiene la compatibilidad con VPN, proxies y redes privadas; la compatibilidad con un proxy concreto depende del transporte.
  • La extracción local de texto PDF y la vista de páginas ya no requieren dividir documentos después de 20 páginas; se elimina el plazo independiente de 30 segundos para la extracción. Se mantienen la cancelación del comando y los límites de tamaño.
  • La transcripción local de grabaciones Ogg Opus completas, mono o estéreo, ya no rechaza audio después de 10 minutos. Las grabaciones largas requieren más memoria y tiempo.
  • Vuelven a estar disponibles los adjuntos de carpetas de trabajo ocultas normales. Siguen protegidos los archivos conocidos de credenciales, las carpetas de la CLI y el almacén de mensajes.
  • La exportación Markdown conserva el formato de los mensajes; MCP conserva el Unicode original al escribir y muestra los controles de forma visible en las respuestas. Los servicios de modelos configurados permiten redirecciones normales.
  • La actualización y la configuración de MCP en Windows aceptan entradas relativas normales de PATH y entornos no estándar del procesador de comandos. El almacén de mensajes conserva su esquema anterior.
  • La guía aclara que la búsqueda con --discover solo lee el archivo local. La búsqueda normal en un chat también puede consultar el servidor MAX; discovery no lo consulta.

0.43.0 — 10.10.2026

Novedades

  • La búsqueda de mensajes con --discover o MCP discover: true encuentra coincidencias parciales y respuestas directas válidas en el archivo local sin descargar modelos. La búsqueda estricta sigue siendo predeterminada; los términos ausentes ayudan al agente a comprobar la evidencia.

Cambios que pueden romper scripts

  • El proyecto usa Apache 2.0. Consulta las condiciones en LICENSE.

0.42.0 — 10.10.2026

Cambios que pueden romper scripts

  • El paquete se llama @wirecat/max-cli y el repositorio pertenece a WireCatLabs. Usa este paquete para instalar y actualizar.
  • La eliminación verifica el resultado leyendo del servidor. Si MAX sigue devolviendo el mensaje o falla la comprobación, informa outcome_unknown en lugar de deleted. Lee el mensaje antes de repetir; la confirmación de la petición no demuestra su eliminación.
  • La transcripción local admite Ogg Opus completo, mono o estéreo, de hasta 10 minutos. Divide las grabaciones más largas. La extracción de texto PDF admite hasta 20 páginas y 30 segundos; divide los PDF mayores.
  • MCP hace visibles los controles Unicode ocultos en resultados de texto y argumentos de escritura, incluida la conversión de formato. Conserva las banderas regionales; el JSON normal de la CLI mantiene las cadenas originales.

Corregido

  • Las descargas de adjuntos por MCP terminan sin quedarse bloqueadas. La extracción local de texto ya no bloquea la conexión necesaria para descargar.
  • messages delete acepta ID separados por comas y argumentos separados.
  • Las guías MCP explican permisos del perfil y aprobación en la aplicación del agente. El servidor no muestra formularios de aprobación; se eliminó código obsoleto no utilizado.

Seguridad

  • La extracción desde carpetas y transferencia de archivos guardados comprueban su ubicación. Rechazan archivos y carpetas ocultos, carpetas de la CLI y el almacén de mensajes, incluidos destinos de enlaces simbólicos. Las descargas MCP tampoco escriben allí; usa una carpeta de descargas normal.
  • DOCX aplica los límites de archivos de Office. Comprueba número de partes, tamaño descomprimido y tamaño de las partes de texto antes de leerlas.

0.41.0 — 09.10.2026

Cambios que pueden romper scripts

  • Las reglas responden a todos los destinatarios que coinciden hasta que limitas la audiencia; desaparece la lista separada testers. max replies audience --reply listed --allow-people <id> limita la audiencia a esas personas; --deny-people y --deny-chats excluyen destinatarios. No se envía nada mientras permissions.replies.send no sea allow; las reglas nuevas permanecen desactivadas hasta que las activas. Antes, el destinatario debía estar tanto en testers como en la audiencia, y ambas listas causaban confusión. Un archivo que todavía incluye testers sigue respondiendo exactamente a las mismas personas: pasan a la lista permitida (si la audiencia ya era listed, solo a las también permitidas por ella). Se eliminan los chats permitidos de ese archivo para evitar responder a todos sus miembros; las prohibiciones se mantienen. La siguiente edición con max replies reescribe el archivo sin testers.
  • max replies status --json ya no incluye testers; los contadores audience muestran a quién se puede responder. En max replies test y serve, los remitentes fuera de la audiencia se omiten con el motivo «not on the allow list» en vez de «not a test account».

Correcciones

  • max mcp config incluye MESSAGING_STORE y XDG_RUNTIME_DIR en la configuración del cliente, igual que tg. Un cliente que iniciaba el servidor con un entorno reducido no podía acceder al llavero en Linux y respondía «sin sesión»; con un MESSAGING_STORE propio buscaba en otro archivo. Ejecuta de nuevo max mcp config y sustituye la entrada del cliente.

0.40.0 — 09.10.2026

Cambios que pueden romper scripts

  • El almacén de mensajes elimina las copias conservadas para versiones antiguas (versión del almacén 28, cli-messaging 0.212.0). Las notas, notas sobre contactos, relaciones y entidades anteriores al nuevo sistema se trasladan una vez a las nuevas tablas durante la actualización. Después, las versiones antiguas de max, tg y memo rechazan abrirlo con «upgrade this tool»: actualiza las tres herramientas juntas.

0.39.0 — 09.10.2026

Novedades

  • max attachments show --page 1 devuelve una página de un PDF guardado como PNG. Un agente remoto puede leer todas las páginas con su propia visión y guardar el texto para la búsqueda. Hacen falta los opcionales unpdf y @napi-rs/canvas; ni la API de OCR ni la escritura en el índice se ejecutan por sí solas. Si el cliente MCP solo muestra los metadatos del recurso, pide format: base64 y muestra el PNG con las herramientas del agente.

  • max search all "<palabras>" busca a la vez en todo lo que se guarda en este equipo: mensajes de MAX y Telegram, correo importado por memo y notas. Cada resultado indica su tipo: mensaje, correo o nota. --only notes (o messages, mail) acota la búsqueda.

  • max search mail y max search notes buscan en un solo tipo. Las notas se encuentran por palabras y, si se ha descargado un modelo de texto local, por significado; --type internal (escritas en memo) o file (de la carpeta de notas).

  • max search messages --type voice (o text, file) encuentra solo ese tipo de mensajes.

Cambios que pueden romper scripts

  • El --answerer de estadísticas acepta nombres guardados, nombres propios y @username. La búsqueda es local, en las cuentas del historial seleccionado; si hay ambigüedad, se devuelven candidatos. Un nombre desconocido ahora da error en lugar de un informe sobre un ID inventado con cero respuestas. Para un ID de texto desconocido elegido explícitamente, usa person:provider/account/id. En responses aparece identityKnown; un ID sin observaciones recibe false y status: unknown. Cero respuestas observadas no prueba que no haya actividad (estadísticas).

  • Toda la búsqueda se ha trasladado a max search. Las órdenes antiguas ya no existen:

    AntesAhora
    max messages searchmax search messages
    max messages search --source emailmax search mail
    max conversations searchmax search conversations
    max bot messages searchmax bot search messages

    Para los agentes, las herramientas se han trasladado igual: search messages, search conversations y el nuevo search all, por el que conviene empezar.

  • max search messages ya no devuelve correo. Una búsqueda guardada con in:email ahora pide max search mail.

  • Los permisos con rutas antiguas (messages.search, conversations.search) detienen max search hasta que max config migrate los renombre con los mismos niveles.

Correcciones

  • La ayuda sobre solicitudes nombra explícitamente las limitaciones de MAX. Ya no ofrece --all ni --link como operaciones disponibles ni promete un orden por fecha; las comprobaciones de rechazo se mantienen.

0.38.1 — 08.10.2026

Novedades

  • max chats requests list|accept|decline muestra y procesa solicitudes de canales. --search filtra nombres. MAX no da hora: requestedAt es null. --link y --all no se admiten y se rechazan antes de consultar.

Correcciones

  • La biblioteca compartida se actualiza a 0.205.0 para que MAX, Telegram y Memo compartan versión del archivo. No cambian el esquema de notas ni los enlaces.

0.38.0 — 08.10.2026

Novedades

  • max store jobs list --state <estado> muestra solo las tareas en segundo plano en ese estado: running, done, failed, cancelled o died.

Cambios que pueden romper scripts

  • Se buscan raíces inglesas y españolas juntas. Antes solo españolas, con peores coincidencias inglesas. Las raíces se reconstruyen automáticamente: archivos pequeños al abrir, grandes por partes; max serve completa en segundo plano y max store migrate inmediatamente. Hasta completar se buscan formas exactas, se indica en stderr y query.stemming.applied es false. El índice latino ocupa aproximadamente el doble. Se conserva searchStemmers.latin propio, aplicado por max store reindex. Actualiza tg también: una versión antigua no usa el índice reconstruido (archivo).

  • Las notas personales (max contacts notes) aparecen en cada perfil que ve a esa persona. Antes solo en el perfil original. Se guardan aparte de mensajes junto con las notas memo. Notas de varios perfiles aparecen juntas; los alias (contacts alias) siguen siendo propios de cada cuenta.

Correcciones

  • max chats join ya no presenta una solicitud como una entrada. Si el canal aprueba a quién entra, la orden solo envía la solicitud y ahora responde requested: true en lugar de la ficha del canal; con max serve en marcha, ese canal no aparece en la lista de chats hasta que se acepte la solicitud (grupos).

0.37.0 — 08.10.2026

Novedades

  • Botones de bots: messages list y messages show muestran botones numerados: [1 Да] [2 Нет]. max messages press <чат> <сообщение> <кнопка> selecciona por número o texto exacto; el bot ve quién pulsó. Solo pulsa callbacks normales. Nunca comparte teléfono o ubicación; otros tipos explican el siguiente paso. Los botones aparecen al leer de MAX y no están en la copia local (uso).
  • Iniciar un bot: max chats start <бот> [--payload] actúa como su botón Inicio. Acepta https://max.ru/<бот>?start=…, incluso si nunca le escribiste; aparece su chat. Rechaza enlaces a personas. Iniciar es un mensaje tuyo y pasa los controles de envío.
  • Miniaplicaciones: max chats app <бот> [--start] imprime una dirección con tu sesión. Mantenla privada; max no la guarda.
  • max account list muestra perfiles locales y cuentas sin consultar MAX.
  • max bot messages list también muestra teclados en mensajes del propio bot.
  • max watch --events muestra lecturas y cambios de chats (incluidos en 0.36.0 sin mencionarse): read puede ser tu otro dispositivo; chat refleja nombre, miembros o salida. Marcar no leído no es un evento de lectura.

Cambios que pueden romper scripts

  • contacts profile: flags contiene bot, true para bots, false para personas; antes estaba vacío.
  • watch --events: chat aparece solo si el chat cambia — nombre, descripción, miembros, estado, foto o propietario. Antes podía aparecer con cada envío mediante max serve.

Correcciones

  • Una respuesta perdida tras iniciar un bot o pulsar un botón da resultado desconocido (outcome_unknown, salida 14), no un fallo seguro para reintentar. No se repite automáticamente; comprueba la respuesta del bot antes de repetir. El registro conserva el resultado desconocido.
  • Consultar un grupo por enlace mediante max serve no añade a tu lista un grupo al que no perteneces (corregido en 0.36.0 sin mencionarse).
  • max y grupos como max chats sin subcomando muestran ayuda en un terminal en lugar de ✗ (outputHelp). Scripts y --json reciben un error con max --help.

0.36.0 — 08.10.2026

Novedades

  • Archivos para agentes remotos: attachments show transfiere bytes guardados por porciones limitadas con SHA256. MCP devuelve imágenes completas o recursos binarios, con alternativa JSON/base64. No llama a un modelo ni cambia el índice; el agente lee y guarda el texto (adjuntos).
  • La biblioteca compartida añade lectura de carpetas con nombres de chats, metadata refresh --only-missing, reintento/limpieza de trabajos, cohortes de retención observadas y contadores con frescura explícita; los valores desconocidos no se sustituyen por cero.

Cambios que pueden romper scripts

  • max contacts profile rellena seen con la última hora de presencia o online si MAX informa de presencia. Un campo antes vacío puede contener un valor (personas).
  • JSON de rankings y pruebas incluye observaciones de contadores y frescura; las pruebas admiten selecciones de cohortes de retención. Comprueba campos y tipo de selección antes de interpretar; un valor desconocido o un archivo incompleto no significa cero.

0.35.0 — 08.10.2026

Novedades

  • max chats delete y max chats clear borran el chat o sus mensajes solo para esta cuenta. Los demás los conservan. Sin --allow-dangerous, pregunta; sin terminal, rechaza.
  • Texto local de adjuntos: ODT, ODS, XLSX, PPTX, EPUB, UTF-16 con BOM y codificaciones antiguas detectadas con confianza. Sin modelo; no calcula fórmulas y las imágenes quedan para el agente. Estos formatos no necesitan paquetes adicionales; PDF/DOCX conservan motores opcionales (adjuntos).
  • Informes de administración del archivo: preguntas sin respuesta observada, tiempo de respuesta de personas elegidas, ayuda tras una entrada conocida y publicaciones vistas con poca conversación. Las selecciones/pruebas muestran los mensajes; lo desconocido no demuestra ausencia de respuesta (clasificaciones).
  • Stickers: max stickers list y max messages send --sticker <id>. Lista paquetes añadidos; --set <id> muestra sus stickers e ids. Envía un sticker sin texto ni archivos.
  • max chats mute y max chats unmute cambian solo tus notificaciones, para siempre o con --until 8h.
  • max account privacy set cambia --find-by-phone, --phone-number, --calls, --chat-invites (everyone, contacts, nobody) y --hide-online on|off; mantiene los demás ajustes. MAX solo admite everyone/contacts para encontrar por teléfono; rechaza nobody.
  • max chats media lee fotos, vídeos, archivos, audio y enlaces del servidor con --type y --before-id (uso).
  • max calls list muestra llamadas entrantes, salientes, perdidas y duración, las nuevas primero.
  • max account privacy show muestra quién encuentra, ve el número, llama o añade la cuenta y si se oculta el estado; usa la respuesta de acceso sin otra petición.

0.34.0 — 08.10.2026

Novedades

  • max chats update --photo establece la foto de un grupo o canal (grupos).
  • max chats folders order cambia el orden de las carpetas. Primero va la carpeta obligatoria «Todos los chats», después las carpetas indicadas y luego las restantes en su orden anterior (uso).
  • Tus propios nombres y notas sobre personas: max contacts alias y max contacts notes. Se guardan solo en este ordenador y no se envían a MAX; contacts show --with-notes los muestra y contacts list --search-notes los busca (uso).
  • Etiquetas automáticas de grupos y canales: max metadata refresh y max tags auto — a partir del nombre y la descripción, sin leer mensajes; tus etiquetas no se modifican (búsqueda).
  • max store fetch --all descarga todos los chats — los últimos 90 días de cada uno; --background lo ejecuta en segundo plano. La búsqueda indica cuántos mensajes y chats ha revisado y cuántos chats no se han descargado o están desactualizados; coverage.next en JSON indica al agente qué comando ejecutar antes de concluir que un mensaje no existe.
  • Las métricas de respuestas y debates utilizan los vínculos de respuesta de MAX guardados. Si los datos son incompletos, el vínculo queda como desconocido en lugar de suponerse.
  • La guía de clasificaciones explica las métricas, puntuaciones, cobertura, selecciones guardadas y pruebas.
  • Las nuevas guías explican los adjuntos, el reconocimiento de voz y la configuración de modelos externos.

Cambios que pueden romper scripts

  • max session end cierra la sesión en MAX, en lugar de limitarse a olvidar el token aquí — como tg session end. revokedOnServer ahora es true. Si el token se copió de una pestaña de web.max.ru, esa pestaña también cerrará la sesión (sesiones).

  • max messages search en un solo chat también consulta el servidor de MAX. Con --chat o chat: y palabras, busca por defecto en el archivo y el servidor (--backend both), y encuentra mensajes aún no descargados. Los resultados del servidor se comprueban con la misma consulta; cada mensaje tiene un campo source. --backend archive busca solo en el archivo; --server-time indica cuánto esperar al servidor (5 segundos). Sin un chat, se busca solo en el archivo (búsqueda). Ten en cuenta: buscar en un chat ahora puede conectarse a MAX; --backend archive mantiene la búsqueda local.

Correcciones

  • Las solicitudes MCP preparadas utilizan los disponibles max_read y max_write, en lugar de los antiguos nombres de herramientas individuales. Sus búsquedas comprueban coverage.next antes de concluir que un mensaje no existe.

  • Las selecciones guardadas conservan los límites de fecha exclusivos al ejecutarse de nuevo, por lo que los mensajes justo en el límite quedan excluidos. MCP ya no ofrece al agente operaciones de carpetas no disponibles.

  • max serve --timeout cierra el servidor. Al agotarse el tiempo, se cierran la conexión, el inicio de sesión pendiente y las tareas en segundo plano; el proceso termina con el código de tiempo de espera agotado.

0.33.0 — 07.10.2026

Novedades

  • max stats messages top y max stats contacts top clasifican los mensajes guardados y sus autores, y el campo evidence de cada entrada muestra qué mensajes explican su posición. Todo se calcula con la copia local; no se envía nada a MAX. searches create --selection guarda esa clasificación como una búsqueda.

Cambios que pueden romper scripts

  • Cada perfil comparte ahora un único ritmo de solicitudes a MAX entre todos los procesos max. Antes, los comandos simultáneos, store fetch en segundo plano, mcp y serve hacían sus pausas por separado y, juntos, contactaban con MAX más a menudo. Ahora comparten un cupo: 10 solicitudes seguidas y después 20 por minuto. Por qué: MAX bloquea las cuentas por un exceso de solicitudes, y las tareas en paralelo las multiplicaban. Ten en cuenta: las descargas masivas en paralelo tardan más; un comando que tendría que esperar más de 5 minutos termina de inmediato con el código 8. Cambia el ritmo con requestsPerMinute o MAX_REQUESTS_PER_MINUTE; 0 lo desactiva. Consulta los límites en limits.md.
  • max messages send ya no tiene la opción --comment-to. Apareció en 0.32.0 con el código compartido de Telegram, pero en MAX solo rechazaba la operación con el código 2. Ten en cuenta: un script que pase --comment-to sigue recibiendo el código 2, ahora con un mensaje de opción desconocida.

0.32.0 — 07.10.2026

Novedades

  • Las fotos y los escaneos de adjuntos se pueden reconocer por lotes con el modelo elegido. Por defecto, el agente sigue leyéndolos por sí mismo y guarda el texto con attachments text set. Para procesarlos por lotes, usa attachments extract --ocr con el modelo de models.ocr y --concurrency; el texto reconocido entra en la búsqueda existente con content:. Ten en cuenta: --ocr envía archivos al proveedor del modelo elegido, por lo que debe activarse de forma explícita. La caché tiene en cuental archivo y el modelo; un fallo de la API no sobrescribe el texto del agente ni el índice anterior.

Cambios que pueden romper scripts

  • max contacts profile muestra los nombres anteriores de una persona en el nuevo campo aliases. Antes, la copia local recordaba solo el nombre actual: un nombre nuevo de un mensaje o de la sincronización de contactos sobrescribía el anterior. Por qué: es más fácil reconocer por un nombre anterior a alguien que ha cambiado de nombre. Ten en cuenta: la respuesta --json incluye ahora aliases, una lista de { name, firstSeenAt, lastSeenAt, source } de más antiguo a más reciente. source: messages indica un nombre de los mensajes guardados y es aproximado. La lista queda vacía hasta que la copia haya observado un cambio de nombre. from: busca solo por el nombre actual. Personas.
  • max messages send añadió --comment-to, pero no funciona en MAX: el comando rechaza la operación con el código 2 y no envía nada. La opción se comparte con Telegram, donde publica un comentario bajo una publicación de canal. Ten en cuenta: MAX no admite comentarios bajo publicaciones de canales; no uses esta opción en scripts.

0.31.0 — 07.10.2026

Novedades

  • Preparación de la búsqueda y reparación del archivo. Extracción de texto mediante MCP, attachments extract --from-dir y messages download --extract; comprobación de archivos modificados por hash. store fetch --catch-up prepara el grafo y los vectores locales instalados dentro de los límites indicados; está desactivado por defecto. store gaps plan/repair y MCP muestran los huecos internos registrados y los descargan de forma explícita con límites y tareas. Los extremos desconocidos y las páginas ambiguas no se consideran un archivo completo.

  • Las listas de miembros de los grupos en seguimiento se actualizan a diario mientras funciona MAX server. Está disponible chats members fetch --track; el seguimiento no amplía el tiempo de espera por inactividad del servidor.

  • max setup es más fácil de leer. Cada paso tiene un encabezado como [1/4] This computer, con lo ocurrido debajo y con sangría; las preguntas y el código QR aparecen bajo su paso, con líneas en blanco alrededor del código. El resultado es una tabla alineada cuya primera fila indica el comando con el que empezar. La salida --json y sus claves no cambian; --quiet sigue ocultando los pasos.

  • Las plantillas de respuestas automáticas utilizan Liquid y bloques ai separados. models.replies elige el proveedor; replies consents concede consentimiento para un perfil y un endpoint, con exclusiones para chats concretos. replies test normal no llama al modelo; --ai pasa explícitamente los datos guardados. Las plantillas antiguas conservan un texto alternativo con una advertencia. El envío sigue limitado por testers y replies.send; consulta la guía.

  • max serve abre tareas a partir de las reglas de respuesta automática. Consúltalas con max tasks list o el prompt MCP open-tasks; crear una tarea no envía nada.

  • La conexión desde el navegador está documentada para Windows, macOS y Linux. La guía distingue Tailscale del servidor, proporciona comandos de PowerShell y explica los permisos temporales de envío, la conexión de Codex web, cómo ejecutar dos mensajeros y cómo detener túneles individuales. Conexión.

  • Los ajustes, permisos y perfiles se explican por separado. Las guías empiezan con tareas habituales, la ubicación del archivo y ejemplos; la referencia completa sigue disponible.

Cambios que pueden romper scripts

  • Contrato del SDK 0.161.0: modo sin interacción, límites de entrada, salida y tiempo, esquemas de comandos, selección de campos, vistas previas y reglas para reintentar escrituras. Las estadísticas utilizan stats <ресурс> <вид> sin los antiguos alias.

  • MCP utiliza tres herramientas de búsqueda, lectura y escritura en lugar de una herramienta por comando; no hay formularios de confirmación del servidor. Se mantienen los permisos del perfil y las reglas de moderación independientes.

  • Los ajustes se dividen en una guía breve y una referencia completa; se añaden una página para usuarios sobre el contrato de la CLI y una comprobación de la habilidad del agente en CI.

  • Las estadísticas se consultan con stats messages show, stats chats show y stats tasks show. Se eliminan las antiguas rutas messages stats, chats stats, tasks stats; actualiza los comandos y los permisos exactos a stats.messages.show, stats.chats.show, stats.tasks.show. Las herramientas MCP se llaman ahora max_stats_messages_show, max_stats_chats_show, max_stats_tasks_show.

  • Los errores de sintaxis devuelven el código 2 y un error JSON estructurado. Los scripts que esperaban el antiguo código 1 o texto normal deben actualizar su tratamiento de errores.

  • La primera carga de ajustes crea config.json. No se sobrescribe un archivo existente; las variables de entorno y las opciones del comando no se guardan en él. config show ahora puede crear el archivo, y los valores habituales muestran el archivo defaults como origen.

  • La búsqueda de palabras y frases encuentra formas de las palabras. Las consultas de los scripts pueden devolver más mensajes. Para la coincidencia exacta anterior, usa exact: o --exact; text: explícito sigue buscando formas de las palabras. Los ajustes de idioma del archivo determinan las coincidencias.

Correcciones

  • La preparación de la búsqueda respeta la prohibición de escribir vínculos. conversations.links: readonly o deny detiene la preparación tras la descarga y durante la reparación de huecos, antes de conectarse o iniciar una tarea. --no-catch-up explícito sigue permitiendo leer el historial normalmente según las reglas del perfil.

  • El contexto de una persona encuentra conversaciones privadas sin una lista de miembros registrada cuando el ID del diálogo coincide con el ID de la persona; vuelven a estar disponibles los mensajes recientes en ambas direcciones.

  • La documentación de MCP utiliza las rutas de comandos y los permisos actuales, sin los formularios de confirmación eliminados.

  • Al interrumpirse una escritura, se conservan los valores originales outcome_unknown, operationId y los datos de reintento devueltos por el comando: la biblioteca compartida se actualiza a 0.161.0.

  • Un tiempo de espera agotado durante una escritura de Bot API conserva un resultado desconocido. La operación puede haberse completado; comprueba el estado antes de reintentar.

  • MCP de MAX no ofrece herramientas de foros no compatibles. La búsqueda de comandos ya no ofrece modificar ni ordenar topics de Telegram.

0.30.0 — 06.10.2026

Novedades

  • max stats charts --output activity.png guarda un gráfico PNG con tema oscuro. SVG sigue disponible; las imágenes solo se escriben en archivos nuevos. MCP max_stats_charts con format: "png" devuelve una imagen junto con JSON, sin conectarse a MAX ni escribir archivos. Sin format, MCP sigue devolviendo JSON.
  • Las reglas de respuesta automática se pueden editar con max replies add|edit|on|off y audience. Una regla nueva está desactivada hasta que se activa explícitamente; los cambios se guardan solo localmente, sin enviar mensajes. Las respuestas automáticas siguen limitadas a cuentas de prueba; la lista testers se sigue definiendo en el archivo. Respuestas automáticas.
  • max tasks muestra qué espera tu respuesta. max review mantiene en la copia local una tarea para una pregunta sin responder o un mensaje que te menciona, y la cierra cuando respondes; ahora estas tareas son visibles. max tasks list las muestra con un enlace al mensaje; max tasks add <сообщение> --type promise añade lo que las reglas no detectan; max tasks close <задача> --as done|dismissed cierra una tarea para siempre; max tasks stats las cuenta por chat. MCP max_tasks_list, max_tasks_add, max_tasks_close, max_tasks_stats ofrece lo mismo al agente. Todo queda en este ordenador; no se envía nada a MAX. Las escrituras requieren los permisos tasks.add y tasks.close. Ten en cuenta: MCP incorpora cuatro herramientas más; max serve aún no abre tareas en MAX. Qué espera tu respuesta.
  • La búsqueda semántica abarca los mensajes largos completos. Antes de crear el embedding, los mensajes de más de unos 1200 caracteres se dividen en fragmentos superpuestos, de modo que se lee todo el mensaje y no solo el principio. Los chats preparados antes se consideran desactualizados: se reconstruyen con conversations build o search --refresh (cli-messaging 0.153.0; el almacén pasa a la versión 21, en la que las compilaciones antiguas pueden seguir escribiendo).
  • MCP realiza escrituras permitidas desde clientes web sin formularios del servidor. --http-confirmation permissions respeta los niveles de permiso: allow no exige formulario del servidor y ask sí. Por defecto, cada escritura sigue exigiendo un formulario. La opción repetible --permission ключ=уровень modifica los permisos solo mientras funciona el servidor, sin cambiar los ajustes. La confirmación de la aplicación es independiente y el servidor no la comprueba. Ten en cuenta: en este modo, el agente del navegador realiza sin formulario todo lo que el perfil permita con allow, incluido el envío de mensajes; revisa los permisos antes de activarlo. Conexión.

Correcciones

  • Las descripciones de las herramientas MCP de seguimiento de miembros tienen en cuenta la recogida manual en MAX. Ya no prometen lecturas diarias mediante serve ni ofrecen el no disponible fetch --track. La lista de grupos y las instantáneas guardadas se siguen leyendo del almacén local.

0.29.0 — 06.10.2026

Novedades

  • max chats tracking list|show|add|remove gestiona los grupos cuyo número de miembros se sigue. Consulta las instantáneas guardadas del número de miembros, añade un grupo sin leerlo inmediatamente o quítalo conservando su historial. Para registrar los miembros, utiliza max chats members fetch. En MAX, serve todavía no lee los miembros diariamente: repite la recogida manualmente o con tu propia programación.

  • Perfil de una persona. max contacts profile <человек> muestra lo que MAX informa sobre una persona: nombre, enlace, descripción, fecha de creación de la cuenta (registered, según MAX) y si tiene foto propia. Para cada chat compartido muestra cuántos mensajes tiene guardados, el primero y el último. Si MAX proporciona un teléfono, aparecen sus cuatro últimos dígitos; --show-phone lo muestra completo. Una petición adicional a MAX respecto a contacts show. MCP: max_contacts_profile.

  • Respuestas por reglas, solo a cuentas de prueba. max serve responde a mensajes entrantes con las reglas de <профиль>.replies.json, solo a personas incluidas en testers y únicamente con permissions.replies.send allow. Comandos: max replies test, pause, resume, status. Véase docs/replies.md.

  • max contacts context <человек> --chat <чат> (repetible) devuelve los mensajes recientes de esa persona en cada chat, con fecha y texto para que el agente los resuma. -v añade identificadores y enlaces; --limit se aplica por chat; --refresh consulta primero la última página del chat en MAX.

  • Utiliza cli-messaging 0.152.0.

  • max contacts check <человек> comprueba si una persona parece un bot. Valora el perfil y los mensajes guardados (ningún mensaje, un enlace como primer mensaje, el mismo texto en varios chats), con una fuente para cada motivo. Las listas públicas de remitentes de spam cubren solo Telegram, así que no se consultan para MAX. max chats members audit --deep <n> comprueba los primeros n miembros de la misma forma, uno por segundo.

  • max chats members fetch guarda instantáneas de miembros; history muestra los cambios. El historial se consulta sin conexión, con --since-time. --budget limita la instantánea; las salidas solo se registran tras una lectura completa. El seguimiento diario espera soporte del servicio en segundo plano de MAX. Trabajo con miembros.

  • max stats charts dibuja estadísticas del chat. Devuelve una descripción neutra en JSON; --output guarda un SVG oscuro de mensajes, autores activos, entradas y salidas por día o semana. Las fechas ausentes quedan como huecos y los datos incompletos se indican. No sobrescribe archivos existentes. MCP max_stats_charts devuelve la descripción del archivo local; PNG llegará por separado. La biblioteca nueva añade unos 61,6 MiB descomprimidos antes de la deduplicación y se carga en el proceso solo al pedir una imagen. Uso.

  • max store fetch también conserva las reacciones a publicaciones de canales. MAX incluye el número de reacciones en el historial del canal; max ahora lo conserva, por lo que max chats stats puede ordenar publicaciones por reacciones sin otra petición.

  • max chats stats <чат> muestra cifras de un grupo o canal durante un periodo. Mensajes, autores activos, respuestas, reacciones, publicaciones destacadas, preguntas y tiempos de respuesta, entradas y salidas. Calcula con el archivo local y consulta las entradas y salidas a MAX. Con historial incompleto, las cifras son mínimos y el comando sugiere un store fetch para completarlo.

  • La búsqueda lee el texto de archivos. attachments extract guarda texto TXT, DOCX y de PDF con capa de texto; content: lo busca. DOCX/PDF requieren los paquetes opcionales mammoth/unpdf; el agente lee fotos y documentos escaneados y guarda el resultado con attachments text set. Por defecto solo lee archivos descargados; --download --output-dir los descarga primero de forma explícita.

  • Actualizar antes de buscar y seguir las respuestas. --sync-first limita la descarga a cinco chats, 500 mensajes y 30 segundos; una actualización incompleta no oculta los resultados locales. --thread añade un grafo acotado de respuestas con la procedencia de los enlaces; sin grafo utiliza el contexto cronológico.

  • La búsqueda de conversaciones acepta filtros estrictos y un alcance explícito de cuentas. --filter limita las conversaciones antes de ordenarlas; al menos un mensaje debe cumplir todo el filtro. --source amplía el alcance explícitamente. Un agente puede enlazar mensajes íntegramente mediante MCP: instrucciones link-conversations, lotes, almacenamiento de enlaces y reconstrucción del grafo.

  • Los modelos de vectores y análisis se configuran por separado para cada perfil. Los vectores locales y tu agente siguen siendo los valores predeterminados. Un servicio externo recibe texto solo al seleccionarlo explícitamente; build --analyze --chat pide consentimiento y lo recuerda para la cuenta, el chat y el servicio hasta revocarlo.

  • Etiquetas propias: max tags add, remove y list. Etiqueta un chat (--chat), persona (--contact) o mensaje (--message); tag:<метка> encuentra lo etiquetado. Las etiquetas se guardan en el archivo local y nunca se envían a MAX. Una etiqueta contiene de 1 a 32 letras latinas, cifras o guiones. El agente dispone de las mismas acciones mediante MCP. Véase Búsqueda de mensajes.

  • Consultas guardadas: max searches y --saved. max searches create <имя> [запрос] guarda una consulta con sus opciones; max messages search --saved <имя> y max messages stats --saved <имя> la ejecutan. Las palabras añadidas a --saved restringen la consulta; las opciones de la línea de comandos sustituyen las guardadas. searches list, show, history, delete y clear muestran y limpian las consultas y el historial. La consulta de messages search ahora es opcional si se indica --saved.

  • max contacts context <человек> muestra lo que el archivo sabe sobre una persona. Chats compartidos, últimos mensajes en ambas direcciones, mensajes recientes y menciones. Lee el archivo sin marcar mensajes como leídos. max contacts link registra que una cuenta de MAX y otra de Telegram pertenecen a la misma persona, para que context incluya ambas; max contacts unlink deshace el enlace. Como context devuelve texto de mensajes, permissions.messages: deny también lo bloquea.

  • max store repair repara la estructura del archivo sin borrar datos. Conserva una tabla con estructura distinta como copia junto a la nueva y la nombra en el resultado. --dry-run muestra los cambios sin aplicarlos. max store copies delete <имя> borra una copia conservada. Véase Archivo.

  • La búsqueda puede usar raíces de palabras al activarlas. max config set searchStemmers.cyrillic russian y searchStemmers.latin spanish (o english) configuran todo el archivo, todos los perfiles y ambos mensajeros. Después hay que ejecutar max store reindex.

  • max flood clear olvida las esperas recordadas y levanta las retenciones de envío. Aparecen en max server status, en el nuevo campo flood. MAX todavía no informa de cuánto hay que esperar, así que estará vacío para una cuenta personal de MAX. La pausa de inicio de sesión que muestra max doctor sigue evitando accesos demasiado frecuentes. No hay herramienta MCP deliberadamente: el agente no debe levantar una restricción.

  • Tres guías de búsqueda. Búsqueda de mensajes cubre búsquedas cotidianas por palabras, personas, fechas, archivos, enlaces y etiquetas; búsqueda por temas, conversaciones, vectores y texto enviado a modelos externos; lenguaje de consultas es la referencia.

Cambios que pueden romper scripts

  • La búsqueda semántica con e5-small local descarta coincidencias débiles antes de combinarlas con las de palabras. La similitud coseno debe superar 0,80; las coincidencias de palabras se mantienen. Puede haber menos resultados, y un resultado encontrado por ambos métodos puede quedar solo como coincidencia de palabras.

  • El archivo incorpora tablas de texto de adjuntos y de consentimiento de análisis. Es una migración local al abrirlo por primera vez; se conservan los mensajes anteriores. Haz una copia de seguridad de un archivo grande antes de actualizar.

  • El archivo ahora conserva todas las consultas correctas de messages search y messages stats, tanto de CLI como de MCP. Guarda la consulta y sus opciones, nunca los mensajes encontrados, y conserva las últimas 1000 ejecuciones. Sirve para searches history y --saved. Si no deben quedar consultas en disco, utiliza --no-record o max config set record false; max searches clear vacía el historial sin borrar consultas guardadas.

  • El archivo migra al nuevo esquema al primer uso. Incorpora tablas de etiquetas, consultas guardadas y raíces de palabras; max store migrate completa el índice de raíces para mensajes existentes. En archivos grandes, store migrate y store reindex tardan más. El archivo es compartido con tg; las versiones anteriores de max y tg todavía pueden abrirlo.

  • max inbox, inbox --new, review y chats list --unread (también con --search y --kind) revisan todos los chats que MAX devuelve al iniciar sesión, en vez de los 200 más recientes. Antes se omitían silenciosamente chats con mensajes no leídos situados más abajo. Cada ejecución sigue procesando como máximo 20 chats y nombra los demás en skipped N chats. Ahora partial: true solo significa que MAX no devolvió todos los chats al iniciar sesión.

  • max chats list indica hasMore: true en la última página no vacía si MAX devolvió una lista incompleta. Antes parecía completa. Los scripts que paginan hasta hasMore: false se detienen en la página vacía.

  • max messages list y max store fetch ya no consideran una página corta como el inicio del chat. MAX no indica si hay mensajes anteriores, y una página puede tener menos mensajes que --limit incluso en medio de una conversación. Tras una página corta, max pide ahora un mensaje más antiguo: si existe, hasMore: true; si no, es el inicio del chat. Ten en cuenta: esto añade una solicitud a MAX por cada página corta, y hasMore será true más a menudo.

  • max config set y config unset aceptan searchStemmers.cyrillic y searchStemmers.latin; config show --json los muestra en el nuevo campo storeSettings. Se guardan en el archivo, no en el fichero de configuración, por lo que rechazan --defaults, --personal y --bot; no se pueden modificar bajo MAX_PROFILE_LOCK.

Correcciones

  • Los errores del fichero de reglas de respuestas ya no imprimen fragmentos de ese fichero en el registro del servicio.

  • max mcp --http: Claude y ChatGPT ya pueden completar el inicio de sesión. La página de acceso hacía que el navegador enviara el formulario sin origen y max respondía «Origin not allowed». Ahora funciona (cli-messaging 0.152.0).

  • Un localizador de mensaje de otra cuenta ya no abre un mensaje con el mismo número en la cuenta actual. messages show/context lo rechaza; MCP acepta offline: true para el contexto local ordinario.

  • La búsqueda estricta text:/…/ encuentra palabras igual que la búsqueda por palabras. Antes text:/Квартир.*/ y text:/счёт/ no encontraban palabras guardadas por las mayúsculas y la letra ё. body: sigue distinguiendo mayúsculas.

  • Los errores de búsqueda estricta indican qué hacer. ~ sugiere --language legacy y слово*; un prefijo corto como к* indica el límite de 10 000 palabras y pide uno más largo; index_not_ready muestra el progreso del índice y el comando exacto max store migrate.

  • MCP no guarda el historial de consultas cuando se desactiva el registro. Antes record: false solo desactivaba el historial en la línea de comandos.

0.28.0 — 04.10.2026

Novedades

  • MCP max_chats_stats calcula la actividad de un grupo o canal a partir del archivo local; no consulta las entradas ni las salidas. max chats members audit muestra señales de miembros sospechosos, sin eliminar a nadie.

  • MCP max_inbox y max_review aceptan kinds y new, con marcas por chat separadas de las de la CLI.

  • max messages stats cuenta mensajes del archivo local por chat, remitente, día u hora. La consulta usa Lucene estricto; sin ella, se cuentan todos los mensajes guardados de la cuenta actual. No usa la red; --source max incluye explícitamente los demás perfiles. En un archivo incompleto, el resultado es un límite inferior; revisa coverage y completeness.

  • max mcp --http --public-url https://<имя>.ts.net abre max a ChatGPT y Claude en el navegador. Las herramientas MCP se ofrecen en 127.0.0.1 detrás de tu propio túnel, con acceso propio: la aplicación necesita un código de un solo uso que max muestra en el terminal. Cada cambio pregunta antes mediante un formulario en la aplicación. El acceso dura 30 días; max mcp --revoke los cierra todos. docs/remote.md sustituye el montaje con un proxy de terceros.

  • El MCP personal usa el mismo conjunto de esquemas que Telegram: dispositivos, búsqueda de contactos por teléfono, carpetas, miembros, invitaciones, configuración del grupo, encuestas, pruebas locales y conversaciones. Los temas de Telegram no existen en MAX. Se conservan los nombres antiguos de comprobación y reglas del grupo.

  • Un envío programado confirmado usa la hora del formulario, aunque la respuesta llegue más tarde.

Cambios que pueden romper scripts

  • coverage.inventoryComplete indica ahora que se ha recibido la lista completa de chats, y lastSyncedAt, la carga más antigua dentro de la cobertura; las entradas de completeness incluyen fetchedAt. Un archivo existente obtiene estos datos tras la siguiente lista completa y la descarga del historial. /catch-up acepta kind y mode en lugar de since.

  • config set permissions rechaza órdenes desconocidas, incluidas erratas dentro de un objeto completo, con el código 2. config unset permite eliminarlas; al leer un archivo existente se avisa y se continúa.

  • Los argumentos de MCP usan los nombres comunes: at_time, md, since_time, before_n, after_n, unanswered; send_id es ahora una cadena. Los argumentos desconocidos se rechazan antes de ejecutar. Actualiza las llamadas según el esquema de tools/list. En max_inbox y max_review, el parámetro all: true incluye los chats silenciados y archivados; sin él, solo quedan las menciones al propietario.

Correcciones

  • La búsqueda y las estadísticas muestran la cobertura real del archivo local y la hora de la última carga. wordsReady ya no promete un índice de palabras listo para búsquedas solo con filtros o regex. store fetch ignora la marca de inicio del historial si aparecen mensajes más antiguos en el archivo.
  • server status informa del código de cierre normal del servicio y del motivo de la parada sin volver a iniciarlo.

0.27.0 — 04.10.2026

Novedades

  • La instalación global con npm configura el PATH de Windows y el skill del agente. Conserva las entradas existentes y permite ejecutar max en terminales nuevas. Un agente que ya está abierto debe actualizar su entorno. El skill se instala antes de iniciar sesión; MAX_INSTALL_AGENT=none lo desactiva. La instalación local y npx no cambian el entorno del usuario.

  • max commands messages search --json describe un comando; max commands messages --json, un grupo. El agente ya no necesita leer el árbol completo antes de cada tarea. Se conservan las opciones globales y los códigos de salida. Las palabras tras commands indican una ruta; consulta otros grupos en llamadas separadas. Sin ruta, sigue devolviendo el árbol completo.

  • max messages link y MCP max_messages_link devuelven un locator del mensaje del archivo local. El destino se valida con la cuenta actual; se rechazan locators de otra cuenta. MAX personal aún no tiene un formato de permalink verificado: url es null y la respuesta indica el motivo. --offline no conecta con MAX. Consulta mensajes.

Cambios que pueden romper scripts

  • CLI y MCP usan permissions con los niveles deny, readonly, ask y allow. Comandos y agentes comparten permisos. La mayoría de escrituras por MCP están ahora disponibles por defecto; eliminar mensajes y cerrar otras sesiones requiere confirmación salvo que exista un allow explícito. Por ejemplo, messages: readonly junto con messages.delete: allow permite leer y eliminar sin preguntar, pero prohíbe las demás escrituras en mensajes; no limita otros recursos. Antes de actualizar, revisa los permisos del agente y asigna readonly o deny a los recursos que quieras restringir. --confirm-send exige un formulario antes de cada escritura; en JSON, ask necesita una opción explícita.

  • config migrate convierte los ajustes antiguos de acceso y los niveles de moderación. --dry-run muestra cambios sin escribir. Conserva los permisos efectivos, los ajustes MAX y las posiciones guardadas de comprobación de grupos. Cuando existe permissions, no se pueden cambiar readOnly, allow ni mcpTools. Los antiguos --allow-send, --allow-mark-read, --allow-delete y --allow-moderate se aceptan con aviso, pero no otorgan permisos. Siguen vigentes la lista de destinatarios y el límite por hora. Consulta configuración y MCP.

Correcciones

  • La apertura simultánea del archivo local espera un bloqueo breve de SQLite al arrancar. Antes, la configuración del journal podía encontrar una base ocupada antes de activar la espera y fallar de inmediato. Un bloqueo prolongado sigue causando un error. Este cambio no inicia la descarga del historial.

0.26.0 — 03.10.2026

Novedades

  • max skill show link-conversations imprime el skill compartido para relacionar conversaciones. Funciona sin sesión; sin nombre, sigue mostrando el skill principal de MAX.

  • max messages evidence devuelve un paquete limitado del archivo local, con locator, información de integridad y continuación mediante --before-id. No conecta con MAX.

Cambios que pueden romper scripts

  • Las fotos descargadas reciben su extensión según el MIME HTTP, por ejemplo .webp para WebP, en lugar de JPEG según el tipo de adjunto. Se conservan los nombres originales; no hay consultas preliminares adicionales.

  • max account show usa el formato de cuenta compartido con Telegram. JSON añade username: null; mantiene los campos MAX, el teléfono oculto y --show-phone.

  • max sends list respeta el limit configurado, como Telegram. Antes seleccionaba siempre 20 intentos sin opción explícita. El campo JSON limit muestra el límite elegido; mantiene items, page y hasMore. --limit tiene prioridad sobre el ajuste.

  • max messages download admite --all, --output-dir y --pause, como Telegram. Crea el directorio y, al repetir la descarga del chat completo, continúa desde el progreso guardado. --output sigue siendo un nombre compatible para el directorio. El JSON de un mensaje contiene ahora {items}, sin page, limit ni hasMore artificiales; los scripts deben leer items. Los audios tienen ahora kind = voice, como Telegram, en vez de audio. Los archivos se descargan en streaming con las mismas comprobaciones de dirección y tamaño; los audios conservan el límite de 32 MiB.

Seguridad

  • max contacts lookup no repite un teléfono pasado por error como argumento. Rechaza el uso antes de pedir el número o conectar; introduce el teléfono cuando se solicite o mediante stdin.

Correcciones

  • messages list, inbox y review con --transcribe descargan la grabación por la conexión de lectura. Antes se abría un segundo acceso a MAX. La grabación se descarga antes de cerrar la conexión, y el reconocimiento local empieza después del cierre. Sin un --mark-read explícito, no se marca nada como leído.

  • review --unanswered tiene en cuenta las transcripciones guardadas y nuevas de preguntas de voz. Antes, una pregunta con texto vacío se descartaba antes de transcribirla. La misma corrección se aplica en MCP; el texto original del mensaje no cambia, y las grabaciones sin reconocer dejan la revisión incompleta.

  • max chats show explica correctamente las diferencias en el número de miembros. La lista puede excluir tu cuenta o estar incompleta. El comando muestra ambas cifras sin afirmar que falló la descarga. Se conservan JSON y la lista original.

  • El rechazo poll.already.voted explica cómo cambiar el voto. Si la encuesta lo permite, ejecuta primero polls vote <chat> <message> --retract en el mismo perfil y elige después otra respuesta.

  • max messages download --timeout también cierra el flujo HTTP del adjunto. Antes podía seguir descargando tras vencer el tiempo del comando, hasta otro límite de inactividad. Ahora el cierre del adaptador cancela sus flujos y eliminal archivo incompleto.

0.25.0 — 03.10.2026

Novedades

  • bot api usa el mismo constructor de comandos y validación de entrada que Telegram. Los generadores permanecen en cli-core; se conservan los parámetros, respuestas nativas y permisos efectivos de MAX. La opción compartida --store-token <profile> sirve para operaciones que devuelven credenciales; las demás la rechazan.

Correcciones

  • messages list, inbox y review con --transcribe descargan la grabación por la conexión de lectura. Antes se abría un segundo acceso a MAX. La grabación se descarga antes de cerrar la conexión, y el reconocimiento local empieza después del cierre. Sin un --mark-read explícito, no se marca nada como leído.
  • review --unanswered tiene en cuenta las transcripciones guardadas y nuevas de preguntas de voz. Antes, una pregunta con texto vacío se descartaba antes de transcribirla. La misma corrección se aplica en MCP; el texto original del mensaje no cambia, y las grabaciones sin reconocer dejan la revisión incompleta.

Cambios que pueden romper scripts

  • max models audio list --json añade directory: el directorio de modelos compartido por MAX y Telegram. Los comandos, la selección del directorio y la verificación de descargas son ahora comunes; se conservan los archivos, el orden y transcribeModel. No hace falta descargar de nuevo. JSONL sigue devolviendo un modelo por línea.

  • --md usa el formateador propio de MAX para send/edit y pies de archivo: estilos anidados, __жирный__, ++подчёркнутый++, enlaces y código. Los bots admiten énfasis, títulos y citas mediante HTML seguro; el protocolo personal rechaza tipos no verificados. Telegram tiene otra sintaxis. Ya no se envían silenciosamente tipos wire desconocidos.

0.24.0 — 03.10.2026

Novedades

  • max setup guía el primer inicio de una cuenta personal: comprueba directorios, ofrece acceso por QR, comprueba la cuenta y hasta cinco chats e instala el skill del agente elegido. Reutiliza la sesión existente al repetirse. El historial se descarga aparte; setup no inicia el servicio en segundo plano. La ayuda, instalación e instrucciones del agente explican los siguientes pasos y cómo ejecutar en Windows sin PATH. max skill show funciona antes de iniciar sesión.

Cambios que pueden romper scripts

  • max chats check pasa a ser max chats moderate: reglas y moderación compartidas con Telegram. --since-time acepta fecha o 30m/2h/1d, en lugar de --since con un ID de mensaje; JSON devuelve { chatId, rows }. Lee hasta 1000 mensajes por ejecución. Los niveles son deny|readonly|ask|allow; los antiguos forbid y flag|confirm se interpretan como deny y ask. El punto guardado se migra de la sesión al archivo de reglas, por lo que la primera ejecución continúa desde él. CLI y MCP personal comparten ese punto; nombres y opciones MCP se conservan. La incorporación por enlace en chats events se llama join.

  • max upgrade --json siempre incluye restarted. En MAX es un array vacío: la política de inicio de servidores no cambia. Comprobar versiones y no encontrar actualizaciones devuelve el mismo formato que instalar, conservando los campos anteriores. Los scripts que comprueban las claves exactas deben admitir este campo.

  • La búsqueda local usa un perfil Lucene estricto: paréntesis, campos, rangos de fechas, --timezone, patrones y regex limitados. Los prefijos deben indicarse como слово*; la búsqueda anterior con correcciones está en --language legacy. JSON informa de la cobertura incluso sin resultados. La guía y el skill explican la migración; JS --regex se ejecuta en un worker separado con límites de tamaño y tiempo.

  • max commands --json incluye la versión del contrato JSON en contract. El valor 0 coincide con Telegram CLI; conserva los campos anteriores. Los scripts que comparan todo el JSON con una cadena guardada deben admitirlo; leer campos concretos no necesita cambios.

  • Las lecturas de grupos comparten opciones y formatos. chats events usa --since-time en lugar de --since y --type en lugar de --event; el límite es temporal, no un ID. La creación se llama create, antes new. chats members list muestra páginas con --limit, --page y --all; añade --all para obtener la cantidad anterior. JSON ya no incluye chatId ni rolesKnown; roles, creación y última conexión permanecen en las filas. chats inspect devuelve id, kind, title, username, participantsCount, description y member, en lugar de acceso, enlace y ajustes. member y username son null si MAX no los informa. Actualiza scripts y filtros. Se conservan los avisos sobre listas incompletas y roles desconocidos; leer no marca mensajes como leídos. Consulta grupos.

  • La gestión de grupos devuelve JSON común con operationId. chats create, join, update y link reset guardan la ficha en chat; leave devuelve chatId. members add incluye added y notAdded; members remove, removed; admins, personId y, al añadir, rights. Es el formato compartido con Telegram; actualiza el análisis de resultados. link show no cambia. Título y ajustes siguen usando dos solicitudes: si cambia título o descripción pero falla la segunda solicitud, informa de outcome_unknown y registra el resultado parcial. Consulta chats show antes de repetir. Más en gestión de grupos.

  • max account update y max account sessions end devuelven el formato común con operationId. Cambiar perfil devuelve {operationId, account} con id, name, username, phone; cerrar sesiones, {operationId, sessions} en lugar de un array. Lee los datos desde account o sessions. Tras cambiar el perfil, consulta su descripción con account show. El teléfono sigue oculto parcialmente; sessions end aún requiere --others --yes. La foto admite JPG, JPEG, PNG y WebP; convierte los GIF a uno de esos formatos. Consulta perfil y sesiones.

  • max chats folders create|update|delete incluye operationId. Crear o modificar devuelve {operationId, folder}; eliminar, {operationId, folderId}, en lugar de la ficha directamente. Los scripts deben leer desde folder y usar folderId al eliminar. update sin --title, --add ni --remove ahora rechaza la operación en lugar de reescribir lo mismo. Listar no cambia. Consulta carpetas.

  • max contacts add|remove|block|unblock|rename|import devuelve el formato común con operationId. Añadir y renombrar devuelve {operationId, person}; eliminar y bloquear, {operationId, personId}; importar, {operationId, sent, recognised}. recognised contiene fichas (id, name, username) devueltas por MAX en lugar de teléfonos; sin fichas queda vacío. sent cuenta filas del archivo, incluidos números repetidos. Actualiza el análisis de respuestas. Un teléfono rechazado por MAX ya no indica la fila; los errores de estructura todavía la indican. Consulta contactos.

  • Se elimina max cache clear. Lecturas y nombres usan la copia compartida; max store clear --left --allow-dangerous elimina datos de chats abandonados. No ofrece borrar toda la copia. El archivo antiguo no se migra ni se abre; max doctor muestra su ruta y puedes descargar otra vez el historial con max store fetch.

Correcciones

  • max conversations embed status calcula mejor el tiempo para e5-small. Usa una medición de 31 fragmentos/s, antes 15; en el portátil medido, la estimación anterior era el doble. El tiempo real depende del ordenador y la longitud del texto. Tres workers dieron 1,04–1,1× con más uso de memoria; la distribución de workers no cambió.

  • max_messages_search por MCP conserva la cobertura del archivo y usa los parámetros de CLI. Admite language, timezone, ast versionado, nombre de chat y filtros source, newest, context. El perfil estándar admite consultas de un carácter. Antes faltaban parámetros y se perdían query, coverage y completeness; una respuesta vacía no explicaba el alcance de la copia. Los campos anteriores y el nombre de herramienta se conservan.

  • max runs list --limit sugiere ampliar el límite si faltan registros. Ya no sugiere la opción inexistente --page. Leer la lista o un registro no crea otra ejecución; JSON conserva hasMore.

  • chats show muestra un grupo guardado aunque no llegue en la última actualización de acceso. Antes podía fallar con «sin chat». Los ajustes y enlaces desconocidos quedan vacíos; leer no modifica el grupo.

  • max messages transcribe encuentra una transcripción guardada por nombre de chat, aunque no esté descargado el modelo. Antes buscaba por nombre en lugar de ID y proponía descargar otra vez el modelo. Un nombre completo o fragmento único devuelve ahora el texto guardado sin descargar el audio ni reconocerlo de nuevo. Consulta mensajes de voz.

  • En Windows, el generador usa Node en lugar de ejecutar .cmd directamente; las comprobaciones de documentación reconocen rutas Windows. Los tests de permisos Unix no los exigen en Windows, donde se usa ACL.

  • Los errores de max bot antes de iniciar una acción respetan los ajustes de registro del perfil bot, incluso con --timeout delante. Antes, una opción global anterior a bot podía aplicar ajustes de la cuenta personal. Si el bot tiene desactivado el registro, un error al interpretar la orden ya no crea un registro contra esa preferencia.

0.23.0 — 03.10.2026

Novedades

  • max serve y los comandos de gestión de chats guardan nombres y chats en la base compartida. Ya no abren la caché antigua. Una lista completa marca chats abandonados; una respuesta vacía conserva la lista anterior.

  • Los comandos de contactos y lectura guardan datos en la base compartida. Buscar personas por nombre y contacts sync ya no requieren la caché antigua. La sincronización sigue devolviendo solo cantidades. Eliminar el archivo anterior no reinicia su progreso; para obtener todos los contactos, ejecuta max contacts sync.

  • max mcp libera el modelo tras 10 minutos sin búsquedas. conversations_search ya no mantiene aproximadamente 1 GB durante toda la sesión del agente. La siguiente búsqueda vuelve a cargarlo en alrededor de un segundo (cli-messaging 0.110.0).

  • El autocompletado consulta la base compartida de la cuenta elegida. No necesita la caché anterior. Tab sigue sin conectarse a MAX; los bots ofrecen chats de su lista local.

  • max mcp setup codex|claude-code y max mcp doctor añaden MCP local al cliente y comprueban inicio y herramientas. Si el perfil ofrece escritura, requiere --allow-writes; esa aprobación no cambia permisos ni verifica el acceso a MAX.

  • max <бот> bot store fetch <чат> descarga historial en la copia del bot, recientes primero, y puede reanudarse. --last, --since-time, --limit, --page-size y --pause funcionan como max store fetch.

  • --yes para cualquier comando aprueba la pregunta del nivel ask antes de escribir; max account sessions end --others --yes funciona igual.

Cambios que pueden romper scripts

  • messages send --topic y polls create --topic rechazan claramente destinos MAX. La opción compartida corresponde a temas de foros de Telegram, que MAX no admite. No envía mensaje ni encuesta; sin --topic, nada cambia.

  • max doctor --json describe la base compartida en store y el archivo anterior en legacyCache. Ya no abre ni comprueba el esquema de la caché antigua. Cambia cache por store en scripts. Puedes borrar el archivo anterior y recuperar historial mediante max store fetch.

  • MCP consulta la base compartida. Búsquedas, contactos, recursos y transcripciones usan messages.db bajo la cuenta del perfil, sin abrir la caché anterior. Leer historial guarda mensajes para búsqueda. La voz lleva kind: "voice". Los nombres y parámetros de herramientas no cambian.

  • inbox y review usan formatos compartidos. Sustituye --since por --since-time. review --unanswered acepta 4h, 1d, no horas sin unidad. Los adjuntos de voz usan kind: "voice" en lugar de "audio". --all incluye silenciados y archivados. La primera ejecución migra el punto anterior de inbox --new. La revisión retrocede por páginas hasta 300 mensajes por chat e indica si está incompleta. Actualiza comandos y comprobaciones JSON.

  • Las transcripciones personales se guardan en la base compartida. messages transcribe, inbox, review y MCP usan el mismo texto que messages list bajo la misma cuenta. No se migran transcripciones antiguas; se regeneran al solicitarlas con --transcribe, con modelo descargado.

  • max <бот> bot people show pasa a max <бот> bot contacts show, herramienta MCP max_bot_contacts_show. Junto con bot messages search|between, son comandos compartidos con tg; opciones y resultados no cambian.

  • max <бот> bot chats check ahora es max <бот> bot chats moderate — comparte el nombre y el comando con tg. --since pasa a ser --since-time (sigue aceptando 2h, 1d); la respuesta --json es { chatId, rows } en lugar de una lista; la herramienta MCP es max_bot_chats_moderate. Las reglas y la posición de la última comprobación quedan en los mismos archivos. El nivel de consentimiento flag significa ahora lo mismo que confirm: preguntarte o actuar con --allow-dangerous.

  • max <бот> bot mcp utiliza permisos del perfil, no opciones. Sin opciones puede escribir salvo restricciones por readOnly: true o allow. Eliminar muestra formulario; --allow-dangerous lo omite. --allow-send, --allow-delete y --allow-moderate se aceptan con avisos, sin habilitar nada. Usa readOnly: true para solo lectura. El servidor se comparte con tg.

  • max bot messages search busca palabras, mejores coincidencias primero, en lugar de fragmentos por fecha. --newest restaura el orden anterior. Requiere todas las palabras; admite "фраза", -слово, а OR б y from:, chat:, after:, before:, has:. Corrige erratas y lo avisa por stderr. Puedes escribir palabras sin comillas; --from sigue siendo repetible. No admite in:: solo busca en su copia y las autorizadas por readOtherBots.

Correcciones

  • Los rechazos del bot indican un comando válido con --bot. Para solo lectura propone desactivar readOnly; si falta un permiso en allow, propone añadirlo conservando los existentes. Antes indicaba el inexistente bot config.

0.22.0 — 02.10.2026

La mayoría de comandos personales se comparten con tg: opciones, resultados --json y base local comunes. Hay muchos cambios de nombres, indicados abajo. No se migra la caché anterior; tras actualizar, ejecuta sin --offline y descarga historiales con max store fetch.

Novedades

  • max conversations search "<запрос>" encuentra conversaciones por significado en uno o todos los chats. Descarga una vez max models text download e5-small (135 MB, compartido con tg) y calcula vectores con max conversations embed --chat <чат>. embed status indica pendientes; embed clear elimina vectores. Con --provider openai y tu clave (max models text key set openai) usa un servicio externo; embed indica tokens y precio y solicita aprobación.
  • chats list --json incluye providerMetadata.partnerId en chats individuales, identificando a la otra persona. Permite resolverla porque MAX diferencia identificadores de chat y persona.
  • max messages search incluye otras cuentas de la base: in:max, in:personal, in:bots, in:all o --source. Sin esas opciones sigue buscando en la cuenta activa.
  • max conversations build|list|show y max messages links identifican conversaciones por respuestas, menciones y turnos, localmente sin consultar MAX. conversations batches status|next y conversations links add|clear proporcionan lotes al agente y reciben sus respuestas.
  • max server logs, max server install, max server uninstall, como tg. install escribe un servicio systemd en Linux o launchd en macOS, sin iniciarlo; max server start y stop lo usan después. Si MAX rechaza el acceso, no lo reinicia, evitando nuevos accesos repetidos. Se conservan max server start --idle y restart --idle.
  • max store status indica cantidades y tramos completos por chat. store fetch --background y store jobs list|show|cancel gestionan descargas en segundo plano. store info|check|migrate|backup|restore|reindex mantienen la base. store clear --left --allow-dangerous elimina chats abandonados y mensajes.
  • max bot auth, max bot list, max bot chats list, max bot recipients y max bot sends list se comparten con tg, con iguales respuestas y ayuda. Token, destinatarios y registro conservan ubicación.
  • max cache clear --left elimina solo chats abandonados y mensajes de la caché del perfil, sin tocar el resto.
  • max messages search --regex — una expresión regular sobre todo el texto guardado. messages show|context msg:… — un mensaje mediante el enlace de search, sin un ID aparte.
  • max polls show <чат> <сообщение> consulta encuesta, identificadores y votos sin cambiar nada.
  • max polls create --send-id reintenta crear una encuesta sin duplicarla tras una respuesta perdida.
  • max messages send --photo <путь> — envía .jpg .png .webp como foto, igual que en tg. --no-preview también está en send, pero MAX no lo admite y el comando rechaza la operación.
  • max skill install instala la habilidad para agentes con un comando: en ~/.claude/skills/max-cli/ para Claude Code y en ~/.agents/skills/max-cli/ para Codex y Gemini CLI, con el número de versión de max. --for claude o --for agents instala solo en una carpeta. max skill show imprime lo mismo que antes.
  • El agente descubre la habilidad automáticamente. Si está definida AI_AGENT o CLAUDECODE y la habilidad falta o es más antigua que max, aparece en stderr una línea sobre max skill install una vez al día. No se añade nada a stdout. Desactívalo con max config set skillHint false --defaults.
  • max mcp y max bot mcp ofrecen max://skill y lo mencionan en instrucciones al agente.
  • max messages delete devuelve operationId, también en max sends list. Igual con max_messages_delete; opciones sin cambios.
  • Cada registro tiene operationId, común a filas de un envío, edición, eliminación o cambio de chat, para ver su resultado. En envíos equivale a sendId.
  • La instalación ocupa unos 16 MB menos: la capa de base de datos ahora está incluida en el paquete, en lugar de instalarse por separado. Los comandos de max no cambian.

Cambios que pueden romper scripts

  • max messages search busca palabras, mejores resultados primero. --newest recupera orden reciente. Admite "фраза", -слово, OR, from:, chat:, after:/before: y has:. Corrige erratas y lo avisa. --context <n> muestra contexto. JSON añade match y score.

  • max bot updates watch ahora es max bot watch, como en tg y el max watch personal. Sin --events, solo se imprimen mensajes nuevos; con --events, se imprime todo y cada línea identifica su evento ({ "event": "message" | "edit" | "delete" | "callback" | "joined" | … }) en lugar del evento sin procesar de MAX. --timeout lo termina normalmente con el código 0. Los perfiles de bot de solo lectura ahora pueden usar watch: recibir eventos es leer. Se mantiene el marcador desde el que continuar.

  • bot webhooks list devuelve { url, types }, no campos propios de MAX. bot callbacks answer --text deja de leer stdin mediante -. bot commands, bot callbacks y bot webhooks se comparten con tg; webhooks set --secret-stdin solo pregunta tras comprobar permisos.

  • Node 22.16 o posterior, o Bun. Si Node en Linux usa SQLite del sistema antiguo, max reinicia con @wirecat/cli-messaging-sqlite antes de leer o enviar. Node oficial y Bun no requieren cambios.

  • max store se comparte con tg. store fetch guarda en la base común y pagina MAX como antes: 30 mensajes, pausas de 5–10 segundos y hasta 40 páginas por ejecución. Así messages, conversations y store leen lo mismo. No se migra la caché; vuelve a descargar. Además:

    • Rechaza store fetch --estimate: los identificadores de MAX no permiten contar lo pendiente.
    • store fetch|export --since pasa a --since-time, solo fechas, no identificadores.
    • store fetch --max-pages <n> pasa a --limit <сообщений>, predeterminado 1200, cuarenta páginas de 30. Tamaño mediante --page-size.
    • store export --format md pasa a --format markdown; jsonl no cambia. Los huecos se consultan en store status, no en stderr de exportación. No sobrescribe archivos.
    • store fetch deja de imprimir el comando de exportación.
    • si dos mensajes se enviaron en el mismo milisegundo y el límite de página quedó entre ellos, store fetch puede omitir el más antiguo. Es poco frecuente.
  • max messages list|show|context|search son comandos compartidos por tg y max. --offline y search leen la copia local compartida, la misma que usa tg. Por qué: las mismas opciones y respuestas que tg, y una copia para leer. Ten en cuenta: las herramientas de lectura de mensajes y chats de max mcp aún leen la antigua copia de max, de modo que un agente mediante MCP y un comando del terminal con --offline pueden responder de forma distinta. La copia empieza a llenarse con la primera ejecución sin --offline tras actualizar; la antigua copia de max no se migra, ni tampoco las transcripciones de mensajes de voz escuchados antes de actualizar. Además:

    • Voz como "kind": "voice", no "audio"; inbox y review aún usan "audio" en esta versión.
    • messages list --before y --after se dividen en --before-id, --before-time, --after-id, --after-time; messages context, --before-n, --after-n. Nombres antiguos producen errores.
    • messages list --before-id excluye ese mismo mensaje; con --offline, solo sirve --before-id, y únicamente con el ID de un mensaje de la copia local;
    • messages list --transcribe --json ya no devuelve el campo transcribeProblem: el motivo aparece en stderr; con --offline, unheard está vacío. El mensaje de voz se descarga en una conexión independiente; con --no-serve, supone un segundo inicio de sesión en MAX;
    • max busca los modelos de voz en ~/.cache/cli-common/models/audio, la misma carpeta que tg; los descargados en ~/.cache/max-cli/models/audio deben descargarse de nuevo o trasladarse;
    • messages search busca palabras y prefijos (квартир encuentra «квартира»), no tres letras cualesquiera. --chat acepta títulos guardados.
  • max chats list|show y max contacts list|show son comandos compartidos por tg y max. Su --offline lee la copia local compartida, la misma que usa tg. Por qué: las mismas opciones y respuestas que tg. Ten en cuenta: la copia empieza a llenarse con la primera ejecución sin --offline tras actualizar; la antigua copia de max no se migra y, hasta entonces, --offline devuelve not_found. Además:

    • chats list --search|--kind|--unread sin --offline busca en los 200 chats más recientes y avisa en stderr si había chats anteriores; con --offline, busca en todos los guardados;
    • chats show --offline no incluye description, access ni settings, conocidos solo por MAX.
    • --kind incorrecto devuelve --kind is one of dialog, group, channel, saved.
    • cache clear también elimina esta cuenta de la base compartida; contacts sync recupera todo allí.
  • max messages send|edit|forward son comandos compartidos por tg y max. Respuestas --json: send devuelve {sendId, operationId, message} (con scheduledFor si se usa --at-time); forward también devuelve {sendId, operationId, message}; edit devuelve {operationId, message}, en lugar del mensaje sin envoltorio. Las herramientas MCP max_messages_send, max_messages_edit y max_messages_forward responden igual; max_messages_edit ya no tiene markdown, y max_messages_forward ya no tiene send_id. Por qué: las mismas opciones y respuestas que tg, con un ID de acción como en el registro de envíos. Ten en cuenta: un script que leía el mensaje de la raíz de la respuesta ahora debe leer message. send ya no permite varios --file en un mensaje: un adjunto de --file y uno de --photo. Si un envío con --at-time no recibe respuesta, el error recomienda messages scheduled sin nombrar el chat.

  • max polls se comparte con tg. polls vote|close --json devuelve {operationId, poll}, donde poll contiene {chatId, messageId, question, answers: [{id, text, voters, chosen}], closed, multiple, anonymous, voters}; polls create, {sendId, operationId, message}. Igual con max_polls_vote, max_polls_close, max_polls_create. max_polls_create cambia revote por silent.

  • Las respuestas --json de reacciones, fijación y marcado como leído se comparten con tg, y cada una incluye operationId, el ID de esa acción como en el registro de envíos:

    • reactions add|remove: {operationId, chatId, messageId, reaction}, reacción propia o null, sin cantidades (están en messages list).
    • messages pin|unpin: {operationId, chatId, messageId, pinned}, con pinned como true o false.
    • chats mark-read: {operationId, chatId, until}, con null para el más reciente.

    Igual en max_reactions_add, max_reactions_remove, max_messages_pin, max_messages_unpin, max_chats_mark_read.

  • max messages unpin <чат> <сообщение> ahora exige un número de mensaje, como pin y tg. MAX tiene un mensaje fijado por chat, y se desfija ese mensaje sea cual sea el número indicado. La herramienta MCP max_messages_unpin también exige message. Ten en cuenta: messages unpin <чат> sin número da error; añade cualquier número de mensaje de ese chat.

  • Desaparecen max serve --detach y max serve --stop: utiliza max server start y max server stop. serve trabaja en primer plano; max server gestiona el segundo. Actualiza scripts y servicios manuales.

  • max server status --json usa el formato tg: byHand pasa a by: hand, manual; command, iniciado por comando; server, por max server start; unit, servicio. Añade log, unit y stale si quedó una marca de un servidor caído. max server start, stop y restart devuelven { started, by, pid, startedAt, log } y { stopped, by, pid }, sin socket.

  • max messages send --at pasa a --at-time; el nombre anterior --at produce error; reemplázalo por --at-time. at de max_messages_send en MCP no cambia.

  • Se elimina --markdown; usa --md en messages send, messages edit y donde se lea formato. Ese es el nombre en todos los comandos tg y max; un script con --markdown da un error de «opción desconocida»: sustitúyelo por --md.

  • max sends list --json cambia cid por sendId, cadena en lugar de número, como outcome_unknown y --send-id. También muestra así registros antiguos.

  • Los registros de ejecuciones (--trace, --record, max runs show) usan un formato compartido por tg y max. El ID de envío de un evento se llama send, en lugar de cid; el campo de error de MAX es providerError, en lugar de maxError, en los eventos, run.json y details de los errores --json.

  • max bot devuelve outcome_unknown, código 14, en escrituras con respuestas 502, 503 o 504, antes provider_unavailable, código 12. El intermediario no demuestra si MAX ejecutó la petición. Reintentar 12 podía duplicar; con 14, comprueba primero. Las lecturas siguen reintentándose y devuelven provider_unavailable.

  • Los comandos de bot adoptan nombres tg sin alias. max bot messages get <сообщение> pasa a messages show <чат> <сообщение>; messages edit|delete también reciben chat primero. bot chats get pasa a chats show; bot chats pin|unpin, a messages pin|unpin <чат> <сообщение>. --format markdown|html pasa a --md o --html; desaparece --type: usa --photo, --voice o --as-file para vídeos como archivo. chats action acepta typing, photo, video, voice, file. Enviar y editar devuelve { operationId, message }. Eliminar pregunta; --allow-dangerous aprueba. MCP: max_bot_chats_show, max_bot_messages_show, max_bot_messages_pin, max_bot_messages_unpin.

  • max bot members y max bot admins ahora son max bot chats members y max bot chats admins, como en tg. admins add acepta --can con los valores de max chats admins add (read, members, admins, info, pin, link, edit, delete) en lugar de --permissions, y --title en lugar de --alias. --can no incluye permisos de «llamadas» ni «estadísticas». admins list devuelve { id, name, username, role, rights, title }. Herramientas MCP: max_bot_chats_members_list|add|remove, max_bot_chats_admins_list.

  • Los cambios locales se clasifican como escrituras. config set y unset, chats rules set y unset, recipients add, remove, clear, y auth set, remove, chats rules set, unset, recipients add, remove, clear del bot modifican configuración, reglas, destinatarios o almacén, no MAX. La referencia indica que solo cambia el equipo; max commands lo muestra en writes. Los filtros de solo lectura mediante max commands --json ahora los excluyen.

Correcciones

  • max store fetch por fecha ya no omite mensajes en límites de página y se detiene si MAX repite páginas.
  • max messages list --before-time excluye mensajes del mismo milisegundo: «antes» es estrictamente anterior.
  • max messages list --after-id (0.21.0: --after <id>) indica si hay página siguiente, en lugar de negar siempre al avanzar.
  • max messages send --voice funciona mediante max serve. Antes perdía la forma de onda y MAX rechazaba con proto.payload, código 11. Con --no-serve ya funcionaba.
  • max chats list y max chats show eliminan chats abandonados al recibir una lista completa en el siguiente acceso. Antes permanecían con cantidades obsoletas. Sus mensajes quedan hasta max cache clear --left; max serve detecta la salida en el siguiente acceso completo.
  • max serve no confunde respuestas tras uso prolongado. Los números de dos bytes reinician tras 65 536 peticiones; ahora se omiten los que aún esperan respuesta.

0.21.0 — 30.09.2026

Cambios que pueden romper scripts

Los comandos siguen una misma regla: primero el objeto y después la acción. Los nombres antiguos ya no funcionan: max devuelve «unknown command» o «unknown option» con el código 1 y no hace nada.

  • max backup messages pasa a max store fetch. Descarga inmediatamente; --estimate solo calcula (antes requería --run). Conserva máximo --max-pages de 40 páginas y pausas. --pause exige duración (5s, 500ms), no número sin unidad. --since y --last son opcionales; sucesivas ejecuciones llegan al inicio, reanudando.
  • max export messages → max store export.
  • --cid pasa a --send-id en messages send y messages forward. outcome_unknown usa sendId; max_messages_send y max_messages_forward cambian cid por send_id.
  • max chats read pasa a max chats mark-read; max_chats_read, a max_chats_mark_read.
  • Se elimina max chats settings. max chats show muestra los ajustes del grupo (campos settings, description, access; el enlace de invitación sigue en max chats link show), y max chats update <чат> --all-can-pin on|off y las demás opciones de ajustes los modifican.
  • max update → max upgrade, y el aviso de nueva versión indica max upgrade.
  • max recipients off pasa a max recipients clear, respuesta off a cleared; max bot recipients off, a max bot recipients clear.
  • max account sessions end-others pasa a max account sessions end --others; sin --others rechaza.

Novedades

  • max complete aparece en max --help, para encontrar cómo activar Tab.
  • Acceso desde navegador: ChatGPT o Claude, con proxy de contraseña y dirección pública Tailscale sin dominio propio. Basado en documentación, sin prueba completa.

0.20.0 — 30.09.2026

Cambios que pueden romper scripts

  • El almacén compartido de mensajes pasa a la versión 6 (cli-messaging 0.49.0). La primera ejecución de max actualiza messages.db; después, las versiones de tg anteriores a la publicada ese día rechazan abrir el archivo y piden actualizar: npm install -g @wirecat/tg-cli@latest. Los comandos de max no cambian.
  • --all-bots necesita autorización para leer otros bots. Define readOtherBots en bot: max <имя> config set --bot readOtherBots true o lista de perfiles. Sin ella, código 5 y comando para permitirlo.
  • Cuando un nombre coincide con varias personas, los candidatos se ordenan por nombre, con las personas sin nombre primero; antes seguían el orden de la caché. El texto del error no cambia.

Novedades

  • --bots news,support en bot messages search, bot people show, bot messages between consulta solo esos perfiles autorizados por readOtherBots. bot messages search también admite --all-bots.
  • bot mcp ofrece all_bots y bots en esas tres herramientas solo si se autorizan lecturas entre bots.
  • Cada bot conserva sus personas. Las vistas por uno no aparecen en otro sin --all-bots o --bots.
  • La búsqueda del bot encuentra fragmentos de tres letras (вартир encuentra «квартиру»), igual que la búsqueda personal en esta versión.

0.19.0 — 28.09.2026

Cambios que pueden romper scripts

  • Un agente mediante max mcp cierra una encuesta solo si el perfil permite edit. Antes bastaba con reaction. Por qué: cerrar modifica el mensaje de la encuesta, y max polls close siempre exigía edit; el agente y una persona tenían permisos distintos para la misma acción. Ten en cuenta: si allow del perfil incluye reaction pero no edit, el agente ya no ve max_polls_close; añade edit para que pueda cerrar encuestas. Si no se define allow, no cambia nada. Consulta docs/mcp.md.

Correcciones

  • max mcp --confirm-send arranca cuando los cambios de cuenta se habilitan solo con mcpTools. Antes, la opción exigía también una de las opciones --allow-*; de lo contrario, el servidor no arrancaba. Por qué importa: por este motivo, un servidor con solo mcpTools funcionaba sin formulario de confirmación; el agente podía añadir y eliminar contactos, crear grupos y cambiar el perfil sin preguntarte. Ten en cuenta: sin --confirm-send, todo sigue igual. Añade la opción al comando de inicio del servidor para ver un formulario antes de cada cambio.
  • max <бот> bot messages search --limit N indica más resultados. Antes siempre devolvía hasMore: false y limit de configuración en lugar de N, deteniendo scripts y agentes que comprueban hasMore antes de tiempo. Ahora devuelve hasMore: true si supera N.

0.18.1 — 28.09.2026

Correcciones

  • max contacts rename se refleja inmediatamente en contacts show y título del chat. Antes esperaba hasta que max serve iniciara sesión porque no aplicaba el contacto devuelto. Si sigue obsoleto, el primer comando 0.18.1 sustituye el servidor anterior.

0.18.0 — 28.09.2026

Novedades

  • Herramientas de cuenta en max mcp: añadir, eliminar, renombrar y bloquear contactos; cerrar tu encuesta; entrar, salir y crear grupos; gestionar administradores; cambiar nombre y descripción. Antes solo leía y enviaba mensajes. Solo tú las habilitas mediante mcpTools, por ejemplo max config set mcpTools contacts,polls; no mediante opciones del agente. Todas pasan por readOnly, allow y registro. Consulta MCP.
  • Las subidas del bot aparecen en --trace y registros. bot messages send --file y bot uploads put muestran tipo, tamaño, estado HTTP y duración en dos líneas. Nunca muestran ni guardan dirección o nombre del archivo.

Correcciones

  • max contacts rename ahora cambia el nombre. Antes, MAX indicaba éxito, pero el nombre seguía igual. Por qué: sin el campo lastName, MAX no modifica nada y no avisa. Ahora siempre se envía lastName (null si no hay apellido), igual que en el cliente web. Ten en cuenta: los nombres «cambiados» con 0.17.x en realidad no cambiaron; vuelve a renombrarlos.

0.17.1 — 28.09.2026

Correcciones

  • Los errores de --limit, --last y --max-pages repiten el valor introducido. Afecta a messages list, inbox, backup, sends list y comandos del bot. Antes, --limit abc aparecía como NaN; en 0.17.0 solo se corrigieron las listas paginadas.
  • runs list y sends list truncadas por --limit indican hasMore: true. Antes devolvían hasMore: false y un limit distinto al solicitado. Los scripts que seguían hasMore podían detenerse en la primera página.
  • Los contactos renombrados usan el nombre que les has dado, como MAX. Antes max mostraba el nombre propio aunque lo cambiaras mediante contacts rename o en la aplicación.

0.17.0 — 28.09.2026

Cambios que pueden romper scripts

  • Todas las listas con --json son objetos {items, page, limit, hasMore}, no arrays. Incluye account sessions list, chats members list, chats folders list, messages scheduled, messages download, messages context, models audio list, recipients list, sends list, runs list, chats check, chats events y listas del bot. Antes algunas eran arrays y chats events devolvía {events, more}. Motivo: había tres formatos distintos que los scripts y agentes debían recordar. Ten en cuenta: lee .items en vez del array. Sin paginación, page es 1 y limit el número de filas. bot members list y bot admins list añaden marker; user_id es una cadena. bot messages get devuelve el mensaje, no un array de uno. --jsonl y las tablas no cambian. MCP usa el mismo formato.

Novedades

  • max doctor y max config show reconocen los bots. La lista incluye todos los perfiles de este ordenador, marcados como cuenta personal, bot o ambos. Antes no aparecían los perfiles de bot. doctor muestra el origen del token del bot (sin el token), cuántos chats ha visto el bot y dónde están los archivos del perfil; doctor --online pregunta a Bot API a quién pertenece el token. Ten en cuenta: para perfiles de bot, doctor y los comandos personales ya no recomiendan session start; indican el comando adecuado max <имя> bot ….
  • Herramientas MCP max_status y max_bot_status. Indican el perfil, la existencia de token y herramientas de escritura activas. No envían nada; max_status ni inicia sesión.
  • El autocompletado con Tab reconoce los bots. Para los comandos de bot, sugiere los chats que ha visto el bot en lugar de los de la cuenta personal; para la primera palabra, sugiere todos los perfiles, incluidos los de bot.
  • Los comandos del bot tienen registros como los personales. max <имя> bot … --trace muestra peticiones Bot API en stderr: operación, chat/mensaje, estado HTTP y duración. --record guarda ejecuciones; los fallos se guardan solos con sus peticiones. Consulta max runs list, max runs show. Las cargas --file aún no se registraban; se añadieron en 0.18.0.
  • Ajustes separados para cuentas y bots. Secciones personal y bot, con defaults y profiles propias. max config set --personal|--bot escribe la sección; max config show --bot indica la clave de origen, como config file: bot.profiles.test. Motivo: necesitan reglas diferentes. Prioridad: perfil de sección, perfil general, sección, defaults generales. Los archivos antiguos siguen funcionando. Consulta Configuración.
  • Límite por hora para bots. max <имя> config set --bot sendsPerHour 200 lo define. Por defecto sigue sin límite.
  • max config set defaultProfile <имя> selecciona el perfil cuando la primera palabra no lo indica; antes siempre default.
  • Foto, nombres propios y bloqueo. max account update --photo <файл> cambia la foto. max contacts rename <кто> <имя> [фамилия] cambia el nombre solo para ti. max contacts block <кто> y unblock bloquean incluso a quien no está en contactos. Aplican los controles de account update y contacts add. contacts rename aún no cambiaba realmente el nombre; corregido en 0.18.0.
  • Canales. max chats create <название> --channel crea un canal privado. Invita mediante max chats link show: MAX puede rechazar añadir personas directamente.
  • Permisos de lectura y enlace. max chats admins add <чат> <кто> --can read,link permite leer la historia y cambiar la invitación. Un bot administrador sin read no ve mensajes del grupo.
  • Tiempos relativos. --since, --before, --after admiten 30m, 2h, 1d: max review --since 1d. Antes exigían tiempos exactos.

Correcciones

  • Los cambios propios de chats se ven inmediatamente. Tras max chats update, chats settings, chats link reset, chats show y chats list mostraban el nombre antiguo durante minutos. MAX no devuelve el cambio como evento; ahora max serve aplica el chat de la respuesta, como los mensajes enviados.
  • max export messages ya no avisa de un hueco hasta 1970-01-01 tras un backup completo. Antes seguía indicando que faltaba el inicio.
  • Los errores de --limit y --page repiten lo que escribiste. Antes, un error para --limit abc identificaba el valor introducido como NaN.
  • Una invitación revocada en chats inspect o chats join da not_found, código 6, en vez de un rechazo MAX con número de operación. Los scripts deben esperar 6.
  • max config show y max doctor no inventan <имя>.moderation como perfil. Antes confundían el archivo de reglas con uno.
  • Errores de subcomando nombran la palabra desconocida, no el perfil. max work bot auth status culpaba a work en lugar de status.
  • max config show incluye transcribeModel, antes ausente.

Eliminaciones

  • Solicitudes de ingreso: max chats requests list|accept|decline, regla requests, niveles consent.accept y consent.decline. MAX permite grupos abiertos o mediante invitación, sin aprobación de solicitudes; los comandos prometían algo inexistente. Los archivos antiguos siguen leyéndose y pierden esas claves al escribirse. Los scripts con chats requests reciben «comando inexistente».

0.16.0 — 27.09.2026

Novedades

  • Personas e historial del bot. max <имя> bot people show <кто> muestra dónde escribió y su chat privado. bot messages search --from <кто> encuentra uno o varios autores; bot messages between <кто> <кто> muestra sus mensajes en chats comunes. Solo usa lo visto en el equipo; --all-bots incluye todas las copias.
  • Moderación del bot por reglas. max <имя> bot chats check <чат> comprueba lo nuevo según bot chats rules show|set|unset, borrando mensajes o expulsando personas. Ingresos mediante bot updates watch. Sin --no-ban, quien es expulsado no vuelve por enlace; Bot API no puede deshacerlo. Tampoco conoce la antigüedad de cuentas.
  • Encuestas. max messages list muestra la encuesta en texto: pregunta, opciones con ID en [скобках], votos y ✓ junto a tu opción. max polls vote <чат> <сообщение> <вариант>… vota, --retract retira el voto, max polls close cierra tu propia encuesta y max polls create crea una. MCP ofrece max_polls_vote y max_polls_create, solo con --allow-send. Ten en cuenta: max rechaza lo que rechazaría el cliente web — encuestas cerradas, opciones de más o un segundo voto sin derecho a cambiarlo — sin enviar nada. web.max.ru no muestra encuestas y polls create lo recuerda.
  • max <имя> bot mcp para agentes. Solo lectura por defecto; escritura con --allow-send, --allow-delete, --allow-moderate, --confirm-send. Ejecuta los mismos comandos con destinatarios y registro. Acciones que requieren consentimiento se muestran en un formulario. Consulta MCP del bot.

Cambios que pueden romper scripts

  • El parámetro timeout de max bot api get-updates ahora se indica con --poll-timeout. Antes, --timeout de esta operación no llegaba a MAX: --timeout es el plazo total del comando. Ten en cuenta: los scripts que pasaban --timeout para consultas de larga espera deben usar --poll-timeout.

Correcciones

  • La primera orden de una versión nueva sustituye al max serve antiguo. Antes seguía rechazando operaciones nuevas, como votos, hasta max server stop.
  • También se sustituye una compilación distinta con igual versión. Un servidor iniciado a mano rechaza operaciones desconocidas sugiriendo max server stop.
  • max bot api get-updates --limit … funciona. Antes, --limit de la operación se confundía con un ajuste de max y el comando rechazaba la operación.

0.15.0 — 27.09.2026

Novedades

  • max chats check <чат> modera por reglas. Lee mensajes y participantes nuevos desde la última revisión, aplica max chats rules y avisa, borra o expulsa. Por defecto solo informa; --dry-run planifica; máximo 10 acciones. Los cambios pasan los controles habituales. Las solicitudes solo estaban previstas aquí y se eliminaron en 0.17.0 porque MAX no las tiene. Consulta Grupos.
  • Moderación mediante agente. max mcp --allow-moderate ofrece max_chats_check; siempre se ofrecen los lectores max_chats_events, max_chats_members, max_chats_rules. Sin el indicador no hay herramienta de actuación. Los cambios pendientes de consentimiento se muestran juntos en un formulario.
  • Roles e invitaciones. max chats members list indica owner, admin, member. max chats link show <чат> muestra la invitación.
  • Vídeos y voz personales. max messages send <чат> --file ролик.mp4 reproduce vídeo en el chat (.mp4 .mov .webm .mkv); max messages send <чат> --voice заметка.ogg envía voz con onda y duración. Antes el vídeo era archivo; --as-file conserva ese comportamiento. Voz solo Ogg Opus; otro audio sugiere ffmpeg. Consulta Uso.
  • Los mensajes de voz aparecen como texto en la lista. max messages list <чат> --transcribe y max inbox --transcribe transcriben los mensajes de voz mostrados en este ordenador; el texto aparece bajo el mensaje con el icono 🎤 y, en --json, en transcript. MCP utiliza transcribe: true en max_messages_list y max_inbox. Ten en cuenta: los mensajes ya transcritos muestran el texto incluso sin la opción. La transcripción requiere un modelo descargado.
  • Más comandos de bot. max <имя> bot messages send --file <путь> adjunta imagen/vídeo/audio/archivo; bot uploads put solo carga. bot members list|add|remove, bot admins list|add|remove, bot comments list|get|send|edit|delete, bot callbacks answer, bot commands list|set|clear, bot webhooks list|set|delete. Consulta Bots. webhooks set rechaza otro destino porque MAX mantendría ambos, en lugar de sustituirlo.
  • Copia local del bot. Lo leído/enviado/recibido se conserva. max <имя> bot messages list <чат> --offline, messages get --offline leen sin red; bot messages search <текст> busca. El borrado propio u observado por updates watch retira el mensaje; la copia contiene texto.
  • max <имя> bot updates watch muestra eventos hasta Ctrl-C, guarda mensajes y reanuda desde la posición anterior. No funciona con webhook; consume los eventos de otros lectores: ejecútalo solo si nadie más necesita el bot.
  • Personas en la copia. max <имя> bot people show <кто> muestra chats y últimos mensajes privados; --refresh relee desde MAX. bot messages search --from <кто> filtra autor; bot messages between <кто> <кто> … compara autores en chats comunes. --all-bots incluye todas las copias. Persona: número, @username o parte del nombre.

Cambios que pueden romper scripts

  • max bot messages list ordena de antiguos a nuevos, como max messages list. Los envíos del bot se marcan propios. Los scripts que tomaban la primera fila como la más reciente deben adaptarse.

Correcciones

  • max review --transcribe cierra MAX antes de reconocer. Primero descarga grabaciones, cierra y ejecuta el modelo.
  • max bot api edit-my-commands, subscribe, unsubscribe, get-upload-url funcionan. Antes fallaban con «an account change without a known action» sin enviar nada.
  • Un destinatario positivo sin user: se identifica como probable persona y sugiere user:<номер>.
  • Los ejemplos de Bots usan identificadores reales, explicando cómo obtenerlos.

0.14.0 — 27.09.2026

Novedades

  • max bot usa el Bot API oficial. max bot auth set valida y guarda el token separado de la cuenta personal. Perfil primero: max рабочий bot me. max bot me muestra el bot; max bot api <operación> ejecuta las 33 operaciones con parámetros y cuerpo JSON, generadas desde la especificación oficial. IDs mayores que 2^53 son cadenas para conservar dígitos; los scripts deben tratarlos así.
  • Comandos prácticos para bots. max <имя> bot messages send <чат> <текст> envía a un chat por número, a una persona como user:<номер> o por el título de un chat que el bot ya ha visto; también hay edit, delete, list y get. max <имя> bot chats list muestra los chats que ha visto el bot; también están chats get|pin|unpin|leave|action. max bot list muestra todos los nombres con un token de bot. Por qué «que ha visto»: MAX no ofrece una lista de chats del bot, por lo que max los recuerda por su cuenta.
  • Destinatarios y registro del bot. max <имя> bot recipients add|list|remove|off, max <имя> bot sends list. Se comprueban todas las escrituras, incluidas bot api. Aún no hay límite por hora; llega en 0.17.0. Consulta Bots.
  • Actividad de grupos. max review --unanswered [часы] encuentra preguntas sin respuesta tuya ni de administradores; max review --chat <чат> revisa un chat. max chats events <чат> muestra ingresos, salidas, altas y expulsiones. max chats members list <чат> lista miembros con registro y última actividad. max chats rules show|set|unset <чат> guarda reglas juntas, como config set.

Correcciones

  • Cuando MAX cierra la conexión, el error indica código y motivo.

0.13.0 — 26.09.2026

Novedades

  • max review revisa obligaciones. Todos los mensajes, también tuyos, desde la última revisión (tres días sin --since). --transcribe reconoce voz. Termina indicando dónde iniciar la siguiente revisión. Si falta lectura, señala resultado incompleto: no lo consideres completo (Uso).
  • max_review y /review en MCP. El agente separa mis obligaciones, esperas y dudas; revisa grupos antes de declarar retrasos y prepara recordatorios. Solo envía con tu aprobación (MCP).
  • max mcp config imprime configuración para Claude Desktop, Cursor y otros. Rutas absolutas para Windows y clientes sin PATH del terminal (Conexión).
  • max doctor comprueba la instalación: qué ejecuta max, dónde está instalado, si un terminal nuevo lo encontrará, si se cargan el llavero y SQLite y si hay un modelo de voz descargado. Ten en cuenta: si la carpeta del comando no está en PATH, doctor imprime un comando para corregirlo: para PowerShell en Windows y export en Linux y macOS. Si no se encuentra el propio max, ejecuta npx @wirecat/max-cli doctor (troubleshooting.md).
  • max doctor --online realiza un inicio, lee un chat y arranca MCP sin enviar.
  • max models audio download prueba el modelo descargado. Si falta, indica idioma y alternativas con tamaños.

Cambios que pueden romper scripts

  • max_messages_attachment pasa a max_messages_photo. Renueva permisos guardados del cliente MCP.
  • No se admite el perfil review, ahora una orden; renombra perfiles existentes.

Seguridad

  • Los informes Windows ocultan el directorio personal con cualquier escritura. Antes el nombre del usuario seguía visible en ciertas rutas.

0.12.0 — 26.09.2026

Novedades

  • Más MCP: max_inbox reúne lo nuevo; respuestas y formato, reacciones, fotos como imagen visible al agente (Herramientas).
  • /catch-up, /reply, /find y chats mediante @ en Claude Code (Comandos).

Correcciones

  • max serve funciona en Windows mediante canal con nombre, no archivo.
  • Sockets demasiado largos en macOS/Linux dan un error claro, no EINVAL; pueden alargarse por perfil o MAX_STATE_DIR.

0.11.0 — 26.09.2026

Novedades

  • max watch --events muestra ediciones, borrados y reacciones con campo event; sin indicador conserva formato (Eventos).
  • Informes mediante incidencias GitHub, no correo. max doctor report create imprime enlace con título y plantilla; se adjunta el informe. Incidencia y archivo son públicos (Problemas).
  • Todos los errores guardan una ejecución, incluso indicadores inválidos, comprobaciones previas y órdenes sin MAX (models, server, watch). Antes solo los que alcanzaban MAX. Solo se guardan palabras de comando, no argumentos ni mensajes (Diagnóstico).
  • max backup messages --run indica ubicación y siguiente paso. Conserva en copia local; max export messages crea archivo. La orden aparece al final y en export.
  • max serve comprueba permisos y registra envíos: lectura, acciones, destinatarios y límite. config set se aplica sin reiniciar. No se inicia con MAX_TOKEN.
  • Tras iniciar sesión, max serve solicita lo mismo que una pestaña de web.max.ru: carpetas, banners, historial de llamadas, conjuntos de stickers y reacciones. También vuelve a iniciar sesión del mismo modo: pasa a MAX la hora del inicio anterior y pide solo los chats modificados, en lugar de toda la lista. Por qué: cuanto menos difiere max del cliente web, menos motivos tiene MAX para detectarlo. Ten en cuenta: todo esto es solo lectura; las respuestas no se muestran ni se guardan. Los comandos puntuales no lo hacen (security.md).
  • El servidor en segundo plano tolera un mensaje entrante de MAX malformado: lo omite, escribe una línea sobre ello y sigue funcionando. Antes, ese mensaje podía detener el servidor.

Cambios que pueden romper scripts

  • Más protección para agentes.

    • max mcp --confirm-send confirma cualquier escritura —edición, reenvío, fijado, lectura y borrado—; aprobación única durante cinco minutos.
    • sendsPerHour incluye ediciones, fijados con aviso y cada persona añadida. Los programados cuentan a la hora de salida. Dos envíos simultáneos ya no superan juntos el límite.
    • Con destinatarios activos, crear grupo o añadir personas exige que el chat privado de cada una esté autorizado.
    • chats members add no muestra historia sin --history; se elimina --hide-history.
    • MAX_PROFILE_LOCK fija el proceso en un perfil.
    • --file rechaza archivos ocultos y propios de max sin --allow-any-file.

    Ten en cuenta: el límite se consume antes. Retira --hide-history de scripts; añade --allow-any-file si debes enviar archivos ocultos.

Correcciones

  • max watch no confunde ediciones/borrados con mensajes nuevos, aunque MAX los envíe con el mismo formato marcado.
  • Un nombre exacto no gana en silencio. Si también forma parte de otro chat, enumera ambos y exige ID: un envío al destinatario equivocado no puede deshacerse.

Seguridad

  • El token de MAX_TOKEN se queda solo ahí. Si MAX emite un token de sesión nuevo, max no lo escribe ni en el llavero ni en un archivo, y avisa en stderr. max doctor indical archivo credentials.json si el token se guarda allí en lugar de en el llavero.
  • max session start oculta el teléfono, como max account show. Ctrl-C al pedir token termina con 130.
  • El servidor en segundo plano no entrega el token a los comandos que le consultan sobre el inicio de sesión: no lo necesitan y consultan el llavero.
  • Límites de red. Tramas MAX descomprimidas hasta 32 MiB; conexión y descargas no esperan indefinidamente. max messages download solo HTTPS, sin equipo local ni red privada, incluso tras redirecciones; máximo 4 GiB, voz para transcripción 32 MiB. Los enlaces provienen de terceros y pueden apuntar a cualquier lugar.
  • Permisos locales. Base y -wal, -shm con 0600, directorio 0700; se corrigen los existentes al abrir. Los informes sustituyen IDs por etiquetas.
  • Texto ajeno en una línea y controles visibles en conversaciones, tablas, candidatos, Markdown y rutas de messages download. Se limpian caracteres de control/dirección en nombres. Solo http, https se convierten en enlaces Markdown.
  • Autocompletado inserta solo números de chat/persona, mostrando nombre aparte: títulos y @имя pertenecen a terceros y no deben ejecutarse en la shell.
  • max cache clear sin perfil limpia el predeterminado y respeta MAX_PROFILE.
  • Los lanzamientos son más estrictos. Las versiones de dependencias se fijan exactamente; el paquete se compila desde cero antes de cada empaquetado, sin utilidades de prueba; publica un paso independiente que no instala ni ejecuta dependencias.

0.10.0 — 25.09.2026

Novedades

  • max doctor report, max doctor report create preparan informes. La primera explica contenido; la segunda crea archivo sin texto y pasos de envío. Aquí por correo; desde 0.11.0 por GitHub (Problemas).
  • max backup messages <чат> --since <дата> | --last <n> descarga más historial del chat a la copia local. Ten en cuenta: sin --run, el comando solo muestra una estimación y no envía nada. Con --run, recorre el historial hacia atrás en páginas de 30 mensajes con pausas, hasta 40 páginas por ejecución, y continúa desde donde quedó al repetirlo (usage.md).
  • max doctor indica la versión web que representa max, avisando si tiene más de 60 días: MAX puede rechazar clientes antiguos (Problemas).
  • max server start|stop|status|restart gestiona el servidor en segundo plano como un componente independiente, como max session. status muestra si funciona, desde cuándo, su versión y si está conectado a MAX; sugiere restart si la versión del servidor es anterior a la de max. max serve --detach y --stop siguen funcionando (usage.md).
  • La lectura del historial envía los mismos cinco campos que el cliente web, y el inicio de sesión pide a MAX 15 chats, como una pestaña de web.max.ru, y después obtiene el resto en una solicitud. Antes, max añadía un campo que el cliente web no envía y pedía 40 chats de una vez. Por qué: cuanto menos difiere max del cliente web, menos motivos tiene MAX para detectarlo. Ten en cuenta: la lista de chats es la misma. Se comprobó en un canal con mensajes sin leer: la lectura sigue sin marcar nada como leído.
  • La descripción del dispositivo se obtiene de tu ordenador: la zona horaria, el idioma del sistema y el sistema operativo son propios de cada instalación, como en el navegador. Antes, todas las instalaciones de max se identificaban como el mismo Chrome en Linux con la zona horaria de Madrid.
  • max serve envía un evento de servicio como una pestaña oculta: lista de chats mostrada, 20 segundos después de entrar. Solo número de cuenta y hora, sin títulos/textos. Las órdenes puntuales no lo envían (Seguridad).
  • max rechaza por sí mismo los títulos de carpeta demasiado largos: como máximo 20 caracteres, el límite que acepta MAX. Antes, la solicitud llegaba a MAX y este la rechazaba.

Cambios que pueden romper scripts

  • Un rechazo por demasiados inicios no provoca nuevos intentos. Código 8 y pausas de 1 minuto, 5, 30, una hora, 6 horas, un día. El servidor se detiene ante cualquier rechazo; antes repetía cada minuto indefinidamente. Scripts reciben 8 hasta acabar la pausa: respeta el plazo del error (Problemas).

Correcciones

  • Un almacén inaccesible no se confunde con falta de sesión. Si ya hubo entrada pero falta token, por ejemplo en cron, max y max doctor señalan las claves, no recomiendan otra sesión que añadiría otro dispositivo (Recetas).
  • Fallos guardados sin --record. Incluyen clave MAX (p. ej. login.token), códigos de aviso, punto del fallo, entorno y SO; sin textos. Servidor: JSON con hora (Diagnóstico).
  • max chats read --until solo marca hasta el mensaje indicado, no hasta ahora ni mensajes más nuevos. Igual para messages list --mark-read. Antes podían aparecer leídos mensajes no vistos.

0.9.0 — 25.09.2026

Novedades

  • max se comunica con MAX como el cliente web: la misma dirección, tramas binarias y compresión que web.max.ru, y la misma descripción de dispositivo con versiones actualizadas de la aplicación y del navegador. Antes, max enviaba tramas de texto en un formato antiguo. Por qué: el formato antiguo era la forma más fácil de distinguir max del cliente web. Además, los mensajes de voz y los vídeos circulares necesitan un campo de bytes que el formato anterior no podía transmitir. Ten en cuenta: los comandos y su salida no cambian. El envío de mensajes de voz queda para versiones posteriores. Por ahora, MAX envía toda la lista de chats en cada inicio de sesión, en lugar de solo los cambios: funciona, pero añade tráfico.
  • Un max serve en segundo plano iniciado por un comando se reinicia automáticamente tras actualizar max. Ten en cuenta: un servidor iniciado manualmente sigue funcionando como antes hasta que lo detengas con max serve --stop y lo vuelvas a iniciar.

0.8.0 — 25.09.2026

Novedades

  • max messages transcribe <чат> <id> reconoce voz localmente. La grabación no sale. max models audio list muestra idiomas; max models audio download <id> descarga y verifica. MCP: max_messages_transcribe (Voz). Descarga única a petición; texto en la copia, sin necesidad de repetir red o modelo.
  • Una conexión por perfil. Comandos, max mcp, max watch comparten max serve, reduciendo inicios con un token y cierres por MAX. max session start detiene, entra y reinicia (Servidor).
  • max serve --detach inicia en segundo plano y responde tras conectar; max serve --stop detiene. Uno iniciado a mano solo se detiene con Ctrl-C/--stop; max session end no lo toca.
  • allow limita acciones. max work config set allow send,reaction permite enviar y reaccionar. Doce nombres de send a sessions. Sin lista todo permitido. Lo prohibido falla con 5 antes de conectar, indicando cómo permitirlo. max mcp oculta herramientas prohibidas (Permisos).
  • max messages send … --at <время> programa. MAX envía aunque el equipo esté apagado; 2026-09-25T09:00 local, 30m, 2h, 1d. max messages scheduled <чат> lista espera; MCP at de max_messages_send, max_messages_scheduled. Cancelación solo en MAX (Programar).
  • max chats read <чат>, max messages list … --mark-read marcan explícitamente. MCP: max mcp --allow-mark-read. El otro ve la marca; lectura ordinaria no la cambia (Lectura).
  • max export messages <чат> --format jsonl|md exporta localmente, con --since, --output, sin MAX. Lo ausente se avisa en stderr; --output crea archivo privado (Exportación).
  • max messages delete <чат> <id…> --allow-dangerous borra hasta 10, solo para ti salvo --for-everyone; MCP max mcp --allow-delete, solo personal. Sin --allow-dangerous falla; cada mensaje consume sendsPerHour (Borrar).

Correcciones

  • Actualizar max conserva la historia. Antes un cambio de estructura borraba todo; ahora migra mensajes. Este lanzamiento también cambia la estructura y conserva historia; chats/personas se renuevan al entrar.
  • Tras rechazo del servidor, los comandos esperan 10 minutos sin crear otro. Antes cada orden reiniciaba intentos rechazados. max session start elimina la espera.
  • max watch ve los envíos propios de max. MAX no los devuelve a la conexión emisora; antes se perdían.
  • Los comandos max simultáneos ya no pierden los datos de inicio de sesión en la copia local. Antes, dos de cada tres comandos simultáneos indicaban «the local record did not take this login» y no guardaban chats, miembros ni el marcador de sincronización. Ahora el segundo espera a que el primero termine de escribir.

Seguridad

  • Los errores no controlan el terminal. Tras mensajes, nombres y tablas en 0.7.0, los errores muestran \x1b visible. Pueden repetir entrada del usuario o respuestas MAX.

0.7.0 — 24.09.2026

Novedades

  • max reactions remove <чат> <id> retira tu reacción.
  • Grupos y canales bajo max chats: inspeccionar invitación, entrar, salir, crear, añadir/expulsar, administrar, renombrar, ajustes y renovar enlace. Las solicitudes se retiraron en 0.17.0 porque MAX no las tiene. Los cambios son visibles y pasan los controles de envío (Grupos).
  • max update actualiza max con el gestor de paquetes con el que se instaló; --check solo indica si existe una versión más reciente. Ten en cuenta: una persona en el terminal ve el aviso de nueva versión una vez al día; los agentes y scripts nunca lo ven. Desactívalo con updateCheck: false en defaults (installation.md).
  • Tab en zsh/bash/fish/PowerShell: source <(max complete zsh), órdenes, indicadores, valores, chats/personas locales sin MAX (Autocompletar).
  • max mcp conecta el perfil por MCP para clientes sin terminal, como Claude Desktop, o mediante MCP en Cursor (MCP). Solo lectura sin --allow-send; envío con controles de max messages send.
  • max mcp --allow-send --confirm-send muestra un formulario antes de cada envío: a qué chat (título e ID) y qué se enviará. Ten en cuenta: sin tu «sí», no se envía nada; un cliente que no pueda mostrar formularios recibe un error (docs/mcp.md).
  • max messages send … --file <путь> envía fotos/archivos, varias fotos en un mensaje.

Seguridad

  • El texto ajeno no controla el terminal. Mensajes, nombres, títulos, archivos o reacciones podían borrar líneas y sobrescribir salida de max. Ahora controles como \x1b se muestran visibles en conversaciones, tablas, errores y Tab. JSON no cambia: ya los escapaba.

0.6.0 — 24.09.2026

Novedades

  • max commands --json describe órdenes, argumentos, indicadores y códigos en una respuesta, cambios MAX con mutates: true. Evita pedir --help por comando. Funciona sin sesión incluso con ajustes rotos.
  • max messages send … --reply-to <id> responde.
  • max messages send … --markdown o --md da formato: **жирный**, _курсив_, ~~зачёркнутый~~, `код`. Sin indicador, literal.
  • max reactions add <чат> <id> <эмодзи> sustituye tu reacción.
  • Reacciones en lectura: messages list, show, context muestran 👍 3 🔥 1 (you: 🔥), JSON reactions. Una petición adicional por página, solo lectura. --offline no tiene reacciones (null) porque no se guardan.
  • Registro y destinatarios. Cada intento sin texto en max sends list. Lista opcional max recipients add|remove|list|off; destinatario no autorizado código 7, perfil readOnly código 5. Alcance: Seguridad.
  • max session start qr | qr-chrome | sms | token permite entrar sin copiar token. qr dibuja en terminal o abre navegador si es estrecho. qr-chrome, sms abren web.max.ru en ventana aparte de Chrome/Chromium/Edge/Brave. Sin método sigue token manual o stdin.

Cambios que pueden romper scripts

  • El envío tiene un límite por hora: 30 mensajes por defecto (sendsPerHour). Por encima del límite, max messages send rechaza la operación con el código 8. Antes no había límite. Ten en cuenta: un script que envíe más debe aumentar sendsPerHour en los ajustes.

0.5.0 — 24.09.2026

Novedades

  • max messages download <чат> <id> [--output <каталог>] guarda foto, archivos, vídeo/audio sin sobrescribir.
  • max config set <настройка> <значение>, max config unset <настройка> editan ajustes, --defaults para todos; nueva sección defaults para perfiles sin valor propio.
  • max chats list --unread filtra no leídos.
  • max messages list <чат> --after <id|время> lee hacia delante, después de mensaje/tiempo; próxima página con --after <id самого нового>.
  • max chats show <чат> y max contacts show <человек> muestran chat con miembros o persona por ID/@username/nombre y chats comunes. Nombres ambiguos enumeran candidatos, no se adivinan.
  • Todo lo nuevo aquí solo lee, sin enviar ni marcar.

Correcciones

  • --offline funciona. Antes, la opción no llegaba a ningún comando: la lectura seguía contactando con MAX, y max --offline messages send enviaba un mensaje. Ahora la lectura utiliza los datos guardados, mientras que el envío y la descarga se rechazan con --offline. Ten en cuenta: si ejecutaste --offline messages send en 0.4.0 o antes, el mensaje se envió.
  • Los errores del archivo de ajustes se explican con claridad: qué ajuste es desconocido, cuáles existen y qué valores se aceptan. Antes eran mensajes de la biblioteca de validación.
  • Un fallo de --record no derriba la orden. Aviso stderr, respuesta/código sin cambios; visible incluso con --quiet.

Seguridad

  • Publicación desde GitHub Actions con procedencia npm, para verificar el repositorio de compilación.

0.4.0 — 23.09.2026

Novedades

  • max messages show <чат> <id> muestra uno; max messages context <чат> <id> con --before, --after muestra contexto. Marcado ◀ y "anchor": true. Si falta, «no encontrado», no el vecino.
  • max skill show imprime instrucciones incluidas: max skill show > ~/.claude/skills/max-cli/SKILL.md.
  • max config show explica perfil/origen, archivo/existencia, todos los perfiles incluso solo de estado, ajustes y fuente (indicador, variable, archivo, integrado). MAX_CONFIG_DIR y similares avisan de entrada de claves distinta.
  • Texto mediante pipe: echo "текст" | max messages send <чат>, sin argumento lee stdin. Evita ps/historial y permite saltos de línea.
  • --timeout <срок> limita toda la ejecución, conexión, entrada y solicitud, no una respuesta.
  • max doctor revisa dependencias sin MAX: fuente del token sin revelarlo, número/último inicio, perfiles, estructura de base y entrada de claves. Funciona con todo roto; falta de sesión es dato, no error.

Cambios que pueden romper scripts

  • La opción --query de las listas pasa a llamarse --search. El cambio ya se incluyó en 0.3.0, pero faltaba en sus notas. Ten en cuenta: un script con --query da error; sustitúyelo por --search.

Correcciones

  • messages list --before <id> no requiere lectura previa, obtiene tiempo del ID.
  • Miembros con nombres, no números. Antes solo contactos tenían nombre; ahora una petición obtiene y guarda todos, incluidos autores de respuestas/reenvíos.
  • La publicación no se detiene antes de crear el tag. Ocurrió dos veces; ahora verifica npm sin caché y espera hasta tres minutos.

0.3.0 — 22.09.2026

Novedades

  • Conversaciones como transcripción: divisores diarios, время автор, texto alineado y ajustado al terminal. вы eres tú; sin nombre aparece ID. ↳ responde, ↪ reenvía; MAX entrega originales completos y se guardan.
  • -v, -vv añaden detalle: IDs de mensaje/autor/chat y URLs; después todo lo conocido.
  • --jsonl da objeto JSON por línea, para streaming y jq.
  • Adjuntos como enlaces: 📎 photo, 📎 photo ×3 1 2 3, 📎 файл.pdf · 24 MB; JSON url, width, height, title. El enlace de foto no requiere sesión: quien lo recibe puede verla.
  • senderColors: true da color por autor, desactivado por defecto.

Cambios que pueden romper scripts

  • -v ahora indica el detalle de la salida; la versión se consulta con max -V. --trace activa las líneas de solicitudes en stderr; antes se llamaba --verbose. Ten en cuenta: los scripts que usaban max -v para la versión o --verbose para las trazas deben pasar a -V y --trace.
  • --query pasa a --search, inicialmente no anotado.
  • La copia local pasa al esquema 4 y se reconstruye en la primera ejecución. Ten en cuenta: en esta versión no se conserva el historial leído; tendrás que leerlo de nuevo.

Correcciones

  • Nombres ambiguos enumeran candidatos con ID, JSON candidates.
  • El aviso local indica estructura y solución, antes solo Error.
  • Continuación de messages list sugiere --before <id>, no el inexistente --page.

0.2.0 — 22.09.2026

Novedades

  • max messages send --silent envía sin aviso. Aún no se comprobó el comportamiento real porque exigiría escribir a una persona.
  • Intercambio del token al primer inicio. MAX devuelve su token; max lo guarda en claves en lugar del pegado. Solo una vez.

Correcciones

  • max session start no destruye el token válido. Antes guardaba antes de validar y una errata lo sustituía; ahora valida y luego guarda.
  • Perfil vinculado al mismo usuario. Token de otra cuenta se rechaza explicando por qué: evita actuar como otra persona.
  • La sugerencia tras envío incierto usa una orden real, no max send.
  • No se descartan mensajes de la respuesta de entrada por estructura mal descrita.

0.1.0 — 21.09.2026

Primera versión que se puede compartir.

Novedades

  • Siete órdenes sobre MAX real: session start|end, account show, chats list, contacts list, messages list, messages send.
  • Perfil primero: max personal chats list. Cuentas independientes con token, estado y copia propios; también MAX_PROFILE.
  • Token en el almacén del sistema, no archivo ni argumento. Aún sin entrada por teléfono: max session start obtiene el del cliente oficial.
  • Modo máquina: --json da un valor en stdout, también automáticamente sin terminal. Error stderr, stdout vacío. Decide por código de salida: Referencia docs/commands.md.
  • Diagnóstico sin contenido: --verbose petición por línea; --record conserva 30 días; max runs list|show|path lee. Por defecto nada registrado.
  • Copia local: lecturas guardadas; --offline sin conexión; max cache clear elimina.
  • ~/.config/max-cli/config.json, prioridad indicador → variable → archivo → integrado. Erratas son errores explícitos.
  • Node 22+ y Bun 1.3+, ambos comprobados en CI.
  • Leer no marca leído. Obtener historia y marcar son operaciones distintas; la segunda nunca se envía, verificado con prueba.
  • Resultado de envío honesto: sin respuesta outcome_unknown (14), sin afirmar fallo/éxito. Repite solo con el mismo --cid para evitar doble envío.
  • Protocolo MAX no oficial por ingeniería inversa, separado de Bot API. Puede cambiar sin aviso; se informa con una línea stderr, no falla en silencio.
  • Aún sin teléfono, adjuntos, reacciones, ediciones, grupos, historias ni llamadas: solo texto. No habrá envíos masivos con la cuenta personal.