diff --git a/content/docs/configuration.es.mdx b/content/docs/configuration.es.mdx
index 01f7852e..f04a6f10 100644
--- a/content/docs/configuration.es.mdx
+++ b/content/docs/configuration.es.mdx
@@ -85,7 +85,7 @@ Las dos herramientas comparten la mayoría de los ajustes, como `limit`, `sends_
- **Telegram:** [guía de configuración de Telegram](./tg/configuration.md) · [todos los ajustes de Telegram, sus valores predeterminados y variables de entorno](./tg/configuration-reference.md).
- **MAX:** [guía de configuración de MAX](./max/configuration.md) · [todos los ajustes de MAX, sus valores predeterminados y variables de entorno](./max/configuration-reference.md).
-Las demás herramientas tienen sus propios archivos de ajustes: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk.mdx#reference), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) y [Memo](./memo/configuration.md).
+Las demás herramientas tienen sus propios archivos de ajustes: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk/configuration.md), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) y [Memo](./memo/configuration.md).
## Perfiles y bots
diff --git a/content/docs/configuration.mdx b/content/docs/configuration.mdx
index 3da8156b..9cf9be30 100644
--- a/content/docs/configuration.mdx
+++ b/content/docs/configuration.mdx
@@ -85,7 +85,7 @@ The two tools share most settings, such as `limit`, `sends_per_hour`, `record` a
- **Telegram:** [Telegram configuration guide](./tg/configuration.md) · [every Telegram setting, default and environment variable](./tg/configuration-reference.md).
- **MAX:** [MAX configuration guide](./max/configuration.md) · [every MAX setting, default and environment variable](./max/configuration-reference.md).
-The other tools have their own settings files: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk.mdx#reference), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) and [Memo](./memo/configuration.md).
+The other tools have their own settings files: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk/configuration.md), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) and [Memo](./memo/configuration.md).
## Profiles and bots
diff --git a/content/docs/configuration.ru.mdx b/content/docs/configuration.ru.mdx
index c083d688..347912ed 100644
--- a/content/docs/configuration.ru.mdx
+++ b/content/docs/configuration.ru.mdx
@@ -85,7 +85,7 @@ tg personal config unset limit
- **Telegram:** [руководство по настройкам Telegram](./tg/configuration.md) · [все настройки Telegram, значения по умолчанию и переменные окружения](./tg/configuration-reference.md).
- **MAX:** [руководство по настройкам MAX](./max/configuration.md) · [все настройки MAX, значения по умолчанию и переменные окружения](./max/configuration-reference.md).
-У остальных инструментов свои файлы настроек: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Яндекс Диск](./ydisk.mdx#reference), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Битрикс24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) и [Memo](./memo/configuration.md).
+У остальных инструментов свои файлы настроек: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Яндекс Диск](./ydisk/configuration.md), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Битрикс24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) и [Memo](./memo/configuration.md).
## Профили и боты
diff --git a/content/docs/features.es.mdx b/content/docs/features.es.mdx
index 3916f50b..0d89694e 100644
--- a/content/docs/features.es.mdx
+++ b/content/docs/features.es.mdx
@@ -115,7 +115,7 @@ Las operaciones de cada servicio, diferencias de compatibilidad y sintaxis exact
- **Zoom:** [reuniones](./zm/meetings.md), [uso diario](./zm/usage.md), [búsqueda](./zm/search.md) y [comandos](./zm/commands.md).
- **Google Drive:** [uso diario](./drive/usage.md), [búsqueda](./drive/search.md) y [comandos](./drive/commands.md).
- **Notion:** [empieza aquí](./notion/index.md), [uso diario](./notion/usage.md), [ajustes y permisos](./notion/configuration.md) y [comandos](./notion/commands.md).
-- **Yandex Disk:** [empieza aquí](./ydisk.mdx), [conecta tu agente](./ydisk.mdx#connect-your-agent), [trabaja con archivos en el Disk](./ydisk.mdx#work-with-files-on-the-disk) y [referencia](./ydisk.mdx#reference).
+- **Yandex Disk:** [empieza aquí](./ydisk/index.md), [conecta tu agente](./ydisk/mcp.md), [trabaja con archivos en el Disk](./ydisk/usage.md) y [referencia](./ydisk/commands.md).
- **Google Calendar:** [uso diario](./gcal/usage.md), [Google Meet](./google-meet.mdx), [escenarios](./gcal/scenarios.md) y [comandos](./gcal/commands.md).
- **Mail:** [uso diario](./mail/usage.md), [preparar el buzón](./mail/providers.md) y [comandos](./mail/commands.md).
- **Bitrix24:** [uso diario](./b24/usage.md), [ajustes y permisos](./b24/configuration.md) y [comandos](./b24/commands.md).
diff --git a/content/docs/features.mdx b/content/docs/features.mdx
index 7c2b6216..0cfb1de2 100644
--- a/content/docs/features.mdx
+++ b/content/docs/features.mdx
@@ -115,7 +115,7 @@ Exact messenger operations, supported differences and command syntax belong in t
- **Zoom:** [meetings](./zm/meetings.md), [daily use](./zm/usage.md), [search](./zm/search.md) and [commands](./zm/commands.md).
- **Google Drive:** [daily use](./drive/usage.md), [search](./drive/search.md) and [commands](./drive/commands.md).
- **Notion:** [start here](./notion/index.md), [daily use](./notion/usage.md), [settings and permissions](./notion/configuration.md) and [commands](./notion/commands.md).
-- **Yandex Disk:** [start here](./ydisk.mdx), [connect your agent](./ydisk.mdx#connect-your-agent), [work with files on the Disk](./ydisk.mdx#work-with-files-on-the-disk) and [reference](./ydisk.mdx#reference).
+- **Yandex Disk:** [start here](./ydisk/index.md), [connect your agent](./ydisk/mcp.md), [work with files on the Disk](./ydisk/usage.md) and [reference](./ydisk/commands.md).
- **Google Calendar:** [daily use](./gcal/usage.md), [Google Meet](./google-meet.mdx), [scenarios](./gcal/scenarios.md) and [commands](./gcal/commands.md).
- **Mail:** [daily use](./mail/usage.md), [preparing the mailbox](./mail/providers.md) and [commands](./mail/commands.md).
- **Bitrix24:** [daily use](./b24/usage.md), [settings and permissions](./b24/configuration.md) and [commands](./b24/commands.md).
diff --git a/content/docs/features.ru.mdx b/content/docs/features.ru.mdx
index 895287d4..dcdfb100 100644
--- a/content/docs/features.ru.mdx
+++ b/content/docs/features.ru.mdx
@@ -115,7 +115,7 @@ Memo также импортирует почту из настроенных а
- **Zoom:** [встречи](./zm/meetings.md), [повседневные задачи](./zm/usage.md), [поиск](./zm/search.md) и [команды](./zm/commands.md).
- **Google Drive:** [повседневные задачи](./drive/usage.md), [поиск](./drive/search.md) и [команды](./drive/commands.md).
- **Notion:** [начните здесь](./notion/index.md), [повседневные задачи](./notion/usage.md), [настройки и разрешения](./notion/configuration.md) и [команды](./notion/commands.md).
-- **Яндекс Диск:** [начните здесь](./ydisk.mdx), [подключите агента](./ydisk.mdx#connect-your-agent), [работа с файлами на Диске](./ydisk.mdx#work-with-files-on-the-disk) и [справочник](./ydisk.mdx#reference).
+- **Яндекс Диск:** [начните здесь](./ydisk/index.md), [подключите агента](./ydisk/mcp.md), [работа с файлами на Диске](./ydisk/usage.md) и [справочник](./ydisk/commands.md).
- **Google Calendar:** [повседневные задачи](./gcal/usage.md), [Google Meet](./google-meet.mdx), [сценарии](./gcal/scenarios.md) и [команды](./gcal/commands.md).
- **Mail:** [повседневные задачи](./mail/usage.md), [подготовка ящика](./mail/providers.md) и [команды](./mail/commands.md).
- **Битрикс24:** [повседневные задачи](./b24/usage.md), [настройки и права](./b24/configuration.md) и [команды](./b24/commands.md).
diff --git a/content/docs/index.es.mdx b/content/docs/index.es.mdx
index 7dd4b687..79b3f012 100644
--- a/content/docs/index.es.mdx
+++ b/content/docs/index.es.mdx
@@ -40,7 +40,7 @@ Elige la fila que coincide con tu objetivo. Puedes combinar herramientas más ad
| Responder una pregunta con Google Docs, Sheets o PDF | `drive` | [Conectar Google Drive](./drive/installation.md) |
| Responder una pregunta con tus páginas y bases de datos de Notion | `notion` | [Conectar Notion](./notion/index.md) |
| Buscar en tus notas Markdown o tu bóveda de Obsidian | `memo` | [Markdown y Obsidian](./markdown.mdx) |
-| Responder una pregunta con archivos de Yandex Disk, o subirlos, moverlos y compartirlos | `ydisk` | [Conectar Yandex Disk](./ydisk.mdx) |
+| Responder una pregunta con archivos de Yandex Disk, o subirlos, moverlos y compartirlos | `ydisk` | [Conectar Yandex Disk](./ydisk/index.md) |
| Preparar las reuniones de mañana | `gcal` | [Conectar Google Calendar](./gcal/installation.md) |
| Leer lo que se dijo en una llamada de Zoom, trabajar con su transcripción y grabación | `zm` | [Conectar Zoom](./zm/installation.md) |
| Guardar tus llamadas de Google Meet con quién se unió y la transcripción | `gcal` | [Google Meet](./google-meet.mdx) |
diff --git a/content/docs/index.mdx b/content/docs/index.mdx
index 1c1f5092..e5227b4d 100644
--- a/content/docs/index.mdx
+++ b/content/docs/index.mdx
@@ -37,7 +37,7 @@ Pick the row that matches your goal. Tools can be combined later; start with one
| Answer a question from Google Docs, Sheets or PDF files | `drive` | [Connect Google Drive](./drive/installation.md) |
| Answer a question from your Notion pages and databases | `notion` | [Connect Notion](./notion/index.md) |
| Search your Markdown notes or Obsidian vault | `memo` | [Markdown and Obsidian](./markdown.mdx) |
-| Answer a question from files on Yandex Disk, or upload, move and share them | `ydisk` | [Connect Yandex Disk](./ydisk.mdx) |
+| Answer a question from files on Yandex Disk, or upload, move and share them | `ydisk` | [Connect Yandex Disk](./ydisk/index.md) |
| Prepare for tomorrow's meetings | `gcal` | [Connect Google Calendar](./gcal/installation.md) |
| Read what was said on a Zoom call, or work with its transcript and recording | `zm` | [Connect Zoom](./zm/installation.md) |
| Keep your Google Meet calls with who joined and the transcript | `gcal` | [Google Meet](./google-meet.mdx) |
diff --git a/content/docs/index.ru.mdx b/content/docs/index.ru.mdx
index e33aec1f..7b83d5e6 100644
--- a/content/docs/index.ru.mdx
+++ b/content/docs/index.ru.mdx
@@ -40,7 +40,7 @@ description: "Документация WireCat: дайте Claude Code, Codex и
| Ответить на вопрос по Google Docs, Sheets или PDF | `drive` | [Подключить Google Drive](./drive/installation.md) |
| Ответить на вопрос по страницам и базам данных Notion | `notion` | [Подключить Notion](./notion/index.md) |
| Искать по заметкам Markdown или хранилищу Obsidian | `memo` | [Markdown и Obsidian](./markdown.mdx) |
-| Ответить на вопрос по файлам на Яндекс Диске, загрузить, переместить файлы или поделиться ими | `ydisk` | [Подключить Яндекс Диск](./ydisk.mdx) |
+| Ответить на вопрос по файлам на Яндекс Диске, загрузить, переместить файлы или поделиться ими | `ydisk` | [Подключить Яндекс Диск](./ydisk/index.md) |
| Подготовиться к завтрашним встречам | `gcal` | [Подключить Google Calendar](./gcal/installation.md) |
| Узнать, что говорили на звонке в Zoom, работать с расшифровкой и записью | `zm` | [Подключить Zoom](./zm/installation.md) |
| Хранить звонки Google Meet: кто подключился и расшифровку | `gcal` | [Google Meet](./google-meet.mdx) |
diff --git a/content/docs/installation.es.mdx b/content/docs/installation.es.mdx
index ce228e41..fbe17312 100644
--- a/content/docs/installation.es.mdx
+++ b/content/docs/installation.es.mdx
@@ -55,7 +55,7 @@ las herramientas y abre el inicio de sesión de cada una. [Qué hace la aplicaci
| Chats de MAX | [Instalar MAX](./max/installation.md); para un bot, usa [su configuración](./max/bot.md) |
| Documentos de Google Drive | [Instalar Drive](./drive/installation.md) desde npm, conectar Google y elegir una carpeta |
| Páginas y bases de datos de Notion | [Instalar Notion](./notion/installation.md) desde npm, luego [iniciar sesión con un token de Notion y copiar tus páginas](./notion/index.md#conecta-y-copia-tus-páginas) |
-| Archivos de Yandex Disk | [Instalar Yandex Disk](./ydisk.mdx#install-and-sign-in) desde npm, luego iniciar sesión con un token de Yandex y [copiar una carpeta](./ydisk.mdx#copy-a-folder-and-search-it) |
+| Archivos de Yandex Disk | [Instalar Yandex Disk](./ydisk/installation.md) desde npm, luego iniciar sesión con un token de Yandex y [copiar una carpeta](./ydisk/usage.md#sync) |
| Reuniones de Google Calendar | [Instalar Google Calendar](./gcal/installation.md) desde npm e iniciar sesión en Google con la aplicación de Google de WireCat, o con la tuya |
| Correo por IMAP | [Instalar Mail](./mail/installation.md) desde npm y crear antes una contraseña de aplicación para tu buzón |
| Reuniones o transcripciones de Zoom | [Instalar Zoom](./zm/installation.md); conectar una aplicación existente/nueva o importar VTT sin ella |
diff --git a/content/docs/installation.mdx b/content/docs/installation.mdx
index a733e9e8..16baccab 100644
--- a/content/docs/installation.mdx
+++ b/content/docs/installation.mdx
@@ -54,7 +54,7 @@ skills and opens each tool's sign-in. [What the app does](./desktop/index.mdx).
| MAX chats | [Install MAX](./max/installation.md); for a bot, use [bot setup](./max/bot.md) |
| Google Drive documents | [Install Drive](./drive/installation.md) from npm, connect Google and choose a folder |
| Notion pages and databases | [Install Notion](./notion/installation.md) from npm, then [sign in with a Notion token and copy your pages](./notion/index.md#connect-and-copy-your-pages) |
-| Yandex Disk files | [Install Yandex Disk](./ydisk.mdx#install-and-sign-in) from npm, then sign in with a Yandex token and [copy a folder](./ydisk.mdx#copy-a-folder-and-search-it) |
+| Yandex Disk files | [Install Yandex Disk](./ydisk/installation.md) from npm, then sign in with a Yandex token and [copy a folder](./ydisk/usage.md#sync) |
| Google Calendar meetings | [Install Google Calendar](./gcal/installation.md) from npm and sign in to Google through WireCat's Google app, or your own |
| Email over IMAP | [Install Mail](./mail/installation.md) from npm, then make an app password for your mailbox |
| Zoom meetings or transcripts | [Install Zoom](./zm/installation.md); connect an existing/new app or import VTT files without one |
diff --git a/content/docs/installation.ru.mdx b/content/docs/installation.ru.mdx
index c8af2904..e6228f8d 100644
--- a/content/docs/installation.ru.mdx
+++ b/content/docs/installation.ru.mdx
@@ -55,7 +55,7 @@ Linux. Оно устанавливает и обновляет эти инстр
| Чаты MAX | [Установить MAX](./max/installation.md); для бота — [настройка бота](./max/bot.md) |
| Документы Google Диска | [Установить Drive](./drive/installation.md) из npm, подключить Google и выбрать папку |
| Страницы и базы данных Notion | [Установить Notion](./notion/installation.md) из npm, затем [войти с токеном Notion и скопировать страницы](./notion/index.md#подключите-и-скопируйте-страницы) |
-| Файлы на Яндекс Диске | [Установить Яндекс Диск](./ydisk.mdx#install-and-sign-in) из npm, затем войти с токеном Яндекса и [скопировать папку](./ydisk.mdx#copy-a-folder-and-search-it) |
+| Файлы на Яндекс Диске | [Установить Яндекс Диск](./ydisk/installation.md) из npm, затем войти с токеном Яндекса и [скопировать папку](./ydisk/usage.md#sync) |
| Встречи Google Календаря | [Установить Google Calendar](./gcal/installation.md) из npm и войти в Google через приложение Google от WireCat или своё |
| Почта по IMAP | [Установить Mail](./mail/installation.md) из npm, затем создать пароль приложения для ящика |
| Встречи или расшифровки Zoom | [Установить Zoom](./zm/installation.md); подключить существующее/новое приложение или импортировать VTT без него |
diff --git a/content/docs/roadmap.es.md b/content/docs/roadmap.es.md
index 7c5cda3b..cb94a2c6 100644
--- a/content/docs/roadmap.es.md
+++ b/content/docs/roadmap.es.md
@@ -28,7 +28,7 @@ decidimos qué viene después.
en la búsqueda junto a tus mensajes.
- **[Notion](./notion/index.md)**: tus páginas y bases de datos de Notion en tu ordenador, en la búsqueda sin conexión
junto a tus mensajes.
-- **[Yandex Disk](./ydisk.mdx)**: el texto de las carpetas del Disk que elijas en tu ordenador, en la búsqueda sin
+- **[Yandex Disk](./ydisk/index.md)**: el texto de las carpetas del Disk que elijas en tu ordenador, en la búsqueda sin
conexión, y los archivos del Disk subidos, movidos y compartidos cuando lo permitas.
- **[amoCRM y Kommo](./amo/index.md)**: tus negociaciones y sus clientes en tu ordenador, con lo que cambió desde ayer,
en la búsqueda junto a tus mensajes.
@@ -104,6 +104,7 @@ la búsqueda por palabras. Consulta [cómo funciona la búsqueda](./search-archi
- [Hoja de ruta de Mail](./mail/roadmap.md)
- [Hoja de ruta de Bitrix24](./b24/roadmap.md)
- [Hoja de ruta de amoCRM](./amo/roadmap.md)
+- [Hoja de ruta de Yandex Disk](./ydisk/roadmap.md)
- [Hoja de ruta de Asterisk](./pbx/roadmap.md)
- [Hoja de ruta de Memo](./memo/roadmap.md)
- [Hoja de ruta de WhatsApp](./wa/roadmap.md)
diff --git a/content/docs/roadmap.md b/content/docs/roadmap.md
index bf0407b2..e4cf9a9f 100644
--- a/content/docs/roadmap.md
+++ b/content/docs/roadmap.md
@@ -27,7 +27,7 @@ what comes next.
and searchable next to your messages.
- **[Notion](./notion/index.md)**: your Notion pages and databases on your computer, searchable offline next to your
messages.
-- **[Yandex Disk](./ydisk.mdx)**: the text of the Disk folders you choose on your computer, searchable offline,
+- **[Yandex Disk](./ydisk/index.md)**: the text of the Disk folders you choose on your computer, searchable offline,
and the files on the Disk listed, uploaded, moved and shared when you allow it.
- **[amoCRM and Kommo](./amo/index.md)**: your own deals and their clients on your computer, with what changed since
yesterday, searchable next to your messages.
@@ -97,6 +97,7 @@ search. See [how search works](./search-architecture.mdx). Next it gets better a
- [Mail roadmap](./mail/roadmap.md)
- [Bitrix24 roadmap](./b24/roadmap.md)
- [amoCRM roadmap](./amo/roadmap.md)
+- [Yandex Disk roadmap](./ydisk/roadmap.md)
- [Asterisk roadmap](./pbx/roadmap.md)
- [Memo roadmap](./memo/roadmap.md)
- [WhatsApp roadmap](./wa/roadmap.md)
diff --git a/content/docs/roadmap.ru.md b/content/docs/roadmap.ru.md
index b63939df..698a52b0 100644
--- a/content/docs/roadmap.ru.md
+++ b/content/docs/roadmap.ru.md
@@ -26,7 +26,7 @@ WireCat собирает ваш контекст в одном месте. Со
доступные в поиске рядом с сообщениями.
- **[Notion](./notion/index.md)**: ваши страницы и базы данных Notion на компьютере, в поиске без интернета рядом с
сообщениями.
-- **[Яндекс Диск](./ydisk.mdx)**: текст выбранных папок Диска на компьютере, в поиске без интернета, а файлы на
+- **[Яндекс Диск](./ydisk/index.md)**: текст выбранных папок Диска на компьютере, в поиске без интернета, а файлы на
Диске можно загружать, перемещать и публиковать по ссылке, когда вы это разрешите.
- **[amoCRM и Kommo](./amo/index.md)**: ваши сделки и их клиенты на компьютере, с тем, что поменялось со вчера, в
поиске рядом с сообщениями.
@@ -99,6 +99,7 @@ WireCat собирает ваш контекст в одном месте. Со
- [Планы Mail](./mail/roadmap.md)
- [Планы Битрикс24](./b24/roadmap.md)
- [Планы amoCRM](./amo/roadmap.md)
+- [Планы Яндекс Диска](./ydisk/roadmap.md)
- [Планы Asterisk](./pbx/roadmap.md)
- [Планы Memo](./memo/roadmap.md)
- [Планы WhatsApp](./wa/roadmap.md)
diff --git a/content/docs/ydisk.es.mdx b/content/docs/ydisk.es.mdx
deleted file mode 100644
index ccf50a8a..00000000
--- a/content/docs/ydisk.es.mdx
+++ /dev/null
@@ -1,193 +0,0 @@
----
-title: "Yandex Disk"
-description: "Busca en el texto de tus carpetas de Yandex Disk en tu ordenador y deja que tu agente de IA lea, archive y comparta documentos allí con la línea de comandos o MCP."
----
-
-Encuentra cualquier documento de tu Yandex Disk por lo que dice y deja que tu agente de IA lo lea, lo archive y lo
-comparta por ti. La herramienta de línea de comandos `ydisk` copia a tu ordenador el texto de las carpetas del Disk
-que elijas, así que una búsqueda de «contrato de alquiler» encuentra el PDF aunque se llame `scan_0042.pdf`, e incluso
-sin internet.
-
-Pregunta a tu agente dónde está el contrato con un cliente y qué condiciones de pago tiene. Te responde con la cita y
-la ruta del archivo en el Disk. Pídele que mueva las facturas del año pasado a un archivo o que cree un enlace para un
-colega, y lo hace en el Disk, preguntándote antes de borrar o de crear un enlace público.
-
-`ydisk` funciona con Claude Code, Codex y otros agentes que ejecutan comandos, con Claude Desktop y Cursor por MCP, y
-con ChatGPT y Claude en el navegador a través de tu propio túnel. Necesita Node.js y un token OAuth de Yandex: una
-clave de tu propia cuenta de Yandex con la que la herramienta usa tu Disk.
-
-**En esta página:**
-
-1. [Cómo funciona](#how-it-works)
-2. [Instalar e iniciar sesión](#install-and-sign-in)
-3. [Copia una carpeta y busca en ella](#copy-a-folder-and-search-it)
-4. [Conecta tu agente](#connect-your-agent)
-5. [Trabaja con archivos en el Disk](#work-with-files-on-the-disk)
-6. [Límites](#limits)
-7. [Si algo no funciona](#if-something-goes-wrong)
-8. [Referencia](#reference)
-
-
-
-## Cómo funciona
-
-- **Una copia del texto en tu ordenador.** `ydisk` lee las carpetas que eliges y guarda el texto de sus archivos en el
- almacén local, un archivo de base de datos en tu ordenador que comparten todas las herramientas de WireCat. La
- búsqueda lee esta copia, no el Disk, y encuentra otras formas de una palabra en ruso y en inglés.
-- **Solo las carpetas que eliges.** Yandex Disk no dice a la herramienta qué cambió, así que cada sincronización vuelve
- a listar todas las carpetas elegidas con sus subcarpetas y descarga solo los archivos cuyo contenido cambió. Elige
- carpetas con documentos, no todo el Disk.
-- **Texto, no copias de archivos.** La herramienta lee Markdown, texto plano, PDF con capa de texto, Word `.docx`,
- Excel `.xlsx`, CSV y TSV. Las fotos y los demás archivos se guardan solo por su nombre. Los archivos se quedan en el
- Disk.
-- **Un perfil por cuenta.** Un perfil es el nombre que eliges para una cuenta de Yandex, como `personal` o `work`.
- Cada comando que usa una cuenta empieza por él: `ydisk personal search budget`.
-- **Los comandos `files` cambian el Disk.** Trabajan directamente con Yandex. Borrar mueve el archivo a la papelera del
- Disk. En una terminal la herramienta pregunta antes de borrar, sobrescribir o crear un enlace público.
-
-
-
-## Instalar e iniciar sesión
-
-1. Instala la herramienta desde npm y compruébala. Necesitas Node.js 22.16 o un 22.x posterior, o 24 o posterior.
-
-```sh
-npm install -g @wirecat/yandex-disk-cli
-ydisk --version
-ydisk doctor
-```
-
-2. Registra una aplicación en Yandex para obtener un token. La aplicación es solo un nombre y una lista de permisos en
- tu cuenta, y no se publica nada. Las páginas de Yandex están en ruso, así que sus textos se dan también en ruso
- ([guía de Yandex](https://yandex.ru/dev/disk-api/doc/ru/concepts/quickstart)):
- - Abre [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) e inicia sesión con la cuenta cuyo Disk
- quieres usar. Si Yandex pregunta el tipo de aplicación, elige «Для доступа к API или отладки» (para acceso a la
- API o depuración).
- - Escribe cualquier nombre y tu correo. En «Доступ к данным» (acceso a los datos) añade los permisos de Yandex Disk
- `cloud_api:disk.read`, `cloud_api:disk.info` y, para cambiar archivos, `cloud_api:disk.write`.
- - Crea la aplicación y copia su **ClientID** de la página de la aplicación.
-
-3. Abre `https://oauth.yandex.ru/authorize?response_type=token&client_id=` añadiendo tu ClientID al final, permite el
- acceso y copia el token de la página. Guárdalo como una contraseña.
-
-4. Inicia sesión con el nombre de perfil que elijas. La herramienta pide el token con entrada oculta, lo comprueba
- con Yandex y lo guarda en el llavero del sistema, o en un archivo privado donde no hay llavero.
-
-```sh
-ydisk personal session start
-ydisk personal session status --check
-```
-
-Yandex mantiene válido el token durante meses mientras se usa. Cuando Yandex deje de aceptarlo, consigue uno nuevo
-igual y vuelve a ejecutar `session start`.
-
-`ydisk personal session end` quita el token de este ordenador.
-
-
-
-## Copia una carpeta y busca en ella
-
-`folders browse` muestra el Disk un nivel cada vez, para elegir una carpeta por su ruta:
-
-```sh
-ydisk personal folders browse
-ydisk personal folders add /Documents
-ydisk personal sync
-ydisk personal search "presupuesto trimestral"
-```
-
-Una sincronización lee hasta 200 archivos (`--limit`), recorre hasta unas 10 000 entradas y recuerda dónde se detuvo.
-Ejecútala otra vez para seguir y, más adelante, para traer lo que cambió. Nada se sincroniza en segundo plano.
-`ydisk personal status` muestra la última sincronización, el trabajo pendiente y los archivos guardados solo por su
-nombre. `documents show` imprime el texto completo de un archivo encontrado por la búsqueda.
-
-La búsqueda por significado encuentra un documento que responde a una pregunta con otras palabras. Necesita un modelo de
-texto que se descarga una vez con [Memo](./memo/installation.md), `memo models download embeddinggemma`, y después
-`ydisk personal sync --embed`.
-
-
-
-## Conecta tu agente
-
-Un agente de terminal como Claude Code o Codex recibe la guía de la herramienta:
-
-```sh
-ydisk skill install
-```
-
-Después pídele las cosas con palabras normales:
-
-```text prompt
-Usa ydisk CLI con el perfil personal. Busca en mis carpetas del Disk el contrato con Harbour Ltd.
-Cita las condiciones de pago y dame la ruta del archivo en el Disk. No cambies ningún archivo.
-```
-
-El agente busca primero en la copia local. Un archivo fuera de las carpetas elegidas lo lee en directo del Disk.
-
-Para añadir la herramienta como servidor MCP, `ydisk personal mcp add claude-code --allow-writes` (o `codex`) lo hace
-con un solo comando. Para Claude Desktop, Cursor y otras aplicaciones MCP, `ydisk personal mcp config` imprime la
-entrada que debes pegar en los ajustes de la aplicación. Para ChatGPT y Claude en el navegador, mira las
-[aplicaciones del navegador](./browser-apps.mdx).
-
-
-
-## Trabaja con archivos en el Disk
-
-```sh
-ydisk personal files list --folder /Documents
-ydisk personal files download /Documents/plan.pdf --output ./plan.pdf
-ydisk personal files upload ./notes.md --folder /Documents
-ydisk personal files move /Documents/old.pdf --folder /Archive
-ydisk personal files delete /Documents/old.pdf
-ydisk personal files publish /Documents/plan.pdf
-```
-
-`files delete` mueve el archivo a la papelera del Disk, y `files restore` lo devuelve. `files publish` crea un enlace
-que puede abrir cualquiera que lo tenga. En una terminal la herramienta pregunta antes de borrar, de sobrescribir con
-`--replace` o de crear un enlace público. Por MCP no hay a quién preguntar, así que para un agente que no debe hacerlo,
-cierra esos permisos:
-
-```sh
-ydisk personal config set permissions.files.delete deny
-ydisk personal config set permissions.files.share deny
-```
-
-`YDISK_READ_ONLY=1` rechaza cualquier cambio. `--dry-run` en cualquier cambio muestra lo que haría sin hacerlo.
-
-
-
-## Límites
-
-- Los PDF escaneados y las imágenes no tienen texto que buscar. Los archivos de más de 50 MB se guardan solo por su
- nombre.
-- Una carpeta elegida que renombras o mueves en el Disk deja de sincronizarse y sus copias salen del almacén. Vuelve a
- añadirla con su nueva ruta.
-- El inicio de sesión es con un token pegado de una aplicación que registras tú. Todavía no hay inicio de sesión en el
- navegador.
-
-
-
-## Si algo no funciona
-
-- **«refused the token», código de salida 4.** El token es incorrecto, está revocado o caducó. Consigue uno nuevo y
- vuelve a ejecutar `session start`.
-- **Un cambio falla con el código de salida 5.** El token se creó sin `cloud_api:disk.write`, o los permisos del perfil
- rechazan el cambio.
-- **La búsqueda no encuentra un archivo que sabes que está.** Comprueba que su carpeta aparece en `folders list`,
- ejecuta `sync` hasta que `status` no muestre trabajo pendiente y mira si `status` lo lista como guardado solo por su
- nombre.
-- **«the OS keyring did not answer» en Linux.** Cierra la sesión y vuelve a entrar, o inicia sesión con
- `ydisk personal session start --credential-storage file`.
-
-`ydisk doctor` muestra lo que está configurado sin conectarse, y `ydisk personal doctor --online` comprueba el token.
-Hay más casos en la [página de problemas](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/troubleshooting.md).
-
-
-
-## Referencia
-
-Todos los comandos y opciones: [comandos](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/commands.md). Ajustes y
-permisos: [ajustes](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/configuration.md). Qué llega al disco y a la
-red: [seguridad](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/security.md). La referencia está en inglés.
-
-Siguiente: [dale también a tu agente una carpeta de notas en Markdown](./markdown.mdx).
diff --git a/content/docs/ydisk.mdx b/content/docs/ydisk.mdx
deleted file mode 100644
index 584625e4..00000000
--- a/content/docs/ydisk.mdx
+++ /dev/null
@@ -1,169 +0,0 @@
----
-title: "Yandex Disk"
-description: "Search the text of your Yandex Disk folders on your computer, and let your AI agent read, file and share documents there through a command line or MCP."
----
-
-Find any document on your Yandex Disk by what it says, and let your AI agent read it, file it and share it for you.
-The `ydisk` command-line tool copies the text of the Disk folders you choose to your computer, so a search for
-"lease" finds the PDF even when its file name is `scan_0042.pdf`, and even without the internet.
-
-Ask your agent where the contract with a client is and what its payment terms are. It answers with the quote and the
-file's path on the Disk. Ask it to move last year's invoices to an archive or to make a link for a colleague, and it
-does that on the Disk, asking first before a delete or a public link.
-
-`ydisk` works with Claude Code, Codex and other agents that run commands, with Claude Desktop and Cursor through MCP,
-and with ChatGPT and Claude in the browser through your own tunnel. It needs Node.js and a Yandex OAuth token, a key
-from your own Yandex account that lets the tool use your Disk.
-
-**On this page:**
-
-1. [How it works](#how-it-works)
-2. [Install and sign in](#install-and-sign-in)
-3. [Copy a folder and search it](#copy-a-folder-and-search-it)
-4. [Connect your agent](#connect-your-agent)
-5. [Work with files on the Disk](#work-with-files-on-the-disk)
-6. [Limits](#limits)
-7. [If something goes wrong](#if-something-goes-wrong)
-8. [Reference](#reference)
-
-## How it works
-
-- **A copy of the text on your computer.** `ydisk` reads the folders you choose and saves the text of their files in
- the local store, one database file on your computer that every WireCat tool shares. Search reads this copy, not the
- Disk, and finds other forms of a word in Russian and English.
-- **Only the folders you choose.** Yandex Disk does not tell a tool what changed, so each sync lists every chosen
- folder and its subfolders again and downloads only the files whose content changed. Choose the folders with
- documents, not the whole Disk.
-- **Text, not copies of files.** The tool reads Markdown, plain text, PDF with a text layer, Word `.docx`, Excel
- `.xlsx`, CSV and TSV. Photos and other files are kept by name. The files themselves stay on the Disk.
-- **A profile for each account.** A profile is a name you choose for one Yandex account, such as `personal` or `work`.
- Every command that uses an account names it first: `ydisk personal search budget`.
-- **Live commands change the Disk.** `files` commands go to Yandex directly. Deleting moves a file to the Disk's trash.
- At a terminal the tool asks before it deletes, overwrites or makes a public link.
-
-## Install and sign in
-
-1. Install the tool from npm and check it. You need Node.js 22.16 or a later 22.x, or 24 or later.
-
-```sh
-npm install -g @wirecat/yandex-disk-cli
-ydisk --version
-ydisk doctor
-```
-
-2. Register an app in Yandex to get a token. The app is only a name and a list of rights in your account, and nothing
- is published. Yandex's pages are in Russian, so their labels are given in Russian too
- ([Yandex's guide](https://yandex.ru/dev/disk-api/doc/en/concepts/quickstart)):
- - Open [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) and sign in with the account whose Disk
- you want to use. If Yandex asks for the app type, choose «Для доступа к API или отладки» (for API access or
- debugging).
- - Enter any name and your email. Under «Доступ к данным» (data access) add the Yandex Disk rights
- `cloud_api:disk.read`, `cloud_api:disk.info` and, to change files, `cloud_api:disk.write`.
- - Create the app and copy its **ClientID** from the app's page.
-
-3. Open `https://oauth.yandex.ru/authorize?response_type=token&client_id=` with your ClientID added at the very end,
- allow access and copy the token from the page. Keep it like a password.
-
-4. Sign in under a profile name you choose. The tool asks for the token with hidden input, checks it with Yandex and
- keeps it in the system keyring, or in a private file where there is no keyring.
-
-```sh
-ydisk personal session start
-ydisk personal session status --check
-```
-
-Yandex keeps a token valid for months while it is used. When Yandex stops accepting it, get a new one the same way
-and run `session start` again.
-
-`ydisk personal session end` removes the token from this computer.
-
-## Copy a folder and search it
-
-`folders browse` shows the Disk one level at a time, so you can pick a folder by its path:
-
-```sh
-ydisk personal folders browse
-ydisk personal folders add /Documents
-ydisk personal sync
-ydisk personal search "quarterly budget"
-```
-
-One sync reads up to 200 files (`--limit`), walks up to about 10,000 entries and saves where it stopped. Run it
-again to go on, and later to bring in what changed. Nothing syncs in the background. `ydisk personal status` shows the
-last sync, the pending work and the files kept by name only. `documents show` prints the whole text of one file found
-by search.
-
-Search by meaning finds a document that answers a question in other words. It needs a text model downloaded once
-with [Memo](./memo/installation.md), `memo models download embeddinggemma`, and then `ydisk personal sync --embed`.
-
-## Connect your agent
-
-A terminal agent such as Claude Code or Codex gets the tool's skill:
-
-```sh
-ydisk skill install
-```
-
-Then ask in plain words:
-
-```text prompt
-Use ydisk CLI with profile personal. Find the contract with Harbour Ltd in my Disk folders.
-Quote the payment terms and give me the file's path on the Disk. Do not change any files.
-```
-
-The agent searches the local copy first. A file outside the chosen folders it reads live from the Disk.
-
-To add the tool as an MCP server, `ydisk personal mcp add claude-code --allow-writes` (or `codex`) does it in one
-command. For Claude Desktop, Cursor and other MCP apps, `ydisk personal mcp config` prints the entry to paste into
-the app's settings. For ChatGPT and Claude in the browser, see [browser apps](./browser-apps.mdx).
-
-## Work with files on the Disk
-
-```sh
-ydisk personal files list --folder /Documents
-ydisk personal files download /Documents/plan.pdf --output ./plan.pdf
-ydisk personal files upload ./notes.md --folder /Documents
-ydisk personal files move /Documents/old.pdf --folder /Archive
-ydisk personal files delete /Documents/old.pdf
-ydisk personal files publish /Documents/plan.pdf
-```
-
-`files delete` moves the file to the Disk's trash, and `files restore` brings it back. `files publish` makes a link
-that anyone who has it can open. At a terminal the tool asks before a delete, an overwrite with `--replace` or a public
-link. Over MCP there is no one to ask, so for an agent that must not do these, set the permissions:
-
-```sh
-ydisk personal config set permissions.files.delete deny
-ydisk personal config set permissions.files.share deny
-```
-
-`YDISK_READ_ONLY=1` refuses every change. `--dry-run` on any change shows what it would do without doing it.
-
-## Limits
-
-- Scanned PDFs and pictures have no text to search. Files over 50 MB are kept by name only.
-- A chosen folder that you rename or move on the Disk stops syncing and its copies leave the store. Add it again under
- its new path.
-- Sign-in is by a pasted token from an app you register. There is no sign-in in the browser yet.
-
-## If something goes wrong
-
-- **"refused the token", exit code 4**: the token is wrong, revoked or expired. Get a new one and run `session start`
- again.
-- **A change fails with exit code 5**: the token was made without `cloud_api:disk.write`, or the profile's permissions
- refuse the change.
-- **Search does not find a file you know is there**: check that its folder is in `folders list`, run `sync` again
- until `status` shows no pending work, and check whether `status` lists the file as kept by name only.
-- **"the OS keyring did not answer" on Linux**: log out and back in, or sign in with
- `ydisk personal session start --credential-storage file`.
-
-`ydisk doctor` shows what is set up without connecting, and `ydisk personal doctor --online` checks the token. More
-cases are on the [troubleshooting page](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/troubleshooting.md).
-
-## Reference
-
-Every command and option: [commands](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/commands.md). Settings and
-permissions: [settings](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/configuration.md). What reaches the disk and
-the network: [security](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/security.md).
-
-Next: [give your agent a folder of Markdown notes too](./markdown.mdx).
diff --git a/content/docs/ydisk.ru.mdx b/content/docs/ydisk.ru.mdx
deleted file mode 100644
index d2719d14..00000000
--- a/content/docs/ydisk.ru.mdx
+++ /dev/null
@@ -1,186 +0,0 @@
----
-title: "Яндекс Диск"
-description: "Ищите по тексту папок Яндекс Диска на своем компьютере и поручите ИИ-агенту читать, раскладывать и отправлять документы через командную строку или MCP."
----
-
-Находите любой документ на Яндекс Диске по тому, что в нем написано, и поручите ИИ-агенту читать, раскладывать и
-отправлять файлы за вас. Инструмент командной строки `ydisk` копирует на ваш компьютер текст выбранных папок Диска.
-Поиск по словам «договор аренды» найдет PDF, даже если файл называется `scan_0042.pdf`, и даже без интернета.
-
-Спросите агента, где договор с клиентом и какие в нем условия оплаты. Он ответит цитатой и путем к файлу на Диске.
-Попросите перенести прошлогодние счета в архив или сделать ссылку для коллеги, и он сделает это на Диске, а перед
-удалением или публичной ссылкой сначала спросит.
-
-`ydisk` работает с Claude Code, Codex и другими агентами, которые запускают команды, с Claude Desktop и Cursor через
-MCP, а с ChatGPT и Claude в браузере через ваш собственный туннель. Нужны Node.js и OAuth-токен Яндекса: ключ из
-вашего аккаунта Яндекса, который дает инструменту доступ к вашему Диску.
-
-**На этой странице:**
-
-1. [Как это устроено](#how-it-works)
-2. [Установка и вход](#install-and-sign-in)
-3. [Скопируйте папку и ищите по ней](#copy-a-folder-and-search-it)
-4. [Подключите агента](#connect-your-agent)
-5. [Работа с файлами на Диске](#work-with-files-on-the-disk)
-6. [Ограничения](#limits)
-7. [Если что-то не работает](#if-something-goes-wrong)
-8. [Справочник](#reference)
-
-
-
-## Как это устроено
-
-- **Копия текста на вашем компьютере.** `ydisk` читает выбранные папки и сохраняет текст их файлов в локальном
- хранилище. Это один файл базы данных на вашем компьютере, общий для всех инструментов WireCat. Поиск читает эту
- копию, а не Диск, и находит слово в любой форме: по запросу «договор» найдутся и «договора», и «договоре».
-- **Только выбранные папки.** Яндекс Диск не сообщает, что изменилось, поэтому каждая синхронизация заново
- перечисляет все выбранные папки с вложенными и скачивает только файлы, содержимое которых изменилось. Выбирайте
- папки с документами, а не весь Диск.
-- **Текст, а не копии файлов.** Инструмент читает Markdown, обычный текст, PDF с текстовым слоем, Word `.docx`, Excel
- `.xlsx`, CSV и TSV. Фото и остальные файлы сохраняются только по имени. Сами файлы остаются на Диске.
-- **Профиль для каждого аккаунта.** Профиль означает имя, которое вы даете одному аккаунту Яндекса, например
- `personal` или `work`. Каждая команда для аккаунта начинается с него: `ydisk personal search budget`.
-- **Команды `files` меняют Диск.** Они работают с Яндексом напрямую. Удаление переносит файл в корзину Диска. В
- терминале инструмент спрашивает перед удалением, перезаписью или публичной ссылкой.
-
-
-
-## Установка и вход
-
-1. Установите инструмент из npm и проверьте его. Нужен Node.js 22.16 или новее в ветке 22.x либо 24 и новее.
-
-```sh
-npm install -g @wirecat/yandex-disk-cli
-ydisk --version
-ydisk doctor
-```
-
-2. Зарегистрируйте приложение в Яндексе, чтобы получить токен. Приложение здесь означает только название и список
- прав в вашем аккаунте, ничего не публикуется ([инструкция Яндекса](https://yandex.ru/dev/disk-api/doc/ru/concepts/quickstart)):
- - Откройте [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) и войдите в аккаунт, с Диском
- которого хотите работать. Если Яндекс спросит тип приложения, выберите «Для доступа к API или отладки».
- - Укажите любое название и свою почту. В разделе «Доступ к данным» добавьте права Яндекс Диска: «Чтение всего
- Диска» (`cloud_api:disk.read`), «Доступ к информации о Диске» (`cloud_api:disk.info`) и, чтобы менять файлы,
- «Запись в любом месте на Диске» (`cloud_api:disk.write`).
- - Создайте приложение и скопируйте его **ClientID** со страницы приложения.
-
-3. Откройте адрес `https://oauth.yandex.ru/authorize?response_type=token&client_id=`, добавив ClientID в самый
- конец, разрешите доступ и скопируйте токен со страницы. Храните его как пароль.
-
-4. Войдите под именем профиля, которое выберете сами. Инструмент спросит токен скрытым вводом, проверит его у Яндекса
- и сохранит в системной связке ключей, а там, где ее нет, в закрытом файле.
-
-```sh
-ydisk personal session start
-ydisk personal session status --check
-```
-
-Яндекс продлевает токен на месяцы, пока им пользуются. Когда Яндекс перестанет его принимать, получите новый так же
-и снова выполните `session start`.
-
-`ydisk personal session end` удаляет токен с этого компьютера.
-
-
-
-## Скопируйте папку и ищите по ней
-
-`folders browse` показывает Диск по одному уровню, чтобы выбрать папку по ее пути:
-
-```sh
-ydisk personal folders browse
-ydisk personal folders add /Documents
-ydisk personal sync
-ydisk personal search "договор аренды"
-```
-
-Одна синхронизация читает до 200 файлов (`--limit`), проходит примерно до 10 000 элементов и запоминает, где
-остановилась. Запустите ее снова, чтобы продолжить, а позже, чтобы получить изменения. В фоне ничего не
-синхронизируется. `ydisk personal status` показывает последнюю синхронизацию, оставшуюся работу и файлы, которые
-сохранены только по имени. `documents show` выводит весь текст одного найденного файла.
-
-Поиск по смыслу находит документ, который отвечает на вопрос другими словами. Для него один раз скачайте текстовую
-модель через [Memo](./memo/installation.md) командой `memo models download embeddinggemma`, а затем выполните
-`ydisk personal sync --embed`.
-
-
-
-## Подключите агента
-
-Терминальный агент, например Claude Code или Codex, получает навык инструмента:
-
-```sh
-ydisk skill install
-```
-
-Дальше просите обычными словами:
-
-```text prompt
-Используй ydisk CLI с профилем personal. Найди в моих папках на Диске договор с Harbour Ltd.
-Процитируй условия оплаты и назови путь к файлу на Диске. Ничего не меняй в файлах.
-```
-
-Сначала агент ищет в локальной копии. Файл вне выбранных папок он читает прямо с Диска.
-
-Чтобы подключить инструмент как MCP-сервер, выполните `ydisk personal mcp add claude-code --allow-writes` (или
-`codex`). Для Claude Desktop, Cursor и других MCP-приложений `ydisk personal mcp config` выводит запись, которую нужно
-вставить в настройки приложения. Для ChatGPT и Claude в браузере смотрите [браузерные приложения](./browser-apps.mdx).
-
-
-
-## Работа с файлами на Диске
-
-```sh
-ydisk personal files list --folder /Documents
-ydisk personal files download /Documents/plan.pdf --output ./plan.pdf
-ydisk personal files upload ./notes.md --folder /Documents
-ydisk personal files move /Documents/old.pdf --folder /Archive
-ydisk personal files delete /Documents/old.pdf
-ydisk personal files publish /Documents/plan.pdf
-```
-
-`files delete` переносит файл в корзину Диска, а `files restore` возвращает его. `files publish` создает ссылку,
-которую может открыть любой, у кого она есть. В терминале инструмент спрашивает перед удалением, перезаписью с
-`--replace` и публичной ссылкой. По MCP спросить некого, поэтому для агента, которому это нельзя, закройте эти права:
-
-```sh
-ydisk personal config set permissions.files.delete deny
-ydisk personal config set permissions.files.share deny
-```
-
-`YDISK_READ_ONLY=1` запрещает любые изменения. `--dry-run` у любого изменения показывает, что оно сделает, и ничего
-не меняет.
-
-
-
-## Ограничения
-
-- В сканированных PDF и картинках нет текста для поиска. Файлы больше 50 МБ сохраняются только по имени.
-- Выбранная папка, которую вы переименовали или перенесли на Диске, перестает синхронизироваться, и ее копии уходят из
- хранилища. Добавьте ее снова по новому пути.
-- Вход только по вставленному токену от приложения, которое вы регистрируете. Входа через браузер пока нет.
-
-
-
-## Если что-то не работает
-
-- **«refused the token», код выхода 4.** Токен неверный, отозван или истек. Получите новый и снова выполните
- `session start`.
-- **Изменение не проходит, код выхода 5.** Токен выдан без права `cloud_api:disk.write`, или изменение запрещают права
- профиля.
-- **Поиск не находит файл, который точно есть.** Проверьте, что его папка есть в `folders list`, запускайте `sync`,
- пока `status` не покажет, что работы не осталось, и посмотрите, не сохранен ли файл в `status` только по имени.
-- **«the OS keyring did not answer» в Linux.** Выйдите из системы и войдите снова или войдите в инструмент командой
- `ydisk personal session start --credential-storage file`.
-
-`ydisk doctor` показывает, что настроено, без подключения к сети, а `ydisk personal doctor --online` проверяет токен.
-Другие случаи описаны на [странице о неполадках](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/troubleshooting.md).
-
-
-
-## Справочник
-
-Все команды и параметры: [команды](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/commands.md). Настройки и
-права: [настройки](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/configuration.md). Что попадает на диск и в
-сеть: [безопасность](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/security.md). Справочник на английском.
-
-Дальше: [дайте агенту и папку заметок в Markdown](./markdown.mdx).
diff --git a/cspell.json b/cspell.json
index 4442e747..e6070303 100644
--- a/cspell.json
+++ b/cspell.json
@@ -219,6 +219,19 @@
"Salesbots",
"sostav",
"revísala",
- "redirección"
+ "redirección",
+ "фотосрез",
+ "фотосреза",
+ "cyrillic",
+ "Omítelo",
+ "Cópialo",
+ "Pégalo",
+ "Bórralos",
+ "sincronízalas",
+ "Pégala",
+ "отсканированном",
+ "arréglalo",
+ "hermes",
+ "latin"
]
}
diff --git a/docs/README.md b/docs/README.md
index 68aeb1c6..0a58e1e6 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -40,7 +40,6 @@ These pages and shared interface/Markdown behavior belong to this repository.
| How do I make Yandex Telemost's emailed meeting notes searchable as meetings? | `telemost.mdx` | Task guide | Keep in step with mail-cli's `meeting-notes` rule and Yandex's notes conditions |
| How do I keep my Google Meet calls and transcripts so my agent can search them? | `google-meet.mdx` | Task guide | Keep in step with gcal's `meetings` commands and Google's 30-day and transcript limits |
| How do I make my Markdown notes or Obsidian vault searchable by my agent? | `markdown.mdx` | Task guide | Keep in step with memo's `folders` and `notes` commands and its readable file types |
-| How do I make my Yandex Disk files searchable and work with them? | `ydisk.mdx` (Documents & files) | Start page | Written from ydisk 0.1.0 while `tools.json` does not list it; move it into a `ydisk` tool section once `tools.json` lists it, keeping the URL |
| How do I connect a browser AI app? | `agents.mdx` (Use from web or mobile) | Connection guide | Preserve current web setup instructions |
| How do I ask for a useful result? | `prompting.mdx` | Task guidance | Cross-link to worked examples instead of duplicating dialogues |
| How do I review a reply in my messaging app or use an auto-reply template? | `drafts-and-templates.mdx` | Task guide and explanation | Keep template facts in step with the tools' auto-reply guides |
@@ -75,7 +74,7 @@ release. The portal owns its overview (`translations/overviews/drive.*.md`), as
is overview → installation → usage/search/recipes; configuration, security, troubleshooting and generated commands
remain discoverable references.
-Google Drive, Notion, the site-owned `ydisk.mdx` (Yandex Disk, until `tools.json` lists it) and `markdown.mdx` (Markdown
+Google Drive, Notion, Yandex Disk (`ydisk`, from its repository) and the site-owned `markdown.mdx` (Markdown
folders and Obsidian vaults, read by `memo`) sit in the Documents & files group of the sidebar (`toolGroups` in
`lib/docs-sidebar-tree.tsx`). Their URLs do not change.
diff --git a/docs/tasks.json b/docs/tasks.json
index a5a40a6b..b4d4a908 100644
--- a/docs/tasks.json
+++ b/docs/tasks.json
@@ -269,6 +269,42 @@
"pages": ["amo/configuration.md", "amo/troubleshooting.md"],
"families": { "amo": ["config", "doctor", "runs", "upgrade"] }
},
+ {
+ "id": "files-ydisk-connect",
+ "pages": ["ydisk/installation.md", "ydisk/mcp.md", "ydisk/security.md"],
+ "families": { "ydisk": ["session", "account", "skill", "mcp"] }
+ },
+ {
+ "id": "files-ydisk-find",
+ "pages": ["ydisk/usage.md", "ydisk/search.md", "ydisk/recipes.md"],
+ "families": {
+ "ydisk": [
+ "folders",
+ "sync",
+ "status",
+ "documents",
+ "search",
+ "catalog",
+ "tags",
+ "relationships",
+ "notes",
+ "memories",
+ "facts",
+ "identities",
+ "store"
+ ]
+ }
+ },
+ {
+ "id": "files-ydisk-work",
+ "pages": ["ydisk/usage.md", "ydisk/commands.md"],
+ "families": { "ydisk": ["files", "api", "commands"] }
+ },
+ {
+ "id": "files-ydisk-upkeep",
+ "pages": ["ydisk/configuration.md", "ydisk/troubleshooting.md"],
+ "families": { "ydisk": ["config", "doctor", "runs", "upgrade"] }
+ },
{
"id": "calls-connect",
"pages": ["pbx/installation.md", "pbx/usage.md", "pbx/security.md"],
diff --git a/lib/docs-sidebar-tree.tsx b/lib/docs-sidebar-tree.tsx
index 972b3f1d..1c94c27d 100644
--- a/lib/docs-sidebar-tree.tsx
+++ b/lib/docs-sidebar-tree.tsx
@@ -365,7 +365,7 @@ export function unifiedDocsTree(tree: Root, lang = "en"): Root {
}
}
if (node.type !== "page") return node
- const slug = /\/docs\/(tg|max|wa|drive|notion|gcal|mail|memo|zm|b24|amo|pbx)\/?$/.test(node.url)
+ const slug = /\/docs\/(tg|max|wa|drive|notion|gcal|mail|memo|zm|ydisk|b24|amo|pbx)\/?$/.test(node.url)
? "index"
: (node.url.split("/").filter(Boolean).at(-1) ?? "")
const Icon = sidebarIcons[slug as keyof typeof sidebarIcons] ?? FileText
diff --git a/lib/seo-copy.json b/lib/seo-copy.json
index e8ebb738..9e8a0b69 100644
--- a/lib/seo-copy.json
+++ b/lib/seo-copy.json
@@ -52,7 +52,8 @@
"mail": "IMAP mail MCP server and CLI with offline search",
"b24": "Bitrix24 MCP server and CLI for your CRM",
"notion": "Notion MCP server and CLI with offline search",
- "amo": "amoCRM and Kommo MCP server and CLI for your CRM"
+ "amo": "amoCRM and Kommo MCP server and CLI for your CRM",
+ "ydisk": "Yandex Disk MCP server and CLI with offline search"
},
"products": {
"tg": "Telegram",
@@ -66,7 +67,8 @@
"max": "MAX messenger",
"mail": "email",
"b24": "Bitrix24",
- "amo": "amoCRM"
+ "amo": "amoCRM",
+ "ydisk": "Yandex Disk"
},
"labels": {
"max": "MAX",
@@ -98,6 +100,7 @@
"attachments": "Send and download {product} file attachments",
"topic-search": "Search {product} conversations by topic",
"drive/search": "Search Google Drive documents with your AI agent",
+ "ydisk/search": "Search Yandex Disk documents with your AI agent",
"drive/usage": "Import and organize Google Drive documents",
"memo/search": "Search notes, mail and messages with Memo",
"memo/archive": "",
@@ -185,7 +188,8 @@
"mail": "MCP-сервер почты по IMAP с поиском без интернета",
"b24": "Битрикс24 MCP-сервер и CLI для CRM",
"notion": "Notion MCP-сервер и CLI с поиском без интернета",
- "amo": "amoCRM и Kommo: MCP-сервер и CLI для CRM"
+ "amo": "amoCRM и Kommo: MCP-сервер и CLI для CRM",
+ "ydisk": "Яндекс Диск: MCP-сервер и CLI с поиском без интернета"
},
"products": {
"tg": "Telegram",
@@ -199,10 +203,12 @@
"max": "MAX",
"mail": "почты",
"b24": "Битрикс24",
- "amo": "amoCRM"
+ "amo": "amoCRM",
+ "ydisk": "Яндекс Диска"
},
"labels": {
- "mail": "Почта"
+ "mail": "Почта",
+ "ydisk": "Яндекс Диск"
},
"pageTitles": {
"installation": "Установка CLI и MCP-сервера {product}",
@@ -230,6 +236,8 @@
"attachments": "Отправка и загрузка вложений в {product}",
"topic-search": "Поиск по темам переписки в {product}",
"drive/search": "Поиск документов Google Drive через ИИ-агента",
+ "ydisk/search": "Поиск документов Яндекс Диска через ИИ-агента",
+ "ydisk/recipes": "Рецепты для ИИ-агента с Яндекс Диском",
"drive/usage": "Импорт и упорядочивание документов Google Drive",
"memo/search": "Поиск по заметкам, почте и сообщениям в Memo",
"memo/archive": "",
@@ -316,7 +324,8 @@
"mail": "Servidor MCP de correo IMAP con búsqueda sin conexión",
"b24": "Servidor MCP y CLI para el CRM de Bitrix24",
"notion": "Servidor MCP y CLI de Notion con búsqueda sin conexión",
- "amo": "Servidor MCP y CLI para el CRM de amoCRM y Kommo"
+ "amo": "Servidor MCP y CLI para el CRM de amoCRM y Kommo",
+ "ydisk": "Servidor MCP y CLI de Yandex Disk con búsqueda sin conexión"
},
"products": {
"tg": "Telegram",
@@ -330,7 +339,8 @@
"max": "MAX",
"mail": "correo",
"b24": "Bitrix24",
- "amo": "amoCRM"
+ "amo": "amoCRM",
+ "ydisk": "Yandex Disk"
},
"labels": {
"mail": "Correo"
@@ -361,6 +371,7 @@
"attachments": "Envía y descarga archivos adjuntos de {product}",
"topic-search": "Busca conversaciones de {product} por tema",
"drive/search": "Busca documentos de Google Drive con tu agente de IA",
+ "ydisk/search": "Busca documentos de Yandex Disk con tu agente de IA",
"drive/usage": "Importa y organiza documentos de Google Drive",
"memo/search": "Busca en notas, correo y mensajes con Memo",
"memo/archive": "",
diff --git a/lib/seo.ts b/lib/seo.ts
index 44770d26..21d0b8bb 100644
--- a/lib/seo.ts
+++ b/lib/seo.ts
@@ -13,6 +13,7 @@ import seoCopy from "./seo-copy.json"
import { appName, siteUrl, tools } from "./shared"
import { homePath } from "./site-routes"
import { whatsappDescriptions } from "./whatsapp-descriptions"
+import { ydiskDescriptions } from "./ydisk-descriptions"
import { zoomDescriptions } from "./zoom-descriptions"
export type SiteLocale = keyof typeof seoCopy
@@ -126,6 +127,7 @@ export function documentationDescription(lang: string, slugs: string[], authored
notion: notionDescriptions,
pbx: pbxDescriptions,
wa: whatsappDescriptions,
+ ydisk: ydiskDescriptions,
}[selectedTool?.name ?? ""]
if (reviewed) {
const description = reviewed[localeOf(lang)][slugs[1] ?? "index"]
diff --git a/lib/ydisk-descriptions.ts b/lib/ydisk-descriptions.ts
new file mode 100644
index 00000000..3635fa79
--- /dev/null
+++ b/lib/ydisk-descriptions.ts
@@ -0,0 +1,55 @@
+export const ydiskDescriptions: Record> = {
+ en: {
+ index: "Search the text of your Yandex Disk folders offline, and let your AI agent read, file and share documents.",
+ installation: "Install the Yandex Disk CLI with npm, get a Yandex token and sign in with a profile.",
+ usage: "Choose Disk folders, sync their text to your computer, read documents and work with files on the Disk.",
+ search: "Find Disk documents by words, by meaning or by file name, and keep tags and notes on them.",
+ recipes: "Whole Yandex Disk tasks for an agent: find a contract, file invoices, share a link.",
+ mcp: "Connect an agent to the Yandex Disk CLI over MCP, see what it is offered and keep its writes yours.",
+ commands: "Find every Yandex Disk CLI command, option and exit code in the generated reference.",
+ configuration: "See and change the Yandex Disk CLI settings: profiles, folders, variables and their order.",
+ troubleshooting: "Fix a refused Yandex token, a folder that does not sync or a search that finds nothing.",
+ security: "What the Yandex Disk CLI keeps, where the token lives, what it reaches and what a run record hides.",
+ changelog: "Read Yandex Disk CLI release notes, including new capabilities, changes and fixes.",
+ roadmap: "See what the Yandex Disk CLI does today and what is planned next, such as two-way folder sync.",
+ compare:
+ "Compare ydisk with the Yandex Disk MCP server, rclone, Yandex Disk for Linux and yandex-disk-mcp by the job.",
+ },
+ ru: {
+ index: "Ищите по тексту папок Яндекс Диска без интернета, а ИИ-агент читает, раскладывает и отправляет документы.",
+ installation: "Установите CLI для Яндекс Диска из npm, получите токен Яндекса и войдите с профилем.",
+ usage: "Выберите папки Диска, скопируйте их текст на компьютер, читайте документы и работайте с файлами на Диске.",
+ search: "Находите документы Диска по словам, по смыслу и по имени файла, добавляйте теги и заметки.",
+ recipes: "Задачи для агента на Яндекс Диске целиком: найти договор, разложить счета, сделать ссылку.",
+ mcp: "Подключите агента к CLI для Яндекс Диска через MCP, посмотрите, что ему доступно, и оставьте запись за собой.",
+ commands: "Все команды, параметры и коды выхода CLI для Яндекс Диска в сгенерированном справочнике.",
+ configuration: "Настройки CLI для Яндекс Диска: профили, папки, переменные и порядок, в котором они действуют.",
+ troubleshooting: "Исправьте отклоненный токен Яндекса, папку, которая не копируется, или поиск без результатов.",
+ security: "Что хранит CLI для Яндекс Диска, где лежит токен, куда он обращается и что скрывает запись запуска.",
+ changelog: "История изменений CLI для Яндекс Диска: новые возможности, изменения и исправления.",
+ roadmap:
+ "Что CLI для Яндекс Диска уже умеет и что запланировано дальше, например двусторонняя синхронизация папок.",
+ compare:
+ "Сравнение ydisk с MCP-сервером Яндекс Диска, rclone, Яндекс Диском для Linux и yandex-disk-mcp по задачам.",
+ },
+ es: {
+ index: "Busca en el texto de tus carpetas de Yandex Disk sin conexión, y tu agente de IA lee, archiva y comparte.",
+ installation: "Instala la CLI de Yandex Disk con npm, consigue un token de Yandex e inicia sesión con un perfil.",
+ usage: "Elige carpetas del Disk, copia su texto a tu ordenador, lee documentos y trabaja con archivos del Disk.",
+ search:
+ "Encuentra documentos del Disk por palabras, por significado o por nombre de archivo, con etiquetas y notas.",
+ recipes:
+ "Tareas completas de Yandex Disk para un agente: encontrar un contrato, archivar facturas, compartir un enlace.",
+ mcp: "Conecta un agente a la CLI de Yandex Disk por MCP, mira qué se le ofrece y mantén tuyas sus escrituras.",
+ commands: "Consulta todos los comandos, opciones y códigos de salida de la CLI de Yandex Disk.",
+ configuration: "Mira y cambia los ajustes de la CLI de Yandex Disk: perfiles, carpetas, variables y su orden.",
+ troubleshooting: "Arregla un token de Yandex rechazado, una carpeta que no se copia o una búsqueda sin resultados.",
+ security:
+ "Qué guarda la CLI de Yandex Disk, dónde vive el token, a qué se conecta y qué oculta un registro de ejecución.",
+ changelog: "Lee las notas de versión de la CLI de Yandex Disk: novedades, cambios y correcciones.",
+ roadmap:
+ "Mira qué hace ya la CLI de Yandex Disk y qué está previsto, como la sincronización de carpetas en ambos sentidos.",
+ compare:
+ "Compara ydisk con el servidor MCP de Yandex Disk, rclone, Yandex Disk para Linux y yandex-disk-mcp por tarea.",
+ },
+}
diff --git a/scripts/docs-navigation.test.ts b/scripts/docs-navigation.test.ts
index fcb7c705..44ebe305 100644
--- a/scripts/docs-navigation.test.ts
+++ b/scripts/docs-navigation.test.ts
@@ -233,9 +233,8 @@ describe("tool folders in the sidebar", () => {
children: [],
})
const markdown: Node = { type: "page", name: "Markdown y Obsidian", url: "/es/docs/markdown" }
- const ydisk: Node = { type: "page", name: "Yandex Disk", url: "/es/docs/ydisk" }
const tree = unifiedDocsTree(
- { name: "Docs", children: [folder("drive"), folder("gcal"), folder("notion"), ydisk, markdown] },
+ { name: "Docs", children: [folder("drive"), folder("gcal"), folder("notion"), folder("ydisk"), markdown] },
"es",
)
const [group, gcal] = tree.children
diff --git a/scripts/localize.ts b/scripts/localize.ts
index dd142ea0..3a4408fa 100644
--- a/scripts/localize.ts
+++ b/scripts/localize.ts
@@ -37,6 +37,7 @@ export const siteOwnedPages: { tool?: string; slug: string; after?: string }[] =
{ tool: "zm", slug: "meetings", after: "usage" },
{ tool: "notion", slug: "roadmap", after: "changelog" },
{ tool: "amo", slug: "roadmap", after: "changelog" },
+ { tool: "ydisk", slug: "roadmap", after: "changelog" },
]
export const siteOwnedFor = (tool: string) => siteOwnedPages.filter((page) => !page.tool || page.tool === tool)
diff --git a/scripts/seo.test.ts b/scripts/seo.test.ts
index dc8ce8b3..299e3cf6 100644
--- a/scripts/seo.test.ts
+++ b/scripts/seo.test.ts
@@ -164,6 +164,25 @@ describe("localized SEO", () => {
for (const slug of [...slugs, "changelog", "compare", "roadmap", "mcp", "permissions"])
expect(() => documentationDescription(lang, ["amo", slug]), `${lang} amo/${slug}`).not.toThrow()
})
+ it("describes every page the Yandex Disk CLI publishes in every locale", () => {
+ for (const lang of seoLocales)
+ for (const slug of [
+ "index",
+ "installation",
+ "usage",
+ "search",
+ "recipes",
+ "mcp",
+ "commands",
+ "configuration",
+ "troubleshooting",
+ "security",
+ "changelog",
+ "compare",
+ "roadmap",
+ ])
+ expect(() => documentationDescription(lang, ["ydisk", slug]), `${lang} ydisk/${slug}`).not.toThrow()
+ })
it("describes every page the Notion CLI publishes in every locale", () => {
const slugs = ["index", "installation", "usage", "commands", "configuration", "troubleshooting", "security"]
for (const lang of seoLocales)
diff --git a/tools.json b/tools.json
index 513e4ff1..7a6e83b0 100644
--- a/tools.json
+++ b/tools.json
@@ -49,6 +49,19 @@
"es": "Importa carpetas de Google, busca documentos localmente y conserva etiquetas, notas y recuerdos con fuentes."
}
},
+ {
+ "name": "ydisk",
+ "displayName": "Yandex Disk",
+ "repo": "WireCatLabs/ydisk-cli",
+ "package": "@wirecat/yandex-disk-cli",
+ "lang": "en",
+ "docsRef": "v0.2.0",
+ "summary": {
+ "en": "Search the text of your Yandex Disk folders on your computer, and let your AI agent read, file and share documents there.",
+ "ru": "Ищите по тексту папок Яндекс Диска на своём компьютере и поручайте ИИ-агенту читать, раскладывать и отправлять документы.",
+ "es": "Busca en el texto de tus carpetas de Yandex Disk en tu ordenador y deja que tu agente de IA lea, archive y comparta documentos."
+ }
+ },
{
"name": "notion",
"displayName": "Notion",
diff --git a/translations/pages/ydisk/roadmap.en.md b/translations/pages/ydisk/roadmap.en.md
new file mode 100644
index 00000000..4a4022f8
--- /dev/null
+++ b/translations/pages/ydisk/roadmap.en.md
@@ -0,0 +1,22 @@
+---
+title: "Roadmap"
+---
+
+This page lists what is planned for `ydisk` and not done yet. Read it before you build a workaround for a missing
+feature: it may already be on the way. The order can change, and there are no dates. To suggest something, open an
+[issue on GitHub](https://github.com/WireCatLabs/ydisk-cli/issues).
+
+## What works today
+
+`ydisk` signs in to your Yandex Disk with a Yandex token you make once. It copies the text of the folders you choose to
+your computer, so you and your agent search it by words, by meaning and by file name, even without the internet. The
+same tool lists, downloads, uploads, moves and shares files on the Disk within the permissions you set, over the
+command line or MCP. See [start here](./index.md).
+
+## Next
+
+- Two-way sync of a local folder with a Disk folder. Changes you make in either place reach the other.
+- Editing and creating documents (`.md`, `.txt`, `.docx` and `.xlsx`). A file goes back to the Disk only if nobody
+ changed it there in the meantime.
+
+What changed in each released version is in the [changelog](./changelog.md).
diff --git a/translations/pages/ydisk/roadmap.es.md b/translations/pages/ydisk/roadmap.es.md
new file mode 100644
index 00000000..0a165ba6
--- /dev/null
+++ b/translations/pages/ydisk/roadmap.es.md
@@ -0,0 +1,22 @@
+---
+title: "Hoja de ruta"
+---
+
+Esta página enumera lo que está previsto para `ydisk` y aún no está hecho. Léela antes de montar un apaño para una
+función que falta: puede que ya esté en camino. El orden puede cambiar y no hay fechas. Para sugerir algo, abre un
+[issue en GitHub](https://github.com/WireCatLabs/ydisk-cli/issues).
+
+## Qué funciona hoy
+
+`ydisk` inicia sesión en tu Yandex Disk con un token de Yandex que creas una sola vez. Copia a tu ordenador el texto de
+las carpetas que elijas, y tú y tu agente lo buscáis por palabras, por significado y por nombre de archivo, incluso sin
+internet. La misma herramienta lista, descarga, sube, mueve y comparte archivos del Disk dentro de los permisos que
+fijes, por la línea de comandos o por MCP. Mira la [introducción](./index.md).
+
+## Siguiente
+
+- Sincronización en ambos sentidos de una carpeta local con una carpeta del Disk: los cambios de un lado llegan al otro.
+- Edición y creación de documentos (`.md`, `.txt`, `.docx` y `.xlsx`). Un archivo vuelve al Disk solo si nadie lo
+ cambió allí mientras tanto.
+
+Lo que cambió en cada versión está en el [registro de cambios](./changelog.md).
diff --git a/translations/pages/ydisk/roadmap.ru.md b/translations/pages/ydisk/roadmap.ru.md
new file mode 100644
index 00000000..c7d90339
--- /dev/null
+++ b/translations/pages/ydisk/roadmap.ru.md
@@ -0,0 +1,22 @@
+---
+title: "Планы развития"
+---
+
+Здесь перечислено, что запланировано для `ydisk` и еще не сделано. Загляните сюда, прежде чем обходить нехватку
+функции: возможно, она уже в работе. Порядок может меняться, сроков нет. Предложить что-то можно в
+[issue на GitHub](https://github.com/WireCatLabs/ydisk-cli/issues).
+
+## Что работает сейчас
+
+`ydisk` входит в ваш Яндекс Диск по токену Яндекса, который вы создаете один раз. Он копирует на компьютер текст
+выбранных папок, и вы с агентом ищете по нему по словам, по смыслу и по имени файла, даже без интернета. Тот же
+инструмент показывает, скачивает, загружает, переносит и раздает файлы на Диске в пределах выбранных вами разрешений, из
+командной строки или через MCP. См. [начало работы](./index.md).
+
+## Дальше
+
+- Двусторонняя синхронизация локальной папки с папкой на Диске: изменения в любом из двух мест попадают в другое.
+- Правка и создание документов (`.md`, `.txt`, `.docx` и `.xlsx`). Файл возвращается на Диск, только если за это время
+ его там никто не менял.
+
+Что изменилось в каждой версии, смотрите в [истории изменений](./changelog.md).
diff --git a/translations/sources.json b/translations/sources.json
index b7eec1c0..a918ceaf 100644
--- a/translations/sources.json
+++ b/translations/sources.json
@@ -409,5 +409,27 @@
"amo/permissions.ru": "dbf0b02efa79c4b7dc8f86a3b78c8973e88a22240d409c00a3a0bd76406031c3",
"amo/index.es": "4d22150757fd48febb1fd4fe5e270e6f7984257964dd7d82542b5947ea0c5b78",
"amo/mcp.es": "f64cc4f782b0e6a87b64a7b5db4f5b95e8b03896c2b45d6b1d1c77ed49e1af60",
- "amo/permissions.es": "dbf0b02efa79c4b7dc8f86a3b78c8973e88a22240d409c00a3a0bd76406031c3"
+ "amo/permissions.es": "dbf0b02efa79c4b7dc8f86a3b78c8973e88a22240d409c00a3a0bd76406031c3",
+ "ydisk/changelog.es": "ff7254cb08d61a01536d3c791788b9878d4ba01a72e2f728e7cb5aca2c159f75",
+ "ydisk/changelog.ru": "ff7254cb08d61a01536d3c791788b9878d4ba01a72e2f728e7cb5aca2c159f75",
+ "ydisk/commands.es": "50f108d727a76515f18662f41b9969953f8e73aa9468dd9414db1073242fcd9a",
+ "ydisk/commands.ru": "50f108d727a76515f18662f41b9969953f8e73aa9468dd9414db1073242fcd9a",
+ "ydisk/configuration.es": "70ac759165e28b2032f2b036761e81e58adb2427e046d740893c485c90a84796",
+ "ydisk/configuration.ru": "70ac759165e28b2032f2b036761e81e58adb2427e046d740893c485c90a84796",
+ "ydisk/index.es": "35028c21952cbd97341fbb20cb7c13501bedf9f83bb78a7142b9f48a0baf04c0",
+ "ydisk/index.ru": "35028c21952cbd97341fbb20cb7c13501bedf9f83bb78a7142b9f48a0baf04c0",
+ "ydisk/installation.es": "aae0075fe1704cc9979f7a310d48709c86b432a108ec5e98c13b56bc257219e3",
+ "ydisk/installation.ru": "aae0075fe1704cc9979f7a310d48709c86b432a108ec5e98c13b56bc257219e3",
+ "ydisk/mcp.es": "5949aadee20312c916b23d159dd54334a4d9e6d83060c4e621b0ac93ab86fecf",
+ "ydisk/mcp.ru": "5949aadee20312c916b23d159dd54334a4d9e6d83060c4e621b0ac93ab86fecf",
+ "ydisk/recipes.es": "09f88b5ee6d0d06e41a328bf6c7ca229ef20ae75305e89aa63a774e9d307b066",
+ "ydisk/recipes.ru": "09f88b5ee6d0d06e41a328bf6c7ca229ef20ae75305e89aa63a774e9d307b066",
+ "ydisk/search.es": "4d9fb50644044580dbda9734041209b57cf6a15c95e4815ea5c2fb861a396942",
+ "ydisk/search.ru": "4d9fb50644044580dbda9734041209b57cf6a15c95e4815ea5c2fb861a396942",
+ "ydisk/security.es": "b77fe966224afe7122b9c4a06210b109dbf77975bec03ef9e41207cda14ad1c7",
+ "ydisk/security.ru": "b77fe966224afe7122b9c4a06210b109dbf77975bec03ef9e41207cda14ad1c7",
+ "ydisk/troubleshooting.es": "dc89e1d11615e66482bfe900b7998913a75a769bd0978745dd767d7c05ef0a8f",
+ "ydisk/troubleshooting.ru": "dc89e1d11615e66482bfe900b7998913a75a769bd0978745dd767d7c05ef0a8f",
+ "ydisk/usage.es": "a0e4bc19e253e39d64ebbe6ea0731b16959baf242fae5adba459298f978f3810",
+ "ydisk/usage.ru": "a0e4bc19e253e39d64ebbe6ea0731b16959baf242fae5adba459298f978f3810"
}
diff --git a/translations/ydisk/changelog.es.md b/translations/ydisk/changelog.es.md
new file mode 100644
index 00000000..ba4fd7b5
--- /dev/null
+++ b/translations/ydisk/changelog.es.md
@@ -0,0 +1,58 @@
+---
+title: "Historial de cambios"
+---
+
+Cambios notables en `@wirecat/yandex-disk-cli`. Una sección por versión, las más nuevas arriba.
+
+## 0.2.0 — 18.11.2026
+
+### Añadido
+
+- `ydisk store info` muestra el archivo del almacén compartido, su tamaño, su formato y el número de filas, así que
+ WireCat Desktop puede decir si Yandex Disk lo lee.
+- `ydisk account remove --keep-data|--delete-data` cierra la sesión del perfil y lo olvida en este
+ ordenador. Conserva o borra las carpetas elegidas y los archivos sincronizados, según lo que elijas.
+- `folders browse` da a cada carpeta un `kind` y un `has_children`. Yandex no da el número de elementos hijos, así que
+ se mira dentro de cada carpeta, con una petición cada una, cuando el nivel tiene 20 carpetas o menos. Con más,
+ `has_children` es `null`.
+
+### Corregido
+
+- Publicado desde GitHub Actions con la procedencia de npm (provenance), así que WireCat Desktop lo instala: Desktop se
+ niega a instalar una versión de una herramienta integrada que no compiló el workflow de su propio repositorio, y la
+ 0.1.0 se publicó desde un ordenador.
+- **Las guías cubren lo que hace la herramienta, paso a paso.** Páginas nuevas: [búsqueda de documentos](./search.md)
+ (palabras, formas de las palabras, significado, nombres de archivo), [conexión del agente](./mcp.md) (el skill,
+ `mcp add`, `mcp config`, aplicaciones del navegador y qué puede cambiar un agente), [recetas](./recipes.md) y
+ [comparación con otras herramientas](./compare.md). [Instala e inicia sesión](./installation.md) explica cómo
+ conseguir el token de Yandex con los nombres que usa el propio Yandex, [la solución de problemas](./troubleshooting.md)
+ va por síntomas e incluye los códigos de salida, y [la seguridad](./security.md) dice qué se queda en tu ordenador y
+ cómo quitarlo. Los pasos del token ahora nombran el tipo de aplicación "For API access or debugging", como las
+ páginas de Yandex.
+- La ayuda y el error de `--cursor` en `folders browse` y `files list` nombran `page.next_cursor`, la clave que tiene la
+ respuesta, y no `page.next`.
+
+## 0.1.0 — 17.11.2026
+
+### Añadido
+
+- Se empezó desde `@wirecat/cli-template` 0.25.0.
+- **Inicio de sesión con un token OAuth de Yandex** pegado una sola vez: `session start` lo lee oculto o desde stdin,
+ lo comprueba con `GET /v1/disk` y lo guarda en el llavero del sistema. `session status --check` y `doctor --online`
+ dicen de quién es.
+- **Carpetas elegidas del Disk como texto en el que buscar**: `folders add `, `sync`, `status`,
+ `documents list|show|export`, `search`, `catalog`, etiquetas, notas y recuerdos, los comandos compartidos de
+ documentos de cli-core. Cada sincronización recorre de nuevo las carpetas elegidas (la API del Disk no tiene un
+ registro de cambios) y lee solo los archivos cuyo MD5 cambió. Un archivo movido conserva su id, sus etiquetas y sus
+ notas. El texto sale de PDF, docx, xlsx, CSV, TSV, texto y Markdown. Las horas se guardan y se responden en UTC.
+- **Los archivos en vivo**: `files list|show|download|upload|copy|move|create|delete|restore|publish|unpublish`, por
+ ruta del Disk. `files delete` envía a la papelera. `--replace` y `files delete` preguntan como lo hace
+ `files.delete`, `files publish` como lo hace `files.share`, y `--dry-run` muestra cada clave que comprueba la
+ escritura. `files publish` responde con el enlace público, o deja fuera `public_url` cuando no puede leerlo de
+ vuelta. Las descargas y las subidas van a la dirección que da Yandex, sin el token.
+- **`api`**: un comando por cada operación de la descripción Swagger 1.2 de Yandex, 20 en total. Se dejan fuera las
+ tres que responden con un enlace de descarga o de subida, y los enlaces `file`, `preview` y `sizes` de un recurso se
+ quitan de cada respuesta. `--all` pasa las páginas donde la API las pagina. Un borrado permanente, `overwrite=true` y
+ un enlace público preguntan según `files.delete` y `files.share`. Una operación que hace lo que hace un comando de
+ `files` comprueba también la clave de ese comando: `files.move: deny` detiene también `api resources-move`, en la
+ ejecución y en `--dry-run`.
diff --git a/translations/ydisk/changelog.ru.md b/translations/ydisk/changelog.ru.md
new file mode 100644
index 00000000..6b6e7e08
--- /dev/null
+++ b/translations/ydisk/changelog.ru.md
@@ -0,0 +1,56 @@
+---
+title: "История изменений"
+---
+
+Заметные изменения в `@wirecat/yandex-disk-cli`. По одному разделу на версию, новые сверху.
+
+## 0.2.0 — 18.11.2026
+
+### Добавлено
+
+- `ydisk store info` показывает файл общего хранилища, его размер, формат и число строк, так что WireCat Desktop может
+ сказать, читает ли его Яндекс Диск.
+- `ydisk account remove --keep-data|--delete-data` выводит профиль из системы и забывает его на этом
+ компьютере. Выбранные папки и синхронизированные файлы остаются или удаляются, как вы выберете.
+- `folders browse` дает каждой папке `kind` и `has_children`. Яндекс не сообщает число вложенных элементов, поэтому
+ инструмент заглядывает в каждую папку отдельным запросом, если на уровне не больше 20 папок. Если их больше,
+ `has_children` равен `null`.
+
+### Исправлено
+
+- Опубликован из GitHub Actions с подписью npm (provenance), поэтому WireCat Desktop его устанавливает: Desktop
+ отказывается ставить выпуск встроенного инструмента, который собрал не workflow его репозитория, а 0.1.0 был
+ опубликован с компьютера.
+- **Руководства рассказывают шаг за шагом, что делает инструмент.** Новые страницы: [найдите документ](./search.md)
+ (слова, формы слов, смысл, имена файлов), [подключение агента](./mcp.md) (навык, `mcp add`, `mcp config`,
+ приложения в браузере и что агент может менять), [сценарии](./recipes.md) и [сравнение с другими
+ инструментами](./compare.md). [Установка и вход](./installation.md) проводит через получение токена Яндекса с
+ названиями из самого Яндекса, [решение проблем](./troubleshooting.md) устроено по симптомам и с кодами выхода, а
+ [безопасность](./security.md) говорит, что остается на вашем компьютере и как это удалить. В шагах с токеном теперь
+ назван тип приложения «Для доступа к API или отладки», как на страницах Яндекса.
+- Справка и ошибка `--cursor` в `folders browse` и `files list` называют `page.next_cursor`, ключ, который есть в
+ ответе, а не `page.next`.
+
+## 0.1.0 — 17.11.2026
+
+### Добавлено
+
+- За основу взят `@wirecat/cli-template` 0.25.0.
+- **Вход с токеном OAuth Яндекса**, который вставляется один раз: `session start` читает его скрыто или из stdin,
+ проверяет через `GET /v1/disk` и хранит в связке ключей системы. `session status --check` и `doctor --online`
+ говорят, чей это токен.
+- **Выбранные папки Диска как текст для поиска**: `folders add `, `sync`, `status`,
+ `documents list|show|export`, `search`, `catalog`, теги, заметки и записи памяти, общие команды документов из
+ cli-core. Каждая синхронизация заново обходит выбранные папки (в API Диска нет ленты изменений) и читает только
+ файлы, у которых изменился MD5. Перемещенный файл сохраняет id, теги и заметки. Текст берется из PDF, docx, xlsx,
+ CSV, TSV, текста и Markdown. Время хранится и отдается в UTC.
+- **Файлы вживую**: `files list|show|download|upload|copy|move|create|delete|restore|publish|unpublish` по путям на
+ Диске. `files delete` отправляет в корзину. `--replace` и `files delete` спрашивают так же, как `files.delete`,
+ `files publish` так же, как `files.share`, а `--dry-run` показывает каждый ключ, который проверяет запись.
+ `files publish` отвечает публичной ссылкой или опускает `public_url`, если не может ее прочитать. Скачивание и
+ загрузка идут по адресу, который дает Яндекс, без токена.
+- **`api`**: по одной команде на каждую операцию описания Swagger 1.2 от Яндекса, всего 20. Три, которые отвечают
+ ссылкой на скачивание или загрузку, пропущены, а ссылки `file`, `preview` и `sizes` ресурса убираются из каждого
+ ответа. `--all` листает страницы там, где их листает API. Окончательное удаление, `overwrite=true` и публичная ссылка
+ спрашивают по `files.delete` и `files.share`. Операция, которая делает то же, что команда `files`, проверяет и ключ
+ этой команды: `files.move: deny` останавливает и `api resources-move`, в запуске и в `--dry-run`.
diff --git a/translations/ydisk/commands.es.md b/translations/ydisk/commands.es.md
new file mode 100644
index 00000000..d70e34d0
--- /dev/null
+++ b/translations/ydisk/commands.es.md
@@ -0,0 +1,2038 @@
+---
+title: "Comandos de ydisk"
+---
+
+
+
+
+Busca cualquier comando de ydisk, sus opciones y lo que responde, con la seguridad de que coincide con tu versión:
+esta página se genera a partir del propio programa.
+
+Tu agente de IA lee la misma lista en JSON con `ydisk commands --json` y elige allí un comando y sus opciones. Cada
+código de salida indica un tipo de fallo, así que un script o un agente sabe qué salió mal. Las descripciones de los
+comandos y de las opciones se quedan en el idioma de la ayuda integrada.
+
+**La primera palabra es el perfil**, un nombre que eliges tú: `ydisk personal config show`. `YDISK_PROFILE` fija el
+perfil para toda una sesión de la shell. Nunca se supone un perfil: un comando que usa una cuenta se detiene sin él y
+muestra los perfiles de este ordenador.
+
+## Opciones de todos los comandos
+
+| Option | What it does |
+|---|---|
+| `-V, --version` | output the version number. |
+| `-v, --verbose` | more detail in what is shown: -v ids, -vv everything we know. Default: `0`. |
+| `--json` | machine-readable output: one JSON value on stdout; --json=id,text keeps only those fields. |
+| `--jsonl` | machine-readable output: one JSON object per line, for streaming and jq. |
+| `--quiet` | diagnostics off; a failure is still said. |
+| `--trace` | the connection's own log lines on stderr — never content. |
+| `--debug` | on a failure, its whole record — cause and stack — in place of the short line. |
+| `--timeout ` | give up on the whole command after this — 30s, 2m, 500ms. |
+| `--offline` | answer from what was recorded and never connect; fails if nothing was. |
+| `--no-input` | never prompt or open interactive login; piped input remains available. |
+| `--max-input-bytes ` | maximum buffered input bytes (default: 16777216). |
+| `--max-output-bytes ` | maximum machine output bytes (default: 4194304; 0 disables). |
+| `--brief` | found items as reference, title, time, author and excerpt only. |
+| `--full` | found items with their whole text and every provider field. |
+| `--compact` | one line per item for an agent: reference first, text last, paging and next steps as # lines. |
+| `--dry-run` | preview parsed arguments and permissions before running the action. |
+| `--yes` | go ahead without the question an ask level puts before a write. |
+| `--record` | keep this run even where the config says record false; record_input false leaves the typed words out. |
+| `--no-record` | do not keep this run, even if it fails. |
+
+## `ydisk commands`
+
+every command by section; --json prints its contract, one path per call
+
+### `ydisk commands info`
+
+one command contract, or all schemas, error reasons and explicit overrides
+
+```sh
+ydisk commands info [path]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `path` | optional | one command path; without one, export schemas, error reasons and explicit overrides. |
+
+**Example:** `ydisk commands info commands`
+
+## `ydisk session`
+
+keep this profile's Yandex Disk token in the OS keyring
+
+### `ydisk session start`
+
+sign this profile in: the Yandex Disk API token is asked hidden or read from stdin, never taken as an argument, checked against the service, and only then kept in the keyring, or in a private file
+
+**Changes something on this computer only.**
+
+```sh
+ydisk session start [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--credential-storage ` | where the token is kept: keyring, which falls back to a private file by itself when no keyring works; file skips the keyring, so keep it for a computer that has none. Default: `keyring`. |
+
+**Example:** `ydisk personal session start`
+
+### `ydisk session status`
+
+show where this profile's token comes from: YDISK_TOKEN, the keyring or a file, never the token; --check asks Yandex Disk whose token it is
+
+```sh
+ydisk session status [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--check` | ask Yandex Disk whether the token still works, and whose it is. |
+
+**Example:** `ydisk personal session status`, `ydisk personal session status --check --json`
+
+### `ydisk session end`
+
+forget this profile's token on this computer; the token itself stays valid in Yandex Disk
+
+**Changes something on this computer only.**
+
+```sh
+ydisk session end
+```
+
+**Example:** `ydisk personal session end`
+
+### `ydisk session list`
+
+list the profiles on this computer and whether each has a token; picks none
+
+```sh
+ydisk session list
+```
+
+**Example:** `ydisk session list`, `ydisk session list --json`
+
+## `ydisk account`
+
+this profile on this computer
+
+### `ydisk account remove`
+
+sign the profile out, then forget it on this computer: its settings, its saved sign-in and its files; --keep-data leaves its messages in the store, where search still finds them, --delete-data deletes them; asks first, or --yes
+
+**Changes something on this computer only.**
+
+```sh
+ydisk account remove [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--keep-data` | leave what the store holds of this account, still searchable. |
+| `--delete-data` | delete what the store and the tool's own files hold of this account. |
+| `--dry-run` | list what it would remove and keep, and change nothing. |
+
+**Returns:** account removal — profile, data, dry_run, account, revoked, config_file, removed, kept; every field: ydisk commands info account remove
+
+**Example:** `ydisk personal account remove --keep-data --dry-run`, `ydisk personal account remove --delete-data --yes`
+
+## `ydisk folders`
+
+choose the Disk folders sync copies
+
+### `ydisk folders add`
+
+import a folder and everything under it on the next sync
+
+**Changes something on this computer only.**
+
+```sh
+ydisk folders add
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `folder` | required | Disk path to add, like /Documents; its id to remove. |
+
+**Example:** `ydisk personal folders add /Documents`
+
+### `ydisk folders list`
+
+list the folder ids sync imports
+
+```sh
+ydisk folders list [query]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+**Returns:** selected folder — id; every field: ydisk commands info folders list
+
+**Example:** `ydisk personal folders list`
+
+### `ydisk folders browse`
+
+list Disk folders one level at a time, live, to choose one for folders add; has_children says whether a folder holds a folder, or is null when the level has more than 20 folders and it is not looked up
+
+```sh
+ydisk folders browse [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--folder ` | the Disk folder to list inside, by its path; the top of the Disk without it. |
+| `--cursor ` | go on from where the last page stopped; page.next_cursor gives it, with the same --folder. |
+
+**Next usually:** `ydisk folders add `
+
+**Example:** `ydisk personal folders browse`, `ydisk personal folders browse --folder /Work --json`
+
+### `ydisk folders remove`
+
+stop importing a folder; the next sync drops its documents
+
+**Changes something on this computer only.**
+
+```sh
+ydisk folders remove
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `folder` | required | Disk path to add, like /Documents; its id to remove. |
+
+**Example:** `ydisk personal folders remove FOLDER_ID`
+
+## `ydisk sync`
+
+import what changed in the chosen folders, and finish an unfinished sync; one sync walks about 10000 entries under the chosen folders, saves where it stopped, and the next sync goes on from there
+
+**Changes something on this computer only.**
+
+```sh
+ydisk sync [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--limit ` | how many files to read from Yandex Disk in this run. Default: `200`. |
+| `--rescan` | read every chosen folder again instead of only what changed; each --rescan starts the walk over, so run it once and continue with a plain sync. |
+| `--embed` | also index pending text for meaning search, with a model already downloaded. |
+
+**Example:** `ydisk personal sync`, `ydisk personal sync --rescan --limit 500`
+
+## `ydisk status`
+
+show the last sync, imported documents and pending work
+
+```sh
+ydisk status
+```
+
+**Example:** `ydisk personal status`
+
+## `ydisk documents`
+
+read the Yandex Disk files synced to this computer
+
+### `ydisk documents list`
+
+list the synced files with their Disk paths
+
+```sh
+ydisk documents list [query] [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+| Option | What it does |
+|---|---|
+| `--limit ` | how many documents to return. Default: `50`. |
+| `--page ` | which page to return. Default: `1`. |
+
+**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]`
+
+**Example:** `ydisk personal documents list`, `ydisk personal documents list tag:budget`, `ydisk personal documents list person:PERSON_UID --limit 10`
+
+### `ydisk documents show`
+
+show an imported document's text, tabs and metadata
+
+```sh
+ydisk documents show
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | file id (resource_id) or a search hit's document: ref. |
+
+**Example:** `ydisk personal documents show DOC_ID`, `ydisk personal documents show document:42 --offline`
+
+### `ydisk documents export`
+
+write an imported document to a new Markdown file
+
+**Changes something on this computer only.**
+
+```sh
+ydisk documents export [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | file id (resource_id) or a search hit's document: ref. |
+
+| Option | What it does |
+|---|---|
+| `--output ` | path of the Markdown file to write; an existing file is refused. |
+
+**Example:** `ydisk personal documents export DOC_ID --output notes.md`
+
+### `ydisk documents context`
+
+show a document with its tags, relationships, notes, memories and editors
+
+```sh
+ydisk documents context
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+
+**Example:** `ydisk personal documents context DOC_ID`
+
+## `ydisk search`
+
+search imported documents by words, and by meaning when indexed
+
+```sh
+ydisk search [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `query` | required | words to look for, and fields such as tag: and date: that every hit must match. |
+
+| Option | What it does |
+|---|---|
+| `--limit ` | how many results to return. Default: `20`. |
+| `--page ` | which page to return. Default: `1`. |
+| `--exact` | match the words exactly: no word forms, no meaning. |
+
+**Example:** `ydisk personal search budget`, `ydisk personal search "quarterly plan" --exact --limit 5`
+
+## `ydisk catalog`
+
+browse stored Yandex Disk files and folders offline
+
+### `ydisk catalog import`
+
+put cached file and folder metadata into the shared database
+
+**Changes something on this computer only.**
+
+```sh
+ydisk catalog import
+```
+
+**Example:** `ydisk personal catalog import --offline`
+
+### `ydisk catalog show`
+
+show stored metadata and the stable file or folder reference
+
+```sh
+ydisk catalog show
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `file` | required | Yandex Disk file or folder id, or its URL. |
+
+**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]`
+
+**Example:** `ydisk personal catalog show FILE_ID --offline`
+
+### `ydisk catalog list`
+
+list cached files and folders using metadata queries
+
+```sh
+ydisk catalog list [query] [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `query` | optional | metadata query: kind, mime, name, parent, person, tag; AND, OR, NOT. |
+
+| Option | What it does |
+|---|---|
+| `--limit ` | how many entries to return (at most 1000). Default: `50`. |
+| `--page ` | which page to return. Default: `1`. |
+
+**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]`
+
+**Example:** `ydisk personal catalog list "parent:FOLDER_ID AND kind:file" --offline`
+
+### `ydisk catalog search`
+
+search cached names, descriptions, types and observed people
+
+```sh
+ydisk catalog search [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `query` | required | metadata query: kind, mime, name, parent, person, tag; AND, OR, NOT. |
+
+| Option | What it does |
+|---|---|
+| `--limit ` | how many entries to return (at most 1000). Default: `50`. |
+| `--page ` | which page to return. Default: `1`. |
+
+**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]`
+
+**Example:** `ydisk personal catalog search "budget AND person:Rin*" --offline`
+
+### `ydisk catalog tree`
+
+show the cached hierarchy below a folder or all selected roots
+
+```sh
+ydisk catalog tree [folder] [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `folder` | optional | Yandex Disk folder id or URL; defaults to the explicitly selected profile's roots. |
+
+| Option | What it does |
+|---|---|
+| `--depth ` | maximum descendant depth, from 0 to 50. Default: `5`. |
+
+**Example:** `ydisk personal catalog tree --offline`, `ydisk personal catalog tree FOLDER_ID --depth 3 --offline`
+
+### `ydisk catalog tags`
+
+add owner tags to cached files or folders
+
+#### `ydisk catalog tags list`
+
+list local tags on a cached file or folder
+
+```sh
+ydisk catalog tags list [query]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `file` | required | Yandex Disk file or folder id, or its URL. |
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+**Returns:** document tag — tag; every field: ydisk commands info catalog tags list
+
+**Example:** `ydisk personal catalog tags list FOLDER_ID --offline`
+
+#### `ydisk catalog tags add`
+
+add local tags on a cached file or folder
+
+**Changes something on this computer only.**
+
+```sh
+ydisk catalog tags add
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `file` | required | Yandex Disk file or folder id, or its URL. |
+| `tags` | required | local tag names. |
+
+**Example:** `ydisk personal catalog tags add FOLDER_ID project --offline`
+
+#### `ydisk catalog tags remove`
+
+remove local tags on a cached file or folder
+
+**Changes something on this computer only.**
+
+```sh
+ydisk catalog tags remove
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `file` | required | Yandex Disk file or folder id, or its URL. |
+| `tags` | required | local tag names. |
+
+**Example:** `ydisk personal catalog tags remove FOLDER_ID project --offline`
+
+## `ydisk tags`
+
+label imported documents; labels survive a sync
+
+### `ydisk tags list`
+
+list a document's tags
+
+```sh
+ydisk tags list [query]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+**Returns:** document tag — tag; every field: ydisk commands info tags list
+
+**Example:** `ydisk personal tags list DOC_ID`
+
+### `ydisk tags add`
+
+tag a document
+
+**Changes something on this computer only.**
+
+```sh
+ydisk tags add
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `tags` | required | one or more tags. |
+
+**Example:** `ydisk personal tags add DOC_ID budget q3`
+
+### `ydisk tags remove`
+
+untag a document
+
+**Changes something on this computer only.**
+
+```sh
+ydisk tags remove
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `tags` | required | one or more tags. |
+
+**Example:** `ydisk personal tags remove DOC_ID budget q3`
+
+## `ydisk relationships`
+
+connect a document to people, projects, notes and other references
+
+### `ydisk relationships list`
+
+list a document's relationships
+
+```sh
+ydisk relationships list [query]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+**Returns:** document relationship — id, from, to, kind, role, confirmed, origin; every field: ydisk commands info relationships list
+
+**Example:** `ydisk personal relationships list DOC_ID`
+
+### `ydisk relationships add`
+
+connect a document to another reference
+
+**Changes something on this computer only.**
+
+```sh
+ydisk relationships add [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `reference` | required | what it connects to, such as person:, project: or note:. |
+
+| Option | What it does |
+|---|---|
+| `--kind ` | how the two relate. One of: `links-to`, `about`, `evidence`, `created-from`, `related-to`, `assigned-to`. Default: `related-to`. |
+| `--role ` | the part the reference plays, in a word or two. |
+| `--reason ` | why the two are connected. |
+
+**Example:** `ydisk personal relationships add DOC_ID project:PROJECT_ID --kind about`, `ydisk personal relationships add DOC_ID person:PERSON_UID --kind assigned-to --role reviewer`
+
+### `ydisk relationships remove`
+
+remove one of a document's relationships
+
+**Changes something on this computer only.**
+
+```sh
+ydisk relationships remove
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `relationship-id` | required | id, as relationships list prints it. |
+
+**Example:** `ydisk personal relationships remove DOC_ID LINK_ID`
+
+## `ydisk notes`
+
+write notes about an imported document
+
+### `ydisk notes add`
+
+write a note about a document
+
+**Changes something on this computer only.**
+
+```sh
+ydisk notes add [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `text` | required | the note's text. |
+
+| Option | What it does |
+|---|---|
+| `--title ` | a title for the note. |
+
+**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes add
+
+**Next usually:** `ydisk notes show `, `ydisk notes edit `, `ydisk notes remove `
+
+**Example:** `ydisk personal notes add DOC_ID "Check the numbers" --title Review`
+
+### `ydisk notes list`
+
+list a document's notes
+
+```sh
+ydisk notes list [query] [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+| Option | What it does |
+|---|---|
+| `--limit ` | how many notes to return. Default: `50`. |
+| `--page ` | which page to return. Default: `1`. |
+
+**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes list
+
+**Next usually:** `ydisk notes show `, `ydisk notes edit `, `ydisk notes remove `
+
+**Example:** `ydisk personal notes list DOC_ID`, `ydisk personal notes list DOC_ID text:review --limit 10`
+
+### `ydisk notes show`
+
+show one note
+
+```sh
+ydisk notes show
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `note` | required | note: reference, as notes list prints it. |
+
+**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes show
+
+**Next usually:** `ydisk notes edit `, `ydisk notes remove `
+
+**Example:** `ydisk personal notes show DOC_ID note:NOTE_ID`
+
+### `ydisk notes edit`
+
+replace a note's text
+
+**Changes something on this computer only.**
+
+```sh
+ydisk notes edit [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `note` | required | note: reference, as notes list prints it. |
+| `text` | required | the note's new text. |
+
+| Option | What it does |
+|---|---|
+| `--revision ` | revision from notes show; a newer note is not overwritten. |
+
+**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes edit
+
+**Next usually:** `ydisk notes show `, `ydisk notes remove `
+
+**Example:** `ydisk personal notes edit DOC_ID note:NOTE_ID "Numbers checked" --revision 2`
+
+### `ydisk notes remove`
+
+delete one note
+
+**Changes something on this computer only.**
+
+```sh
+ydisk notes remove
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `note` | required | note: reference, as notes list prints it. |
+
+**Example:** `ydisk personal notes remove DOC_ID note:NOTE_ID`
+
+## `ydisk memories`
+
+keep what was learned from a document, with evidence; an agent's stay proposed
+
+### `ydisk memories add`
+
+record a memory about a document
+
+**Changes something on this computer only.**
+
+```sh
+ydisk memories add [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `text` | required | what to remember. |
+
+| Option | What it does |
+|---|---|
+| `--scope ` | whose memory it is: personal or work. One of: `personal`, `work`. |
+| `--kind ` | what kind of memory it is. One of: `summary`, `digest`, `preference`. Default: `summary`. |
+| `--supersedes ` | a memory: about the same document that this one replaces. |
+
+**Example:** `ydisk personal memories add DOC_ID "The team prefers async reviews" --scope work --kind preference`
+
+### `ydisk memories list`
+
+list a document's memories
+
+```sh
+ydisk memories list [query] [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+| Option | What it does |
+|---|---|
+| `--limit ` | how many memories to return. Default: `50`. |
+
+**Returns:** memory — ref, id, kind, text, subject, author, model, confidence, and 13 more; every field: ydisk commands info memories list
+
+**Example:** `ydisk personal memories list DOC_ID scope:work`, `ydisk personal memories list DOC_ID kind:preference status:confirmed`
+
+### `ydisk memories show`
+
+show one memory
+
+```sh
+ydisk memories show
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `memory` | required | memory: reference, as memories list prints it. |
+
+**Example:** `ydisk personal memories show DOC_ID memory:MEMORY_ID`
+
+### `ydisk memories confirm`
+
+confirm a proposed memory as true
+
+**Changes something on this computer only.**
+
+```sh
+ydisk memories confirm
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `memory` | required | memory: reference, as memories list prints it. |
+
+**Example:** `ydisk personal memories confirm DOC_ID memory:MEMORY_ID`
+
+### `ydisk memories stale`
+
+mark a memory as out of date
+
+**Changes something on this computer only.**
+
+```sh
+ydisk memories stale
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `memory` | required | memory: reference, as memories list prints it. |
+
+**Example:** `ydisk personal memories stale DOC_ID memory:MEMORY_ID`
+
+### `ydisk memories search`
+
+search a document's memories by words
+
+```sh
+ydisk memories search
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `query` | required | words to look for, and scope:personal or scope:work — the fields are below. |
+
+**Returns:** memory — ref, id, kind, text, subject, author, model, confidence, and 13 more; every field: ydisk commands info memories search
+
+**Example:** `ydisk personal memories search DOC_ID reviews scope:work`, `ydisk personal memories search DOC_ID "async reviews"`
+
+### `ydisk memories extract`
+
+send a document's text to the model and show the memories it proposes
+
+**Changes something in the service.**
+
+```sh
+ydisk memories extract [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+
+| Option | What it does |
+|---|---|
+| `--scope ` | whose memories they become: personal or work. One of: `personal`, `work`. |
+| `--tab ` | send only this tab of the document. |
+| `--yes` | save the proposals, each with its quote and the document's version. |
+
+**Example:** `ydisk personal memories extract DOC_ID --scope work`, `ydisk personal memories extract DOC_ID --scope work --yes`
+
+## `ydisk facts`
+
+what happened, as a document shows it; an agent's stay proposed until confirmed
+
+### `ydisk facts add`
+
+record a fact a document shows
+
+**Changes something on this computer only.**
+
+```sh
+ydisk facts add [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. |
+| `statement` | required | the fact, in one sentence. |
+
+| Option | What it does |
+|---|---|
+| `--type ` | what kind of fact it is. One of: `fact`, `statement`, `question`, `decision`, `promise`. Default: `fact`. |
+| `--scope ` | whose fact it is: personal or work. One of: `personal`, `work`. |
+| `--supersedes ` | a decision only: the decision this one replaces. |
+| `--occurred-time