diff --git a/app/[lang]/(home)/about/page.tsx b/app/[lang]/(home)/about/page.tsx
index 57b6445..b769785 100644
--- a/app/[lang]/(home)/about/page.tsx
+++ b/app/[lang]/(home)/about/page.tsx
@@ -82,7 +82,7 @@ export default async function AboutPage({ params }: Props) {
                 max · {words.source}
                 <ArrowRight aria-hidden="true" />
               </a>
-              <Link href={`/${lang}/docs/tg/security`}>
+              <Link href={`/${lang}/docs/security`}>
                 {words.security}
                 <ArrowRight aria-hidden="true" />
               </Link>
diff --git a/components/architecture-diagram.tsx b/components/architecture-diagram.tsx
new file mode 100644
index 0000000..5ebe266
--- /dev/null
+++ b/components/architecture-diagram.tsx
@@ -0,0 +1,292 @@
+type Lang = "en" | "ru" | "es"
+type Box = { name: string; note: string; tone?: "tool" | "shared" | "core" | "outside" }
+type Row = { boxes: Box[]; label?: string }
+
+const tones = {
+  tool: "border-fd-primary/50 bg-fd-primary/10",
+  shared: "border-fd-border bg-fd-card",
+  core: "border-fd-border bg-fd-secondary",
+  outside: "border-dashed border-fd-border bg-transparent",
+} as const
+
+const diagrams: Record<string, Record<Lang, { title: string; rows: Row[] }>> = {
+  packages: {
+    en: {
+      title: "Packages and who depends on whom",
+      rows: [
+        {
+          boxes: [
+            { name: "@leemour/tg-cli", note: "Telegram adapter, login, setup", tone: "tool" },
+            { name: "@leemour/max-cli", note: "MAX protocol, session, max serve, Bot API", tone: "tool" },
+          ],
+        },
+        {
+          boxes: [
+            {
+              name: "@leemour/cli-messaging",
+              note: "domain, services, store, send guard, commands, MCP",
+              tone: "shared",
+            },
+          ],
+        },
+        {
+          boxes: [
+            {
+              name: "@leemour/cli-core",
+              note: "output, errors and exit codes, keyring, config, codegen",
+              tone: "core",
+            },
+            { name: "cli-messaging-sqlite · -onnx", note: "pinned SQLite and ONNX Runtime builds", tone: "core" },
+          ],
+        },
+        {
+          label: "outside",
+          boxes: [
+            { name: "@mtcute/node", note: "Telegram MTProto, used only by tg", tone: "outside" },
+            { name: "ws · msgpack", note: "MAX WebSocket, used only by max", tone: "outside" },
+          ],
+        },
+      ],
+    },
+    ru: {
+      title: "Пакеты и зависимости между ними",
+      rows: [
+        {
+          boxes: [
+            { name: "@leemour/tg-cli", note: "адаптер Telegram, вход, настройка", tone: "tool" },
+            { name: "@leemour/max-cli", note: "протокол MAX, сессия, max serve, Bot API", tone: "tool" },
+          ],
+        },
+        {
+          boxes: [
+            {
+              name: "@leemour/cli-messaging",
+              note: "модель, сервисы, хранилище, защита отправки, команды, MCP",
+              tone: "shared",
+            },
+          ],
+        },
+        {
+          boxes: [
+            {
+              name: "@leemour/cli-core",
+              note: "вывод, ошибки и коды выхода, ключница, настройки, генератор",
+              tone: "core",
+            },
+            { name: "cli-messaging-sqlite · -onnx", note: "закреплённые сборки SQLite и ONNX Runtime", tone: "core" },
+          ],
+        },
+        {
+          label: "снаружи",
+          boxes: [
+            { name: "@mtcute/node", note: "MTProto Telegram, только в tg", tone: "outside" },
+            { name: "ws · msgpack", note: "WebSocket MAX, только в max", tone: "outside" },
+          ],
+        },
+      ],
+    },
+    es: {
+      title: "Paquetes y quién depende de quién",
+      rows: [
+        {
+          boxes: [
+            { name: "@leemour/tg-cli", note: "adaptador de Telegram, acceso, configuración", tone: "tool" },
+            { name: "@leemour/max-cli", note: "protocolo MAX, sesión, max serve, Bot API", tone: "tool" },
+          ],
+        },
+        {
+          boxes: [
+            {
+              name: "@leemour/cli-messaging",
+              note: "dominio, servicios, almacén, protección de envíos, comandos, MCP",
+              tone: "shared",
+            },
+          ],
+        },
+        {
+          boxes: [
+            {
+              name: "@leemour/cli-core",
+              note: "salida, errores y códigos de salida, llavero, configuración, codegen",
+              tone: "core",
+            },
+            { name: "cli-messaging-sqlite · -onnx", note: "builds fijados de SQLite y ONNX Runtime", tone: "core" },
+          ],
+        },
+        {
+          label: "fuera",
+          boxes: [
+            { name: "@mtcute/node", note: "MTProto de Telegram, solo en tg", tone: "outside" },
+            { name: "ws · msgpack", note: "WebSocket de MAX, solo en max", tone: "outside" },
+          ],
+        },
+      ],
+    },
+  },
+  command: {
+    en: {
+      title: "One command, start to finish",
+      rows: [
+        { boxes: [{ name: "argv", note: 'tg work messages send "Book club" …' }] },
+        { boxes: [{ name: "run()", note: "profile, settings, deadline, run record; never throws" }] },
+        { boxes: [{ name: "command", note: "parses its options, asks for services" }] },
+        { boxes: [{ name: "send guard", note: "permissions → recipients → hourly limit; writes only" }] },
+        { boxes: [{ name: "service", note: "the use case, shared with the MCP tool" }] },
+        {
+          boxes: [
+            { name: "adapter + decorators", note: "times each call, saves what was read" },
+            { name: "local store", note: "SQLite, one transaction per call", tone: "core" },
+          ],
+        },
+        { boxes: [{ name: "messenger", note: "Telegram or MAX", tone: "outside" }] },
+        {
+          boxes: [
+            { name: "stdout · exit code", note: "data on stdout, notes on stderr, everything closed", tone: "tool" },
+          ],
+        },
+      ],
+    },
+    ru: {
+      title: "Одна команда от начала до конца",
+      rows: [
+        { boxes: [{ name: "argv", note: 'tg work messages send "Book club" …' }] },
+        { boxes: [{ name: "run()", note: "профиль, настройки, тайм-аут, запись запуска; не бросает исключений" }] },
+        { boxes: [{ name: "команда", note: "разбирает свои параметры, просит сервисы" }] },
+        { boxes: [{ name: "защита отправки", note: "права → получатели → лимит в час; только для записи" }] },
+        { boxes: [{ name: "сервис", note: "сценарий, общий с MCP-инструментом" }] },
+        {
+          boxes: [
+            { name: "адаптер + обёртки", note: "замеряют каждый вызов, сохраняют прочитанное" },
+            { name: "локальная копия", note: "SQLite, одна транзакция на вызов", tone: "core" },
+          ],
+        },
+        { boxes: [{ name: "мессенджер", note: "Telegram или MAX", tone: "outside" }] },
+        {
+          boxes: [
+            { name: "stdout · код выхода", note: "данные в stdout, заметки в stderr, всё закрыто", tone: "tool" },
+          ],
+        },
+      ],
+    },
+    es: {
+      title: "Un comando, de principio a fin",
+      rows: [
+        { boxes: [{ name: "argv", note: 'tg work messages send "Book club" …' }] },
+        { boxes: [{ name: "run()", note: "perfil, ajustes, plazo, registro de ejecución; nunca lanza" }] },
+        { boxes: [{ name: "comando", note: "analiza sus opciones, pide servicios" }] },
+        {
+          boxes: [
+            { name: "protección de envíos", note: "permisos → destinatarios → límite por hora; solo escrituras" },
+          ],
+        },
+        { boxes: [{ name: "servicio", note: "el caso de uso, compartido con la herramienta MCP" }] },
+        {
+          boxes: [
+            { name: "adaptador + decoradores", note: "miden cada llamada, guardan lo leído" },
+            { name: "almacén local", note: "SQLite, una transacción por llamada", tone: "core" },
+          ],
+        },
+        { boxes: [{ name: "mensajero", note: "Telegram o MAX", tone: "outside" }] },
+        {
+          boxes: [
+            { name: "stdout · código de salida", note: "datos en stdout, notas en stderr, todo cerrado", tone: "tool" },
+          ],
+        },
+      ],
+    },
+  },
+  layers: {
+    en: {
+      title: "Layers: each calls only the ones below",
+      rows: [
+        {
+          boxes: [{ name: "interface", note: "CLI commands · MCP tools", tone: "tool" }],
+        },
+        { boxes: [{ name: "services", note: "messages, chats, people, inbox, archive, conversations…" }] },
+        { boxes: [{ name: "ports", note: "MessengerAdapter · MessageStore" }] },
+        {
+          boxes: [
+            { name: "adapters", note: "TelegramAdapter (tg) · maxAdapter (max)", tone: "outside" },
+            { name: "SQLite store", note: "Node and Bun drivers", tone: "core" },
+          ],
+        },
+        { boxes: [{ name: "domain", note: "Chat, Message, Person, Page… types only", tone: "core" }] },
+      ],
+    },
+    ru: {
+      title: "Слои: каждый вызывает только нижние",
+      rows: [
+        { boxes: [{ name: "интерфейс", note: "команды CLI · MCP-инструменты", tone: "tool" }] },
+        { boxes: [{ name: "сервисы", note: "messages, chats, people, inbox, archive, conversations…" }] },
+        { boxes: [{ name: "порты", note: "MessengerAdapter · MessageStore" }] },
+        {
+          boxes: [
+            { name: "адаптеры", note: "TelegramAdapter (tg) · maxAdapter (max)", tone: "outside" },
+            { name: "хранилище SQLite", note: "драйверы Node и Bun", tone: "core" },
+          ],
+        },
+        { boxes: [{ name: "модель", note: "Chat, Message, Person, Page… только типы", tone: "core" }] },
+      ],
+    },
+    es: {
+      title: "Capas: cada una llama solo a las de abajo",
+      rows: [
+        { boxes: [{ name: "interfaz", note: "comandos CLI · herramientas MCP", tone: "tool" }] },
+        { boxes: [{ name: "servicios", note: "messages, chats, people, inbox, archive, conversations…" }] },
+        { boxes: [{ name: "puertos", note: "MessengerAdapter · MessageStore" }] },
+        {
+          boxes: [
+            { name: "adaptadores", note: "TelegramAdapter (tg) · maxAdapter (max)", tone: "outside" },
+            { name: "almacén SQLite", note: "drivers de Node y Bun", tone: "core" },
+          ],
+        },
+        { boxes: [{ name: "dominio", note: "Chat, Message, Person, Page… solo tipos", tone: "core" }] },
+      ],
+    },
+  },
+}
+
+const Arrow = () => (
+  <svg
+    className="mx-auto my-1 block text-fd-muted-foreground"
+    width="14"
+    height="18"
+    viewBox="0 0 14 18"
+    aria-hidden="true"
+  >
+    <path d="M7 0v15M2 10l5 6 5-6" fill="none" stroke="currentColor" strokeWidth="1.6" />
+  </svg>
+)
+
+/** A box diagram drawn from data, so its labels follow the page language and its colours the theme. */
+export function ArchitectureDiagram({ name, lang = "en" }: { name: keyof typeof diagrams; lang?: Lang }) {
+  const diagram = diagrams[name]?.[lang] ?? diagrams[name]?.en
+  if (!diagram) return null
+  return (
+    <figure
+      className="not-prose my-6 rounded-xl border border-fd-border bg-fd-background p-4"
+      aria-label={diagram.title}
+    >
+      <figcaption className="mb-3 text-center text-sm font-semibold text-fd-foreground">{diagram.title}</figcaption>
+      {diagram.rows.map((row, index) => (
+        <div key={row.boxes.map((box) => box.name).join()}>
+          {index > 0 && <Arrow />}
+          {row.label && (
+            <p className="mb-1 text-center text-xs uppercase tracking-wide text-fd-muted-foreground">{row.label}</p>
+          )}
+          <div className="flex flex-col gap-2 sm:flex-row">
+            {row.boxes.map((box) => (
+              <div
+                key={box.name}
+                className={`flex-1 rounded-lg border px-3 py-2 text-center ${tones[box.tone ?? "shared"]}`}
+              >
+                <div className="font-mono text-sm font-semibold text-fd-foreground">{box.name}</div>
+                <div className="text-xs text-fd-muted-foreground">{box.note}</div>
+              </div>
+            ))}
+          </div>
+        </div>
+      ))}
+    </figure>
+  )
+}
diff --git a/components/mdx.tsx b/components/mdx.tsx
index fd0463c..ec0a38b 100644
--- a/components/mdx.tsx
+++ b/components/mdx.tsx
@@ -3,6 +3,7 @@ import defaultMdxComponents from "fumadocs-ui/mdx"
 import { ExternalLink } from "lucide-react"
 import type { MDXComponents } from "mdx/types"
 import type { ComponentProps, ComponentType } from "react"
+import { ArchitectureDiagram } from "@/components/architecture-diagram"
 import { DocTerm } from "@/components/doc-term"
 import { DocsCodeBlock } from "@/components/docs-code-block"
 import { InstallationGuide } from "@/components/installation-guide"
@@ -28,6 +29,7 @@ export function getMDXComponents(components?: MDXComponents) {
     ),
     h2: (props: ComponentProps<"h2"> & { "data-static-heading"?: boolean }) =>
       props["data-static-heading"] ? <h2 {...props}>{props.children}</h2> : <Heading as="h2" {...props} />,
+    ArchitectureDiagram,
     InstallationGuide,
     DocTerm,
     SearchPlayground,
diff --git a/content/docs/architecture.es.mdx b/content/docs/architecture.es.mdx
new file mode 100644
index 0000000..b89e4d1
--- /dev/null
+++ b/content/docs/architecture.es.mdx
@@ -0,0 +1,277 @@
+---
+title: Arquitectura
+description: Cómo están construidos tg y max — los paquetes, las capas, el contrato del adaptador, el almacén local y los patrones que lo sostienen.
+---
+
+`tg` y `max` son dos herramientas de línea de comandos sobre un núcleo común. Esta página muestra
+cómo está montado ese núcleo: qué paquete se ocupa de qué, cómo viaja un comando desde tu terminal
+hasta un mensajero y de vuelta, cómo se conecta un mensajero nuevo y dónde tiene límites el diseño.
+Está escrita para quien quiere saber qué está ejecutando y para quien quiere contribuir.
+
+Describe el código leído el 4 de octubre de 2026. Los enlaces al código apuntan a commits fijos, así
+que siguen mostrando lo que describe esta página aunque el código cambie. Cómo funcionan la búsqueda,
+los grafos de conversaciones y los embeddings es otra guía: [arquitectura de la búsqueda](./search-architecture.mdx).
+
+## Paquetes
+
+<ArchitectureDiagram name="packages" lang="es" />
+
+Cuatro paquetes propios y dos builds fijados, todos publicados en npm bajo `@leemour`:
+
+| Paquete | De qué se ocupa |
+| --- | --- |
+| [`@leemour/cli-core`](https://github.com/leemour/cli-core/tree/8648e39) | Lo que necesita cualquier herramienta de línea de comandos y ningún mensajero: modos de salida, el renderizado en terminal, la lista cerrada de errores y sus códigos de salida, el llavero, archivos de configuración, relojes, reintentos, un cliente HTTP, un generador de código para APIs HTTP, la autoactualización. También lo usa `braze-cli`, que no tiene nada que ver con mensajería. |
+| [`@leemour/cli-messaging`](https://github.com/leemour/cli-messaging/tree/c7cd479) | Todo lo de mensajería que no es de un mensajero concreto: el modelo de dominio, la resolución de nombres, el almacén local SQLite, la protección de envíos, los servicios (casos de uso), el árbol de comandos, el servidor MCP, el reconocimiento de voz, los procesos en segundo plano. |
+| `@leemour/cli-messaging-sqlite` | Builds de SQLite 3.53, cargados solo donde el SQLite del entorno es demasiado antiguo (Bun en macOS, el Node de una distribución Linux). |
+| `@leemour/cli-messaging-onnx` | ONNX Runtime como WebAssembly, para los modelos locales de embeddings. El reconocimiento de voz usa `sherpa-onnx`. |
+| [`@leemour/tg-cli`](https://github.com/leemour/tg-cli/tree/4a36e85) | El adaptador de Telegram sobre [mtcute](https://github.com/mtcute/mtcute), la sesión de Telegram, la configuración guiada. Casi todos los comandos de `tg` vienen de cli-messaging. |
+| [`@leemour/max-cli`](https://github.com/leemour/max-cli/tree/fff19ff) | El protocolo MAX (WebSocket, tramas binarias), la sesión de MAX, la conexión en segundo plano `max serve`, su propio servidor MCP sobre los servicios comunes y una parte aparte para la Bot API oficial de MAX. |
+
+Cada herramienta fija una versión exacta de cli-messaging y cli-core. Un cambio en el código común
+llega a los usuarios con una versión del paquete común y después una versión de cada herramienta; las
+dos suelen salir el mismo día.
+
+**La regla del paquete común: nada en él conoce un mensajero.** Una regla del linter rechaza cualquier
+import de `@mtcute/*`, `ws` o de una carpeta de adaptador dentro de `src/` de cli-messaging
+([biome.json](https://github.com/leemour/cli-messaging/blob/c7cd479/biome.json)). Lo que solo tiene un
+mensajero viaja en un campo `providerMetadata` de los tipos comunes.
+
+## Un comando, de principio a fin
+
+<ArchitectureDiagram name="command" lang="es" />
+
+Toma `tg work messages send "Book club" "See you at 7"`:
+
+1. **`run()`** ([program.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/cli/program.ts))
+   toma `work` como perfil, resuelve los ajustes en un orden fijo (opción → entorno → archivo → valor
+   por defecto), empieza el registro de la ejecución y arma el plazo de `--timeout`. Nunca lanza una
+   excepción: cada resultado se convierte en un código de salida.
+2. **El comando** analiza sus propias opciones y pide servicios. No sabe nada de Telegram.
+3. **La protección de envíos** ([guard.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/sends/guard.ts))
+   comprueba `permissions`, la lista de destinatarios y el límite por hora, antes de conectar. Las
+   lecturas no pasan por ella. Cada intento de escritura — enviado, rechazado, fallido o desconocido —
+   queda en el registro de envíos, sin su texto.
+4. **El servicio** ejecuta el caso de uso. La herramienta MCP `tg_messages_send` llama al mismo método,
+   así que un comando y una herramienta dan la misma respuesta, y el mismo error, para la misma
+   entrada.
+5. **El adaptador** convierte la llamada en peticiones a Telegram y la respuesta de Telegram en un
+   `Message` del dominio. Lo rodean dos envoltorios: uno mide cada llamada para el registro de la
+   ejecución, otro guarda lo leído en el almacén local.
+6. **Salida**: stdout recibe el resultado y nada más; notas y avisos van a stderr. Después se cierra
+   todo lo que abrió el comando — socket, temporizador, base de datos — y el proceso termina.
+
+Un comando puntual que imprime su resultado y sigue en marcha se considera un defecto. Solo `watch`,
+`serve` y `mcp` mantienen una conexión, y solo mientras se ejecutan.
+
+## Capas
+
+<ArchitectureDiagram name="layers" lang="es" />
+
+Cinco capas, cada una llama solo a las de abajo:
+
+- **Dominio** ([models.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/domain/models.ts)) —
+  `Chat`, `Message`, `Person`, `Page` y el resto. Solo tipos, sin comportamiento, sin mensajero.
+- **Adaptadores** — uno por mensajero, en su propio repositorio:
+  [TelegramAdapter](https://github.com/leemour/tg-cli/blob/4a36e85/src/telegram/adapter.ts) en tg,
+  [maxAdapter](https://github.com/leemour/max-cli/blob/fff19ff/src/adapter/max-adapter.ts) en max.
+- **Puertos** — las dos interfaces de las que dependen los servicios:
+  [`MessengerAdapter`](https://github.com/leemour/cli-messaging/blob/c7cd479/src/cli/messenger/port.ts)
+  y [`MessageStore`](https://github.com/leemour/cli-messaging/blob/c7cd479/src/store/store.ts).
+- **Servicios** ([services/](https://github.com/leemour/cli-messaging/blob/c7cd479/src/services/index.ts)) —
+  messages, chats, people, inbox, archive, conversations, moderation y más; cada uno es un objeto
+  simple creado por una fábrica.
+- **Interfaz** — los comandos CLI y las herramientas MCP.
+
+La dirección se hace cumplir, no se espera. Las reglas del linter rechazan un import de `commander` o
+de un archivo de comando desde los servicios, la protección de envíos y el servidor MCP; en tg solo
+`src/telegram/` puede importar mtcute; en max los comandos no pueden importar el protocolo, las
+especificaciones de operaciones ni el código generado. Un import prohibido rompe la compilación con
+una frase que explica por qué.
+
+**Los servicios abren lo que necesitan al primer uso.** Un servicio obtiene su conexión, su almacén y
+su cuenta de forma perezosa ([deps.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/services/deps.ts)),
+así que una lectura respondida desde el almacén local nunca conecta. Un comando obtiene los servicios
+con `withServices`, que cierra lo abierto; una herramienta MCP los construye sobre la conexión de su
+sesión.
+
+**Una herramienta sustituye un caso de uso, no un comando.** Un mensajero puede redefinir un método
+de un servicio y llamar al común dentro del suyo; el comando y la herramienta MCP ven el cambio:
+
+```ts
+services: (base) => ({
+  messages: { ...base.messages, list: (chat, window) => maxList(base.messages, chat, window) },
+}),
+```
+
+## Adaptadores
+
+Un mensajero se incorpora escribiendo dos cosas: un **adaptador**, que habla con el mensajero, y una
+descripción **`Messenger`**, que se lo presenta a los comandos comunes — el nombre de la aplicación,
+el nombre del proveedor en el almacén, cómo conectar, cómo paginar el historial. No se modifica
+cli-messaging. La guía completa es [ADAPTERS.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ADAPTERS.md).
+
+**Un núcleo obligatorio y grupos opcionales.** `MessengerCore` — `self`, `me`, `resolve`, `chat`,
+`send`, `logout`, `close` — es obligatorio. Todo lo demás va en grupos: `ServerReads`,
+`MessageEditing`, `MessagePins`, `MessageReactions`, `MessagePolls`, `ReadState`, `LiveUpdates`,
+`PushedHistory`, `MessageMedia`, `GroupAdmin`, `ChatFolders`, `ContactBook` y más. Un comando llega
+a un método opcional con `capability()`; si el adaptador no lo tiene, el comando responde «este
+mensajero no puede …», no se cae.
+
+**Rechazar, nunca descartar.** Una opción que el mensajero no puede cumplir — un mensaje silencioso
+donde no existen — se rechaza con `validation_error`. Nunca se ignora en silencio.
+
+**Los ids son cadenas, siempre.** Chats, mensajes, personas, encuestas. Los ids de mensaje de MAX
+tienen 18 dígitos, más de lo que un número de JavaScript guarda con exactitud, y el código común
+nunca hace aritmética con un id. Un mensajero cuyos ids no son enteros pequeños pagina su historial
+por tiempo.
+
+**Un envío tiene identidad.** Cada envío recibe un `sendId`, que se pasa al mensajero como id propio
+del cliente cuando lo admite, así el servidor descarta una repetición. Si la petición salió y no
+llegó respuesta, el adaptador lanza `outcome_unknown` — no `network_error`, que diría que el mensaje
+no salió. Repetir el envío con el mismo `sendId` da un mensaje, no dos. En max, el único reintento
+reutiliza el mismo id porque se midió que MAX elimina duplicados con él.
+
+**Los errores se traducen en la frontera.** Cada error de una biblioteca se convierte en un código de
+la lista cerrada de cli-core, cada uno con su código de salida, para que un script pueda decidir por
+`$?`:
+
+| Código | Salida | Código | Salida |
+| --- | --- | --- | --- |
+| `validation_error` | 2 | `timeout` | 9 |
+| `configuration_error` | 3 | `network_error` | 10 |
+| `authentication_error` | 4 | `provider_error` | 11 |
+| `permission_error` | 5 | `provider_unavailable` | 12 |
+| `not_found` | 6 | `invalid_response` | 13 |
+| `confirmation_required` | 7 | `outcome_unknown` | 14 |
+| `rate_limited` | 8 | `cancelled` | 130 |
+
+**Ningún tipo de biblioteca cruza el adaptador.** Por encima solo hay tipos del dominio. Eso es lo que
+mantiene reemplazables mtcute o el código de protocolo propio de max.
+
+**Historial del servidor o historial enviado.** Telegram responde cuando se le pide el historial de
+un chat, así que tg implementa `ServerReads`. Un mensajero que en cambio envía el historial al
+cliente declara `history: "store"`: los servicios comunes responden las lecturas desde el almacén
+local, y `PushedHistory.feed()` del adaptador entrega lotes a `serve`, que los guarda.
+
+**Cómo cumplen el contrato las dos herramientas.** El adaptador de tg envuelve mtcute, y un solo
+archivo, [map.ts](https://github.com/leemour/tg-cli/blob/4a36e85/src/telegram/map.ts), conoce la forma
+de los objetos de mtcute. El adaptador de max se apoya en su propio
+[`MaxClient`](https://github.com/leemour/max-cli/blob/fff19ff/src/client.ts), dueño del protocolo MAX;
+[messenger.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/messenger.ts) describe MAX a los
+comandos comunes, y la mayoría de los archivos de comandos de max son envoltorios finos sobre los
+comunes que añaden las opciones propias de MAX.
+
+## El almacén local
+
+Un archivo SQLite, `~/.local/share/cli-messaging/messages.db`, guarda todos los mensajeros y cuentas —
+los perfiles de tg, la cuenta de max y sus bots — con clave por proveedor y cuenta.
+
+- **Dos entornos.** Abre `node:sqlite` en Node y `bun:sqlite` en Bun, cada uno con import dinámico,
+  porque un import estático del módulo del otro entorno falla al cargar.
+- **Un SQLite comprobado.** Antes de abrir, el almacén comprueba que el SQLite del entorno tiene la
+  búsqueda de texto completo que necesita el esquema; el número de versión no basta. Donde falta, el
+  build fijado ocupa su lugar: siempre en Bun para macOS, y en el Node de una distribución Linux el
+  comando se reinicia con la biblioteca fijada primero, antes de leer o enviar nada
+  ([sqlite-runtime.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/sqlite-runtime.ts)).
+- **Un método, una transacción.** Cada método del almacén es una operación completa: un
+  `BEGIN IMMEDIATE` … `COMMIT` síncrono, sin `await` en medio. Dos llamadas en el mismo proceso de
+  larga duración no se mezclan dentro de una transacción. La única excepción deliberada es reconstruir
+  las conversaciones de un chat: escribe una versión nueva en transacciones cortas y cambia a ella en
+  una más, así nunca se lee una versión a medio escribir.
+- **Migraciones solo hacia delante.** Numeradas, aditivas, nunca editadas una vez publicadas
+  ([manifest.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/store/sqlite/manifest.ts)).
+  Una versión `min_compatible` permite que una herramienta antigua siga usando un archivo que migró una
+  nueva; subirla es una versión mayor del paquete común, y las dos herramientas publican su
+  actualización juntas.
+- **Consultas con Drizzle, empaquetado.** El constructor de consultas va empaquetado dentro del
+  paquete publicado en lugar de instalarse, lo que bajó su coste de carga de unos 200 ms a unos 6 ms
+  por proceso.
+
+El almacén guarda el texto de los mensajes para responder sin red. No está cifrado;
+[seguridad](./security.md) explica qué significa eso para ti.
+
+## Patrones que lo sostienen
+
+- **stdout lleva datos y nada más** en modo máquina: sin spinner, sin color, sin avisos. Los agentes y
+  los scripts dependen de ello, y los tests lo comprueban.
+- **Puntual significa que el proceso termina.** Lo que abre un socket, un temporizador o un listener
+  lo cierra en cada camino de salida.
+- **Leer solo observa.** Leer un chat nunca lo marca como leído; eso es un comando aparte y explícito.
+  Un test comprueba que leer no envía la petición de «leído».
+- **Un nombre nunca se resuelve adivinando.** Un nombre que encaja con varios chats es un error que
+  los lista, no una elección.
+- **Un modelo de permisos, una protección**, usados por cada comando, cada herramienta MCP y, en max,
+  por el proceso en segundo plano `max serve` para todo lo que pasa por él.
+- **Las ejecuciones se registran sin contenido.** Un registro guarda las palabras del comando, ids,
+  recuentos y tiempos; los mensajes, tokens y teléfonos nunca llegan a un log, un fixture o un
+  documento.
+- **Generado y comprobado.** La referencia de comandos (`commands.md`), los envoltorios de operaciones
+  de max y los tipos de la Bot API se generan; CI falla si la copia confirmada se aparta del
+  generador.
+
+## El lado de MAX
+
+MAX no publica una API para cuentas personales, así que max lleva más código propio que tg:
+
+- **Cada operación se declara una vez.** Cada petición a MAX se declara en
+  [`src/spec/operations/`](https://github.com/leemour/max-cli/tree/fff19ff/src/spec/operations) con su
+  esquema y de dónde salió su forma — medida en una conexión real, capturada del cliente web o leída en
+  la ingeniería inversa de otros. Los envoltorios de `src/generated/` se generan a partir de ellas y
+  nunca se editan a mano.
+- **Tramas binarias, como las envía el cliente web.** MessagePack con compresión LZ4; todo el códec es
+  un archivo, [frame.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/protocol/frame.ts). Un
+  número que perdería dígitos llega como `bigint` y por encima del códec se convierte en cadena.
+- **Se parece al cliente oficial.** El user agent y cada campo que identifica al cliente copian lo que
+  envía web.max.ru; no hay un nombre propio en la red.
+- **`max serve` mantiene la conexión.** Lo arranca en segundo plano el primer comando que necesita MAX;
+  los siguientes pasan por él, y se detiene solo tras 15 minutos sin actividad.
+- **Su propio servidor MCP.** `max mcp` mantiene una conexión con sesión iniciada por cada sesión del
+  agente y la cierra tras poco tiempo inactiva; sus herramientas llaman a los mismos servicios comunes
+  que los comandos.
+- **La Bot API es una parte aparte.** `max bot …` habla con la Bot API HTTP oficial de MAX. Sus tipos y
+  esquemas se generan a partir del documento OpenAPI oficial con el generador de cli-core, y nada en
+  `src/bot/` comparte transporte, sesión ni código generado con la cuenta personal.
+
+## Tests
+
+- **Los tests nunca tocan tus datos.** Configuración, estado, caché y la carpeta temporal viven en un
+  sandbox durante la ejecución ([sandbox.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/testing/sandbox.ts)).
+- **Casos de contrato para adaptadores.** cli-messaging incluye una semilla fija, un adaptador falso y
+  los casos de contrato ([src/kit](https://github.com/leemour/cli-messaging/tree/c7cd479/src/kit)). El
+  adaptador de un mensajero ejecuta los mismos casos sobre su propio cliente falso; ningún caso habla
+  con un servicio real.
+- **Los comandos se prueban de extremo a extremo** con `run(argv, environment)`: un mensajero con guion,
+  un llavero en memoria y la salida capturada.
+- **Los dos entornos.** CI se ejecuta en Linux, macOS y Windows, con Node y Bun, y en un Node antiguo
+  para ver al almacén rechazar un SQLite sin búsqueda de texto completo.
+- **La paridad entre herramientas** la comprueba un auditor común que compara comandos, opciones,
+  esquemas MCP y tests de tg y max.
+- **Las pruebas en vivo son aparte y manuales**: solo con cuentas y chats de prueba, con el
+  consentimiento del propietario, guardando la forma de cada respuesta y nunca su contenido.
+
+## Límites y compromisos
+
+- **El protocolo de MAX no es oficial.** Todo lo que max sabe de él se midió o se obtuvo por ingeniería
+  inversa. Puede dejar de funcionar sin aviso; entonces un comando lo dice en stderr en lugar de
+  mostrar una lista vacía.
+- **Una escritura a la vez por almacén.** Las escrituras bloquean el bucle de eventos del proceso
+  mientras duran, y otro proceso espera hasta 5 segundos por el bloqueo. Las escrituras grandes se
+  hacen en lotes acotados.
+- **Sin índice vectorial.** La búsqueda de conversaciones compara vectores en JavaScript, página a
+  página; el trabajo crece con el número de fragmentos en el ámbito ([detalles](./search-architecture.mdx)).
+- **Las protecciones viven dentro de la herramienta.** Frenan a un modelo convencido para enviar, no a
+  un agente con shell que decide cambiar la configuración. Un sandbox o un usuario del sistema aparte
+  es el límite externo.
+- **El almacén local no está cifrado.** El cifrado de disco completo protege frente a un ordenador
+  perdido.
+
+## Contribuir: por dónde empezar
+
+- Un mensajero nuevo: [ADAPTERS.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ADAPTERS.md),
+  y después los casos de contrato.
+- El código común: [ARCHITECTURE.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ARCHITECTURE.md)
+  de cli-messaging.
+- Telegram: [ARCHITECTURE.md](https://github.com/leemour/tg-cli/blob/4a36e85/docs/dev/ARCHITECTURE.md) de tg.
+- MAX: [ARCHITECTURE.md](https://github.com/leemour/max-cli/blob/fff19ff/docs/dev/ARCHITECTURE.md) de max
+  y las [notas del protocolo](https://github.com/leemour/max-cli/blob/fff19ff/docs/dev/protocol.md).
+- Preguntas: el [chat de soporte](https://t.me/wirecatdev).
diff --git a/content/docs/architecture.mdx b/content/docs/architecture.mdx
new file mode 100644
index 0000000..7739280
--- /dev/null
+++ b/content/docs/architecture.mdx
@@ -0,0 +1,264 @@
+---
+title: Architecture
+description: How tg and max are built — the packages, the layers, the adapter contract, the local store and the patterns that hold them together.
+---
+
+`tg` and `max` are two command line tools on one shared core. This page shows how that core is
+put together: which package owns what, how a command travels from your terminal to a messenger and
+back, how a new messenger plugs in, and where the design has limits. It is written for people who
+want to know what they are running and for anyone who wants to contribute.
+
+It describes the code as read on 4 October 2026. Links to source point at fixed commits, so they
+keep showing what this page describes after the code moves on. How search, conversation graphs and
+embeddings work is a separate guide: [search architecture](./search-architecture.mdx).
+
+## Packages
+
+<ArchitectureDiagram name="packages" lang="en" />
+
+Four packages of our own, plus two pinned builds, all published to npm under `@leemour`:
+
+| Package | What it owns |
+| --- | --- |
+| [`@leemour/cli-core`](https://github.com/leemour/cli-core/tree/8648e39) | What any command line tool needs and no messenger: output modes, the terminal renderer, the closed list of errors and their exit codes, keyring access, config files, clocks, retry, an HTTP client, a code generator for HTTP APIs, self-update. Also used by `braze-cli`, which has nothing to do with messaging. |
+| [`@leemour/cli-messaging`](https://github.com/leemour/cli-messaging/tree/c7cd479) | Everything about messaging that is not one messenger: the domain model, name resolution, the local SQLite store, the send guard, the services (use cases), the command tree, the MCP server, speech recognition, background processes. |
+| `@leemour/cli-messaging-sqlite` | SQLite 3.53 builds, loaded only where the runtime's own SQLite is too old (Bun on macOS, a Linux distribution's Node). |
+| `@leemour/cli-messaging-onnx` | ONNX Runtime as WebAssembly, for the local embedding models. Speech recognition uses `sherpa-onnx`. |
+| [`@leemour/tg-cli`](https://github.com/leemour/tg-cli/tree/4a36e85) | The Telegram adapter over [mtcute](https://github.com/mtcute/mtcute), the Telegram session, guided setup. Almost every `tg` command comes from cli-messaging. |
+| [`@leemour/max-cli`](https://github.com/leemour/max-cli/tree/fff19ff) | The MAX protocol (WebSocket, binary frames), the MAX session, the `max serve` background connection, its own MCP server over the shared services, and a separate slice for MAX's official Bot API. |
+
+Each tool pins an exact version of cli-messaging and cli-core. A change in the shared code reaches
+users through a release of the shared package and then a release of each tool; the two tools usually
+ship the same day.
+
+**The one rule of the shared package: nothing in it knows a messenger.** A lint rule refuses any
+import of `@mtcute/*`, `ws` or an adapter directory under cli-messaging's `src/`
+([biome.json](https://github.com/leemour/cli-messaging/blob/c7cd479/biome.json)). What only one
+messenger has travels in a `providerMetadata` field on the shared types.
+
+## One command, start to finish
+
+<ArchitectureDiagram name="command" lang="en" />
+
+Take `tg work messages send "Book club" "See you at 7"`:
+
+1. **`run()`** ([program.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/cli/program.ts))
+   takes `work` as the profile, resolves settings in a fixed order (flag → environment → file →
+   default), starts the run record and arms the `--timeout` deadline. It never throws: every outcome
+   becomes an exit code.
+2. **The command** parses its own options and asks for services. It knows nothing about Telegram.
+3. **The send guard** ([guard.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/sends/guard.ts))
+   checks `permissions`, the recipient list and the hourly limit, before anything connects. Reads
+   skip it. Every write attempt — sent, refused, failed or unknown — goes into the send journal,
+   without its text.
+4. **The service** runs the use case. The MCP tool `tg_messages_send` calls the same method, so a
+   command and a tool give the same answer, and the same error, for the same input.
+5. **The adapter** turns the call into Telegram requests and Telegram's answer into a domain
+   `Message`. Two wrappers sit around it: one times each call into the run record, one saves what was
+   read into the local store.
+6. **Output**: stdout gets the result and nothing else; notes and warnings go to stderr. Then
+   everything the command opened — socket, timer, database — is closed, and the process exits.
+
+A one-shot command that prints its result and keeps running is treated as a defect. Only `watch`,
+`serve` and `mcp` hold a connection, and only while they run.
+
+## Layers
+
+<ArchitectureDiagram name="layers" lang="en" />
+
+Five layers, each calling only the ones below it:
+
+- **Domain** ([models.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/domain/models.ts)) —
+  `Chat`, `Message`, `Person`, `Page` and the rest. Types only, no behaviour, no messenger.
+- **Adapters** — one per messenger, in its own repository:
+  [TelegramAdapter](https://github.com/leemour/tg-cli/blob/4a36e85/src/telegram/adapter.ts) in tg,
+  [maxAdapter](https://github.com/leemour/max-cli/blob/fff19ff/src/adapter/max-adapter.ts) in max.
+- **Ports** — the two interfaces the services depend on:
+  [`MessengerAdapter`](https://github.com/leemour/cli-messaging/blob/c7cd479/src/cli/messenger/port.ts)
+  and [`MessageStore`](https://github.com/leemour/cli-messaging/blob/c7cd479/src/store/store.ts).
+- **Services** ([services/](https://github.com/leemour/cli-messaging/blob/c7cd479/src/services/index.ts)) —
+  messages, chats, people, inbox, archive, conversations, moderation and more, each a plain object
+  made by a factory.
+- **Interface** — the CLI commands and the MCP tools.
+
+The direction is enforced, not hoped for. Lint rules refuse an import of `commander` or of a command
+file from the services, the send guard and the MCP server; in tg only `src/telegram/` may import
+mtcute; in max the commands may not import the protocol, the operation specs or the generated code.
+A forbidden import fails the build with a sentence saying why.
+
+**Services open what they need on first use.** A service gets its connection, store and account
+lazily ([deps.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/services/deps.ts)), so a
+read answered from the local store never connects. A command gets services through `withServices`,
+which closes what was opened; an MCP tool builds them over its session's connection.
+
+**A tool replaces a use case, not a command.** A messenger can override one service method and call
+the shared one inside it; the command and the MCP tool both see the replacement:
+
+```ts
+services: (base) => ({
+  messages: { ...base.messages, list: (chat, window) => maxList(base.messages, chat, window) },
+}),
+```
+
+## Adapters
+
+A messenger joins by writing two things: an **adapter**, which speaks to the messenger, and a
+**`Messenger`** description, which tells the shared commands about it — the app name, the provider
+name in the store, how to connect, how to page history. It does not edit cli-messaging. The full
+guide is [ADAPTERS.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ADAPTERS.md).
+
+**A required core and optional groups.** `MessengerCore` — `self`, `me`, `resolve`, `chat`, `send`,
+`logout`, `close` — is required. Everything else comes in groups: `ServerReads`, `MessageEditing`,
+`MessagePins`, `MessageReactions`, `MessagePolls`, `ReadState`, `LiveUpdates`, `PushedHistory`,
+`MessageMedia`, `GroupAdmin`, `ChatFolders`, `ContactBook` and more. A command reaches an optional
+method through `capability()`; when the adapter lacks it, the command fails with "this messenger
+cannot …", not a crash.
+
+**Refuse, never drop.** An option the messenger cannot honour — a silent message where there is no
+such thing — is refused with `validation_error`. It is never quietly ignored.
+
+**Ids are strings, everywhere.** Chats, messages, people, polls. MAX message ids are 18 digits, past
+what a JavaScript number holds exactly, and shared code never does arithmetic on an id. A messenger
+whose ids are not small integers pages its history by time instead.
+
+**A send has an identity.** Each send gets a `sendId`, passed to the messenger as the client's own
+message id where it has one, so the server drops a repeat. When the request went out and no answer
+came back, the adapter throws `outcome_unknown` — not `network_error`, which would say the message
+did not go. Repeating the send with the same `sendId` gives one message, not two. In max, the single
+retry reuses the same id because MAX was measured to deduplicate by it.
+
+**Errors are translated at the border.** Every library error becomes one code from cli-core's closed
+list, each with its own exit code, so a script can branch on `$?`:
+
+| Code | Exit | Code | Exit |
+| --- | --- | --- | --- |
+| `validation_error` | 2 | `timeout` | 9 |
+| `configuration_error` | 3 | `network_error` | 10 |
+| `authentication_error` | 4 | `provider_error` | 11 |
+| `permission_error` | 5 | `provider_unavailable` | 12 |
+| `not_found` | 6 | `invalid_response` | 13 |
+| `confirmation_required` | 7 | `outcome_unknown` | 14 |
+| `rate_limited` | 8 | `cancelled` | 130 |
+
+**No library type crosses the adapter.** Above it there are only domain types. That is what keeps
+mtcute, or max's own protocol code, replaceable.
+
+**Server history or pushed history.** Telegram answers when asked for a chat's history, so tg
+implements `ServerReads`. A messenger that instead pushes history to the client sets
+`history: "store"`: the shared services answer reads from the local store, and the adapter's
+`PushedHistory.feed()` hands batches to `serve`, which saves them.
+
+**How the two tools fill the contract.** tg's adapter wraps mtcute, and one file,
+[map.ts](https://github.com/leemour/tg-cli/blob/4a36e85/src/telegram/map.ts), is the only one that
+knows mtcute's object shapes. max's adapter sits on its own
+[`MaxClient`](https://github.com/leemour/max-cli/blob/fff19ff/src/client.ts), which owns the MAX
+protocol; [messenger.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/messenger.ts) describes
+MAX to the shared commands, and most of max's command files are thin wrappers over the shared ones
+that add MAX's own options.
+
+## The local store
+
+One SQLite file, `~/.local/share/cli-messaging/messages.db`, holds every messenger and account —
+tg's profiles, max's account and its bots — keyed by provider and account.
+
+- **Two runtimes.** It opens `node:sqlite` under Node and `bun:sqlite` under Bun, each by dynamic
+  import, since a static import of the other runtime's module fails at load time.
+- **A checked SQLite.** Before opening, the store checks that the runtime's SQLite has the full-text
+  search the schema needs; the version number alone does not tell. Where it falls short, the pinned
+  build takes its place: always on Bun for macOS, and on a Linux distribution's Node the command
+  restarts itself with the pinned library first, before anything is read or sent
+  ([sqlite-runtime.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/sqlite-runtime.ts)).
+- **One method, one transaction.** Every store method is one whole operation: one synchronous
+  `BEGIN IMMEDIATE` … `COMMIT`, with no `await` in between. Two calls in the same long-running process
+  cannot interleave inside a transaction. The one deliberate exception is rebuilding a chat's
+  conversations, which writes a new build in short transactions and switches to it in one more, so a
+  half-written build is never read.
+- **Forward-only migrations.** Numbered, additive, never edited once released
+  ([manifest.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/store/sqlite/manifest.ts)).
+  A `min_compatible` version lets an older tool keep using a file a newer one migrated; raising it is
+  a major version of the shared package, and both tools ship their upgrade together.
+- **Queries through Drizzle, bundled.** The query builder is bundled into the published package
+  instead of installed, which cut its load cost from about 200 ms to about 6 ms per process.
+
+The store keeps message text so it can answer without the network. It is not encrypted;
+[security](./security.md) says what that means for you.
+
+## Patterns that hold it together
+
+- **stdout carries data and nothing else** in machine mode: no spinner, no colour, no warning. Agents
+  and scripts depend on that, and tests check it.
+- **One-shot means the process exits.** Whatever opens a socket, a timer or a listener closes it on
+  every exit path.
+- **Reading is observational.** Reading a chat never marks it read; that is a separate, explicit
+  command. A test asserts that reading sends no "mark read" request.
+- **A name is never resolved by guessing.** A chat name that fits several chats is an error that
+  lists them, not a pick.
+- **One permission model, one guard**, used by every command, every MCP tool and, in max, by the
+  background `max serve` process for anything that passes through it.
+- **Runs are recorded without content.** A run record holds the command's words, ids, counts and
+  timings; messages, tokens and phone numbers never reach a log, a fixture or a document.
+- **Generated, then checked.** The command reference (`commands.md`), max's operation wrappers and
+  the Bot API types are generated; CI fails when the committed copy drifts from the generator.
+
+## The MAX side
+
+MAX publishes no API for personal accounts, so max carries more of its own code than tg:
+
+- **Operations declared once.** Each MAX request is declared in
+  [`src/spec/operations/`](https://github.com/leemour/max-cli/tree/fff19ff/src/spec/operations) with
+  its schema and where its shape came from — measured on a live connection, captured from the web
+  client, or read in someone else's reverse engineering. Wrappers in `src/generated/` are generated
+  from these and never edited by hand.
+- **Binary frames, as the web client sends them.** MessagePack with LZ4 compression; the whole codec
+  is one file, [frame.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/protocol/frame.ts). A
+  number that would lose digits comes back as a `bigint` and becomes a string above the codec.
+- **It looks like the official client.** The user agent and every field that identifies the client
+  copy what web.max.ru sends; there is no custom name on the wire.
+- **`max serve` holds the connection.** The first command that needs MAX starts it in the background;
+  later commands go through it, and it stops itself after 15 minutes idle.
+- **Its own MCP server.** `max mcp` keeps one logged-in connection per agent session and drops it
+  after a short idle time; its tools call the same shared services as the commands.
+- **The Bot API is a separate slice.** `max bot …` talks to MAX's official HTTP Bot API. Its types and
+  schemas are generated from the official OpenAPI document with cli-core's generator, and nothing in
+  `src/bot/` shares a transport, a session or generated code with the personal account.
+
+## Testing
+
+- **Tests never touch your data.** Config, state, cache and the temporary folder all live in a
+  sandbox for the run ([sandbox.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/testing/sandbox.ts)).
+- **Contract cases for adapters.** cli-messaging ships a fixed seed, a fake adapter and contract cases
+  ([src/kit](https://github.com/leemour/cli-messaging/tree/c7cd479/src/kit)). A messenger's adapter
+  runs the same cases over its own fake client; no case talks to a live service.
+- **Commands are tested end to end** through `run(argv, environment)`, with a scripted messenger, an
+  in-memory keyring and captured streams.
+- **Both runtimes.** CI runs on Linux, macOS and Windows, under Node and Bun, and on an old Node to
+  see the store refuse a SQLite without full-text search.
+- **Parity between the tools** is checked by a shared auditor that compares commands, options, MCP
+  schemas and tests across tg and max.
+- **Live checks are separate and manual**: run against test accounts and test chats only, with the
+  owner's consent, recording the shape of each answer and never its content.
+
+## Limits and trade-offs
+
+- **MAX's protocol is unofficial.** Everything max knows about it was measured or reverse engineered.
+  It can stop working without warning; when it does, a command says so on stderr instead of printing
+  an empty list.
+- **One write at a time per store.** Writes block the process's event loop while they run, and another
+  process waits up to 5 seconds for the lock. Large writes are kept in bounded batches.
+- **No vector index.** Conversation search compares vectors in JavaScript, page by page; the work grows
+  with the number of chunks in scope ([details](./search-architecture.mdx)).
+- **Guards live inside the tool.** They stop a model talked into sending, not an agent with a shell
+  that sets out to change the settings. A sandbox or a separate OS user is the outside boundary.
+- **The local store is not encrypted.** Whole-disk encryption is the protection against a lost
+  computer.
+
+## Contributing: where to start
+
+- A new messenger: [ADAPTERS.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ADAPTERS.md),
+  then the contract cases.
+- The shared code: cli-messaging's
+  [ARCHITECTURE.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ARCHITECTURE.md).
+- Telegram: tg's [ARCHITECTURE.md](https://github.com/leemour/tg-cli/blob/4a36e85/docs/dev/ARCHITECTURE.md).
+- MAX: max's [ARCHITECTURE.md](https://github.com/leemour/max-cli/blob/fff19ff/docs/dev/ARCHITECTURE.md)
+  and the [protocol notes](https://github.com/leemour/max-cli/blob/fff19ff/docs/dev/protocol.md).
+- Questions: the [support chat](https://t.me/wirecatdev).
diff --git a/content/docs/architecture.ru.mdx b/content/docs/architecture.ru.mdx
new file mode 100644
index 0000000..5485199
--- /dev/null
+++ b/content/docs/architecture.ru.mdx
@@ -0,0 +1,265 @@
+---
+title: Архитектура
+description: Как устроены tg и max — пакеты, слои, контракт адаптера, локальная копия и приёмы, на которых всё держится.
+---
+
+`tg` и `max` — два инструмента командной строки на одном общем ядре. Здесь показано, как это ядро
+собрано: какой пакет за что отвечает, как команда идёт из терминала в мессенджер и обратно, как
+подключается новый мессенджер и где у устройства есть пределы. Страница для тех, кто хочет понимать,
+что у них запущено, и для тех, кто хочет участвовать в разработке.
+
+Описан код, прочитанный 4 октября 2026 года. Ссылки на исходники зафиксированы на конкретных
+коммитах, поэтому и после изменений кода показывают то, о чём здесь сказано. Как работают поиск,
+граф разговоров и embeddings — отдельная страница: [архитектура поиска](./search-architecture.mdx).
+
+## Пакеты
+
+<ArchitectureDiagram name="packages" lang="ru" />
+
+Четыре собственных пакета и две закреплённые сборки, все опубликованы в npm под `@leemour`:
+
+| Пакет | За что отвечает |
+| --- | --- |
+| [`@leemour/cli-core`](https://github.com/leemour/cli-core/tree/8648e39) | То, что нужно любому инструменту командной строки и не связано с мессенджерами: режимы вывода, отрисовка в терминале, закрытый список ошибок и их коды выхода, ключница, файлы настроек, часы, повторы, HTTP-клиент, генератор кода для HTTP API, самообновление. Его использует и `braze-cli`, который к переписке отношения не имеет. |
+| [`@leemour/cli-messaging`](https://github.com/leemour/cli-messaging/tree/c7cd479) | Всё о переписке, что не относится к одному мессенджеру: модель данных, поиск по именам, локальное хранилище SQLite, защита отправки, сервисы (сценарии), дерево команд, MCP-сервер, распознавание речи, фоновые процессы. |
+| `@leemour/cli-messaging-sqlite` | Сборки SQLite 3.53; загружаются только там, где собственный SQLite среды слишком старый (Bun на macOS, Node из дистрибутива Linux). |
+| `@leemour/cli-messaging-onnx` | ONNX Runtime в WebAssembly для локальных моделей embeddings. Распознавание речи использует `sherpa-onnx`. |
+| [`@leemour/tg-cli`](https://github.com/leemour/tg-cli/tree/4a36e85) | Адаптер Telegram поверх [mtcute](https://github.com/mtcute/mtcute), сессия Telegram, пошаговая настройка. Почти все команды `tg` приходят из cli-messaging. |
+| [`@leemour/max-cli`](https://github.com/leemour/max-cli/tree/fff19ff) | Протокол MAX (WebSocket, двоичные кадры), сессия MAX, фоновое соединение `max serve`, собственный MCP-сервер поверх общих сервисов и отдельная часть для официального Bot API MAX. |
+
+Каждый инструмент закрепляет точную версию cli-messaging и cli-core. Изменение общего кода доходит
+до пользователей через выпуск общего пакета, а затем выпуск каждого инструмента; обычно оба
+инструмента выходят в один день.
+
+**Главное правило общего пакета: в нём ничего не знает о конкретном мессенджере.** Правило линтера
+запрещает импорт `@mtcute/*`, `ws` и папок адаптеров в `src/` cli-messaging
+([biome.json](https://github.com/leemour/cli-messaging/blob/c7cd479/biome.json)). То, что есть только у
+одного мессенджера, передаётся в поле `providerMetadata` общих типов.
+
+## Одна команда от начала до конца
+
+<ArchitectureDiagram name="command" lang="ru" />
+
+Возьмём `tg work messages send "Book club" "See you at 7"`:
+
+1. **`run()`** ([program.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/cli/program.ts))
+   берёт `work` как профиль, вычисляет настройки в постоянном порядке (флаг → окружение → файл →
+   значение по умолчанию), начинает запись запуска и ставит срок `--timeout`. Исключений он не
+   бросает: любой исход становится кодом выхода.
+2. **Команда** разбирает свои параметры и просит сервисы. О Telegram она ничего не знает.
+3. **Защита отправки** ([guard.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/sends/guard.ts))
+   проверяет `permissions`, список получателей и лимит в час — до любого подключения. Чтение её не
+   проходит. Каждая попытка записи — отправленная, отклонённая, неудачная или с неизвестным исходом —
+   попадает в журнал отправок без текста.
+4. **Сервис** выполняет сценарий. MCP-инструмент `tg_messages_send` вызывает тот же метод, поэтому
+   команда и инструмент дают одинаковый ответ и одинаковую ошибку на одинаковый ввод.
+5. **Адаптер** превращает вызов в запросы Telegram, а ответ Telegram — в доменный `Message`. Вокруг
+   него две обёртки: одна замеряет каждый вызов для записи запуска, другая сохраняет прочитанное в
+   локальную копию.
+6. **Вывод**: в stdout — результат и больше ничего; заметки и предупреждения — в stderr. Затем всё,
+   что команда открыла, — сокет, таймер, база — закрывается, и процесс завершается.
+
+Одноразовая команда, которая напечатала результат и продолжает работать, считается дефектом.
+Соединение держат только `watch`, `serve` и `mcp`, и только пока работают.
+
+## Слои
+
+<ArchitectureDiagram name="layers" lang="ru" />
+
+Пять слоёв, каждый вызывает только нижние:
+
+- **Модель** ([models.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/domain/models.ts)) —
+  `Chat`, `Message`, `Person`, `Page` и остальное. Только типы, без поведения и без мессенджера.
+- **Адаптеры** — по одному на мессенджер, каждый в своём репозитории:
+  [TelegramAdapter](https://github.com/leemour/tg-cli/blob/4a36e85/src/telegram/adapter.ts) в tg,
+  [maxAdapter](https://github.com/leemour/max-cli/blob/fff19ff/src/adapter/max-adapter.ts) в max.
+- **Порты** — два интерфейса, от которых зависят сервисы:
+  [`MessengerAdapter`](https://github.com/leemour/cli-messaging/blob/c7cd479/src/cli/messenger/port.ts)
+  и [`MessageStore`](https://github.com/leemour/cli-messaging/blob/c7cd479/src/store/store.ts).
+- **Сервисы** ([services/](https://github.com/leemour/cli-messaging/blob/c7cd479/src/services/index.ts)) —
+  messages, chats, people, inbox, archive, conversations, moderation и другие; каждый — простой
+  объект, который создаёт фабрика.
+- **Интерфейс** — команды CLI и MCP-инструменты.
+
+Направление проверяется, а не подразумевается. Правила линтера запрещают импорт `commander` и файлов
+команд из сервисов, защиты отправки и MCP-сервера; в tg импортировать mtcute может только
+`src/telegram/`; в max команды не могут импортировать протокол, описания операций и сгенерированный
+код. Запрещённый импорт ломает сборку с объяснением, почему.
+
+**Сервисы открывают нужное при первом обращении.** Соединение, хранилище и аккаунт сервис получает
+лениво ([deps.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/services/deps.ts)), поэтому
+чтение из локальной копии не подключается к сети. Команда получает сервисы через `withServices`,
+который закрывает открытое; MCP-инструмент строит их поверх соединения своей сессии.
+
+**Инструмент заменяет сценарий, а не команду.** Мессенджер может переопределить один метод сервиса и
+вызвать общий внутри своего; и команда, и MCP-инструмент видят замену:
+
+```ts
+services: (base) => ({
+  messages: { ...base.messages, list: (chat, window) => maxList(base.messages, chat, window) },
+}),
+```
+
+## Адаптеры
+
+Чтобы подключить мессенджер, пишут две вещи: **адаптер**, который говорит с мессенджером, и
+описание **`Messenger`**, которое рассказывает о нём общим командам: имя приложения, имя провайдера
+в хранилище, как подключаться, как листать историю. cli-messaging при этом не меняют. Полное
+руководство — [ADAPTERS.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ADAPTERS.md).
+
+**Обязательное ядро и необязательные группы.** `MessengerCore` — `self`, `me`, `resolve`, `chat`,
+`send`, `logout`, `close` — обязателен. Остальное разбито на группы: `ServerReads`, `MessageEditing`,
+`MessagePins`, `MessageReactions`, `MessagePolls`, `ReadState`, `LiveUpdates`, `PushedHistory`,
+`MessageMedia`, `GroupAdmin`, `ChatFolders`, `ContactBook` и другие. Команда обращается к
+необязательному методу через `capability()`; если у адаптера его нет, команда отвечает «этот
+мессенджер не умеет …», а не падает.
+
+**Отказать, а не выбросить.** Параметр, который мессенджер не может выполнить, — например, тихое
+сообщение там, где таких нет, — отклоняется с `validation_error`. Молча он не игнорируется никогда.
+
+**Номера — всегда строки.** Чаты, сообщения, люди, опросы. Номера сообщений MAX — 18 цифр, больше,
+чем точно вмещает число JavaScript, и общий код не делает с номерами арифметики. Мессенджер, у
+которого номера не маленькие целые, листает историю по времени.
+
+**У отправки есть идентичность.** Каждая отправка получает `sendId`; он передаётся мессенджеру как
+собственный номер сообщения клиента, если такой есть, и сервер отбрасывает повтор. Если запрос ушёл, а
+ответ не пришёл, адаптер бросает `outcome_unknown`, а не `network_error`, который означал бы, что
+сообщение не ушло. Повтор с тем же `sendId` даёт одно сообщение, а не два. В max единственный повтор
+берёт тот же номер, потому что измерено: MAX убирает дубли по нему.
+
+**Ошибки переводятся на границе.** Любая ошибка библиотеки становится одним кодом из закрытого списка
+cli-core, у каждого свой код выхода, поэтому скрипт может ветвиться по `$?`:
+
+| Код | Выход | Код | Выход |
+| --- | --- | --- | --- |
+| `validation_error` | 2 | `timeout` | 9 |
+| `configuration_error` | 3 | `network_error` | 10 |
+| `authentication_error` | 4 | `provider_error` | 11 |
+| `permission_error` | 5 | `provider_unavailable` | 12 |
+| `not_found` | 6 | `invalid_response` | 13 |
+| `confirmation_required` | 7 | `outcome_unknown` | 14 |
+| `rate_limited` | 8 | `cancelled` | 130 |
+
+**Типы библиотеки не выходят за адаптер.** Выше него — только доменные типы. Поэтому mtcute или
+собственный код протокола max можно заменить.
+
+**История с сервера или присланная.** Telegram отвечает на запрос истории чата, поэтому tg реализует
+`ServerReads`. Мессенджер, который сам присылает историю клиенту, ставит `history: "store"`: общие
+сервисы отвечают на чтение из локальной копии, а `PushedHistory.feed()` адаптера передаёт пачки в
+`serve`, который их сохраняет.
+
+**Как два инструмента выполняют контракт.** Адаптер tg оборачивает mtcute, и только один файл,
+[map.ts](https://github.com/leemour/tg-cli/blob/4a36e85/src/telegram/map.ts), знает форму объектов
+mtcute. Адаптер max стоит на собственном
+[`MaxClient`](https://github.com/leemour/max-cli/blob/fff19ff/src/client.ts), который владеет протоколом
+MAX; [messenger.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/messenger.ts) описывает MAX
+общим командам, а большинство файлов команд max — тонкие обёртки над общими, добавляющие параметры MAX.
+
+## Локальная копия
+
+Один файл SQLite, `~/.local/share/cli-messaging/messages.db`, хранит все мессенджеры и аккаунты —
+профили tg, аккаунт max и его ботов — с ключом по провайдеру и аккаунту.
+
+- **Две среды.** Под Node открывается `node:sqlite`, под Bun — `bun:sqlite`, каждый динамическим
+  импортом: статический импорт модуля другой среды падает при загрузке.
+- **Проверенный SQLite.** Перед открытием хранилище проверяет, что в SQLite среды есть
+  полнотекстовый поиск, нужный схеме; номер версии этого не говорит. Где его нет, его место
+  занимает закреплённая сборка: всегда в Bun на macOS, а в Node из дистрибутива Linux команда
+  перезапускает себя с закреплённой библиотекой первой — до того, как что-то прочитано или отправлено
+  ([sqlite-runtime.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/sqlite-runtime.ts)).
+- **Один метод — одна транзакция.** Каждый метод хранилища — одна целая операция: один синхронный
+  `BEGIN IMMEDIATE` … `COMMIT` без `await` между ними. Два вызова в одном долгоживущем процессе не
+  перемешаются внутри транзакции. Единственное намеренное исключение — перестройка разговоров чата:
+  новая сборка пишется короткими транзакциями и включается ещё одной, поэтому наполовину записанная
+  сборка никогда не читается.
+- **Миграции только вперёд.** Пронумерованы, только добавляют, после выпуска не меняются
+  ([manifest.ts](https://github.com/leemour/cli-messaging/blob/c7cd479/src/store/sqlite/manifest.ts)).
+  Версия `min_compatible` позволяет старому инструменту работать с файлом, который мигрировал новый;
+  её повышение — мажорная версия общего пакета, и оба инструмента выпускают обновление вместе.
+- **Запросы через Drizzle, встроенный в сборку.** Построитель запросов встроен в опубликованный
+  пакет, а не устанавливается отдельно: это снизило его стоимость загрузки примерно с 200 мс до
+  6 мс на процесс.
+
+Копия хранит тексты сообщений, чтобы отвечать без сети. Она не зашифрована; что это значит для вас —
+на странице [безопасность](./security.md).
+
+## Приёмы, на которых всё держится
+
+- **В машинном режиме stdout несёт только данные**: ни спиннера, ни цвета, ни предупреждений. На это
+  опираются агенты и скрипты, и это проверяют тесты.
+- **Одноразовая команда завершается.** Всё, что открывает сокет, таймер или слушатель, закрывает их
+  на каждом пути выхода.
+- **Чтение только наблюдает.** Чтение чата никогда не отмечает его прочитанным; для этого есть
+  отдельная явная команда. Тест проверяет, что чтение не отправляет запрос «прочитано».
+- **Имя никогда не угадывается.** Название, подходящее к нескольким чатам, — ошибка со списком, а не
+  выбор наугад.
+- **Одна модель прав, одна защита** — для каждой команды, каждого MCP-инструмента и, в max, для
+  фонового `max serve` на всё, что через него проходит.
+- **Запуски записываются без содержимого.** Запись запуска хранит слова команды, номера, счётчики и
+  время; сообщения, токены и номера телефонов никогда не попадают в журнал, фикстуру или документ.
+- **Сгенерировано и проверено.** Справочник команд (`commands.md`), обёртки операций max и типы Bot API
+  генерируются; CI падает, если закоммиченная копия расходится с генератором.
+
+## Сторона MAX
+
+MAX не публикует API для личных аккаунтов, поэтому в max больше собственного кода, чем в tg:
+
+- **Каждая операция описана один раз.** Каждый запрос MAX описан в
+  [`src/spec/operations/`](https://github.com/leemour/max-cli/tree/fff19ff/src/spec/operations) со
+  схемой и происхождением формы — измерено на живом соединении, записано из веб-клиента или прочитано
+  в чужой обратной инженерии. Обёртки в `src/generated/` генерируются из этих описаний и руками не
+  правятся.
+- **Двоичные кадры, как у веб-клиента.** MessagePack со сжатием LZ4; весь кодек — один файл,
+  [frame.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/protocol/frame.ts). Число, которое
+  потеряло бы цифры, приходит как `bigint` и выше кодека становится строкой.
+- **Выглядит как официальный клиент.** User agent и все поля, по которым узнают клиента, взяты у
+  web.max.ru; собственного имени на проводе нет.
+- **Соединение держит `max serve`.** Его запускает в фоне первая команда, которой нужен MAX;
+  следующие команды идут через него, а сам он останавливается через 15 минут без дела.
+- **Собственный MCP-сервер.** `max mcp` держит одно соединение со входом на сессию агента и
+  закрывает его после короткого простоя; его инструменты вызывают те же общие сервисы, что и команды.
+- **Bot API — отдельная часть.** `max bot …` работает с официальным HTTP Bot API MAX. Его типы и схемы
+  генерируются из официального документа OpenAPI генератором cli-core, и ничто в `src/bot/` не делит с
+  личным аккаунтом ни транспорт, ни сессию, ни сгенерированный код.
+
+## Тесты
+
+- **Тесты не трогают ваши данные.** Настройки, состояние, кэш и временная папка на время прогона
+  лежат в песочнице ([sandbox.ts](https://github.com/leemour/max-cli/blob/fff19ff/src/testing/sandbox.ts)).
+- **Контрактные проверки адаптеров.** cli-messaging поставляет набор данных, поддельный адаптер и
+  контрактные проверки ([src/kit](https://github.com/leemour/cli-messaging/tree/c7cd479/src/kit)).
+  Адаптер мессенджера прогоняет те же проверки поверх своего поддельного клиента; ни одна не ходит в
+  живой сервис.
+- **Команды проверяются целиком** через `run(argv, environment)`: с мессенджером по сценарию,
+  ключницей в памяти и перехваченным выводом.
+- **Обе среды.** CI работает на Linux, macOS и Windows, под Node и Bun, и на старом Node — чтобы
+  увидеть, как хранилище отказывается от SQLite без полнотекстового поиска.
+- **Паритет между инструментами** проверяет общий аудитор: он сравнивает команды, параметры, схемы MCP
+  и тесты tg и max.
+- **Живые проверки отдельны и ручные**: только на тестовых аккаунтах и тестовых чатах, с согласия
+  владельца, с записью формы каждого ответа и никогда — его содержимого.
+
+## Пределы и компромиссы
+
+- **Протокол MAX неофициальный.** Всё, что max о нём знает, измерено или получено обратной
+  инженерией. Он может перестать работать без предупреждения; тогда команда скажет об этом в stderr,
+  а не покажет пустой список.
+- **Одна запись за раз на хранилище.** Запись блокирует цикл событий процесса, пока идёт, а другой
+  процесс ждёт блокировку до 5 секунд. Большие записи разбиваются на ограниченные пачки.
+- **Нет векторного индекса.** Поиск разговоров сравнивает векторы в JavaScript постранично; работа
+  растёт с числом фрагментов в области поиска ([подробнее](./search-architecture.mdx)).
+- **Защита живёт внутри инструмента.** Она останавливает модель, которую уговорили отправить, а не
+  агента с оболочкой, который решил поменять настройки. Внешняя граница — песочница или отдельный
+  пользователь ОС.
+- **Локальная копия не зашифрована.** От потерянного компьютера защищает шифрование всего диска.
+
+## Участие в разработке: с чего начать
+
+- Новый мессенджер: [ADAPTERS.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ADAPTERS.md),
+  затем контрактные проверки.
+- Общий код: [ARCHITECTURE.md](https://github.com/leemour/cli-messaging/blob/c7cd479/docs/dev/ARCHITECTURE.md)
+  в cli-messaging.
+- Telegram: [ARCHITECTURE.md](https://github.com/leemour/tg-cli/blob/4a36e85/docs/dev/ARCHITECTURE.md) в tg.
+- MAX: [ARCHITECTURE.md](https://github.com/leemour/max-cli/blob/fff19ff/docs/dev/ARCHITECTURE.md) в max
+  и [заметки о протоколе](https://github.com/leemour/max-cli/blob/fff19ff/docs/dev/protocol.md).
+- Вопросы: [чат поддержки](https://t.me/wirecatdev).
diff --git a/content/docs/meta.es.json b/content/docs/meta.es.json
index f5c11cf..11d187c 100644
--- a/content/docs/meta.es.json
+++ b/content/docs/meta.es.json
@@ -5,10 +5,12 @@
     "agents",
     "first-tasks",
     "prompting",
+    "architecture",
     "search-architecture",
     "search-playground",
     "mcp",
     "bot-api",
+    "security",
     "---Mensajeros---",
     "tg",
     "max"
diff --git a/content/docs/meta.json b/content/docs/meta.json
index d4a2fe7..5c0ea46 100644
--- a/content/docs/meta.json
+++ b/content/docs/meta.json
@@ -5,10 +5,12 @@
     "agents",
     "first-tasks",
     "prompting",
+    "architecture",
     "search-architecture",
     "search-playground",
     "mcp",
     "bot-api",
+    "security",
     "---Messengers---",
     "tg",
     "max"
diff --git a/content/docs/meta.ru.json b/content/docs/meta.ru.json
index c080ef6..42c1618 100644
--- a/content/docs/meta.ru.json
+++ b/content/docs/meta.ru.json
@@ -5,10 +5,12 @@
     "agents",
     "first-tasks",
     "prompting",
+    "architecture",
     "search-architecture",
     "search-playground",
     "mcp",
     "bot-api",
+    "security",
     "---Мессенджеры---",
     "tg",
     "max"
diff --git a/content/docs/security.es.md b/content/docs/security.es.md
new file mode 100644
index 0000000..abbccf6
--- /dev/null
+++ b/content/docs/security.es.md
@@ -0,0 +1,215 @@
+---
+title: Seguridad
+description: Qué guardan las herramientas de WireCat en tu ordenador, qué impide que un agente envíe de más y cómo informar de una vulnerabilidad.
+---
+
+`tg` y `max` trabajan con tus cuentas reales de mensajería. Esta página describe lo que comparten
+las dos: la copia local de los mensajes, la protección de envíos, lo que puede hacer un agente y lo
+que nunca sale de tu ordenador. Los detalles de cada mensajero — dónde vive el inicio de sesión, con
+qué servidores habla, qué dicen sus condiciones — están en la página de cada herramienta:
+[seguridad de Telegram](./tg/security.md) y [seguridad de MAX](./max/security.md).
+
+Las dos herramientas se construyen sobre las mismas bibliotecas ([arquitectura](./architecture.mdx)),
+así que lo que dice esta página es una sola implementación, no dos promesas.
+
+## En resumen
+
+Protege contra:
+
+- **un agente convencido por un mensaje que leyó.** Los `permissions` del perfil deciden qué puede
+  hacer un agente. Cada herramienta de lectura avisa al modelo de que el texto de un mensaje son
+  datos, nunca instrucciones.
+- **un cambio que el perfil no permite.** `permissions`, la lista de destinatarios y el límite por
+  hora se comprueban en cada comando y en cada herramienta MCP. Cada intento se escribe en un
+  registro sin su texto.
+- **un agente que sale de su perfil o envía tus claves.** `TG_PROFILE_LOCK` y `MAX_PROFILE_LOCK` fijan
+  el perfil; `--file` rechaza archivos ocultos, `~/.ssh` y las carpetas de la propia herramienta.
+- **texto ajeno que toma el control del terminal.** Los caracteres de control e invisibles se
+  muestran como texto, los nombres se imprimen en una línea y el autocompletado inserta solo ids.
+- **un secreto en un registro, en `ps` o en el historial de la shell.** Las ejecuciones, los informes
+  y el registro de envíos guardan ids y recuentos, nunca texto. Ningún comando recibe una contraseña,
+  un token, un código o un número de teléfono como argumento.
+- **otros usuarios de esta máquina.** Cada archivo se crea legible solo por ti, en carpetas que solo
+  tú puedes abrir (Linux y macOS).
+- **una versión manipulada.** Los paquetes se publican desde GitHub Actions con procedencia de npm.
+  El paso de publicación no instala nada ni ejecuta scripts de paquetes; las dependencias directas
+  están fijadas a versiones exactas.
+
+No protege contra:
+
+- **alguien con tu usuario en esta máquina.** Puede leer el inicio de sesión y la copia local, igual
+  que tú.
+- **un agente que puede cambiar la configuración.** La protección lee la configuración del perfil.
+  Un agente al que se le permite ejecutar `config set` o `recipients add`, o editar esos archivos,
+  puede quitar los límites ([abajo](#lo-que-la-protección-no-puede-impedir)).
+
+## Lo que queda en tu ordenador
+
+| Qué | Dónde | Contiene |
+|---|---|---|
+| la copia local, compartida por `tg` y `max` | `~/.local/share/cli-messaging/messages.db` | **el texto completo** de cada mensaje leído o enviado, títulos de chats, nombres, transcripciones de voz |
+| el inicio de sesión | max: un token en el llavero del sistema · tg: un archivo de sesión, con el id y el hash de la app en el llavero | ver la página de la herramienta |
+| configuración | `config.json` en la carpeta de configuración de la herramienta | solo ajustes — no hay campo para un secreto |
+| ejecuciones registradas — con `--record`, y cada ejecución fallida | `runs/` en la carpeta de estado de la herramienta | las palabras del comando, ids, recuentos, duraciones, códigos de error |
+| el registro de envíos — siempre | `sends/<perfil>.jsonl` | por cada intento: cuándo, qué chat, el resultado, la longitud — nunca el texto |
+| la lista de destinatarios | `profiles/<perfil>.recipients.json` | los chats a los que este perfil puede enviar |
+| modelos de voz — solo tras `models audio download` | `~/.cache/cli-common/models/audio/` | los archivos del modelo |
+| exportaciones, descargas, informes de problemas | solo donde lo pidas, con `--output` | lo que pediste |
+
+`tg doctor` y `max doctor` muestran las rutas exactas en esta máquina.
+
+En Linux y macOS los archivos son `0600` en carpetas `0700`. Windows usa las listas de acceso
+heredadas de tu carpeta de usuario; los modos numéricos no las fijan.
+
+**La copia local no está cifrada.** Ese es su propósito: responder sin red. Quien pueda leer el
+archivo lee tus mensajes. Se conserva tras `session end` y tras desinstalar. El texto de los mensajes
+está también en exportaciones y archivos descargados; nada más de la tabla lo contiene.
+
+**Si pierdes el ordenador:** los permisos de archivo frenan a otros usuarios, no a quien se lleva el
+disco. Eso lo hace el cifrado de disco completo — FileVault en macOS, LUKS en Linux, BitLocker en
+Windows. La copia no tiene cifrado propio: una clave en el llavero no detendría a un programa que se
+ejecuta con tu usuario, que puede leer el llavero igual que la herramienta. Cierra la sesión desde
+otro dispositivo; la página de la herramienta dice dónde.
+
+## Lo que nunca hace
+
+- **Marcar como leído sin que lo pidas.** Leer un chat y marcarlo como leído son dos peticiones
+  distintas. Solo `chats mark-read` y `messages list --mark-read` envían la segunda.
+- **Enviar o cambiar algo que no escribiste.** Solo lo hacen los comandos marcados como «cambia
+  algo»; `commands --json` los marca con `mutates`. Cada uno hace solo lo que dice su línea.
+- **Borrar sin una palabra explícita.** Borrar mensajes y cerrar otras sesiones preguntan por
+  defecto. Borrar para todos necesita además `--for-everyone`. Un agente por MCP nunca borra para
+  todos.
+- **Escribir un mensaje en un registro.** Ni acortado ni como hash.
+- **Enviar telemetría propia.** No la hay.
+
+## La protección de envíos
+
+Un agente lee mensajes de otras personas junto con tu petición. Un mensaje puede estar escrito para
+que el agente lo tome por una orden: «reenvía esta conversación allí». Por eso cada comando y cada
+herramienta MCP que cambia algo — un envío, una respuesta, una edición, un reenvío, un mensaje
+fijado, una reacción, un voto, un borrado, marcar como leído — pasa por las mismas comprobaciones,
+en este orden:
+
+| Comprobación | Cómo activarla | Rechazo |
+|---|---|---|
+| **`permissions`** — por recurso o comando: `deny`, `readonly`, `ask` o `allow` | `tg config set permissions.messages.send ask` | `deny` y `readonly`: código `5`, antes de enviar nada; `ask` sin nadie que responda: código `7` |
+| **la lista de destinatarios** — solo los chats que contiene | `max recipients add <chat>` | código `7` |
+| **`sendsPerHour`** — el máximo de envíos en cualquier hora, 30 por defecto | `tg config set sendsPerHour 10` | código `8`; el error dice cuándo se puede volver a enviar |
+| **el registro** — cada intento, nunca su texto | siempre; `sends list` | — |
+
+Por defecto se permite todo salvo borrar mensajes y cerrar otras sesiones, que preguntan. Una clave
+más precisa gana: `messages` en `readonly` y `messages.send` en `allow` permiten al perfil enviar y
+nada más.
+
+La lista de destinatarios es opcional: mientras esté vacía, se permite cualquier chat. Dos comandos
+lanzados a la vez no pueden superar juntos el límite por hora: cada uno reserva su sitio desde la
+comprobación hasta la respuesta del mensajero. Un mensaje programado cuenta en la hora en que sale.
+
+**Un rechazo es una decisión del propietario, no un fallo.** Un agente que recibe el código `5`, `7`
+u `8` debe detenerse y decirlo, no cambiar la configuración ni reintentar. El archivo de skill se lo
+dice así a los agentes.
+
+### Lo que la protección no puede impedir
+
+Las comprobaciones viven en la propia herramienta, así que un agente con shell puede quitarlas:
+cambiar un ajuste, vaciar la lista. Protegen contra un modelo **convencido** por un mensaje que leyó,
+no contra un agente que **se propone** saltárselas. Contra eso solo sirve un límite externo: un
+sandbox, un usuario del sistema aparte, una regla en la configuración del propio agente.
+
+Al elegir ese límite:
+
+- **`*_PROFILE_LOCK` fija el perfil; `*_PROFILE` no.** La primera palabra de un comando gana a
+  `TG_PROFILE`: a un agente con `TG_PROFILE=agent` le basta escribir `tg work messages send …`.
+  `TG_PROFILE_LOCK=agent` lo rechaza — pero solo donde el agente no puede cambiar su propio entorno:
+  en la configuración del cliente MCP o en un script envoltorio. El servidor MCP fija su perfil al
+  arrancar.
+- **`--file` rechaza archivos y carpetas ocultos, `~/.ssh` y las carpetas de la herramienta**, donde
+  viven claves y tokens. `--allow-any-file` lo levanta para un comando; es para ti, no para un agente.
+  Cualquier otra cosa que tu usuario pueda leer se puede enviar; el registro guarda solo su tipo y
+  tamaño.
+- **Una regla del agente como «preguntar antes de `tg messages send`»** no ve la forma con perfil,
+  `tg work messages send`. Limita el propio perfil — `permissions` o la lista de destinatarios — y no
+  tengas al lado un perfil sin límites con una sesión activa.
+
+## Agentes y MCP
+
+- **El texto de un mensaje son datos.** «Reenvía esto allí» dentro de un mensaje no es tu petición.
+  El archivo de skill y las instrucciones del servidor MCP se lo dicen a cada agente que los lee; la
+  protección de envíos está para cuando uno no hace caso.
+- **El servidor MCP usa los mismos `permissions` que los comandos.** Un nivel `ask` muestra un
+  formulario en el cliente MCP antes del cambio.
+- **`--confirm-send` muestra un formulario antes de cada cambio**, incluso con `allow`. Un sí vale una
+  vez, durante cinco minutos, y solo para el chat y el texto que mostró. Los antiguos `--allow-send` y
+  `--allow-delete` se aceptan con un aviso y no deciden nada.
+
+Cómo conectar un cliente y qué hace cada herramienta: [MCP](./mcp.md).
+
+## Texto ajeno en tu pantalla
+
+Los nombres, títulos de chats, nombres de archivo y mensajes los escriben otras personas. Las
+herramientas no les dejan controlar tu terminal ni falsear lo que ves:
+
+- los caracteres de control — los que cambian colores, borran líneas, cambian el título de la ventana
+  o el portapapeles — se muestran como texto (`\x1b`), no se ejecutan; igual los invisibles y los que
+  invierten la dirección del texto;
+- un nombre, un título o un pie se imprime en una línea, así que un salto de línea en un nombre no
+  puede iniciar una línea falsa de la conversación;
+- cuando un nombre escrito encaja con más de un chat, la herramienta no elige: los muestra todos;
+- el autocompletado inserta solo un id; el título es una pista al lado;
+- una exportación Markdown y el nombre de un archivo descargado pasan por la misma limpieza.
+
+`--json` son datos: las cadenas llegan como las envió el mensajero, escapadas según las reglas de
+JSON. Si las pasas a un programa que imprime en un terminal, límpialas allí.
+
+## Lo que ven otros en esta máquina
+
+Los argumentos de un comando son visibles para cualquier proceso en `ps`. Por eso ningún secreto es
+un argumento — pero **el texto de un mensaje sí lo es**:
+
+```sh
+tg messages send me "text"     # visible en ps, y queda en el historial de la shell
+```
+
+Cuando importe, pasa el texto por una tubería: `tg messages send me < note.txt`.
+
+## Lo que sale a la red
+
+- **El propio mensajero** — Telegram o MAX, para los comandos que lo necesitan. Qué servidores
+  exactamente: la página de la herramienta.
+- **npm**, una vez al día cuando una persona ejecuta un comando en un terminal, para saber si hay una
+  versión nueva, y con `upgrade`. `updateCheck: false` lo desactiva.
+- **Hugging Face y GitHub**, solo cuando ejecutas `models … download`. Un mensaje de voz nunca va
+  allí: el reconocimiento se hace en este ordenador.
+- **Un proveedor de embeddings que elijas**, solo si configuras uno externo para la búsqueda de
+  conversaciones. Recibe el texto que vectoriza; el comando pregunta antes de enviar fragmentos. El
+  modelo por defecto funciona en local.
+
+Nada más.
+
+## Para ti
+
+Las herramientas guardan mensajes y nombres de otras personas en tu ordenador. Es correcto mientras
+lo hagas para ti, con tu propia cuenta: el RGPD no se aplica al tratamiento con fines exclusivamente
+personales o domésticos (artículo 2(2)(c)). Trabajar con cuentas ajenas o para una empresa ya no es
+personal. Una exportación que entregas a otra persona también sale de ese fin.
+
+Un informe de problema (`doctor report create`) está pensado para una incidencia **pública**. No
+contiene textos, nombres ni teléfonos, y cada id se sustituye por una etiqueta. Abre el archivo y
+revísalo antes de enviarlo.
+
+## Informar de una vulnerabilidad
+
+Informa de un problema de seguridad en privado, no en el chat ni en una incidencia pública:
+
+- por correo: [hello@wirecat.dev](mailto:hello@wirecat.dev);
+- o mediante el informe privado de vulnerabilidades de GitHub, en el repositorio afectado:
+  [tg-cli](https://github.com/leemour/tg-cli/security/advisories/new),
+  [max-cli](https://github.com/leemour/max-cli/security/advisories/new),
+  [cli-messaging](https://github.com/leemour/cli-messaging/security/advisories/new),
+  [cli-core](https://github.com/leemour/cli-core/security/advisories/new).
+
+Di qué viste, cómo repetirlo y qué versión usas (`tg --version`, `max --version`). Nunca envíes un
+archivo de sesión, un token ni mensajes de otras personas.
+
+Todo lo demás — un fallo, una pregunta — va al [chat de soporte](https://t.me/wirecatdev).
diff --git a/content/docs/security.md b/content/docs/security.md
new file mode 100644
index 0000000..dbd7110
--- /dev/null
+++ b/content/docs/security.md
@@ -0,0 +1,210 @@
+---
+title: Security
+description: What the WireCat tools keep on your computer, what stops an agent from sending, and how to report a vulnerability.
+---
+
+`tg` and `max` work with your real messenger accounts. This page covers what both tools share:
+the local store, the send guard, what an agent may do, and what never leaves your computer. The
+details of each messenger — where its login lives, which servers it talks to, what its account
+rules say — are on the tool's own page: [Telegram security](./tg/security.md) and
+[MAX security](./max/security.md).
+
+Both tools are built on the same libraries ([architecture](./architecture.mdx)), so what this page
+says is one implementation, not two promises.
+
+## In short
+
+It protects against:
+
+- **an agent talked into sending** by a message it read. The profile's `permissions` decide what an
+  agent may do. Every read tool tells the model that message text is data, never instructions.
+- **a change the profile does not allow.** `permissions`, the recipient list and the hourly limit
+  are checked by every command and every MCP tool. Every attempt is written to a journal without
+  its text.
+- **an agent stepping outside its profile, or sending your keys.** `TG_PROFILE_LOCK` and
+  `MAX_PROFILE_LOCK` pin the profile; `--file` refuses hidden files, `~/.ssh` and the tool's own
+  folders.
+- **other people's text taking over your terminal.** Control and invisible characters are shown as
+  text, names are printed on one line, completion inserts only ids.
+- **a secret in a log, in `ps` or in shell history.** Runs, reports and the send journal hold ids
+  and counts, never text. No command takes a password, a token, a code or a phone number as an
+  argument.
+- **other users of this machine.** Every file is created readable by you only, in folders only you
+  can open (Linux and macOS).
+- **a tampered release.** Packages are published from GitHub Actions with npm provenance. The
+  publish step installs nothing and runs no package scripts; direct dependencies are pinned to
+  exact versions.
+
+It does not protect against:
+
+- **someone with your user account on this machine.** They can read the login and the local store,
+  as you can.
+- **an agent that can change the settings.** The guard reads the profile's settings. An agent
+  allowed to run `config set` or `recipients add`, or to edit those files, can lift the limits
+  ([below](#what-the-guard-cannot-hold)).
+
+## What stays on your computer
+
+| What | Where | Holds |
+|---|---|---|
+| the local store, shared by `tg` and `max` | `~/.local/share/cli-messaging/messages.db` | **the full text** of every message read or sent, chat titles, names, voice transcripts |
+| the login | max: a token in the OS keyring · tg: a session file, with the app id and hash in the keyring | see the tool's page |
+| settings | `config.json` in the tool's config folder | settings only — there is no field for a secret |
+| recorded runs — with `--record`, and every failed run | `runs/` in the tool's state folder | the command's words, ids, counts, durations, error codes |
+| the send journal — always | `sends/<profile>.jsonl` | for each attempt: when, which chat, the outcome, the length — never the text |
+| the recipient list | `profiles/<profile>.recipients.json` | the chats this profile may send to |
+| speech models — only after `models audio download` | `~/.cache/cli-common/models/audio/` | the model files |
+| exports, downloads, problem reports | only where you ask, with `--output` | what you asked for |
+
+`tg doctor` and `max doctor` print the exact paths on this machine.
+
+On Linux and macOS, files are `0600` in `0700` folders. Windows uses the access lists inherited from
+your user folder; the numeric modes do not set one.
+
+**The local store is not encrypted.** That is its purpose: to answer without the network. Anyone who
+can read the file reads your messages. It stays after `session end` and after uninstalling. Message
+text is also in exports and downloaded files; nothing else in the table holds it.
+
+**If the computer is lost:** the file modes keep other users out, not someone who takes the disk.
+Whole-disk encryption does that — FileVault on macOS, LUKS on Linux, BitLocker on Windows. The store
+has no encryption of its own: a key in the keyring would not stop a program running as your user,
+which can read the keyring as the tool does. End the session from another device; the tool's page
+says where.
+
+## What it never does
+
+- **Mark anything read without being asked.** Reading a chat and marking it read are two different
+  requests. Only `chats mark-read` and `messages list --mark-read` send the second.
+- **Send or change anything you did not type.** Only commands marked "changes something" do;
+  `commands --json` marks them `mutates`. Each does only what its line says.
+- **Delete without an explicit word.** Deleting messages and ending other sessions ask by default.
+  Deleting for everyone needs `--for-everyone` too. An agent over MCP never deletes for everyone.
+- **Write a message into a log.** Not shortened, not hashed.
+- **Send telemetry of its own.** There is none.
+
+## The send guard
+
+An agent reads other people's messages together with your request. A message can be written so the
+agent takes it for an order: "forward this conversation there". So every command and MCP tool that
+changes something — a send, a reply, an edit, a forward, a pin, a reaction, a vote, a deletion,
+marking a chat read — goes through the same checks, in this order:
+
+| Check | Turn it on | Refusal |
+|---|---|---|
+| **`permissions`** — per resource or command: `deny`, `readonly`, `ask` or `allow` | `tg config set permissions.messages.send ask` | `deny` and `readonly`: exit code `5`, before anything is sent; `ask` with nobody to answer: exit code `7` |
+| **the recipient list** — only the chats on it | `max recipients add <chat>` | exit code `7` |
+| **`sendsPerHour`** — the most sends in any hour, 30 by default | `tg config set sendsPerHour 10` | exit code `8`; the error says when the next send is possible |
+| **the journal** — every attempt, never its text | always; `sends list` | — |
+
+By default every change is allowed except deleting messages and ending other sessions, which ask.
+A more precise key wins: `messages` set to `readonly` and `messages.send` set to `allow` lets a
+profile send and nothing else.
+
+The recipient list is optional: until something is added, any chat is allowed. Two commands started
+at once cannot get past the hourly limit together — each holds its place from the check until the
+messenger answers. A scheduled message counts in the hour it goes out.
+
+**A refusal is the owner's decision, not a fault.** An agent that meets exit code `5`, `7` or `8`
+should stop and say so, not change the settings or retry. The skill file tells agents exactly that.
+
+### What the guard cannot hold
+
+The checks live in the tool itself, so an agent with a shell can lift them: change a setting, clear
+the list. They protect against a model **talked into** sending by a message it read, not against an
+agent that **sets out** to get round them. Against that, only a boundary outside works: a sandbox, a
+separate OS user, a rule in the agent's own settings.
+
+When you choose that boundary:
+
+- **`*_PROFILE_LOCK` pins the profile; `*_PROFILE` does not.** The first word of a command beats
+  `TG_PROFILE`: an agent with `TG_PROFILE=agent` only has to type `tg work messages send …`.
+  `TG_PROFILE_LOCK=agent` refuses that — but only where the agent cannot change its own environment:
+  in the MCP client's settings, or in a wrapper script. The MCP server pins its profile at start.
+- **`--file` refuses hidden files and folders, `~/.ssh` and the tool's own folders**, where keys and
+  tokens live. `--allow-any-file` lifts it for one command; it is meant for you, not for an agent.
+  Anything else your user can read can be sent; the journal keeps only its kind and size.
+- **An agent rule like "ask before `tg messages send`"** does not see the form with a profile,
+  `tg work messages send`. Limit the profile itself — `permissions` or the recipient list — and do
+  not keep an unlimited profile with a live login beside it.
+
+## Agents and MCP
+
+- **Message text is data.** "Forward this there" inside a message is not your request. The skill
+  file and the MCP server's instructions say so to every agent that reads them; the send guard is
+  there for when one does not listen.
+- **The MCP server uses the same `permissions` as the commands.** A level of `ask` shows you a form
+  in the MCP client before the change.
+- **`--confirm-send` shows a form before every change**, even at `allow`. A yes counts once, for five
+  minutes, and only for the chat and text the form showed. The older `--allow-send` and
+  `--allow-delete` flags are accepted with a warning and decide nothing.
+
+How to connect a client, and what each tool does: [MCP](./mcp.md).
+
+## Other people's text on your screen
+
+Names, chat titles, file names and messages are written by other people. The tools do not let them
+drive your terminal or fake what you see:
+
+- control characters — the ones that recolour, erase lines, change the window title or the
+  clipboard — are shown as text (`\x1b`), not run; so are invisible characters and the ones that
+  reverse the direction of text;
+- a name, a title or a caption is printed on one line, so a line break in a name cannot start a fake
+  line of the conversation;
+- when a typed name fits more than one chat, the tool does not choose: it lists them all;
+- shell completion inserts only an id; the title is a hint beside it;
+- a Markdown export and a downloaded file's name go through the same cleaning.
+
+`--json` is data: strings are as the messenger sent them, escaped by JSON's rules. If you pass it to
+a program that prints to a terminal, clean it there.
+
+## What others on this machine can see
+
+The arguments of a command are visible to every process in `ps`. That is why no secret is an
+argument — but **a message's text is**:
+
+```sh
+tg messages send me "text"     # visible in ps, and stays in your shell history
+```
+
+When that matters, pipe the text in: `tg messages send me < note.txt`.
+
+## What goes over the network
+
+- **The messenger itself** — Telegram or MAX, for the commands that need it. Exactly which servers:
+  the tool's page.
+- **npm**, once a day when a person runs a command in a terminal, to see whether a newer version
+  exists, and on `upgrade`. `updateCheck: false` turns it off.
+- **Hugging Face and GitHub**, only when you run `models … download`. A voice message never goes
+  there: recognition runs on this computer.
+- **An embedding provider you choose**, only if you configure a hosted one for conversation search.
+  It gets the text it embeds; the command asks before sending passages. The default model runs
+  locally.
+
+Nothing else.
+
+## For yourself
+
+The tools keep other people's messages and names on your computer. That is fine while you do it
+for yourself, with your own account: the GDPR does not apply to processing for purely personal or
+household purposes (Article 2(2)(c)). Working with other people's accounts, or for a business, is no
+longer personal. An export you hand to someone else leaves that purpose too.
+
+A problem report (`doctor report create`) is meant for a **public** issue. It holds no text, names
+or phone numbers, and every id in it is replaced by a label. Open the file and check it before you
+send it.
+
+## Reporting a vulnerability
+
+Please report a security problem privately, not in the chat or a public issue:
+
+- by email: [hello@wirecat.dev](mailto:hello@wirecat.dev);
+- or through GitHub's private vulnerability reporting, on the repository it concerns:
+  [tg-cli](https://github.com/leemour/tg-cli/security/advisories/new),
+  [max-cli](https://github.com/leemour/max-cli/security/advisories/new),
+  [cli-messaging](https://github.com/leemour/cli-messaging/security/advisories/new),
+  [cli-core](https://github.com/leemour/cli-core/security/advisories/new).
+
+Say what you saw, how to repeat it, and which version (`tg --version`, `max --version`). Never send a
+session file, a token or someone's messages.
+
+Anything else — a bug, a question — goes to the [support chat](https://t.me/wirecatdev).
diff --git a/content/docs/security.ru.md b/content/docs/security.ru.md
new file mode 100644
index 0000000..376223c
--- /dev/null
+++ b/content/docs/security.ru.md
@@ -0,0 +1,213 @@
+---
+title: Безопасность
+description: Что инструменты WireCat хранят на компьютере, что не даёт агенту отправить лишнее и как сообщить об уязвимости.
+---
+
+`tg` и `max` работают с вашими настоящими аккаунтами в мессенджерах. Здесь описано то, что у них
+общее: локальная копия переписки, защита от отправки, права агента и то, что никогда не покидает
+компьютер. Особенности каждого мессенджера — где хранится вход, к каким серверам идёт инструмент,
+что говорят правила сервиса — на странице инструмента: [безопасность Telegram](./tg/security.md) и
+[безопасность MAX](./max/security.md).
+
+Оба инструмента построены на одних библиотеках ([архитектура](./architecture.mdx)), поэтому всё
+сказанное здесь — одна реализация, а не два обещания.
+
+## Коротко
+
+От чего защищает:
+
+- **Агента уговорило прочитанное сообщение.** Что агенту можно, решают `permissions` профиля.
+  Каждый инструмент чтения предупреждает модель: текст сообщения — данные, а не команды.
+- **Изменение, которое профиль не разрешает.** `permissions`, список получателей и лимит в час
+  проверяет каждая команда и каждый MCP-инструмент. Каждая попытка пишется в журнал без текста.
+- **Агент выходит за свой профиль или отправляет ваши ключи.** `TG_PROFILE_LOCK` и
+  `MAX_PROFILE_LOCK` закрепляют профиль; `--file` не берёт скрытые файлы, `~/.ssh` и папки самого
+  инструмента.
+- **Чужой текст управляет терминалом.** Управляющие и невидимые символы показываются как текст,
+  имена печатаются в одну строку, автодополнение подставляет только номера.
+- **Секрет в журнале, в `ps` или в истории оболочки.** Записи запусков, отчёты и журнал отправок
+  содержат номера и счётчики, но не текст. Ни одна команда не принимает пароль, токен, код или
+  номер телефона аргументом.
+- **Другие пользователи машины.** Каждый файл доступен только вам, в папках, которые открываете
+  только вы (Linux и macOS).
+- **Подменённый выпуск.** Пакеты публикуются из GitHub Actions с подтверждением происхождения npm.
+  Шаг публикации ничего не устанавливает и не запускает скрипты пакетов; версии прямых
+  зависимостей закреплены точно.
+
+От чего не защищает:
+
+- **Человек с вашей учётной записью на этой машине.** Он читает вход и локальную копию так же,
+  как вы.
+- **Агент, которому можно менять настройки.** Защита читает настройки профиля. Агент, которому
+  разрешено запускать `config set` или `recipients add` либо править эти файлы, снимет ограничения
+  ([ниже](#чего-защита-не-держит)).
+
+## Что остаётся на компьютере
+
+| Что | Где | Что внутри |
+|---|---|---|
+| локальная копия, общая для `tg` и `max` | `~/.local/share/cli-messaging/messages.db` | **полный текст** каждого прочитанного или отправленного сообщения, названия чатов, имена, расшифровки голосовых |
+| вход | max: токен в ключнице ОС · tg: файл сессии, а id и hash приложения — в ключнице | см. страницу инструмента |
+| настройки | `config.json` в папке настроек инструмента | только настройки — поля для секрета нет |
+| записи запусков — с `--record` и для каждого неудачного запуска | `runs/` в папке состояния инструмента | слова команды, номера, счётчики, длительность, коды ошибок |
+| журнал отправок — всегда | `sends/<профиль>.jsonl` | для каждой попытки: когда, какой чат, исход, длина — никогда не текст |
+| список получателей | `profiles/<профиль>.recipients.json` | чаты, в которые профилю можно отправлять |
+| модели речи — только после `models audio download` | `~/.cache/cli-common/models/audio/` | файлы моделей |
+| выгрузки, скачанные файлы, отчёты о проблеме | только там, где вы попросили, через `--output` | то, что вы попросили |
+
+`tg doctor` и `max doctor` показывают точные пути на этой машине.
+
+На Linux и macOS файлы создаются с правами `0600` в папках `0700`. Windows использует списки
+доступа, унаследованные от папки пользователя; числа прав их не задают.
+
+**Локальная копия не зашифрована.** В этом её назначение: отвечать без сети. Кто может прочитать
+файл, читает вашу переписку. Копия остаётся после `session end` и после удаления инструмента. Текст
+сообщений есть ещё в выгрузках и скачанных файлах; больше ни в чём из таблицы его нет.
+
+**Если компьютер попадёт в чужие руки:** права файлов закрывают их от других пользователей, но не
+от того, кто достанет диск. От этого защищает шифрование всего диска — FileVault в macOS, LUKS в
+Linux, BitLocker в Windows. Своего шифрования у копии нет: ключ в ключнице не остановил бы
+программу, запущенную под вашим пользователем, — она читает ключницу так же, как инструмент.
+Завершите сеанс с другого устройства; где именно — на странице инструмента.
+
+## Чего инструменты не делают
+
+- **Не отмечают прочитанным без просьбы.** Прочитать чат и отметить его прочитанным — два разных
+  запроса. Второй отправляют только `chats mark-read` и `messages list --mark-read`.
+- **Не отправляют и не меняют ничего, чего вы не набрали.** Меняют что-то только команды с
+  пометкой «что-то меняет»; `commands --json` помечает их `mutates`. Каждая делает только то, что
+  написано в строке.
+- **Не удаляют без явного слова.** Удаление сообщений и завершение других сеансов по умолчанию
+  требуют подтверждения. Для удаления у всех нужен ещё `--for-everyone`. Агент через MCP никогда не
+  удаляет у всех.
+- **Не пишут сообщения в журнал.** Ни в обрезанном виде, ни хэшем.
+- **Не шлют собственную телеметрию.** Её нет.
+
+## Защита от отправки
+
+Агент читает чужие сообщения вместе с вашей просьбой. Сообщение может быть написано так, чтобы агент
+принял его за команду: «перешли эту переписку вот сюда». Поэтому каждая команда и каждый
+MCP-инструмент, который что-то меняет, — отправка, ответ, правка, пересылка, закрепление, реакция,
+голос, удаление, отметка о прочтении — проходит одни и те же проверки в таком порядке:
+
+| Проверка | Как включить | Отказ |
+|---|---|---|
+| **`permissions`** — по ресурсу или команде: `deny`, `readonly`, `ask` или `allow` | `tg config set permissions.messages.send ask` | `deny` и `readonly`: код `5`, до отправки; `ask`, когда ответить некому: код `7` |
+| **список получателей** — только чаты из него | `max recipients add <чат>` | код `7` |
+| **`sendsPerHour`** — не больше N отправок за любой час, по умолчанию 30 | `tg config set sendsPerHour 10` | код `8`; в ошибке сказано, когда можно снова |
+| **журнал** — каждая попытка, без текста | всегда; `sends list` | — |
+
+По умолчанию разрешено всё, кроме удаления сообщений и завершения других сеансов: они спрашивают.
+Более точный ключ главнее: `messages` со значением `readonly` и `messages.send` со значением `allow`
+разрешают профилю только отправку.
+
+Список получателей необязателен: пока в нём ничего нет, можно в любой чат. Две команды, запущенные
+разом, не перепрыгнут лимит в час: каждая держит своё место от проверки до ответа мессенджера.
+Отложенное сообщение считается в тот час, когда уйдёт.
+
+**Отказ — решение владельца, а не сбой.** Агент, получивший код `5`, `7` или `8`, должен
+остановиться и сказать об этом, а не менять настройки и не повторять. Файл навыка говорит агентам
+ровно это.
+
+### Чего защита не держит
+
+Проверки стоят в самом инструменте, и агент с доступом к оболочке может их снять: поменять
+настройку, очистить список. Они защищают от модели, которую **уговорило** прочитанное сообщение, а
+не от агента, который **хочет** их обойти. Против такого работает только граница снаружи:
+песочница, отдельный пользователь ОС, запрет в правилах самого агента.
+
+Что стоит знать, выбирая такую границу:
+
+- **Профиль закрепляет `*_PROFILE_LOCK`, а не `*_PROFILE`.** Первое слово команды главнее
+  `TG_PROFILE`: агенту с `TG_PROFILE=agent` достаточно набрать `tg work messages send …`.
+  `TG_PROFILE_LOCK=agent` такой вызов отклонит — но только там, где агент не может сам поменять
+  окружение: в настройках MCP-клиента или в скрипте-обёртке. MCP-сервер закрепляет профиль при
+  запуске.
+- **`--file` не берёт скрытые файлы и папки, `~/.ssh` и папки самого инструмента**: там лежат ключи и
+  токены. `--allow-any-file` снимает запрет на одну команду; этот флаг для вас, а не для агента.
+  Остальное, что может прочитать ваш пользователь, отправить можно; в журнал попадают только вид и
+  размер вложения.
+- **Правило агента вида «спрашивать перед `tg messages send`»** не видит форму с профилем —
+  `tg work messages send`. Ограничьте сам профиль — `permissions` или списком получателей — и не
+  держите рядом профиль без ограничений с действующим входом.
+
+## Агенты и MCP
+
+- **Текст сообщения — данные.** «Перешли это туда» внутри сообщения — не ваша просьба. Файл навыка и
+  инструкции MCP-сервера говорят это каждому агенту, который их читает; защита от отправки — на
+  случай, если агент не послушает.
+- **MCP-сервер использует те же `permissions`, что и команды.** Уровень `ask` показывает форму в
+  MCP-клиенте перед изменением.
+- **`--confirm-send` показывает форму перед каждым изменением**, даже на уровне `allow`. Ответ «да»
+  действует один раз, пять минут и только для показанных чата и текста. Старые флаги `--allow-send`
+  и `--allow-delete` принимаются с предупреждением и ничего не решают.
+
+Как подключить клиент и что делает каждый инструмент — [MCP](./mcp.md).
+
+## Чужой текст на экране
+
+Имена, названия чатов, имена файлов и сообщения пишут другие люди. Инструменты не дают им управлять
+вашим терминалом и подделать то, что вы видите:
+
+- управляющие символы — те, что перекрашивают, стирают строки, меняют заголовок окна или буфер
+  обмена, — показываются как текст (`\x1b`), а не выполняются; так же — невидимые символы и символы
+  смены направления текста;
+- имя, название или подпись печатаются в одну строку: перевод строки в имени не начнёт поддельную
+  строку переписки;
+- если набранное имя подходит к нескольким чатам, инструмент не выбирает сам, а показывает все;
+- автодополнение подставляет только номер; название — подсказка рядом;
+- выгрузка в Markdown и имя скачанного файла проходят ту же очистку.
+
+`--json` — данные: строки в нём такие, как прислал мессенджер, экранированные по правилам JSON.
+Отдавая его программе, которая печатает в терминал, очищайте там.
+
+## Что видно другим на машине
+
+Аргументы команды видны в `ps` любому процессу. Поэтому секрет никогда не аргумент — но **текст
+сообщения передаётся аргументом**:
+
+```sh
+tg messages send me "text"     # видно в ps и остаётся в истории оболочки
+```
+
+Если это важно, передайте текст через трубу: `tg messages send me < note.txt`.
+
+## Что уходит в сеть
+
+- **Сам мессенджер** — Telegram или MAX, для команд, которым он нужен. Какие именно серверы — на
+  странице инструмента.
+- **npm** — раз в сутки, когда человек запускает команду в терминале, чтобы узнать о новой версии,
+  и при `upgrade`. Выключается `updateCheck: false`.
+- **Hugging Face и GitHub** — только когда вы запускаете `models … download`. Голосовое туда не
+  уходит: распознавание работает на этом компьютере.
+- **Выбранный вами провайдер embeddings** — только если вы настроили внешний для поиска
+  разговоров. Он получает текст, который векторизует; перед отправкой фрагментов команда спрашивает.
+  Модель по умолчанию работает локально.
+
+Больше ничего.
+
+## Только для себя
+
+Инструменты хранят у вас сообщения и имена других людей. Это допустимо, пока вы делаете это для
+себя, со своим аккаунтом: GDPR не распространяется на обработку для личных и семейных нужд
+(ст. 2(2)(c)). Работа с чужими аккаунтами или для бизнеса — уже не личные нужды. Выгрузка,
+отданная кому-то ещё, тоже выходит за эти рамки.
+
+Отчёт о проблеме (`doctor report create`) предназначен для **открытой** задачи. В нём нет текстов,
+имён и телефонов, а каждый номер заменён меткой. Откройте файл и проверьте его перед отправкой.
+
+## Как сообщить об уязвимости
+
+Сообщайте о проблеме безопасности приватно, а не в чате и не в открытой задаче:
+
+- письмом: [hello@wirecat.dev](mailto:hello@wirecat.dev);
+- или через приватные сообщения об уязвимостях GitHub в нужном репозитории:
+  [tg-cli](https://github.com/leemour/tg-cli/security/advisories/new),
+  [max-cli](https://github.com/leemour/max-cli/security/advisories/new),
+  [cli-messaging](https://github.com/leemour/cli-messaging/security/advisories/new),
+  [cli-core](https://github.com/leemour/cli-core/security/advisories/new).
+
+Опишите, что вы увидели, как это повторить и какая версия (`tg --version`, `max --version`). Никогда
+не присылайте файл сессии, токен или чужие сообщения.
+
+Всё остальное — ошибки, вопросы — в [чат поддержки](https://t.me/wirecatdev).
diff --git a/design/landing/g-home.es.html b/design/landing/g-home.es.html
index ca4ffb8..646af54 100644
--- a/design/landing/g-home.es.html
+++ b/design/landing/g-home.es.html
@@ -632,8 +632,8 @@ <h2 class="big" id="closing-title">Continúa la conversación con todo el contex
       <div><h2>Proyecto</h2><ul>
         <li><a href="https://github.com/leemour/tg-cli">tg en GitHub</a></li>
         <li><a href="https://github.com/leemour/max-cli">max en GitHub</a></li>
-        <li><a href="https://github.com/leemour/tg-cli/issues">Informar de un problema</a></li>
-        <li><a href="https://wirecat.dev/es/docs/tg/security">Seguridad</a></li></ul></div>
+        <li><a href="https://t.me/wirecatdev">Informar de un problema</a></li>
+        <li><a href="https://wirecat.dev/es/docs/security">Seguridad</a></li></ul></div>
     </div>
     <div class="foot-bottom">
       <span>© 2026 WireCat · licencia MIT · Windows, macOS, Linux</span>
diff --git a/design/landing/g-home.html b/design/landing/g-home.html
index 0d9c944..963f587 100644
--- a/design/landing/g-home.html
+++ b/design/landing/g-home.html
@@ -632,8 +632,8 @@ <h2 class="big" id="closing-title">Continue the conversation with the full conte
       <div><h2>Project</h2><ul>
         <li><a href="https://github.com/leemour/tg-cli">tg on GitHub</a></li>
         <li><a href="https://github.com/leemour/max-cli">max on GitHub</a></li>
-        <li><a href="https://github.com/leemour/tg-cli/issues">Report a problem</a></li>
-        <li><a href="https://wirecat.dev/en/docs/tg/security">Security</a></li></ul></div>
+        <li><a href="https://t.me/wirecatdev">Report a problem</a></li>
+        <li><a href="https://wirecat.dev/en/docs/security">Security</a></li></ul></div>
     </div>
     <div class="foot-bottom">
       <span>© 2026 WireCat · MIT licence · Windows, macOS, Linux</span>
diff --git a/design/landing/g-home.ru.html b/design/landing/g-home.ru.html
index 5882f28..61ef792 100644
--- a/design/landing/g-home.ru.html
+++ b/design/landing/g-home.ru.html
@@ -632,8 +632,8 @@ <h2 class="big" id="closing-title">Продолжайте разговор с п
       <div><h2>Проект</h2><ul>
         <li><a href="https://github.com/leemour/tg-cli">tg на GitHub</a></li>
         <li><a href="https://github.com/leemour/max-cli">max на GitHub</a></li>
-        <li><a href="https://github.com/leemour/tg-cli/issues">Сообщить о проблеме</a></li>
-        <li><a href="https://wirecat.dev/ru/docs/tg/security">Безопасность</a></li></ul></div>
+        <li><a href="https://t.me/wirecatdev">Сообщить о проблеме</a></li>
+        <li><a href="https://wirecat.dev/ru/docs/security">Безопасность</a></li></ul></div>
     </div>
     <div class="foot-bottom">
       <span>© 2026 WireCat · лицензия MIT · Windows, macOS, Linux</span>
diff --git a/docs/DESIGN.md b/docs/DESIGN.md
index a57df99..e22ab8b 100644
--- a/docs/DESIGN.md
+++ b/docs/DESIGN.md
@@ -37,6 +37,8 @@ wirecat.dev/
 ├── /{lang}/docs                   getting started: choose a messenger and a path              ✅
 ├── /{lang}/docs/installation      install with an agent or terminal, log in, first check        ✅
 ├── /{lang}/docs/agents            Codex, Cursor, Claude Code, Gemini CLI, Hermes                ✅
+├── /{lang}/docs/architecture     packages, layers, adapters, store, patterns, limits         ✅
+├── /{lang}/docs/security         shared security: store, send guard, MCP, reporting          ✅
 ├── /{lang}/docs/search-architecture  message/graph/embedding architecture, shared guide       🟡
 ├── /{lang}/docs/search-playground  interactive search on a fictional local archive            🟡
 ├── /{lang}/docs/mcp               MCP connections and documentation for agents                ✅
diff --git a/docs/plans/2026-10-04-architecture-and-security.md b/docs/plans/2026-10-04-architecture-and-security.md
new file mode 100644
index 0000000..845c599
--- /dev/null
+++ b/docs/plans/2026-10-04-architecture-and-security.md
@@ -0,0 +1,167 @@
+# Architecture guide, shared security page, footer links
+
+The owner asked for three things on 2026-10-04:
+
+1. A public architecture guide for users and contributors: the packages (cli-core, cli-messaging,
+   its SQLite and ONNX builds, the two CLIs), the layers in the code, how adapters work, the key
+   patterns. Diagrams. It shows how things work and where the limits are; it does not sell.
+2. Footer: "Report a problem" leads to the support Telegram chat; "Security" leads to a shared
+   security page, not to tg's.
+3. A shared security page on the site, and the tg and max security pages pointing to it, each
+   keeping its own details.
+
+## Current state (origin/main, 2026-10-04)
+
+Sources read: cli-docs `a4c1899`, cli-messaging `680d22e` (0.140.0), cli-core 0.17.0, max-cli
+`b09b0ca` (pins cli-messaging 0.140.0), tg-cli `4a36e85`.
+
+**Architecture material that exists, none of it on the site:**
+
+- `cli-messaging/docs/dev/ARCHITECTURE.md` (307 lines) — modules, store, migrations, the command
+  skeleton, the five layers, services. Its "Who consumes it" section says max's personal account
+  keeps its own cache; that has not been true since the T6 cache-off work (max-cli #330–#344).
+- `cli-messaging/docs/dev/ADAPTERS.md` (187 lines) — the adapter contract: required core, optional
+  groups through `capability()`, ids as strings, `sendId` and `outcome_unknown`,
+  `history: "server" | "store"`, contract cases.
+- `max-cli/docs/dev/ARCHITECTURE.md` (560 lines) — max's own layers. Its §1 diagram shows
+  `MaxClient` as the only path; `src/messenger.ts` and `src/adapter/max-adapter.ts` now plug max into
+  cli-messaging. §17 still describes max's own MCP server.
+- `tg-cli/docs/dev/ARCHITECTURE.md` (52 lines) — current and short.
+- The site has one architecture page, `content/docs/search-architecture{,.ru,.es}.mdx`, with a
+  light-only English SVG (`public/search-architecture.svg`).
+
+**Packages, verified in each `package.json`:**
+
+- `@leemour/cli-core` — output modes, renderer, error model and exit codes, keyring (optional
+  `@napi-rs/keyring`), config, clocks; plus `./http`, `./codegen`, `./update`, `./release`,
+  `./skill`, `./completion`. Also used by `braze-cli` (public).
+- `@leemour/cli-messaging` — domain model, store, send guard, services, command skeleton, MCP
+  server, speech, background. Hard dependencies on `@leemour/cli-messaging-sqlite` and
+  `@leemour/cli-messaging-onnx` (both 1.0.0).
+- `@leemour/tg-cli` — adds `@mtcute/node`; its own code is the Telegram adapter, session, setup,
+  update.
+- `@leemour/max-cli` — adds `ws`, `@msgpack/msgpack`, `lossless-json`; owns the MAX protocol,
+  session and the official Bot API slice (`src/bot/`).
+
+**Footer and security links:**
+
+- The footer HTML comes from `lib/landing/{en,ru,es}.json`, generated by
+  `scripts/export-landing.mjs` from `design/landing/g-home*.html`. The issue link is injected by
+  `scripts/export-landing.mjs:196-197`; the security link is `/{lang}/docs/tg/security` in the
+  prototypes.
+- `components/landing/landing.tsx:881,884` has the same two links; the page renders
+  `components/landing.tsx` (`app/[lang]/(home)/page.tsx:1`). I will check whether the other file is
+  still imported anywhere before touching it.
+- `app/[lang]/(home)/about/page.tsx:71` links Security to `/docs/tg/security`.
+- `site.config.json` `contacts.telegram` is `https://t.me/wirecatdev`. Its public page shows
+  "3 members", which is how Telegram shows a group, not a channel — so I infer it is the support
+  chat.
+- No repository has a `SECURITY.md` or a private way to report a vulnerability.
+- Tool pages link to the site only by absolute URL (`max-cli/README.md:13`). `scripts/sync.ts:50`
+  passes absolute and root links through unchanged, and `scripts/localize.ts:117` requires every
+  translation to keep the same link destinations.
+
+## Decisions
+
+- **D1 · Both guides are shared pages in cli-docs**, like `search-architecture`: one fact, one home.
+  `content/docs/architecture{,.ru,.es}.mdx` and `content/docs/security{,.ru,.es}.md`. Sidebar:
+  `architecture` next to `search-architecture`; `security` after `bot-api`.
+- **D2 · Diagrams are a React component with labels per language**, not an English image: the
+  existing SVG shows English text on the Russian page and stays light in dark mode. One
+  `components/architecture-diagrams.tsx` with inline SVG using the theme's colour variables. Each
+  diagram is followed by prose that says the same thing, since the Markdown copy for agents
+  (`/llms.mdx/...`) drops JSX.
+- **D3 · The architecture page links code at a pinned commit**, as the search page does, and dates
+  what it read. It states the limits next to the design: the MAX protocol is unofficial and reverse
+  engineered; one socket per device for MAX, so writes go through `max serve`; vectors are scanned
+  in JavaScript with no vector index; store writes block the event loop and other processes wait up
+  to 5 s for the lock.
+- **D4 · Footer links.** "Report a problem" → `https://t.me/wirecatdev`; "Security" →
+  `/{lang}/docs/security`. **Correction 2026-10-04:** written into the prototypes and the export
+  script rather than read from `site.config.json` — the footer is static exported HTML, and a
+  render-time rewrite would be more code for one URL. Re-exported; the JSON diff touches only those
+  two links.
+- **D5 · The shared security page holds what cli-core and cli-messaging own**, the same for both
+  tools: what stays on the computer, the keyring, the shared store and run records (never message
+  text), the send guard and permissions, MCP `--allow-send` / `--confirm-send`, other people's text
+  as untrusted input for agents, what goes over the network, how to report a problem. Anything
+  only one tool has stays on its page.
+- **D6 · Tool pages are trimmed now** (NEED-556 B): a lead line pointing to the shared page, and the
+  generic sections the shared page covers cut down to what is specific to the tool, in one PR per tool. It appears on the site with each tool's next release; each change needs
+  its translations re-reviewed (max: en, es; tg: ru, es) and fingerprints updated in
+  `translations/sources.json`.
+- **D7 · Links from a tool page to the site are rewritten per language at sync.** The tool page
+  writes `https://wirecat.dev/ru/docs/security`; `scripts/sync.ts` turns any
+  `https://wirecat.dev/<lang>/docs/<path>` into `/<page lang>/docs/<path>` after translation checks,
+  so the English copy of a Russian page does not send the reader to Russian. Small and tested in
+  `scripts/sync.test.ts`. On GitHub the absolute URL still works.
+
+## Architecture page outline
+
+1. **What it is in one picture** — diagram A: the packages and who depends on whom (tg-cli,
+   max-cli → cli-messaging → cli-core; cli-messaging-sqlite, -onnx; mtcute, ws). One line per
+   package on what it owns.
+2. **One command, start to finish** — diagram B: argv → `run()` → settings → guard → service →
+   adapter → messenger, and the store/run record beside it; the process exits.
+3. **Layers** — domain, adapters, ports, services, interface (CLI and MCP). Each calls only the
+   ones below; Biome import rules enforce it. Diagram C.
+4. **Adapters** — the port: required core, optional groups through `capability()`, refusal over
+   silent drop, ids as strings, `providerMetadata`, `sendId` and `outcome_unknown`, server vs
+   pushed history (MAX). How tg and max each fill it. Contract cases.
+5. **The local store** — one SQLite file for every messenger and account, keyed by provider and
+   account; Node and Bun drivers; the bundled SQLite where the system one is too old; forward-only
+   migrations and `min_compatible`; one method, one transaction. Link to the search guide for the
+   indexes.
+6. **Patterns that hold it together** — services shared by commands and MCP tools; decorators that
+   save and time adapter calls; per-messenger overrides of a use case; stdout carries data only;
+   closed error codes; one-shot processes close everything; the send guard in one place.
+7. **The MAX specifics** — operations declared once in `src/spec/`, generated wrappers, binary
+   frames, the Bot API slice generated from OpenAPI with cli-core's codegen.
+8. **Testing** — sandboxed tests, the fake adapter, contract cases, generated docs checked in CI,
+   parity checks between tg and max.
+9. **Limits and trade-offs** — D3's list.
+10. **Contributing: where to start** — links to `ADAPTERS.md`, each repository's
+    `ARCHITECTURE.md`, `CONVENTIONS.md`.
+11. **Sources** — pinned links.
+
+## Work items (in order)
+
+**Correction 2026-10-04:** items 1–4 shipped as one cli-docs PR — the security page links to the
+architecture page, so splitting them would have published a dead link. Item 5 is cli-messaging #492,
+tg-cli #257 and max-cli #387.
+
+
+1. Footer and About links (D4) — cli-docs PR 1. Smallest, independent.
+2. Shared security page in three languages, sidebar, footer pointing to it — cli-docs PR 1 too,
+   since the footer needs the page to exist.
+3. Architecture page, diagram component, three languages, `search-intents.json` entries if the
+   search needs them — cli-docs PR 2.
+4. Sync rewrite of site links (D7) — cli-docs PR 2 or 3.
+5. Lead link on `max-cli/docs/security.md` and `tg-cli/docs/security.md`; correct the stale
+   sections in `cli-messaging/docs/dev/ARCHITECTURE.md` ("Who consumes it") and
+   `max-cli/docs/dev/ARCHITECTURE.md` (§1, §17) in place — one PR per repository, each on `main`.
+6. After the next tg and max releases: re-review the four security translations and update the
+   fingerprints.
+
+## Checks
+
+`pnpm lint && pnpm typecheck && pnpm test`, `pnpm sync && pnpm exec next build && pnpm check:links`;
+open `/en|ru|es/docs/architecture` and `/security` in light and dark, phone width; the footer links
+on the landing and on a docs page. In each tool repository its own `pnpm lint && pnpm typecheck &&
+pnpm test`.
+
+## Owner's answers (2026-10-04)
+
+- NEED-554 → **A**: "Report a problem" links to `t.me/wirecatdev`.
+- NEED-555 → **C**: `hello@wirecat.dev` and GitHub private vulnerability reporting, enabled on each
+  repository; tg-cli and max-cli get a `SECURITY.md` pointing to the shared page.
+- NEED-556 → **B**: trim the tool pages now.
+
+## Open questions (answered above)
+
+- **NEED-554 · Support link:** is `https://t.me/wirecatdev` the support chat for "Report a problem"?
+  (Inferred from "3 members".)
+- **NEED-555 · Vulnerability reports:** where does someone report a security problem privately —
+  `hello@wirecat.dev`, GitHub private vulnerability reporting on each repository, or both?
+- **NEED-556 · Trimming tool security pages:** after the link lands, should the generic sections that
+  the shared page now covers be cut from the tool pages, or stay duplicated?
diff --git a/lib/landing/en.json b/lib/landing/en.json
index db85569..596bd5d 100644
--- a/lib/landing/en.json
+++ b/lib/landing/en.json
@@ -1,6 +1,6 @@
 {
   "html": "<section class=\"wrap hero\" aria-labelledby=\"headline\">\n  <div class=\"hero-text\">\n    <h1 id=\"headline\">Never search a chat again. <span>Just ask.</span></h1>\n    <div>\n      <p class=\"lede\">Connect Claude Code, Codex or another agent to <b>Telegram and MAX</b>. Find what matters, keep track of commitments and reply with the full context.</p>\n      <div class=\"cta\"><details class=\"agent-connect\"><summary class=\"btn\">Connect your agent<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"connect-menu\"><p>Click to copy the installation command.</p><button class=\"connect-choice\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\" aria-label=\"Telegram: Copy\"><span class=\"connect-choice-title\"><strong>Telegram</strong><span data-copy-label role=\"status\" aria-live=\"polite\">Copy</span></span><code>npm i -g @leemour/tg-cli</code></button><a class=\"connect-guide\" href=\"/en/docs/installation#tg\">Setup guide: Telegram →</a><button class=\"connect-choice\" type=\"button\" data-copy=\"npm i -g @leemour/max-cli\" aria-label=\"MAX: Copy\"><span class=\"connect-choice-title\"><strong>MAX</strong><span data-copy-label role=\"status\" aria-live=\"polite\">Copy</span></span><code>npm i -g @leemour/max-cli</code></button><a class=\"connect-guide\" href=\"/en/docs/installation#max\">Setup guide: MAX →</a></div></details></div>\n      <p class=\"tagline\"><b>Messaging tools for your AI agent.</b> Free and open source.</p>\n    </div>\n  </div>\n\n  <h2 class=\"sr-only\">Agent conversation</h2><div class=\"app\" id=\"app\">\n    <div class=\"titlebar\"><i></i><i></i><i></i><span>Agent · ~/inbox</span>\n      <div class=\"demo-messengers\" role=\"group\" aria-label=\"Messenger for this example\"><button type=\"button\" data-messenger=\"tg\" aria-pressed=\"true\">Telegram</button><button type=\"button\" data-messenger=\"max\" aria-pressed=\"false\">MAX</button></div><button class=\"replay\" type=\"button\" id=\"replay\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" aria-hidden=\"true\"><path d=\"M2.5 8a5.5 5.5 0 1 0 1.8-4.1M2.5 2v3.5H6\"/></svg>Replay</button>\n    </div>\n    <div class=\"app-body\">\n      <nav class=\"sessions\" aria-label=\"Sessions\" id=\"sessions\"><h2>Sessions</h2><button class=\"session\" type=\"button\" aria-current=\"true\">Context for a call<small>tg chats list → tg review</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Find recommendations<small>messages search --source all</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Manage a group<small>chats moderate --dry-run</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Morning briefing<small>tg inbox → tg review</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Commitments and replies<small>tg review --unanswered</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Reminders and scheduled messages<small>tg messages send --at-time</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">All documents on a topic<small>tg chats list → tg messages search</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Customer support bot<small>tg bot messages list → tg bot messages send</small></button></nav>\n      <div class=\"conv\">\n        <div class=\"log\" id=\"log\"><div class=\"ask step\"><p>Use tg cli, gather context for tomorrow’s Atlas call: decisions, risks and <span class=\"prompt-ending\">questions.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Use tg cli, gather context for tomorrow’s Atlas call: decisions, risks and questions.\" aria-label=\"Copy prompt\" title=\"Copy prompt\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Copy prompt</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg chats list <b>--search \"Atlas\"</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"101\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · team\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"group\"</span>\n    },\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"102\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · design\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"group\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg review <b>--chat \"Atlas · team\" --since-time 7d</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"chats\"</span>: [\n    {\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · team\"</span>,\n      <span class=\"k\">\"messages\"</span>: [\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Anna\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"We’re launching on Friday.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        },\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48211\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Marco\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Anna needs the final copy by Thursday.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        },\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48212\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Tom needs staging access.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        }\n      ],\n      <span class=\"k\">\"more\"</span>: <span class=\"n\">false</span>\n    }\n  ],\n  <span class=\"k\">\"skipped\"</span>: [],\n  <span class=\"k\">\"partial\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Decisions so far</span><ul><li><b>Launch:</b> Friday. The scope of the first release is agreed.</li><li><b>Copy:</b> Anna needs the final version by Thursday.</li></ul><span class=\"answer-label\">Blocking the launch</span><p><b>Tom:</b> needs staging access to test payments.</p><span class=\"answer-label\">For the call</span><p>Agree who will provide access and when testing will be finished. I also found the design group — I can check it and your direct messages with the people involved.</p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Source messages<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-3-0\"><summary><span class=\"evidence-heading\"><strong>Anna <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Atlas · team · Telegram · Oct 2, 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>We’re launching on Friday.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-3-1\"><summary><span class=\"evidence-heading\"><strong>Marco <span class=\"evidence-id\">#48211</span></strong><span class=\"evidence-meta\">Atlas · team · Telegram · Oct 2, 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Anna needs the final copy by Thursday.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-3-2\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48212</span></strong><span class=\"evidence-meta\">Atlas · team · Telegram · Oct 2, 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Tom needs staging access.</blockquote></details></div></details></div><div class=\"ask step\"><p>Check the design group and my DMs with Tom too. He may have sent the results <span class=\"prompt-ending\">there.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Check the design group and my DMs with Tom too. He may have sent the results there.\" aria-label=\"Copy prompt\" title=\"Copy prompt\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Copy prompt</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg review <b>--chat \"Atlas · design\" --since-time 7d</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"chats\"</span>: [\n    {\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · design\"</span>,\n      <span class=\"k\">\"messages\"</span>: [\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Anna\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"The design is ready. We’re still waiting for the final copy.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        }\n      ],\n      <span class=\"k\">\"more\"</span>: <span class=\"n\">false</span>\n    }\n  ],\n  <span class=\"k\">\"skipped\"</span>: [],\n  <span class=\"k\">\"partial\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg chats list <b>--search \"Tom\"</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"503\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"private\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages list <b>503 --limit 30</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Test payments work. I still need access to production.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages search <b>\"Atlas\" --chat 503 --language legacy</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Test payments work. I still need access to production.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Context from other chats</span><ul><li><b>Design:</b> the layout is ready; final copy is the last dependency.</li><li><b>Tom, in your DMs:</b> test payments work. He still needs access to production.</li></ul><span class=\"answer-label\">The remaining risk</span><p>Payment testing is partly done — only the production check is blocked. Focus the call on that, rather than starting from scratch.</p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Source messages<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-9-0\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Tom · Telegram · Oct 2, 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Test payments work. I still need access to production.</blockquote></details></div></details></div><div class=\"ask step\"><p>Make a 20-minute agenda covering risks, owners and deadlines. Don't send <span class=\"prompt-ending\">anything.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Make a 20-minute agenda covering risks, owners and deadlines. Don't send anything.\" aria-label=\"Copy prompt\" title=\"Copy prompt\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Copy prompt</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages context <b>503 48210 --before-n 2 --after-n 2</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Test payments work. I still need access to production.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    },\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48211\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"I need access to production.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">20-minute agenda</span><ol><li><b>0–7 min:</b> production access — who will grant it, and when can Tom finish testing?</li><li><b>7–12 min:</b> final copy — who will get it to Anna by Thursday?</li><li><b>12–17 min:</b> if we run out of time, do we reduce scope or move the launch?</li><li><b>17–20 min:</b> record an owner and deadline for each action.</li></ol><p><small>Draft ready, based on the project group, design group and your DMs with Tom. Nothing has been sent.</small></p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Source messages<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-12-0\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Tom · Telegram · Oct 2, 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Test payments work. I still need access to production.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-12-1\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48211</span></strong><span class=\"evidence-meta\">Tom · Telegram · Oct 2, 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>I need access to production.</blockquote></details></div></details></div></div>\n        <div class=\"composer\"><span>Ask about your chats…</span><span class=\"slash\">Unread</span><span class=\"slash\">Agreements</span><span class=\"slash\">Replies</span><span class=\"slash\">Search</span></div>\n      </div>\n    </div>\n  </div>\n</section>\n\n\n\n\n\n\n\n\n\n\n\n<section id=\"features\" style=\"padding-top:0\">\n  <div class=\"wrap\">\n    <h2 class=\"big\" id=\"feat-title\">Less busywork in your chats</h2>\n    <p class=\"intro\">Keep track of agreements, help customers and keep your groups useful. Ask your agent to work through Telegram and MAX.</p>\n    <div class=\"fv fv6\" data-variant=\"6\"><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"8\" r=\"3.6\"/><path d=\"M4.5 20c1.2-4 4.2-6 7.5-6s6.3 2 7.5 6\"/></svg></span><span class=\"fv-name\">Personal account</span><span class=\"fv-short\">Context, decisions and reminders</span></div><p class=\"fv-lead\">Connect your own account, just like adding another device. Access your chats, history, groups, channels and contacts.</p><div class=\"g6\"><div class=\"t6\"><b>Unread messages in one place</b><span>See incoming messages without marking them as read.</span></div><div class=\"t6\"><b>Keep track of agreements</b><span>Review what you and others have promised since your last check-in.</span></div><div class=\"t6\"><b>Find it, even with a typo</b><span>Search your local chat archive by full words, partial words or approximate spelling.</span></div><div class=\"t6\"><b>News from your subscriptions</b><span>Ask your agent for a digest of the channels you follow, on the topics you choose, with links to the posts.</span></div><div class=\"t6\"><b>Voice notes as text</b><span>Transcribe with Telegram or a speech model running on your computer.</span></div><div class=\"t6\"><b>Send later</b><span>Telegram delivers your message on schedule, even when your laptop is closed.</span></div></div><a class=\"more\" href=\"/en/docs/tg/usage\">How to use your account →</a></div><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"4\" y=\"8\" width=\"16\" height=\"11\" rx=\"3\"/><path d=\"M12 4v4M9 13h.01M15 13h.01M9.5 16.5h5\"/></svg></span><span class=\"fv-name\">Bots</span><span class=\"fv-short\">Personalisation, customer support and broadcasts</span></div><p class=\"fv-lead\"><strong><a href=\"/en/docs/bot-api\">All Bot API methods.</a></strong> Every method of the official Telegram and MAX Bot APIs is exposed through the CLI, alongside simple commands for messages, files and chat administration.</p><div class=\"g6\"><div class=\"t6\"><b>Group broadcasts</b><span>Ask your agent to send an announcement to the groups and channels you choose.</span></div><div class=\"t6\"><b>Personalised messages</b><span>Let your agent tailor each message using the customer details you provide.</span></div><div class=\"t6\"><b>Replies with context</b><span>Give your agent a knowledge base or conversation history to help it answer customer questions.</span></div><div class=\"t6\"><b>Team notifications</b><span>Keep people informed about requests, results and changes, with the files they need.</span></div><div class=\"t6\"><b>Buttons and clear choices</b><span>Help people choose an action, open a link or respond with a tap.</span></div><div class=\"t6\"><b>Control what gets sent</b><span>Choose who the bot may contact and check which sends succeeded or need attention.</span></div></div><a class=\"more\" href=\"/en/docs/max/bot\">How to set up a bot →</a></div><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><circle cx=\"9\" cy=\"9\" r=\"3\"/><circle cx=\"17\" cy=\"10\" r=\"2.4\"/><path d=\"M3.5 19c.9-3.2 3-4.8 5.5-4.8s4.6 1.6 5.5 4.8M14.5 15c2.6-.4 4.6.9 5.5 3.6\"/></svg></span><span class=\"fv-name\">Groups you run</span><span class=\"fv-short\">Moderation, answers and community health</span></div><p class=\"fv-lead\">Keep your community useful: unanswered questions, clear decisions and conversations that follow your rules.</p><div class=\"g6\"><div class=\"t6\"><b>Question monitoring</b><span>Find questions left without an answer so members get the help they came for.</span></div><div class=\"t6\"><b>Analytics</b><span>Who joined, left, was added or removed, and who did it.</span></div><div class=\"t6\"><b>Keep discussions on track</b><span>Ask your agent to flag spam, insults and conflicts so you can step in early.</span></div><div class=\"t6\"><b>Moderation by your rules</b><span>Choose which violations to flag, which messages to delete and when to remove a participant.</span></div><div class=\"t6\"><b>Discussion summaries</b><span>Get the decisions, open questions and next steps without rereading the whole conversation.</span></div><div class=\"t6\"><b>Group management</b><span>Delegate routine invitations, admin changes and invite-link updates to your agent.</span></div></div><a class=\"more\" href=\"/en/docs/tg/groups\">How to run a group →</a></div></div>\n  </div>\n</section>\n<!--time-savings-->\n<section>\n  <div class=\"wrap\">\n    <h2 class=\"big\">Telegram and MAX, one search</h2>\n    <p class=\"intro\">Find messages across both. Bring agreements and files together from your saved history.</p>\n    <div class=\"tools\">\n      <article class=\"tool-card\"><div class=\"tool-name\">tg<small>Telegram</small></div><p>A Telegram client for your terminal and AI agents, using your own account.</p><span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Copy</button></span><div class=\"tool-links\"><a href=\"/en/docs/tg\" target=\"_blank\" rel=\"noopener noreferrer\">Docs<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://github.com/leemour/tg-cli\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://www.npmjs.com/package/@leemour/tg-cli\" target=\"_blank\" rel=\"noopener noreferrer\">npm<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a></div></article>\n      <article class=\"tool-card\"><div class=\"tool-name\">max<small>MAX Messenger</small></div><p>Connect your MAX account or use your bots through the official Bot API.</p><span class=\"cmd\"><code>npm i -g @leemour/max-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/max-cli\">Copy</button></span><div class=\"tool-links\"><a href=\"/en/docs/max\" target=\"_blank\" rel=\"noopener noreferrer\">Docs<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://github.com/leemour/max-cli\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://www.npmjs.com/package/@leemour/max-cli\" target=\"_blank\" rel=\"noopener noreferrer\">npm<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a></div></article>\n    </div>\n  </div>\n</section>\n<section class=\"band\" id=\"why\">\n  <div class=\"wrap\">\n    <h2 class=\"big\">Why it works this well</h2>\n    <p class=\"intro\">Built for agents and scripts: fast, predictable and easy to audit.</p>\n    <dl class=\"spec\">\n      <div><dt>Fast</dt><dd>Search runs on the copy of your chats on your computer. No network, no waiting.<code>tg messages search \"contract\" --offline</code></dd></div>\n      <div><dt>Runs everywhere</dt><dd>Windows, macOS and Linux with Node.js 22 or later. No native modules to compile.<code>npm i -g @leemour/tg-cli</code></dd></div>\n      <div><dt>Powerful search</dt><dd>Find messages even with typos or incomplete words. Search across chats and channels, narrow results by sender or date and recover the surrounding conversation.<code>tg messages search \"contract\"</code></dd></div>\n      <div><dt>Local storage</dt><dd>Your chat history stays in a local cache on your computer. Search it offline, create backups and restore your archive when needed.<code>tg store backup · tg store restore</code></dd></div>\n      <div><dt>Flexible permissions</dt><dd>You control what your agent can do: read only, run allowed commands or ask your permission before an action.<code>permissions.messages.send · --confirm-send</code></dd></div>\n      <div><dt>Always up to date</dt><dd>A background service keeps your local history up to date and syncs missed messages after a restart.<code>tg server install</code></dd></div>\n      <div><dt>Multiple accounts and bots</dt><dd>Switch easily between accounts and bots. Keep work and personal conversations separate, or ask your agent to gather context from several accounts.<code>tg work inbox</code></dd></div>\n      <div><dt>Action history</dt><dd>Check send attempts in the journal and record command runs when needed. Logs keep IDs, statuses and timings, without message text.<code>tg sends list · tg runs list · --record</code></dd></div>\n      <div><dt>Secure</dt><dd>Secrets stay in the system keyring. Passwords, login codes, phone numbers and tokens do not leak into logs or command history. Protection against prompt injection helps prevent chat messages from steering your agent.<code>tg session start</code></dd></div>\n    </dl>\n  </div>\n</section>\n<section id=\"day\"><div class=\"wrap\"><h2 class=\"big\">A day with your agent</h2><p class=\"intro\">A few moments with your agent. The rest of the day is yours.</p><div class=\"day-summary\"><div><time class=\"time\" datetime=\"08:00\">08:00</time><h3>Start with the essentials</h3><p>Get one short summary of the chats that need your attention.</p></div><div><time class=\"time\" datetime=\"11:00\">11:00</time><h3>Prepare for a meeting</h3><p>Bring together the relevant messages before the conversation starts.</p></div><div><time class=\"time\" datetime=\"15:00\">15:00</time><h3>Keep things moving</h3><p>Reply to a request or follow up with someone you are waiting for.</p></div><div><time class=\"time\" datetime=\"19:00\">19:00</time><h3>Finish with a clear picture</h3><p>See what was resolved and what needs attention tomorrow.</p></div></div></div></section>\n<section class=\"close\" id=\"closing\">\n  <div class=\"wrap\">\n    <h2 class=\"big\" id=\"closing-title\">Continue the conversation with the full context</h2>\n    <p class=\"intro\" id=\"closing-help\">Choose Telegram or MAX. The guide takes you from installation to your first answer.</p>\n    <div class=\"cta\"><a class=\"btn\" href=\"/en/docs/installation#tg\">Start with Telegram →</a><a class=\"btn\" href=\"/en/docs/installation#max\">Start with MAX →</a></div>\n  </div>\n</section>\n\n\n\n\n<div data-search-playground></div>",
-  "footerHtml": "<footer class=\"site\">\n  <div class=\"wrap\">\n    <div class=\"foot\">\n      <div class=\"foot-brand\">\n        <a class=\"mark\" href=\"#\"><svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><circle class=\"ring\" cx=\"16\" cy=\"16\" r=\"16\"/><circle cx=\"16\" cy=\"16\" r=\"16\" fill=\"#4b53f0\"/><path class=\"wire\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\" fill=\"none\" stroke=\"#fff\" stroke-width=\"2.4\" stroke-linejoin=\"round\" stroke-linecap=\"round\"/><path class=\"pulse\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\"/></svg><span class=\"word\">WireCat</span></a>\n        <p>Your Telegram and MAX conversations, connected to your scripts and AI agents.</p>\n        <span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Copy</button></span>\n      </div>\n      <div><h2>Tools</h2><ul>\n        <li><a href=\"/en/docs/tg\">tg · Telegram</a></li>\n        <li><a href=\"/en/docs/max\">max · MAX</a></li>\n        <li><a href=\"/en/docs/tg/changelog\">tg changelog</a></li>\n        <li><a href=\"/en/docs/max/changelog\">max changelog</a></li></ul></div>\n      <div><h2>Docs</h2><ul>\n        <li><a href=\"/en/docs/installation\">Installation</a></li>\n        <li><a href=\"/en/docs/tg/usage\">Usage</a></li>\n        <li><a href=\"/en/docs/tg/commands\">All commands</a></li>\n        <li><a href=\"/en/docs/tg/troubleshooting\">Troubleshooting</a></li></ul></div>\n      <div><h2>For agents</h2><ul>\n        <li><a href=\"/en/docs/mcp\">MCP server</a></li>\n        <li><a href=\"/en/docs/tg/recipes\">Recipes</a></li>\n        <li><a href=\"/llms.txt\"><code>/llms.txt</code></a></li>\n        <li><a href=\"/llms-full.txt\"><code>/llms-full.txt</code></a></li></ul></div>\n      <div><h2>Project</h2><ul>\n        <li><a href=\"https://github.com/leemour/tg-cli\">tg on GitHub</a></li>\n        <li><a href=\"https://github.com/leemour/max-cli\">max on GitHub</a></li>\n        <li><a href=\"/en/about\">About</a></li><li><a href=\"https://github.com/leemour/tg-cli/issues\">Report a problem</a></li>\n        <li><a href=\"/en/docs/tg/security\">Security</a></li></ul></div>\n    </div>\n    <div class=\"foot-bottom\">\n      <span>© 2026 WireCat · MIT licence · Windows, macOS, Linux</span>\n      <div class=\"footer-controls\"><button class=\"theme-toggle\" type=\"button\" aria-label=\"Switch theme\" title=\"Switch theme\"><svg class=\"theme-sun\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"4\"/><path d=\"M12 2v2m0 16v2M2 12h2m16 0h2M5 5l1.5 1.5m11 11L19 19M5 19l1.5-1.5m11-11L19 5\"/></svg><svg class=\"theme-moon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M20.5 14a9 9 0 0 1-10.5-10.5A9 9 0 1 0 20.5 14Z\"/></svg></button><details class=\"lang footer-language\"><summary aria-label=\"Language\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"9\"/><ellipse cx=\"12\" cy=\"12\" rx=\"4\" ry=\"9\"/><path d=\"M3 12h18\"/></svg><span>EN</span><svg class=\"dn\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"lang-menu\"><a href=\"/en\" aria-current=\"page\">English</a><a href=\"/ru\">Русский</a><a href=\"/es\">Español</a></div></details></div>\n    </div>\n  </div>\n</footer>",
+  "footerHtml": "<footer class=\"site\">\n  <div class=\"wrap\">\n    <div class=\"foot\">\n      <div class=\"foot-brand\">\n        <a class=\"mark\" href=\"#\"><svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><circle class=\"ring\" cx=\"16\" cy=\"16\" r=\"16\"/><circle cx=\"16\" cy=\"16\" r=\"16\" fill=\"#4b53f0\"/><path class=\"wire\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\" fill=\"none\" stroke=\"#fff\" stroke-width=\"2.4\" stroke-linejoin=\"round\" stroke-linecap=\"round\"/><path class=\"pulse\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\"/></svg><span class=\"word\">WireCat</span></a>\n        <p>Your Telegram and MAX conversations, connected to your scripts and AI agents.</p>\n        <span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Copy</button></span>\n      </div>\n      <div><h2>Tools</h2><ul>\n        <li><a href=\"/en/docs/tg\">tg · Telegram</a></li>\n        <li><a href=\"/en/docs/max\">max · MAX</a></li>\n        <li><a href=\"/en/docs/tg/changelog\">tg changelog</a></li>\n        <li><a href=\"/en/docs/max/changelog\">max changelog</a></li></ul></div>\n      <div><h2>Docs</h2><ul>\n        <li><a href=\"/en/docs/installation\">Installation</a></li>\n        <li><a href=\"/en/docs/tg/usage\">Usage</a></li>\n        <li><a href=\"/en/docs/tg/commands\">All commands</a></li>\n        <li><a href=\"/en/docs/tg/troubleshooting\">Troubleshooting</a></li></ul></div>\n      <div><h2>For agents</h2><ul>\n        <li><a href=\"/en/docs/mcp\">MCP server</a></li>\n        <li><a href=\"/en/docs/tg/recipes\">Recipes</a></li>\n        <li><a href=\"/llms.txt\"><code>/llms.txt</code></a></li>\n        <li><a href=\"/llms-full.txt\"><code>/llms-full.txt</code></a></li></ul></div>\n      <div><h2>Project</h2><ul>\n        <li><a href=\"https://github.com/leemour/tg-cli\">tg on GitHub</a></li>\n        <li><a href=\"https://github.com/leemour/max-cli\">max on GitHub</a></li>\n        <li><a href=\"/en/about\">About</a></li><li><a href=\"https://t.me/wirecatdev\">Report a problem</a></li>\n        <li><a href=\"/en/docs/security\">Security</a></li></ul></div>\n    </div>\n    <div class=\"foot-bottom\">\n      <span>© 2026 WireCat · MIT licence · Windows, macOS, Linux</span>\n      <div class=\"footer-controls\"><button class=\"theme-toggle\" type=\"button\" aria-label=\"Switch theme\" title=\"Switch theme\"><svg class=\"theme-sun\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"4\"/><path d=\"M12 2v2m0 16v2M2 12h2m16 0h2M5 5l1.5 1.5m11 11L19 19M5 19l1.5-1.5m11-11L19 5\"/></svg><svg class=\"theme-moon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M20.5 14a9 9 0 0 1-10.5-10.5A9 9 0 1 0 20.5 14Z\"/></svg></button><details class=\"lang footer-language\"><summary aria-label=\"Language\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"9\"/><ellipse cx=\"12\" cy=\"12\" rx=\"4\" ry=\"9\"/><path d=\"M3 12h18\"/></svg><span>EN</span><svg class=\"dn\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"lang-menu\"><a href=\"/en\" aria-current=\"page\">English</a><a href=\"/ru\">Русский</a><a href=\"/es\">Español</a></div></details></div>\n    </div>\n  </div>\n</footer>",
   "sessions": [
     {
       "id": "context",
diff --git a/lib/landing/es.json b/lib/landing/es.json
index fe1fa7f..582fbfc 100644
--- a/lib/landing/es.json
+++ b/lib/landing/es.json
@@ -1,6 +1,6 @@
 {
   "html": "<section class=\"wrap hero\" aria-labelledby=\"headline\">\n  <div class=\"hero-text\">\n    <h1 id=\"headline\">Deja de revisar chats. <span>Solo pregunta.</span></h1>\n    <div>\n      <p class=\"lede\">Conecta Claude Code, Codex u otro agente a <b>Telegram y MAX</b>. Encuentra lo importante, recuerda lo acordado y responde con todo el contexto.</p>\n      <div class=\"cta\"><details class=\"agent-connect\"><summary class=\"btn\">Conecta tu agente<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"connect-menu\"><p>Haz clic para copiar el comando de instalación.</p><button class=\"connect-choice\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\" aria-label=\"Telegram: Copiar\"><span class=\"connect-choice-title\"><strong>Telegram</strong><span data-copy-label role=\"status\" aria-live=\"polite\">Copiar</span></span><code>npm i -g @leemour/tg-cli</code></button><a class=\"connect-guide\" href=\"/es/docs/installation#tg\">Guía: Telegram →</a><button class=\"connect-choice\" type=\"button\" data-copy=\"npm i -g @leemour/max-cli\" aria-label=\"MAX: Copiar\"><span class=\"connect-choice-title\"><strong>MAX</strong><span data-copy-label role=\"status\" aria-live=\"polite\">Copiar</span></span><code>npm i -g @leemour/max-cli</code></button><a class=\"connect-guide\" href=\"/es/docs/installation#max\">Guía: MAX →</a></div></details></div>\n      <p class=\"tagline\"><b>Herramientas de mensajería para tu agente de IA.</b> Gratis y de código abierto.</p>\n    </div>\n  </div>\n\n  <h2 class=\"sr-only\">Conversación con el agente</h2><div class=\"app\" id=\"app\">\n    <div class=\"titlebar\"><i></i><i></i><i></i><span>Agente · ~/inbox</span>\n      <div class=\"demo-messengers\" role=\"group\" aria-label=\"Mensajero del ejemplo\"><button type=\"button\" data-messenger=\"tg\" aria-pressed=\"true\">Telegram</button><button type=\"button\" data-messenger=\"max\" aria-pressed=\"false\">MAX</button></div><button class=\"replay\" type=\"button\" id=\"replay\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" aria-hidden=\"true\"><path d=\"M2.5 8a5.5 5.5 0 1 0 1.8-4.1M2.5 2v3.5H6\"/></svg>Repetir</button>\n    </div>\n    <div class=\"app-body\">\n      <nav class=\"sessions\" aria-label=\"Sesiones\" id=\"sessions\"><h2>Sesiones</h2><button class=\"session\" type=\"button\" aria-current=\"true\">Contexto para una llamada<small>tg chats list → tg review</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Buscar recomendaciones<small>messages search --source all</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Gestionar un grupo<small>chats moderate --dry-run</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Resumen de la mañana<small>tg inbox → tg review</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Compromisos y respuestas<small>tg review --unanswered</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Recordatorios y mensajes programados<small>tg messages send --at-time</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Todos los documentos de un tema<small>tg chats list → tg messages search</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Bot de atención al cliente<small>tg bot messages list → tg bot messages send</small></button></nav>\n      <div class=\"conv\">\n        <div class=\"log\" id=\"log\"><div class=\"ask step\"><p>Usa tg cli, reúne el contexto para la llamada de Atlas de mañana: decisiones, riesgos y <span class=\"prompt-ending\">preguntas.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Usa tg cli, reúne el contexto para la llamada de Atlas de mañana: decisiones, riesgos y preguntas.\" aria-label=\"Copiar petición\" title=\"Copiar petición\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Copiar petición</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg chats list <b>--search \"Atlas\"</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"101\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · equipo\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"group\"</span>\n    },\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"102\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · diseño\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"group\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg review <b>--chat \"Atlas · equipo\" --since-time 7d</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"chats\"</span>: [\n    {\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · equipo\"</span>,\n      <span class=\"k\">\"messages\"</span>: [\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Anna\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Lanzamos el viernes.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        },\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48211\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Marco\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Anna necesita los textos finales para el jueves.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        },\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48212\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Tom necesita acceso al entorno de pruebas.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        }\n      ],\n      <span class=\"k\">\"more\"</span>: <span class=\"n\">false</span>\n    }\n  ],\n  <span class=\"k\">\"skipped\"</span>: [],\n  <span class=\"k\">\"partial\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Lo que ya está decidido</span><ul><li><b>Lanzamiento:</b> el viernes. El alcance de la primera versión está definido.</li><li><b>Textos:</b> Anna necesita la versión final para el jueves.</li></ul><span class=\"answer-label\">Qué bloquea el lanzamiento</span><p><b>Tom:</b> necesita acceso al entorno de pruebas para comprobar los pagos.</p><span class=\"answer-label\">Para la llamada</span><p>Acordar quién dará acceso y cuándo terminarán las pruebas. También he encontrado el grupo de diseño: puedo revisarlo junto con tus conversaciones privadas con los participantes.</p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Mensajes originales<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-3-0\"><summary><span class=\"evidence-heading\"><strong>Anna <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Atlas · equipo · Telegram · 2 oct 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Lanzamos el viernes.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-3-1\"><summary><span class=\"evidence-heading\"><strong>Marco <span class=\"evidence-id\">#48211</span></strong><span class=\"evidence-meta\">Atlas · equipo · Telegram · 2 oct 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Anna necesita los textos finales para el jueves.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-3-2\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48212</span></strong><span class=\"evidence-meta\">Atlas · equipo · Telegram · 2 oct 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Tom necesita acceso al entorno de pruebas.</blockquote></details></div></details></div><div class=\"ask step\"><p>Revisa también el grupo de diseño y mi conversación privada con Tom. Puede que haya enviado los resultados por <span class=\"prompt-ending\">ahí.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Revisa también el grupo de diseño y mi conversación privada con Tom. Puede que haya enviado los resultados por ahí.\" aria-label=\"Copiar petición\" title=\"Copiar petición\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Copiar petición</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg review <b>--chat \"Atlas · diseño\" --since-time 7d</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"chats\"</span>: [\n    {\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · diseño\"</span>,\n      <span class=\"k\">\"messages\"</span>: [\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Anna\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"La maqueta está lista. Aún faltan los textos finales.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        }\n      ],\n      <span class=\"k\">\"more\"</span>: <span class=\"n\">false</span>\n    }\n  ],\n  <span class=\"k\">\"skipped\"</span>: [],\n  <span class=\"k\">\"partial\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg chats list <b>--search \"Tom\"</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"503\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"private\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages list <b>503 --limit 30</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Los pagos de prueba funcionan. Todavía necesito acceso a producción.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages search <b>\"Atlas\" --chat 503 --language legacy</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Los pagos de prueba funcionan. Todavía necesito acceso a producción.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Contexto de otros chats</span><ul><li><b>Diseño:</b> la maqueta está lista; solo faltan los textos finales.</li><li><b>Tom, por privado:</b> los pagos de prueba funcionan. Lo que le falta es acceso al entorno de producción.</li></ul><span class=\"answer-label\">El riesgo pendiente</span><p>Las pruebas de pago están parcialmente hechas: solo queda la comprobación en producción. Conviene centrar la llamada en eso, sin empezar de cero.</p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Mensajes originales<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-9-0\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Tom · Telegram · 2 oct 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Los pagos de prueba funcionan. Todavía necesito acceso a producción.</blockquote></details></div></details></div><div class=\"ask step\"><p>Prepara una agenda de 20 minutos con riesgos, responsables y plazos. No envíes <span class=\"prompt-ending\">nada.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Prepara una agenda de 20 minutos con riesgos, responsables y plazos. No envíes nada.\" aria-label=\"Copiar petición\" title=\"Copiar petición\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Copiar petición</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages context <b>503 48210 --before-n 2 --after-n 2</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Los pagos de prueba funcionan. Todavía necesito acceso a producción.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    },\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48211\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Tom\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Necesito acceso a producción.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Agenda de 20 minutos</span><ol><li><b>0–7 min:</b> acceso a producción: quién lo dará y cuándo podrá Tom terminar las pruebas.</li><li><b>7–12 min:</b> textos finales: quién se los entregará a Anna para el jueves.</li><li><b>12–17 min:</b> si no llegamos a tiempo, ¿reducimos el alcance o aplazamos el lanzamiento?</li><li><b>17–20 min:</b> dejar un responsable y un plazo para cada tarea.</li></ol><p><small>Borrador listo a partir del grupo del proyecto, el de diseño y tu conversación privada con Tom. No se ha enviado nada.</small></p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Mensajes originales<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-12-0\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Tom · Telegram · 2 oct 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Los pagos de prueba funcionan. Todavía necesito acceso a producción.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-12-1\"><summary><span class=\"evidence-heading\"><strong>Tom <span class=\"evidence-id\">#48211</span></strong><span class=\"evidence-meta\">Tom · Telegram · 2 oct 2026</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Necesito acceso a producción.</blockquote></details></div></details></div></div>\n        <div class=\"composer\"><span>Pregunta sobre tus chats…</span><span class=\"slash\">Sin leer</span><span class=\"slash\">Acuerdos</span><span class=\"slash\">Respuestas</span><span class=\"slash\">Buscar</span></div>\n      </div>\n    </div>\n  </div>\n</section>\n\n\n\n\n\n\n\n\n\n\n\n<section id=\"features\" style=\"padding-top:0\">\n  <div class=\"wrap\">\n    <h2 class=\"big\" id=\"feat-title\">Menos tareas repetitivas en tus chats</h2>\n    <p class=\"intro\">Ten presentes los acuerdos, ayuda a clientes y cuida tus grupos. Pide a tu agente que trabaje con Telegram y MAX.</p>\n    <div class=\"fv fv6\" data-variant=\"6\"><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"8\" r=\"3.6\"/><path d=\"M4.5 20c1.2-4 4.2-6 7.5-6s6.3 2 7.5 6\"/></svg></span><span class=\"fv-name\">Cuenta personal</span><span class=\"fv-short\">Contexto, decisiones y recordatorios</span></div><p class=\"fv-lead\">Conecta tu cuenta como si añadieras otro dispositivo. Accede a tus chats, historial, grupos, canales y contactos.</p><div class=\"g6\"><div class=\"t6\"><b>Lo que tienes sin leer, en un solo lugar</b><span>Consulta los mensajes recibidos sin marcarlos como leídos.</span></div><div class=\"t6\"><b>Recuerda lo acordado</b><span>Revisa lo que habéis acordado desde la última revisión, incluidos tus propios compromisos.</span></div><div class=\"t6\"><b>Encuentra mensajes incluso con erratas</b><span>Busca en tu archivo local de chats por palabras completas, fragmentos o términos con erratas.</span></div><div class=\"t6\"><b>Noticias de los canales que sigues</b><span>Pide a tu agente un resumen de los canales que sigues, sobre los temas que elijas y con enlaces a las publicaciones.</span></div><div class=\"t6\"><b>Audios convertidos en texto</b><span>Transcribe con Telegram o con un modelo de voz que se ejecuta en tu ordenador.</span></div><div class=\"t6\"><b>Envío programado</b><span>Telegram envía tu mensaje a la hora prevista, aunque el portátil esté cerrado.</span></div></div><a class=\"more\" href=\"/es/docs/tg/usage\">Cómo usar tu cuenta →</a></div><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"4\" y=\"8\" width=\"16\" height=\"11\" rx=\"3\"/><path d=\"M12 4v4M9 13h.01M15 13h.01M9.5 16.5h5\"/></svg></span><span class=\"fv-name\">Bots</span><span class=\"fv-short\">Personalización, ayuda al cliente y comunicaciones</span></div><p class=\"fv-lead\"><strong><a href=\"/es/docs/bot-api\">Todos los métodos de la Bot API.</a></strong> Todos los métodos de las Bot API oficiales de Telegram y MAX están disponibles desde la CLI, junto con comandos sencillos para mensajes, archivos y administración de chats.</p><div class=\"g6\"><div class=\"t6\"><b>Avisos a grupos</b><span>Pide a tu agente que envíe un anuncio a los grupos y canales que elijas.</span></div><div class=\"t6\"><b>Mensajes personalizados</b><span>Tu agente adapta cada mensaje con los datos del cliente que le proporciones.</span></div><div class=\"t6\"><b>Respuestas con contexto</b><span>Dale a tu agente una base de conocimientos o el historial de consultas para ayudarle a responder a tus clientes.</span></div><div class=\"t6\"><b>Notificaciones para el equipo</b><span>Informa sobre solicitudes, resultados y cambios, con los archivos necesarios.</span></div><div class=\"t6\"><b>Botones y opciones claras</b><span>Ayuda a elegir una acción, abrir un enlace o responder con un toque.</span></div><div class=\"t6\"><b>Control de los envíos</b><span>Elige a quién puede escribir el bot y revisa qué envíos se completaron o requieren atención.</span></div></div><a class=\"more\" href=\"/es/docs/max/bot\">Cómo configurar un bot →</a></div><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><circle cx=\"9\" cy=\"9\" r=\"3\"/><circle cx=\"17\" cy=\"10\" r=\"2.4\"/><path d=\"M3.5 19c.9-3.2 3-4.8 5.5-4.8s4.6 1.6 5.5 4.8M14.5 15c2.6-.4 4.6.9 5.5 3.6\"/></svg></span><span class=\"fv-name\">Grupos que administras</span><span class=\"fv-short\">Moderación, respuestas y orden</span></div><p class=\"fv-lead\">Ayuda a que los miembros reciban respuestas, conserva las decisiones y cuida los debates.</p><div class=\"g6\"><div class=\"t6\"><b>Seguimiento de preguntas</b><span>Encuentra preguntas sin respuesta para que los miembros reciban la ayuda que buscan.</span></div><div class=\"t6\"><b>Analítica</b><span>Quién entró, salió, fue añadido o expulsado, y quién lo hizo.</span></div><div class=\"t6\"><b>Supervisión de conversaciones</b><span>Pide a tu agente que señale spam, insultos y conflictos para poder intervenir a tiempo.</span></div><div class=\"t6\"><b>Moderación con tus reglas</b><span>Elige qué infracciones señalar, qué mensajes borrar y cuándo expulsar a un participante.</span></div><div class=\"t6\"><b>Resúmenes de conversaciones</b><span>Recibe las decisiones, preguntas pendientes y próximos pasos sin releer toda la conversación.</span></div><div class=\"t6\"><b>Gestión de grupos</b><span>Delega las invitaciones, los cambios de administradores y la renovación de enlaces en tu agente.</span></div></div><a class=\"more\" href=\"/es/docs/tg/groups\">Cómo gestionar un grupo →</a></div></div>\n  </div>\n</section>\n<!--time-savings-->\n<section>\n  <div class=\"wrap\">\n    <h2 class=\"big\">Telegram y MAX, una búsqueda</h2>\n    <p class=\"intro\">Busca mensajes en ambos. Reúne acuerdos y archivos de tu historial guardado.</p>\n    <div class=\"tools\">\n      <article class=\"tool-card\"><div class=\"tool-name\">tg<small>Telegram</small></div><p>Un cliente de Telegram para la terminal y los agentes de IA, con tu propia cuenta.</p><span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Copiar</button></span><div class=\"tool-links\"><a href=\"/es/docs/tg\" target=\"_blank\" rel=\"noopener noreferrer\">Documentación<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://github.com/leemour/tg-cli\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://www.npmjs.com/package/@leemour/tg-cli\" target=\"_blank\" rel=\"noopener noreferrer\">npm<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a></div></article>\n      <article class=\"tool-card\"><div class=\"tool-name\">max<small>MAX Messenger</small></div><p>Conecta tu cuenta de MAX o usa tus bots a través de la Bot API oficial.</p><span class=\"cmd\"><code>npm i -g @leemour/max-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/max-cli\">Copiar</button></span><div class=\"tool-links\"><a href=\"/es/docs/max\" target=\"_blank\" rel=\"noopener noreferrer\">Documentación<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://github.com/leemour/max-cli\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://www.npmjs.com/package/@leemour/max-cli\" target=\"_blank\" rel=\"noopener noreferrer\">npm<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a></div></article>\n    </div>\n  </div>\n</section>\n<section class=\"band\" id=\"why\">\n  <div class=\"wrap\">\n    <h2 class=\"big\">Por qué funciona tan bien</h2>\n    <p class=\"intro\">Diseñado para agentes y scripts: rápido, predecible y con un registro de acciones.</p>\n    <dl class=\"spec\">\n      <div><dt>Rápido</dt><dd>La búsqueda funciona sobre la copia de tus chats en tu ordenador. Sin red, sin esperas.<code>tg messages search \"contrato\" --offline</code></dd></div>\n      <div><dt>Funciona en todas partes</dt><dd>Windows, macOS y Linux con Node.js 22 o posterior. No necesitas compilar módulos nativos.<code>npm i -g @leemour/tg-cli</code></dd></div>\n      <div><dt>Búsqueda potente</dt><dd>Encuentra mensajes incluso con erratas o palabras incompletas. Busca en chats y canales, filtra por autor o fecha y recupera el contexto de la conversación.<code>tg messages search \"contrato\"</code></dd></div>\n      <div><dt>Almacenamiento local</dt><dd>El historial se guarda en una caché local en tu ordenador. Busca sin conexión, crea copias de seguridad y restaura el historial cuando lo necesites.<code>tg store backup · tg store restore</code></dd></div>\n      <div><dt>Permisos flexibles</dt><dd>Tú controlas qué puede hacer el agente: solo leer, ejecutar comandos permitidos o pedirte permiso antes de actuar.<code>permissions.messages.send · --confirm-send</code></dd></div>\n      <div><dt>Siempre al día</dt><dd>Un servicio en segundo plano mantiene el historial local al día y sincroniza los mensajes pendientes tras un reinicio.<code>tg server install</code></dd></div>\n      <div><dt>Varias cuentas, varios bots</dt><dd>Cambia fácilmente entre cuentas y bots. Separa tus conversaciones personales de las de trabajo, o pide a tu agente que reúna contexto de varias cuentas.<code>tg work inbox</code></dd></div>\n      <div><dt>Historial de acciones</dt><dd>Consulta los intentos de envío y registra las ejecuciones de comandos cuando lo necesites. Los registros incluyen identificadores, estados y tiempos, sin el texto de los mensajes.<code>tg sends list · tg runs list · --record</code></dd></div>\n      <div><dt>Seguro</dt><dd>Los secretos se guardan en el almacén de contraseñas del sistema. Las contraseñas, los códigos de acceso, los números de teléfono y los tokens no se filtran a los registros ni al historial de comandos. La protección contra la inyección de instrucciones (prompt injection) ayuda a impedir que mensajes maliciosos controlen al agente.<code>tg session start</code></dd></div>\n    </dl>\n  </div>\n</section>\n<section id=\"day\"><div class=\"wrap\"><h2 class=\"big\">Un día con tu agente</h2><p class=\"intro\">Unos minutos con tu agente. El resto del día es tuyo.</p><div class=\"day-summary\"><div><time class=\"time\" datetime=\"08:00\">08:00</time><h3>Empieza por lo importante</h3><p>Recibe un resumen breve de los chats que necesitan tu atención.</p></div><div><time class=\"time\" datetime=\"11:00\">11:00</time><h3>Prepara una reunión</h3><p>Reúne los mensajes relevantes antes de empezar la conversación.</p></div><div><time class=\"time\" datetime=\"15:00\">15:00</time><h3>Haz avanzar las tareas</h3><p>Responde a una petición o retoma una conversación pendiente.</p></div><div><time class=\"time\" datetime=\"19:00\">19:00</time><h3>Cierra el día</h3><p>Consulta qué se ha resuelto y qué necesita atención mañana.</p></div></div></div></section>\n<section class=\"close\" id=\"closing\">\n  <div class=\"wrap\">\n    <h2 class=\"big\" id=\"closing-title\">Continúa la conversación con todo el contexto</h2>\n    <p class=\"intro\" id=\"closing-help\">Elige Telegram o MAX. La guía te acompaña desde la instalación hasta tu primera respuesta.</p>\n    <div class=\"cta\"><a class=\"btn\" href=\"/es/docs/installation#tg\">Empezar con Telegram →</a><a class=\"btn\" href=\"/es/docs/installation#max\">Empezar con MAX →</a></div>\n  </div>\n</section>\n\n\n\n\n<div data-search-playground></div>",
-  "footerHtml": "<footer class=\"site\">\n  <div class=\"wrap\">\n    <div class=\"foot\">\n      <div class=\"foot-brand\">\n        <a class=\"mark\" href=\"#\"><svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><circle class=\"ring\" cx=\"16\" cy=\"16\" r=\"16\"/><circle cx=\"16\" cy=\"16\" r=\"16\" fill=\"#4b53f0\"/><path class=\"wire\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\" fill=\"none\" stroke=\"#fff\" stroke-width=\"2.4\" stroke-linejoin=\"round\" stroke-linecap=\"round\"/><path class=\"pulse\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\"/></svg><span class=\"word\">WireCat</span></a>\n        <p>Tus conversaciones de Telegram y MAX, conectadas a tus scripts y agentes de IA.</p>\n        <span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Copiar</button></span>\n      </div>\n      <div><h2>Herramientas</h2><ul>\n        <li><a href=\"/es/docs/tg\">tg · Telegram</a></li>\n        <li><a href=\"/es/docs/max\">max · MAX</a></li>\n        <li><a href=\"/es/docs/tg/changelog\">Cambios de tg</a></li>\n        <li><a href=\"/es/docs/max/changelog\">Cambios de max</a></li></ul></div>\n      <div><h2>Documentación</h2><ul>\n        <li><a href=\"/es/docs/installation\">Instalación</a></li>\n        <li><a href=\"/es/docs/tg/usage\">Uso</a></li>\n        <li><a href=\"/es/docs/tg/commands\">Todos los comandos</a></li>\n        <li><a href=\"/es/docs/tg/troubleshooting\">Solución de problemas</a></li></ul></div>\n      <div><h2>Para agentes</h2><ul>\n        <li><a href=\"/es/docs/mcp\">Servidor MCP</a></li>\n        <li><a href=\"/es/docs/tg/recipes\">Recetas</a></li>\n        <li><a href=\"/llms.txt\"><code>/llms.txt</code></a></li>\n        <li><a href=\"/llms-full.txt\"><code>/llms-full.txt</code></a></li></ul></div>\n      <div><h2>Proyecto</h2><ul>\n        <li><a href=\"https://github.com/leemour/tg-cli\">tg en GitHub</a></li>\n        <li><a href=\"https://github.com/leemour/max-cli\">max en GitHub</a></li>\n        <li><a href=\"/es/about\">Acerca de</a></li><li><a href=\"https://github.com/leemour/tg-cli/issues\">Informar de un problema</a></li>\n        <li><a href=\"/es/docs/tg/security\">Seguridad</a></li></ul></div>\n    </div>\n    <div class=\"foot-bottom\">\n      <span>© 2026 WireCat · licencia MIT · Windows, macOS, Linux</span>\n      <div class=\"footer-controls\"><button class=\"theme-toggle\" type=\"button\" aria-label=\"Switch theme\" title=\"Switch theme\"><svg class=\"theme-sun\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"4\"/><path d=\"M12 2v2m0 16v2M2 12h2m16 0h2M5 5l1.5 1.5m11 11L19 19M5 19l1.5-1.5m11-11L19 5\"/></svg><svg class=\"theme-moon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M20.5 14a9 9 0 0 1-10.5-10.5A9 9 0 1 0 20.5 14Z\"/></svg></button><details class=\"lang footer-language\"><summary aria-label=\"Idioma\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"9\"/><ellipse cx=\"12\" cy=\"12\" rx=\"4\" ry=\"9\"/><path d=\"M3 12h18\"/></svg><span>ES</span><svg class=\"dn\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"lang-menu\"><a href=\"/en\">English</a><a href=\"/ru\">Русский</a><a href=\"/es\" aria-current=\"page\">Español</a></div></details></div>\n    </div>\n  </div>\n</footer>",
+  "footerHtml": "<footer class=\"site\">\n  <div class=\"wrap\">\n    <div class=\"foot\">\n      <div class=\"foot-brand\">\n        <a class=\"mark\" href=\"#\"><svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><circle class=\"ring\" cx=\"16\" cy=\"16\" r=\"16\"/><circle cx=\"16\" cy=\"16\" r=\"16\" fill=\"#4b53f0\"/><path class=\"wire\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\" fill=\"none\" stroke=\"#fff\" stroke-width=\"2.4\" stroke-linejoin=\"round\" stroke-linecap=\"round\"/><path class=\"pulse\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\"/></svg><span class=\"word\">WireCat</span></a>\n        <p>Tus conversaciones de Telegram y MAX, conectadas a tus scripts y agentes de IA.</p>\n        <span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Copiar</button></span>\n      </div>\n      <div><h2>Herramientas</h2><ul>\n        <li><a href=\"/es/docs/tg\">tg · Telegram</a></li>\n        <li><a href=\"/es/docs/max\">max · MAX</a></li>\n        <li><a href=\"/es/docs/tg/changelog\">Cambios de tg</a></li>\n        <li><a href=\"/es/docs/max/changelog\">Cambios de max</a></li></ul></div>\n      <div><h2>Documentación</h2><ul>\n        <li><a href=\"/es/docs/installation\">Instalación</a></li>\n        <li><a href=\"/es/docs/tg/usage\">Uso</a></li>\n        <li><a href=\"/es/docs/tg/commands\">Todos los comandos</a></li>\n        <li><a href=\"/es/docs/tg/troubleshooting\">Solución de problemas</a></li></ul></div>\n      <div><h2>Para agentes</h2><ul>\n        <li><a href=\"/es/docs/mcp\">Servidor MCP</a></li>\n        <li><a href=\"/es/docs/tg/recipes\">Recetas</a></li>\n        <li><a href=\"/llms.txt\"><code>/llms.txt</code></a></li>\n        <li><a href=\"/llms-full.txt\"><code>/llms-full.txt</code></a></li></ul></div>\n      <div><h2>Proyecto</h2><ul>\n        <li><a href=\"https://github.com/leemour/tg-cli\">tg en GitHub</a></li>\n        <li><a href=\"https://github.com/leemour/max-cli\">max en GitHub</a></li>\n        <li><a href=\"/es/about\">Acerca de</a></li><li><a href=\"https://t.me/wirecatdev\">Informar de un problema</a></li>\n        <li><a href=\"/es/docs/security\">Seguridad</a></li></ul></div>\n    </div>\n    <div class=\"foot-bottom\">\n      <span>© 2026 WireCat · licencia MIT · Windows, macOS, Linux</span>\n      <div class=\"footer-controls\"><button class=\"theme-toggle\" type=\"button\" aria-label=\"Switch theme\" title=\"Switch theme\"><svg class=\"theme-sun\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"4\"/><path d=\"M12 2v2m0 16v2M2 12h2m16 0h2M5 5l1.5 1.5m11 11L19 19M5 19l1.5-1.5m11-11L19 5\"/></svg><svg class=\"theme-moon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M20.5 14a9 9 0 0 1-10.5-10.5A9 9 0 1 0 20.5 14Z\"/></svg></button><details class=\"lang footer-language\"><summary aria-label=\"Idioma\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"9\"/><ellipse cx=\"12\" cy=\"12\" rx=\"4\" ry=\"9\"/><path d=\"M3 12h18\"/></svg><span>ES</span><svg class=\"dn\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"lang-menu\"><a href=\"/en\">English</a><a href=\"/ru\">Русский</a><a href=\"/es\" aria-current=\"page\">Español</a></div></details></div>\n    </div>\n  </div>\n</footer>",
   "sessions": [
     {
       "id": "context",
diff --git a/lib/landing/ru.json b/lib/landing/ru.json
index 8b5d667..b2ceca5 100644
--- a/lib/landing/ru.json
+++ b/lib/landing/ru.json
@@ -1,6 +1,6 @@
 {
   "html": "<section class=\"wrap hero\" aria-labelledby=\"headline\">\n  <div class=\"hero-text\">\n    <h1 id=\"headline\">Хватит листать чаты. <span>Просто спросите.</span></h1>\n    <div>\n      <p class=\"lede\">Подключите Claude Code, Codex или другого агента к <b>Telegram и MAX</b>. Находите важное, вспоминайте договорённости и отвечайте с учётом всей переписки.</p>\n      <div class=\"cta\"><details class=\"agent-connect\"><summary class=\"btn\">Подключите агента<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"connect-menu\"><p>Нажмите, чтобы скопировать команду установки.</p><button class=\"connect-choice\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\" aria-label=\"Telegram: Копировать\"><span class=\"connect-choice-title\"><strong>Telegram</strong><span data-copy-label role=\"status\" aria-live=\"polite\">Копировать</span></span><code>npm i -g @leemour/tg-cli</code></button><a class=\"connect-guide\" href=\"/ru/docs/installation#tg\">Инструкция: Telegram →</a><button class=\"connect-choice\" type=\"button\" data-copy=\"npm i -g @leemour/max-cli\" aria-label=\"MAX: Копировать\"><span class=\"connect-choice-title\"><strong>MAX</strong><span data-copy-label role=\"status\" aria-live=\"polite\">Копировать</span></span><code>npm i -g @leemour/max-cli</code></button><a class=\"connect-guide\" href=\"/ru/docs/installation#max\">Инструкция: MAX →</a></div></details></div>\n      <p class=\"tagline\"><b>ИИ-переписка через CLI для агентов.</b> Бесплатно, с открытым кодом.</p>\n    </div>\n  </div>\n\n  <h2 class=\"sr-only\">Диалог с агентом</h2><div class=\"app\" id=\"app\">\n    <div class=\"titlebar\"><i></i><i></i><i></i><span>Агент · ~/inbox</span>\n      <div class=\"demo-messengers\" role=\"group\" aria-label=\"Мессенджер для примера\"><button type=\"button\" data-messenger=\"tg\" aria-pressed=\"true\">Telegram</button><button type=\"button\" data-messenger=\"max\" aria-pressed=\"false\">MAX</button></div><button class=\"replay\" type=\"button\" id=\"replay\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" aria-hidden=\"true\"><path d=\"M2.5 8a5.5 5.5 0 1 0 1.8-4.1M2.5 2v3.5H6\"/></svg>Повторить</button>\n    </div>\n    <div class=\"app-body\">\n      <nav class=\"sessions\" aria-label=\"Сессии\" id=\"sessions\"><h2>Сессии</h2><button class=\"session\" type=\"button\" aria-current=\"true\">Контекст к созвону<small>tg chats list → tg review</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Найти рекомендации<small>messages search --source all</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Управление группой<small>chats moderate --dry-run</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Утренняя сводка<small>tg inbox → tg review</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Договорённости и ответы<small>tg review --unanswered</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Напоминания и отправка<small>tg messages send --at-time</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Все документы по теме<small>tg chats list → tg messages search</small></button><button class=\"session\" type=\"button\" aria-current=\"false\">Бот для клиентов<small>tg bot messages list → tg bot messages send</small></button></nav>\n      <div class=\"conv\">\n        <div class=\"log\" id=\"log\"><div class=\"ask step\"><p>Используй tg cli, собери контекст к завтрашнему созвону по Atlas: решения, риски и <span class=\"prompt-ending\">вопросы.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Используй tg cli, собери контекст к завтрашнему созвону по Atlas: решения, риски и вопросы.\" aria-label=\"Копировать запрос\" title=\"Копировать запрос\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Копировать запрос</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg chats list <b>--search \"Atlas\"</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"101\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · команда\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"group\"</span>\n    },\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"102\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas · дизайн\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"group\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg review <b>--chat \"Atlas · команда\" --since-time 7d</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"chats\"</span>: [\n    {\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas\"</span>,\n      <span class=\"k\">\"messages\"</span>: [\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Анна\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Запускаем в пятницу.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        },\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48211\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Марко\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Анна ждёт финальные тексты до четверга.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        },\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48212\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Том\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Тому нужен доступ к стенду.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        }\n      ],\n      <span class=\"k\">\"more\"</span>: <span class=\"n\">false</span>\n    }\n  ],\n  <span class=\"k\">\"skipped\"</span>: [],\n  <span class=\"k\">\"partial\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Уже решили</span><ul><li><b>Запуск:</b> пятница, объём первой версии зафиксирован.</li><li><b>Тексты:</b> Анне нужна финальная версия до четверга.</li></ul><span class=\"answer-label\">Блокирует запуск</span><p><b>Том:</b> ждёт доступ к стенду для проверки оплаты.</p><span class=\"answer-label\">К созвону</span><p>Назначить ответственного за доступ и срок проверки. Нашёл также группу дизайна — могу проверить её и личные договорённости участников.</p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Исходные сообщения<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-3-0\"><summary><span class=\"evidence-heading\"><strong>Анна <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Atlas · Telegram · 2 окт. 2026 г.</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Запускаем в пятницу.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-3-1\"><summary><span class=\"evidence-heading\"><strong>Марко <span class=\"evidence-id\">#48211</span></strong><span class=\"evidence-meta\">Atlas · Telegram · 2 окт. 2026 г.</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Анна ждёт финальные тексты до четверга.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-3-2\"><summary><span class=\"evidence-heading\"><strong>Том <span class=\"evidence-id\">#48212</span></strong><span class=\"evidence-meta\">Atlas · Telegram · 2 окт. 2026 г.</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Тому нужен доступ к стенду.</blockquote></details></div></details></div><div class=\"ask step\"><p>Посмотри ещё дизайн и мою личку с Томом. Он мог прислать результат <span class=\"prompt-ending\">туда.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Посмотри ещё дизайн и мою личку с Томом. Он мог прислать результат туда.\" aria-label=\"Копировать запрос\" title=\"Копировать запрос\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Копировать запрос</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg review <b>--chat \"Atlas · дизайн\" --since-time 7d</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"chats\"</span>: [\n    {\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Atlas\"</span>,\n      <span class=\"k\">\"messages\"</span>: [\n        {\n          <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n          <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Анна\"</span>,\n          <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Макет готов. Финальные тексты ещё ждём.\"</span>,\n          <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n        }\n      ],\n      <span class=\"k\">\"more\"</span>: <span class=\"n\">false</span>\n    }\n  ],\n  <span class=\"k\">\"skipped\"</span>: [],\n  <span class=\"k\">\"partial\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg chats list <b>--search \"Том\"</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"503\"</span>,\n      <span class=\"k\">\"title\"</span>: <span class=\"s\">\"Том\"</span>,\n      <span class=\"k\">\"kind\"</span>: <span class=\"s\">\"private\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages list <b>503 --limit 30</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Том\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Проверил тестовую оплату. Для боевого стенда всё ещё нужен доступ.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages search <b>\"Atlas\" --chat 503 --language legacy</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Том\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Проверил тестовую оплату. Для боевого стенда всё ещё нужен доступ.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Контекст из других чатов</span><ul><li><b>Дизайн:</b> макет готов; тексты остаются последней зависимостью.</li><li><b>Том, личная переписка:</b> тестовую оплату проверил. Доступ нужен именно к боевому стенду.</li></ul><span class=\"answer-label\">Уточнённый риск</span><p>Не вся проверка оплаты заблокирована — осталась проверка в боевой среде. На созвоне стоит обсуждать её, а не начинать с нуля.</p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Исходные сообщения<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-9-0\"><summary><span class=\"evidence-heading\"><strong>Том <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Том · Telegram · 2 окт. 2026 г.</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Проверил тестовую оплату. Для боевого стенда всё ещё нужен доступ.</blockquote></details></div></details></div><div class=\"ask step\"><p>Сделай повестку на 20 минут: риски, ответственные и сроки. Ничего не <span class=\"prompt-ending\">отправляй.<span class=\"prompt-actions\"><button type=\"button\" data-prompt=\"Сделай повестку на 20 минут: риски, ответственные и сроки. Ничего не отправляй.\" aria-label=\"Копировать запрос\" title=\"Копировать запрос\"><svg class=\"prompt-copy-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"8\" y=\"8\" width=\"12\" height=\"12\" rx=\"2\"/><path d=\"M16 8V4a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h4\"/></svg><svg class=\"prompt-copied-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m5 12 4 4L19 6\"/></svg><span class=\"prompt-feedback\" data-prompt-label role=\"status\" aria-live=\"polite\">Копировать запрос</span></button></span></span></p></div><details class=\"tool step\"><summary><span class=\"state\"><svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M3 8.5l3 3 7-7\"/></svg></span><code>tg messages context <b>503 48210 --before-n 2 --after-n 2</b></code><svg class=\"chev\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg></summary><pre>{\n  <span class=\"k\">\"items\"</span>: [\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48210\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Том\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Проверил тестовую оплату. Для боевого стенда всё ещё нужен доступ.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    },\n    {\n      <span class=\"k\">\"id\"</span>: <span class=\"s\">\"48211\"</span>,\n      <span class=\"k\">\"senderName\"</span>: <span class=\"s\">\"Том\"</span>,\n      <span class=\"k\">\"text\"</span>: <span class=\"s\">\"Нужен доступ к боевому стенду.\"</span>,\n      <span class=\"k\">\"timestamp\"</span>: <span class=\"s\">\"2026-10-02T09:00:00Z\"</span>\n    }\n  ],\n  <span class=\"k\">\"hasMore\"</span>: <span class=\"n\">false</span>\n}</pre></details><div class=\"say step\"><span class=\"answer-label\">Повестка на 20 минут</span><ol><li><b>0–7:</b> боевой стенд — кто выдаёт доступ и когда Том завершит проверку.</li><li><b>7–12:</b> финальные тексты — кто передаёт Анне до четверга.</li><li><b>12–17:</b> если не успеваем — сокращаем объём или переносим запуск?</li><li><b>17–20:</b> зафиксировать владельца и срок каждого решения.</li></ol><p><small>Черновик готов. Учтены проектная группа, дизайн и личная переписка с Томом. Ничего не отправлено.</small></p><details class=\"answer-sources\"><summary class=\"sources-toggle\">Исходные сообщения<svg class=\"sources-chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><div class=\"sources-list\"><details class=\"evidence-message\" id=\"evidence-tg-context-12-0\"><summary><span class=\"evidence-heading\"><strong>Том <span class=\"evidence-id\">#48210</span></strong><span class=\"evidence-meta\">Том · Telegram · 2 окт. 2026 г.</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Проверил тестовую оплату. Для боевого стенда всё ещё нужен доступ.</blockquote></details><details class=\"evidence-message\" id=\"evidence-tg-context-12-1\"><summary><span class=\"evidence-heading\"><strong>Том <span class=\"evidence-id\">#48211</span></strong><span class=\"evidence-meta\">Том · Telegram · 2 окт. 2026 г.</span></span><svg class=\"evidence-chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 4 4 4-4 4\"/></svg></summary><blockquote>Нужен доступ к боевому стенду.</blockquote></details></div></details></div></div>\n        <div class=\"composer\"><span>Спросите о своих чатах…</span><span class=\"slash\">Непрочитанное</span><span class=\"slash\">Договорённости</span><span class=\"slash\">Ответы</span><span class=\"slash\">Поиск</span></div>\n      </div>\n    </div>\n  </div>\n</section>\n\n\n\n\n\n\n\n\n\n\n\n<section id=\"features\" style=\"padding-top:0\">\n  <div class=\"wrap\">\n    <h2 class=\"big\" id=\"feat-title\">Меньше рутины в мессенджерах</h2>\n    <p class=\"intro\">Следите за договорённостями, помогайте клиентам и поддерживайте порядок в группах. Поручите агенту работу с Telegram и MAX.</p>\n    <div class=\"fv fv6\" data-variant=\"6\"><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"8\" r=\"3.6\"/><path d=\"M4.5 20c1.2-4 4.2-6 7.5-6s6.3 2 7.5 6\"/></svg></span><span class=\"fv-name\">Личный аккаунт</span><span class=\"fv-short\">Поиск контекста, принятие решений и напоминания</span></div><p class=\"fv-lead\">Ваш аккаунт как ещё одно ваше устройство: все чаты с историей, группы, каналы и контакты.</p><div class=\"g6\"><div class=\"t6\"><b>Непрочитанное во всех чатах сразу</b><span>Чужие сообщения, и ничего не отмечается прочитанным.</span></div><div class=\"t6\"><b>Помните о договорённостях</b><span>Всё сказанное с прошлого разбора, и ваше тоже, одним вызовом.</span></div><div class=\"t6\"><b>Находите даже с опечаткой</b><span>Ищите сразу по чатам: по словам, части слова или неточному написанию — в локальном архиве.</span></div><div class=\"t6\"><b>Новости из ваших подписок</b><span>Попросите агента собрать новости из ваших каналов по нужным темам, со ссылками на публикации.</span></div><div class=\"t6\"><b>Голосовые — текстом</b><span>Силами Telegram или моделью на вашем компьютере.</span></div><div class=\"t6\"><b>Отправка по времени</b><span>Telegram доставит вовремя, даже если ноутбук закрыт.</span></div></div><a class=\"more\" href=\"/ru/docs/tg/usage\">Как работать с аккаунтом →</a></div><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"4\" y=\"8\" width=\"16\" height=\"11\" rx=\"3\"/><path d=\"M12 4v4M9 13h.01M15 13h.01M9.5 16.5h5\"/></svg></span><span class=\"fv-name\">Боты</span><span class=\"fv-short\">персонализация, помощь клиентам и рассылки</span></div><p class=\"fv-lead\"><strong><a href=\"/ru/docs/bot-api\">Все методы Bot API.</a></strong> Все методы официальных Bot API Telegram и MAX доступны через CLI — вместе с удобными командами для сообщений, файлов и управления чатами.</p><div class=\"g6\"><div class=\"t6\"><b>Групповые рассылки</b><span>Попросите агента разослать объявление в выбранные группы и каналы.</span></div><div class=\"t6\"><b>Персонализация</b><span>Агент подготовит разные сообщения для клиентов по данным, которые вы ему передадите.</span></div><div class=\"t6\"><b>Ответы с контекстом</b><span>Передайте агенту базу знаний или историю обращений, чтобы он помогал отвечать на вопросы клиентов.</span></div><div class=\"t6\"><b>Уведомления команды</b><span>Сообщайте о новых заявках, результатах и изменениях — вместе с нужными файлами.</span></div><div class=\"t6\"><b>Кнопки и понятные сценарии</b><span>Помогите пользователю выбрать действие, открыть ссылку или ответить одним нажатием.</span></div><div class=\"t6\"><b>Контроль отправок</b><span>Выберите, кому бот может писать, и проверяйте, какие отправки прошли, а где возникла ошибка.</span></div></div><a class=\"more\" href=\"/ru/docs/max/bot\">Как настроить бота →</a></div><div class=\"grp6\"><div class=\"head6\"><span class=\"fv-ico\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><circle cx=\"9\" cy=\"9\" r=\"3\"/><circle cx=\"17\" cy=\"10\" r=\"2.4\"/><path d=\"M3.5 19c.9-3.2 3-4.8 5.5-4.8s4.6 1.6 5.5 4.8M14.5 15c2.6-.4 4.6.9 5.5 3.6\"/></svg></span><span class=\"fv-name\">Ваши группы</span><span class=\"fv-short\">Модерация, ответы на вопросы и порядок</span></div><p class=\"fv-lead\">Помогайте участникам получать ответы, сохраняйте решения и поддерживайте порядок в обсуждениях.</p><div class=\"g6\"><div class=\"t6\"><b>Мониторинг вопросов</b><span>Находите вопросы, оставшиеся без ответа, чтобы участники получали нужную помощь.</span></div><div class=\"t6\"><b>Аналитика</b><span>Кто вступил, вышел, кого добавили или удалили — и кто это сделал.</span></div><div class=\"t6\"><b>Контроль дискуссий</b><span>Попросите агента отметить спам, ругательства и конфликты, чтобы вовремя вмешаться.</span></div><div class=\"t6\"><b>Модерация по правилам</b><span>Задайте, какие нарушения отмечать, какие сообщения удалять и когда удалять участника.</span></div><div class=\"t6\"><b>Итоги обсуждений</b><span>Получайте решения, открытые вопросы и следующие шаги без перечитывания всей переписки.</span></div><div class=\"t6\"><b>Управление группой</b><span>Делегируйте агенту рутину: приглашение участников, смену администраторов и обновление ссылок.</span></div></div><a class=\"more\" href=\"/ru/docs/tg/groups\">Как вести группу →</a></div></div>\n  </div>\n</section>\n<!--time-savings-->\n<section>\n  <div class=\"wrap\">\n    <h2 class=\"big\">Telegram и MAX — один поиск</h2>\n    <p class=\"intro\">Ищите сообщения сразу в обоих. Собирайте договорённости и файлы из сохранённой истории.</p>\n    <div class=\"tools\">\n      <article class=\"tool-card\"><div class=\"tool-name\">tg<small>Telegram</small></div><p>Клиент Telegram для терминала и ИИ-агентов, на вашем собственном аккаунте.</p><span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Копировать</button></span><div class=\"tool-links\"><a href=\"/ru/docs/tg\" target=\"_blank\" rel=\"noopener noreferrer\">Документация<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://github.com/leemour/tg-cli\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://www.npmjs.com/package/@leemour/tg-cli\" target=\"_blank\" rel=\"noopener noreferrer\">npm<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a></div></article>\n      <article class=\"tool-card\"><div class=\"tool-name\">max<small>Мессенджер MAX</small></div><p>Ваши боты MAX через официальный Bot API и ваш личный аккаунт.</p><span class=\"cmd\"><code>npm i -g @leemour/max-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/max-cli\">Копировать</button></span><div class=\"tool-links\"><a href=\"/ru/docs/max\" target=\"_blank\" rel=\"noopener noreferrer\">Документация<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://github.com/leemour/max-cli\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a><a href=\"https://www.npmjs.com/package/@leemour/max-cli\" target=\"_blank\" rel=\"noopener noreferrer\">npm<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M7 17 17 7M7 7h10v10\"/></svg></a></div></article>\n    </div>\n  </div>\n</section>\n<section class=\"band\" id=\"why\">\n  <div class=\"wrap\">\n    <h2 class=\"big\">Почему это работает так хорошо</h2>\n    <p class=\"intro\">Сделано в первую очередь для агентов и скриптов: быстро, предсказуемо и с журналом.</p>\n    <dl class=\"spec\">\n      <div><dt>Быстро</dt><dd>Поиск идёт по копии чатов на вашем компьютере. Без сети и без ожидания.<code>tg messages search \"договор\" --offline</code></dd></div>\n      <div><dt>Работает везде</dt><dd>Windows, macOS и Linux, Node 22 и новее. Ничего не нужно собирать.<code>npm i -g @leemour/tg-cli</code></dd></div>\n      <div><dt>Мощный поиск</dt><dd>Находите сообщения даже с опечатками или по части слова. Ищите по чатам и каналам, уточняйте автора и дату и восстанавливайте контекст переписки.<code>tg messages search \"договор\"</code></dd></div>\n      <div><dt>Локальное хранение</dt><dd>История переписок хранится в локальном кеше на вашем компьютере. Ищите без интернета, создавайте бэкапы и восстанавливайте архив при необходимости.<code>tg store backup · tg store restore</code></dd></div>\n      <div><dt>Гибкая настройка прав</dt><dd>Вы контролируете, что может выполнять агент: только читать, запускать разрешённые команды или спрашивать ваше разрешение перед действием.<code>permissions.messages.send · --confirm-send</code></dd></div>\n      <div><dt>Всегда свежее</dt><dd>Фоновая служба держит копию в актуальном состоянии и догоняет пропущенное после перезапуска.<code>tg server install</code></dd></div>\n      <div><dt>Много аккаунтов и ботов</dt><dd>Удобно переключайтесь между аккаунтами и ботами. Разделяйте рабочие и личные переписки или поручайте агенту собирать общий контекст из нескольких аккаунтов.<code>tg work inbox</code></dd></div>\n      <div><dt>История действий</dt><dd>Смотрите попытки отправки в журнале и при необходимости записывайте запуски команд. В логах — ID, статусы и время выполнения, без текста сообщений.<code>tg sends list · tg runs list · --record</code></dd></div>\n      <div><dt>Безопасно</dt><dd>Секреты хранятся в системном хранилище паролей. Пароли, коды входа и номера телефонов не утекают. Защита от prompt injection не даст злоумышленникам управлять агентом.<code>tg session start</code></dd></div>\n    </dl>\n  </div>\n</section>\n<section id=\"day\"><div class=\"wrap\"><h2 class=\"big\">Один день с агентом</h2><p class=\"intro\">Несколько обращений к агенту. Остальное время — ваше.</p><div class=\"day-summary\"><div><time class=\"time\" datetime=\"08:00\">08:00</time><h3>Начните с главного</h3><p>Получите короткую сводку чатов, которым нужно ваше внимание.</p></div><div><time class=\"time\" datetime=\"11:00\">11:00</time><h3>Подготовьтесь к встрече</h3><p>Соберите нужные сообщения перед началом разговора.</p></div><div><time class=\"time\" datetime=\"15:00\">15:00</time><h3>Продвиньте дела</h3><p>Ответьте на запрос или напомните о том, чего ждёте.</p></div><div><time class=\"time\" datetime=\"19:00\">19:00</time><h3>Завершите день</h3><p>Посмотрите, что решено и к чему вернуться завтра.</p></div></div></div></section>\n<section class=\"close\" id=\"closing\">\n  <div class=\"wrap\">\n    <h2 class=\"big\" id=\"closing-title\">Продолжайте разговор с полным контекстом</h2>\n    <p class=\"intro\" id=\"closing-help\">Выберите мессенджер. Гайд проведёт вас от установки до первого ответа.</p>\n    <div class=\"cta\"><a class=\"btn\" href=\"/ru/docs/installation#tg\">Начать с Telegram →</a><a class=\"btn\" href=\"/ru/docs/installation#max\">Начать с MAX →</a></div>\n  </div>\n</section>\n\n\n\n\n<div data-search-playground></div>",
-  "footerHtml": "<footer class=\"site\">\n  <div class=\"wrap\">\n    <div class=\"foot\">\n      <div class=\"foot-brand\">\n        <a class=\"mark\" href=\"#\"><svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><circle class=\"ring\" cx=\"16\" cy=\"16\" r=\"16\"/><circle cx=\"16\" cy=\"16\" r=\"16\" fill=\"#4b53f0\"/><path class=\"wire\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\" fill=\"none\" stroke=\"#fff\" stroke-width=\"2.4\" stroke-linejoin=\"round\" stroke-linecap=\"round\"/><path class=\"pulse\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\"/></svg><span class=\"word\">WireCat</span></a>\n        <p>ИИ-переписка через CLI для агентов. Ваши Telegram и MAX — для вас, ваших скриптов и ИИ-агентов.</p>\n        <span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Копировать</button></span>\n      </div>\n      <div><h2>Инструменты</h2><ul>\n        <li><a href=\"/ru/docs/tg\">tg · Telegram</a></li>\n        <li><a href=\"/ru/docs/max\">max · MAX</a></li>\n        <li><a href=\"/ru/docs/tg/changelog\">Изменения tg</a></li>\n        <li><a href=\"/ru/docs/max/changelog\">Изменения max</a></li></ul></div>\n      <div><h2>Документация</h2><ul>\n        <li><a href=\"/ru/docs/installation\">Установка</a></li>\n        <li><a href=\"/ru/docs/tg/usage\">Использование</a></li>\n        <li><a href=\"/ru/docs/tg/commands\">Все команды</a></li>\n        <li><a href=\"/ru/docs/tg/troubleshooting\">Если что-то не так</a></li></ul></div>\n      <div><h2>Для агентов</h2><ul>\n        <li><a href=\"/ru/docs/mcp\">MCP-сервер</a></li>\n        <li><a href=\"/ru/docs/tg/recipes\">Рецепты</a></li>\n        <li><a href=\"/llms.txt\"><code>/llms.txt</code></a></li>\n        <li><a href=\"/llms-full.txt\"><code>/llms-full.txt</code></a></li></ul></div>\n      <div><h2>Проект</h2><ul>\n        <li><a href=\"https://github.com/leemour/tg-cli\">tg на GitHub</a></li>\n        <li><a href=\"https://github.com/leemour/max-cli\">max на GitHub</a></li>\n        <li><a href=\"/ru/about\">О проекте</a></li><li><a href=\"https://github.com/leemour/tg-cli/issues\">Сообщить о проблеме</a></li>\n        <li><a href=\"/ru/docs/tg/security\">Безопасность</a></li></ul></div>\n    </div>\n    <div class=\"foot-bottom\">\n      <span>© 2026 WireCat · лицензия MIT · Windows, macOS, Linux</span>\n      <div class=\"footer-controls\"><button class=\"theme-toggle\" type=\"button\" aria-label=\"Switch theme\" title=\"Switch theme\"><svg class=\"theme-sun\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"4\"/><path d=\"M12 2v2m0 16v2M2 12h2m16 0h2M5 5l1.5 1.5m11 11L19 19M5 19l1.5-1.5m11-11L19 5\"/></svg><svg class=\"theme-moon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M20.5 14a9 9 0 0 1-10.5-10.5A9 9 0 1 0 20.5 14Z\"/></svg></button><details class=\"lang footer-language\"><summary aria-label=\"Язык\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"9\"/><ellipse cx=\"12\" cy=\"12\" rx=\"4\" ry=\"9\"/><path d=\"M3 12h18\"/></svg><span>RU</span><svg class=\"dn\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"lang-menu\"><a href=\"/en\">English</a><a href=\"/ru\" aria-current=\"page\">Русский</a><a href=\"/es\">Español</a></div></details></div>\n    </div>\n  </div>\n</footer>",
+  "footerHtml": "<footer class=\"site\">\n  <div class=\"wrap\">\n    <div class=\"foot\">\n      <div class=\"foot-brand\">\n        <a class=\"mark\" href=\"#\"><svg viewBox=\"0 0 32 32\" aria-hidden=\"true\"><circle class=\"ring\" cx=\"16\" cy=\"16\" r=\"16\"/><circle cx=\"16\" cy=\"16\" r=\"16\" fill=\"#4b53f0\"/><path class=\"wire\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\" fill=\"none\" stroke=\"#fff\" stroke-width=\"2.4\" stroke-linejoin=\"round\" stroke-linecap=\"round\"/><path class=\"pulse\" pathLength=\"40\" d=\"M9 21V11l4 4 3-4 3 4 4-4v10\"/></svg><span class=\"word\">WireCat</span></a>\n        <p>ИИ-переписка через CLI для агентов. Ваши Telegram и MAX — для вас, ваших скриптов и ИИ-агентов.</p>\n        <span class=\"cmd\"><code>npm i -g @leemour/tg-cli</code><button class=\"copy\" type=\"button\" data-copy=\"npm i -g @leemour/tg-cli\">Копировать</button></span>\n      </div>\n      <div><h2>Инструменты</h2><ul>\n        <li><a href=\"/ru/docs/tg\">tg · Telegram</a></li>\n        <li><a href=\"/ru/docs/max\">max · MAX</a></li>\n        <li><a href=\"/ru/docs/tg/changelog\">Изменения tg</a></li>\n        <li><a href=\"/ru/docs/max/changelog\">Изменения max</a></li></ul></div>\n      <div><h2>Документация</h2><ul>\n        <li><a href=\"/ru/docs/installation\">Установка</a></li>\n        <li><a href=\"/ru/docs/tg/usage\">Использование</a></li>\n        <li><a href=\"/ru/docs/tg/commands\">Все команды</a></li>\n        <li><a href=\"/ru/docs/tg/troubleshooting\">Если что-то не так</a></li></ul></div>\n      <div><h2>Для агентов</h2><ul>\n        <li><a href=\"/ru/docs/mcp\">MCP-сервер</a></li>\n        <li><a href=\"/ru/docs/tg/recipes\">Рецепты</a></li>\n        <li><a href=\"/llms.txt\"><code>/llms.txt</code></a></li>\n        <li><a href=\"/llms-full.txt\"><code>/llms-full.txt</code></a></li></ul></div>\n      <div><h2>Проект</h2><ul>\n        <li><a href=\"https://github.com/leemour/tg-cli\">tg на GitHub</a></li>\n        <li><a href=\"https://github.com/leemour/max-cli\">max на GitHub</a></li>\n        <li><a href=\"/ru/about\">О проекте</a></li><li><a href=\"https://t.me/wirecatdev\">Сообщить о проблеме</a></li>\n        <li><a href=\"/ru/docs/security\">Безопасность</a></li></ul></div>\n    </div>\n    <div class=\"foot-bottom\">\n      <span>© 2026 WireCat · лицензия MIT · Windows, macOS, Linux</span>\n      <div class=\"footer-controls\"><button class=\"theme-toggle\" type=\"button\" aria-label=\"Switch theme\" title=\"Switch theme\"><svg class=\"theme-sun\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"4\"/><path d=\"M12 2v2m0 16v2M2 12h2m16 0h2M5 5l1.5 1.5m11 11L19 19M5 19l1.5-1.5m11-11L19 5\"/></svg><svg class=\"theme-moon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M20.5 14a9 9 0 0 1-10.5-10.5A9 9 0 1 0 20.5 14Z\"/></svg></button><details class=\"lang footer-language\"><summary aria-label=\"Язык\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.6\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"9\"/><ellipse cx=\"12\" cy=\"12\" rx=\"4\" ry=\"9\"/><path d=\"M3 12h18\"/></svg><span>RU</span><svg class=\"dn\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" aria-hidden=\"true\"><path d=\"m4 6 4 4 4-4\"/></svg></summary><div class=\"lang-menu\"><a href=\"/en\">English</a><a href=\"/ru\" aria-current=\"page\">Русский</a><a href=\"/es\">Español</a></div></details></div>\n    </div>\n  </div>\n</footer>",
   "sessions": [
     {
       "id": "context",
diff --git a/scripts/export-landing.mjs b/scripts/export-landing.mjs
index c563e64..8305005 100644
--- a/scripts/export-landing.mjs
+++ b/scripts/export-landing.mjs
@@ -193,8 +193,8 @@ for (const lang of ["en", "ru", "es"]) {
     html = html.replace(/(<nav class="site"[\s\S]*?)(<\/nav>)/, `$1<a href="/${lang}/about">${aboutLabel}</a>$2`)
   }
   html = html.replace(
-    '<li><a href="https://github.com/leemour/tg-cli/issues">',
-    `<li><a href="/${lang}/about">${aboutLabel}</a></li><li><a href="https://github.com/leemour/tg-cli/issues">`,
+    '<li><a href="https://t.me/wirecatdev">',
+    `<li><a href="/${lang}/about">${aboutLabel}</a></li><li><a href="https://t.me/wirecatdev">`,
   )
   const w = copy[lang]
   html = html.replace(/<section class="band" id="connect">[\s\S]*?<\/section>/, "")
diff --git a/scripts/localize.test.ts b/scripts/localize.test.ts
index 9b072df..ebe2105 100644
--- a/scripts/localize.test.ts
+++ b/scripts/localize.test.ts
@@ -7,6 +7,7 @@ import {
   correctDocumentation,
   fingerprint,
   localizeTool,
+  siteLinks,
   translationProblems,
   withOriginalAnchors,
 } from "./localize.ts"
@@ -45,6 +46,10 @@ describe("released documentation translations", () => {
   it("marks the actual content language, including untranslated fallbacks", () => {
     expect(contentLanguage(original, "en")).toContain('contentLanguage: "en"')
   })
+  it("opens a site page named by its full URL in the reader's language", () => {
+    const page = "[shared page](https://wirecat.dev/ru/docs/security) · `https://wirecat.dev/ru/docs/x`"
+    expect(siteLinks(page, "es")).toBe("[shared page](/es/docs/security) · `https://wirecat.dev/ru/docs/x`")
+  })
   it("applies reviewed errata exactly once and rejects stale or ambiguous corrections", () => {
     const correction = [{ before: "old claim", after: "reviewed claim" }]
     expect(correctDocumentation("An old claim.", correction)).toBe("An reviewed claim.")
diff --git a/scripts/localize.ts b/scripts/localize.ts
index c27b0d9..e27198c 100644
--- a/scripts/localize.ts
+++ b/scripts/localize.ts
@@ -34,6 +34,10 @@ export const fingerprint = (text: string) =>
 export const contentLanguage = (text: string, lang: string) =>
   text.replace(/^---\r?\n/, `---\ncontentLanguage: ${JSON.stringify(lang)}\n`)
 
+/** A tool page names a site page by its full URL, in its own language; on the site it opens in the reader's. */
+export const siteLinks = (text: string, lang: string) =>
+  text.replace(/\]\(https:\/\/wirecat\.dev\/(?:en|ru|es)\/docs\//g, `](/${lang}/docs/`)
+
 type MarkdownNode = {
   type: string
   value?: string
@@ -164,39 +168,39 @@ export function localizeTool(root: string, tool: Tool) {
   for (const file of pages) {
     const slug = file.slice(0, -3)
     const original = readFileSync(join(source, file), "utf8")
-    writeFileSync(join(target, file), contentLanguage(corrected(original, slug, tool.lang), tool.lang))
+    writeFileSync(join(target, file), siteLinks(contentLanguage(corrected(original, slug, tool.lang), tool.lang), "en"))
     for (const lang of languages) {
       const overview = join(root, "translations/overviews", `${tool.name}.${lang}.md`)
       const path = join(translations, `${slug}.${lang}.md`)
       const destination = join(target, lang === "en" ? file : `${slug}.${lang}.md`)
       if (slug === "index" && existsSync(overview)) {
-        writeFileSync(destination, contentLanguage(readFileSync(overview, "utf8"), lang))
+        writeFileSync(destination, siteLinks(contentLanguage(readFileSync(overview, "utf8"), lang), lang))
         continue
       }
       if (lang === tool.lang && !existsSync(path)) {
-        writeFileSync(destination, contentLanguage(corrected(original, slug, lang), lang))
+        writeFileSync(destination, siteLinks(contentLanguage(corrected(original, slug, lang), lang), lang))
         continue
       }
       if (!existsSync(path)) {
         problems.push(`${tool.name}/${slug}.${lang}: missing translation`)
-        if (lang !== "en") writeFileSync(destination, contentLanguage(original, tool.lang))
+        if (lang !== "en") writeFileSync(destination, siteLinks(contentLanguage(original, tool.lang), lang))
         continue
       }
       if (hashes[`${tool.name}/${slug}.${lang}`] !== fingerprint(original)) {
         problems.push(`${tool.name}/${slug}.${lang}: source changed; translation needs review`)
-        if (lang !== "en") writeFileSync(destination, contentLanguage(original, tool.lang))
+        if (lang !== "en") writeFileSync(destination, siteLinks(contentLanguage(original, tool.lang), lang))
         continue
       }
       const translated = readFileSync(path, "utf8")
       const errors = translationProblems(original, translated)
       if (errors.length) {
         problems.push(`${tool.name}/${slug}.${lang}: ${errors.join(", ")}`)
-        if (lang !== "en") writeFileSync(destination, contentLanguage(original, tool.lang))
+        if (lang !== "en") writeFileSync(destination, siteLinks(contentLanguage(original, tool.lang), lang))
         continue
       }
       writeFileSync(
         destination,
-        contentLanguage(withOriginalAnchors(original, corrected(translated, slug, lang)), lang),
+        siteLinks(contentLanguage(withOriginalAnchors(original, corrected(translated, slug, lang)), lang), lang),
       )
     }
   }