diff --git a/.gitignore b/.gitignore
index aa8ae16..54ff5d9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -45,3 +45,6 @@ test/coverage.lcov
 .playwright-mcp/
 /tiktok
 /.cuckoo/skills
+# cookie/agents — НЕ игнорируем: агенты проекта должны попадать в git.
+# Пользовательские агенты лежат в ~/cookie/agents (вне репозитория).
+# Ранее здесь был /cookie/agents — убрано, иначе новые агенты untracked.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b771b3b..5b7ae5e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,90 +1,40 @@
 # Changelog
 
-## [5.0.0] - 2024-10-05
-
-### 🎉 Major Release — Cookie Code
-
-**Breaking Changes:**
-- 🍪 **Rebrand: Cuckoo Code → Cookie Code** — новое название, новая идентичность:
-  - все пользовательские строки обновлены на "Cookie Code";
-  - внутренние API и техническая терминология остались без изменений для совместимости.
+## [5.0.2] - 2026-10-06
 
 ### Added
 
-- 📚 **Билингвальная документация** — теперь три README для разных аудиторий:
-  - `README.md` (12K, русский) — краткая версия для русских пользователей;
-  - `README.en.md` (12K, английский) — полная версия с чётким value proposition для международной аудитории;
-  - `README.ru.md` (25K, русский) — полная техническая документация на русском.
-- 🎨 **SVG-иконки вместо эмодзи** — заменили 🔄 на чистые SVG:
-  - кнопка "Изменить" (проект) — иконка карандаша/редактирования;
-  - кнопка "Обновить" (сессии, окна, MCP, diff) — иконка круговой стрелки;
-  - `stroke="currentColor"` — автоматическая адаптация к цвету текста;
-  - компактные 14×14px иконки с чёткими линиями.
-- 🔧 **Улучшенный diff viewer** — 8 крупных апгрейдов:
-  - навигация по hunks с кнопками ◀/▶ и хоткеями `n`/`p`;
-  - внутристроковый diff (алгоритм Myers) — подсветка изменённых символов;
-  - копирование — кнопка Copy для всего diff, клик на строку копирует без префикса;
-  - фильтры — чекбоксы Added/Deleted/Context для скрытия ненужных строк;
-  - мини-карта — вертикальная полоса с цветными сегментами изменений;
-  - статистика — `📊 +234 -89 в 12 файлах` в списке;
-  - кэширование — результаты git-команд сохраняются в Map;
-  - перетаскиваемое окно — захват за шапку, сохранение позиции в localStorage.
-- 📱 **Построчный diff в Telegram-уведомлениях** — операции `edit` теперь показывают реальные изменения:
-  - вместо "было/стало" — unified diff с префиксами `+`/`-`/` `;
-  - до 30 строк diff, затем `…(обрезано)`;
-  - используется тот же `buildLineDiff` из `tools/line-diff.js`, что и в UI.
+- 🚀 **Субагенты — теперь у AI есть свои помощники!** 😎 Представьте: просите AI «разберись с этим куском проекта», а он не тонет в тысяче файлов сам, а зовёт специалиста. Каждый субагент работает в **отдельном окне** со своим контекстом — весь его рабочий шум (поиски, чтения, пробы) остаётся там, а вам прилетает только чистый итог. Основной чат не пухнет, голова не кругом:
+  - 🎯 `run_agent(name, task)` — «эй, explore, найди все вызовы apiFetch». Открывается второе окно (тот же логин DeepSeek — ничего заново вводить не надо), субагент делает дело, окно само закрывается, родителю уходит резюме;
+  - 📋 `list_agents` — глянуть, кто вообще у нас в команде: имя, описание, какие инструменты разрешены, сколько шагов максимум;
+  - 🔍 `read_agent(name)` — подсмотреть полный промпт агента (удобно для отладки);
+  - 🧬 `create_agent({...})` — а вот самое интересное: **AI может вырастить себе специалиста прямо из чата!** «Создай агента для ревью SQL-миграций» — и через секунду файл готов, можно сразу делегировать;
+  - 📂 агенты лежат в `cookie/agents/*.md` (проектные — едут с репо, команда видит) или в `~/cookie/agents/*.md` (личные, для всех проектов). Формат — обычный markdown с frontmatter (`name`, `description`, `tools`, `maxTurns`);
+  - 🎁 из коробки уже есть четверо: `explore` (разведчик), `code-reviewer` (ревьюер), `git-committer` (гит-мастер), `changelog-writer` (летописец).
+- 🔒 **Whitelist инструментов — субагент делает только то, что ему разрешили** 🛡️ Написали в frontmatter `tools: read, grep` — и всё, `bash`, `mysql`, `deleteFile` для него закрыты наглухо:
+  - проверка происходит **до** запуска инструмента — не «а потом откатим», а «даже не начнём»;
+  - попробует запрещённое — получит чёткое «Инструмент X не разрешён этому агенту, разрешены: read, grep»;
+  - а ещё субагент не может позвать другого субагента — никаких бесконечных матрёшек 🪆.
+- 🤖 **Субагенты теперь болтают с вами в Telegram** 📱 Полный жизненный цикл на экране телефона:
+  - 🚀 при делегировании сразу прилетает карточка «кому и что поручили»;
+  - 🛠 каждое действие агента помечено «🤖 Агент: <имя>» — сразу видно, кто работает;
+  - 🎯 когда агент закончил — отдельное сообщение с итогом;
+  - 🔇 и никаких дублей: ответы из окна субагента не спамят в чат-фид;
+  - ⏱ финал определяется по «текст устоялся» (а не по старой ненадёжной проверке), с учётом лимита шагов и таймаута.
+- 🧠 **Память AI — теперь AI вас помнит** 💭 Скажите «Запомни, что меня зовут Ваня» или «Сохрани в память: у меня Windows 11 и RTX 3060» — и он запомнит. В следующей сессии уже будет знать контекст, не придётся повторять:
+  - 💾 `memory_save(text)` — сохранить одну мысль (одна запись = одна строчка с датой);
+  - 📖 `memory_read()` — прочитать всё, что накопилось;
+  - 🗑 `memory_clear()` — стереть всё (только по прямой просьбе — AI сначала предупредит);
+  - 📁 всё живёт в одном файлике `<userData>/memory.md`, можно открыть или очистить прямо из настроек;
+  - 🎯 содержимое памяти **не** подмешивается в промпт автоматически — читается только когда реально нужно, чтобы не жечь токены зря;
+  - 🔒 в plan-mode любые изменения памяти заблокированы — на этапе планирования AI ничего не перепишет.
+- 📚 **Новый раздел в README про субагентов** — как делегировать, три способа завести агента, что его защищает (whitelist, anti-recursion, `maxTurns`, timeout) и готовый пример файла агента. Читайте и заводите своих! 📖
 
 ### Changed
 
-- 📖 **Новая структура README** — English-first для GitHub-аудитории:
-  - чёткая проблема → решение в первых строках;
-  - value proposition: "Zero token cost + Real agent loop + Git integration";
-  - конкретные примеры использования вместо технического описания;
-  - призыв к действию — скачать бинарники.
-
-### Removed
-
-- 🗑️ **Устаревшие документы удалены из репозитория**:
-  - `ROADMAP.ru.md` и `Roadmap.md` — 3-недельной давности, больше не актуальны;
-  - `.cuckooCode/AUTO_UPDATE_RELEASE.md` — документация по auto-update на китайском;
-  - `DIFF_IMPROVEMENTS.md` — временный документ с описанием улучшений (все реализованы).
-
-### Added (EN)
-
-- 📚 **Bilingual documentation** — three README files for different audiences:
-  - `README.md` (12K, Russian) — concise version for Russian users;
-  - `README.en.md` (12K, English) — full version with clear value proposition for international audience;
-  - `README.ru.md` (25K, Russian) — complete technical documentation in Russian.
-- 🎨 **SVG icons instead of emoji** — replaced 🔄 with clean SVG:
-  - "Change" button (project) — pencil/edit icon;
-  - "Refresh" button (sessions, windows, MCP, diff) — circular arrow icon;
-  - `stroke="currentColor"` — automatic adaptation to text color;
-  - compact 14×14px icons with sharp lines.
-- 🔧 **Enhanced diff viewer** — 8 major upgrades:
-  - hunk navigation with ◀/▶ buttons and `n`/`p` hotkeys;
-  - intra-line diff (Myers algorithm) — highlights changed characters;
-  - copy — Copy button for full diff, click on line copies without prefix;
-  - filters — Added/Deleted/Context checkboxes to hide unwanted lines;
-  - mini-map — vertical bar with colored change segments;
-  - statistics — `📊 +234 -89 in 12 files` in the list;
-  - caching — git command results saved in Map;
-  - draggable window — grab by header, position saved in localStorage.
-- 📱 **Line-by-line diff in Telegram notifications** — `edit` operations now show real changes:
-  - instead of "before/after" — unified diff with `+`/`-`/` ` prefixes;
-  - up to 30 lines of diff, then `…(truncated)`;
-  - uses the same `buildLineDiff` from `tools/line-diff.js` as the UI.
-
-### Changed (EN)
-
-- 📖 **New README structure** — English-first for GitHub audience:
-  - clear problem → solution in the first lines;
-  - value proposition: "Zero token cost + Real agent loop + Git integration";
-  - concrete usage examples instead of technical description;
-  - call to action — download binaries.
+- 📁 **Агенты переехали: `.cuckoo/agents` → `cookie/agents`** — теперь проектные агенты лежат в репозитории рядышком с кодом (команда видит и использует), а личные — в `~/cookie/agents` (вне репо). Сканер, типы и документация обновлены. 🚚
+- 🎛 **Окно субагента получает полный системный промпт Cookie Code** — тот же набор инструментов и формат `cuckoo`, что у основного ассистента. То есть субагент работает ровно так же умело, просто в своей песочнице. 🧰
 
-### Removed (EN)
+### Fixed
 
-- 🗑️ **Obsolete documents removed from repository**:
-  - `ROADMAP.ru.md` and `Roadmap.md` — 3 weeks old, no longer relevant;
-  - `.cuckooCode/AUTO_UPDATE_RELEASE.md` — auto-update documentation in Chinese;
-  - `DIFF_IMPROVEMENTS.md` — temporary document describing improvements (all implemented).
+- 🐛 **Рабочая папка субагента больше не теряется** — была хитрая бага: при загрузке домашней DeepSeek (когда `sessionId` ещё не появился) выбранная папка проекта сбрасывалась в `null`, и агент начинал искать файлы «в никуда». Теперь папка кэшируется (`pendingProjectDir`) до готовности сессии и привязывается сама — относительные пути работают с первой секунды. ✅
diff --git a/README.en.md b/README.en.md
index 0e0b267..5a3aa85 100644
--- a/README.en.md
+++ b/README.en.md
@@ -27,9 +27,10 @@
 
 ✅ **Zero token cost** — uses your free DeepSeek web account, no API keys  
 ✅ **Real agent loop** — AI reads files → writes code → runs tests → commits changes  
+✅ **Subagents** — AI delegates tasks to isolated agents (own context, own tool whitelist)  
 ✅ **Git integration** — see diffs, browse history, review changes in a visual panel  
 ✅ **Telegram control** — code from your phone, get notifications, approve commands remotely  
-✅ **Beautiful UI** — glass effects, custom themes, animated pets, dark mode  
+✅ **Beautiful UI** — glass effects, custom themes, animated pets, dark mode
 
 ---
 
@@ -38,6 +39,7 @@
 ### 🤖 **AI Agent That Actually Does Things**
 
 The AI can now:
+
 - 📖 **Read your files** — entire project structure, grep patterns, file contents
 - ✏️ **Write & edit code** — create files, apply patches, delete old code
 - 💻 **Run commands** — bash, PowerShell, database queries, any shell script
@@ -47,11 +49,57 @@ The AI can now:
 - 🔧 **MCP tools** — connect any MCP server for extended capabilities
 
 **How it works:**
+
 1. You ask: "Show me recent changes in auth.js"
 2. AI emits: `` `cuckoo const r = await grep('auth.js', 'login');` ``
 3. Cookie Code intercepts, executes, streams result back to AI
 4. AI sees the output and continues working
 
+### 🚀 **Subagents — AI Builds Its Own Helpers**
+
+<p align="center">
+  <img src="assets/photo_2026-10-06_18-24-20.jpg" alt="Cookie Code — subagents" width="440">
+  <img src="assets/photo_2026-10-06_18-24-55.jpg" alt="Cookie Code — control panel" width="440">
+</p>
+
+Cookie Code can **delegate tasks to isolated AI agents**, each in its own window with its own context. The subagent's drafts, searches, and tool calls **never pollute the main conversation** — only the final summary comes back to the parent.
+
+**How it works:**
+
+1. You: _"Delegate to explore: find all calls to apiFetch"_
+2. AI calls `run_agent("explore", "find all calls to apiFetch")`
+3. A **separate window** opens using the same DeepSeek login
+4. The subagent works in isolation: `glob → read → grep → ...`
+5. When done, the window closes and **only the summary** appears in the chat
+
+**Three ways to create an agent:**
+
+- **Manually** — drop `cookie/agents/<name>.md` with frontmatter into your project
+- **Via AI** — say _"Create an agent for SQL migration review"_ → AI calls `create_agent` and uses it immediately
+- **Built-in** — `explore`, `code-reviewer`, `git-committer`, `changelog-writer` ship with the project
+
+**Safety rails:**
+
+- 🔒 **Tool whitelist** — put `tools: read, grep` in the agent's frontmatter → it **physically cannot** call `bash` or `mysql`
+- 🚫 **Anti-recursion** — a subagent cannot spawn another subagent
+- ⏱ **maxTurns** — breaks infinite loops (e.g., 40 steps for the committer)
+- ⏲ **10-min timeout** — force-closes a hung window
+
+**Agent example:**
+
+```markdown
+---
+name: code-reviewer
+description: Review code quality. Use after writing code.
+tools: read, grep, glob
+maxTurns: 20
+---
+
+You are an experienced code review expert...
+```
+
+---
+
 ### 🎨 **Beautiful & Customizable**
 
 <p align="center">
@@ -94,6 +142,7 @@ Control everything from your phone:
 </p>
 
 Built-in diff viewer:
+
 - **Changes tab** — see uncommitted changes, file-by-file diffs
 - **History tab** — browse commits, click to see full diff
 - **Navigation** — jump between hunks, filter added/deleted lines
@@ -103,6 +152,7 @@ Built-in diff viewer:
 ### 📈 **Statistics Dashboard**
 
 Track your productivity:
+
 - **Activity heatmap** — GitHub-style contribution graph
 - **Token usage** — daily/weekly trends
 - **Favorite models** — which AI you use most
@@ -114,12 +164,14 @@ Track your productivity:
 
 ### Option 1: Download Binary (Recommended)
 
-**Windows:**  
+**Windows:**
+
 1. Download [CookieCode-Setup.exe](https://github.com/merfiDEV/Cookie-code/releases/latest)
 2. Run installer
 3. Launch Cookie Code
 
-**macOS:**  
+**macOS:**
+
 1. Download [CookieCode.dmg](https://github.com/merfiDEV/Cookie-code/releases/latest)
 2. Drag to Applications
 3. Open (right-click → Open if Gatekeeper blocks)
@@ -178,6 +230,7 @@ AI: [runs git add + git commit]
 ### 3️⃣ **Explore Tools**
 
 Open the side panel (Cookie Code logo) to:
+
 - 🗂️ **Browse sessions** — switch between project contexts
 - 📝 **Manage todos** — see AI-created task lists
 - 🔄 **View git diff** — visual file changes
@@ -192,6 +245,7 @@ Open the side panel (Cookie Code logo) to:
 **Current limitation:** AI only knows files it explicitly reads.
 
 **Planned feature:** Full project indexing
+
 - Embed all source files into a vector database
 - AI can semantic search: "Where's the auth logic?"
 - Instant jump-to-definition for any symbol
@@ -222,13 +276,13 @@ Drop `.js` files into `tools/custom/` to extend Cookie Code:
 ```javascript
 // tools/custom/deploy.js
 module.exports = {
-  name: 'deploy',
-  description: 'Deploy to production',
-  params: { target: 'string' },
+  name: "deploy",
+  description: "Deploy to production",
+  params: { target: "string" },
   async execute({ target }) {
     // Your deployment logic
-    return { success: true, url: '...' };
-  }
+    return { success: true, url: "..." };
+  },
 };
 ```
 
@@ -240,20 +294,20 @@ AI can now call `deploy` like any built-in tool.
 
 Cookie Code ships with 20+ tools out of the box:
 
-| Tool | Description | Example |
-|------|-------------|---------|
-| `read` | Read file contents | `read('src/auth.js')` |
-| `write` | Create or overwrite file | `write('test.js', code)` |
-| `edit` | Apply targeted patch | `edit('app.js', oldCode, newCode)` |
-| `glob` | Find files by pattern | `glob('**/*.test.js')` |
-| `grep` | Search file contents | `grep('TODO', { include: '*.js' })` |
-| `bash` | Run shell command | `bash('npm test')` |
-| `pwsh` | Run PowerShell script | `pwsh('Get-Process')` |
-| `git` | Git operations | `git('status')` |
-| `mysql` | SQL queries | `mysql('SELECT * FROM users')` |
-| `webFetch` | HTTP requests | `webFetch('https://api.example.com')` |
-| `todoWrite` | Manage task lists | `todoWrite([{content: 'Fix bug'}])` |
-| `mcpCall` | Call MCP server tool | `mcpCall('github', 'create_pr', {...})` |
+| Tool        | Description              | Example                                 |
+| ----------- | ------------------------ | --------------------------------------- |
+| `read`      | Read file contents       | `read('src/auth.js')`                   |
+| `write`     | Create or overwrite file | `write('test.js', code)`                |
+| `edit`      | Apply targeted patch     | `edit('app.js', oldCode, newCode)`      |
+| `glob`      | Find files by pattern    | `glob('**/*.test.js')`                  |
+| `grep`      | Search file contents     | `grep('TODO', { include: '*.js' })`     |
+| `bash`      | Run shell command        | `bash('npm test')`                      |
+| `pwsh`      | Run PowerShell script    | `pwsh('Get-Process')`                   |
+| `git`       | Git operations           | `git('status')`                         |
+| `mysql`     | SQL queries              | `mysql('SELECT * FROM users')`          |
+| `webFetch`  | HTTP requests            | `webFetch('https://api.example.com')`   |
+| `todoWrite` | Manage task lists        | `todoWrite([{content: 'Fix bug'}])`     |
+| `mcpCall`   | Call MCP server tool     | `mcpCall('github', 'create_pr', {...})` |
 
 [Full tool reference →](docs/TOOLS.md)
 
@@ -316,12 +370,14 @@ Free to use, modify, and distribute. Commercial use allowed.
 ## 🙏 Credits
 
 Built with:
+
 - [Electron](https://www.electronjs.org/) — desktop app framework
 - [DeepSeek](https://www.deepseek.com/) — AI chat interface
 - [Telegraf](https://github.com/telegraf/telegraf) — Telegram bot framework
 - [gifenc](https://github.com/mattdesl/gifenc) — GIF processing
 
 Inspired by:
+
 - [Aider](https://github.com/paul-gauthier/aider) — AI pair programming in terminal
 - [Claude Desktop](https://claude.ai/download) — MCP protocol pioneer
 - [Cursor](https://cursor.sh/) — AI-first code editor
@@ -341,8 +397,8 @@ If Cookie Code saves you time, consider giving it a star! It helps others discov
 - **Documentation:** [docs/](docs/)
 - **Changelog:** [CHANGELOG.md](CHANGELOG.md)
 - **Roadmap:** [GitHub Projects](https://github.com/merfiDEV/Cookie-code/projects)
-- **Discord:** [Join the community](https://discord.gg/...) *(coming soon)*
-- **Twitter:** [@CookieCodeAI](https://twitter.com/...) *(coming soon)*
+- **Discord:** [Join the community](https://discord.gg/...) _(coming soon)_
+- **Twitter:** [@CookieCodeAI](https://twitter.com/...) _(coming soon)_
 
 ---
 
diff --git a/README.md b/README.md
index dd73361..ca278b4 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@
 </p>
 
 <p align="center">
-  <img src="assets/photo_1_2026-09-12_19-02-00.jpg" alt="Cookie Code — main window" width="900">
+  <img src="assets/photo_1_2026-09-12_19-02-00.jpg" alt="Cookie Code — главное окно" width="900">
 </p>
 
 **Превратите DeepSeek в настоящего помощника по коду.** Cookie Code соединяет AI-чат с вашей реальной кодовой базой — без API-токенов, без копипасты, только чистая автоматизация.
@@ -27,9 +27,10 @@
 
 ✅ **Нулевая стоимость токенов** — использует ваш бесплатный веб-аккаунт DeepSeek, без API-ключей  
 ✅ **Настоящий агентный цикл** — AI читает файлы → пишет код → запускает тесты → коммитит изменения  
+✅ **Субагенты** — AI делегирует задачи изолированным агентам (свой контекст, свой whitelist инструментов)  
 ✅ **Интеграция Git** — смотрите diff, листайте историю, проверяйте изменения визуально  
 ✅ **Управление через Telegram** — пишите код с телефона, получайте уведомления, подтверждайте команды удалённо  
-✅ **Красивый UI** — стеклянные эффекты, кастомные темы, анимированные петы, тёмная тема  
+✅ **Красивый UI** — стеклянные эффекты, кастомные темы, анимированные петы, тёмная тема
 
 ---
 
@@ -38,6 +39,7 @@
 ### 🤖 **AI-агент, который реально работает**
 
 Теперь AI умеет:
+
 - 📖 **Читать файлы** — структура проекта, grep-паттерны, содержимое
 - ✏️ **Писать и редактировать код** — создавать файлы, применять патчи, удалять старый код
 - 💻 **Запускать команды** — bash, PowerShell, SQL-запросы, любые shell-скрипты
@@ -45,13 +47,60 @@
 - 📊 **Управлять задачами** — создавать, отслеживать и завершать todo-списки
 - 🌐 **Получать данные** — HTTP-запросы, API-вызовы, веб-скрапинг
 - 🔧 **MCP-инструменты** — подключать любой MCP-сервер для расширенных возможностей
+- 🧠 **Память** — AI запоминает факты о вас и вашей системе («Сохрани в память, что…»), читает их в следующих сессиях через `memoryRead()`. Файл памяти лежит в папке пользователя, открывается и очищается в настройках.
 
 **Как это работает:**
+
 1. Вы спрашиваете: "Покажи последние изменения в auth.js"
 2. AI генерирует: `` `cuckoo const r = await grep('auth.js', 'login');` ``
 3. Cookie Code перехватывает, выполняет, стримит результат обратно в AI
 4. AI видит вывод и продолжает работать
 
+### 🚀 **Субагенты — AI создаёт своих помощников**
+
+<p align="center">
+  <img src="assets/photo_2026-10-06_18-24-20.jpg" alt="Cookie Code — субагенты" width="440">
+  <img src="assets/photo_2026-10-06_18-24-55.jpg" alt="Cookie Code — панель управления" width="440">
+</p>
+
+Cookie Code умеет **делегировать задачи изолированным AI-агентам**, каждый в своём окне и со своим контекстом. Черновики, поиски и tool-вызовы субагента **не засоряют основной диалог** — родителю возвращается только финальное резюме.
+
+**Как это работает:**
+
+1. Вы: _«Делегируй explore: найди все вызовы apiFetch»_
+2. AI вызывает `run_agent("explore", "...", "...")`
+3. Открывается **отдельное окно** с тем же логином DeepSeek
+4. Субагент работает в изоляции: `glob → read → grep → ...`
+5. Когда закончит — окно закрывается, в чат приходит **только резюме**
+
+**Три способа завести агента:**
+
+- **Вручную** — положите `cookie/agents/<имя>.md` с frontmatter в проект
+- **Через AI** — скажите _«Создай агента для ревью SQL-миграций»_ → AI вызовет `create_agent` и сразу его использует
+- **Готовые** — `explore`, `code-reviewer`, `git-committer`, `changelog-writer` уже в проекте
+
+**Что защищает:**
+
+- 🔒 **Whitelist инструментов** — в frontmatter агента указываете `tools: read, grep` → агент **физически не сможет** вызвать `bash` или `mysql`
+- 🚫 **Anti-recursion** — субагент не может запустить ещё одного субагента
+- ⏱ **maxTurns** — обрубает зацикливание (например, 40 шагов для коммиттера)
+- ⏲ **Timeout 10 мин** — принудительно закрывает зависшее окно
+
+**Пример агента:**
+
+```markdown
+---
+name: code-reviewer
+description: Проверка качества кода. Использовать после написания кода.
+tools: read, grep, glob
+maxTurns: 20
+---
+
+Ты — опытный эксперт по ревью кода...
+```
+
+---
+
 ### 🎨 **Красиво и настраиваемо**
 
 - **Стеклянный UI** — матовое стекло с настраиваемым размытием и прозрачностью
@@ -86,6 +135,7 @@
 ### 📊 **Интеграция Git**
 
 Встроенный просмотрщик diff:
+
 - **Вкладка "Изменения"** — незакоммиченные изменения, построчные diff
 - **Вкладка "История"** — листайте коммиты, кликайте для просмотра полного diff
 - **Навигация** — прыгайте между hunks, фильтруйте добавленные/удалённые строки
@@ -95,6 +145,7 @@
 ### 📈 **Дашборд статистики**
 
 Отслеживайте продуктивность:
+
 - **Тепловая карта активности** — график вкладов в стиле GitHub
 - **Использование токенов** — тренды по дням/неделям
 - **Любимые модели** — какой AI вы используете чаще
@@ -151,6 +202,7 @@ AI: [git commit] Закоммичено: "feat(auth): добавлены тес
 ### Исследуйте
 
 Откройте боковую панель для:
+
 - 🗂️ Просмотра сессий
 - 📝 Управления задачами
 - 🔄 Просмотра git diff
@@ -162,19 +214,19 @@ AI: [git commit] Закоммичено: "feat(auth): добавлены тес
 
 20+ инструментов из коробки:
 
-| Инструмент | Описание |
-|------|-------------|
-| `read` | Прочитать содержимое файла |
-| `write` | Создать/перезаписать файл |
-| `edit` | Применить патч |
-| `glob` | Найти файлы по паттерну |
-| `grep` | Поиск по содержимому |
-| `bash` / `pwsh` | Запуск shell-команд |
-| `git` | Git-операции |
-| `mysql` | SQL-запросы |
-| `webFetch` | HTTP-запросы |
-| `todoWrite` | Списки задач |
-| `mcpCall` | Инструменты MCP-сервера |
+| Инструмент      | Описание                   |
+| --------------- | -------------------------- |
+| `read`          | Прочитать содержимое файла |
+| `write`         | Создать/перезаписать файл  |
+| `edit`          | Применить патч             |
+| `glob`          | Найти файлы по паттерну    |
+| `grep`          | Поиск по содержимому       |
+| `bash` / `pwsh` | Запуск shell-команд        |
+| `git`           | Git-операции               |
+| `mysql`         | SQL-запросы                |
+| `webFetch`      | HTTP-запросы               |
+| `todoWrite`     | Списки задач               |
+| `mcpCall`       | Инструменты MCP-сервера    |
 
 ---
 
@@ -182,7 +234,7 @@ AI: [git commit] Закоммичено: "feat(auth): добавлены тес
 
 **Темы:** Размытие фона, прозрачность панелей, стеклянные цвета  
 **Петы:** Бросьте PNG/GIF в `userData/pets/`, выберите из сетки  
-**Шрифты:** Бросьте `.ttf`/`.woff` в `userData/fonts/`, выберите из выпадающего списка  
+**Шрифты:** Бросьте `.ttf`/`.woff` в `userData/fonts/`, выберите из выпадающего списка
 
 ---
 
@@ -196,6 +248,7 @@ AI: [git commit] Закоммичено: "feat(auth): добавлены тес
 6. Пушьте и открывайте PR
 
 **Области, где нужна помощь:**
+
 - 🌍 Переводы
 - 📚 Документация
 - 🐛 Отчёты об ошибках
diff --git a/README.ru.md b/README.ru.md
index f30c0b8..7b8b5b4 100644
--- a/README.ru.md
+++ b/README.ru.md
@@ -143,6 +143,69 @@
 
 Поместите папку в `.cuckoo/skills/<name>/` с файлом `SKILL.md` (и опциональным `tool.js`) — она станет вызываемой через `skillList`, `skillLoad`, `skillExecute`.
 
+### Субагенты
+
+<p align="center">
+  <img src="assets/photo_2026-10-06_18-24-20.jpg" alt="Cookie Code — субагенты" width="440">
+  <img src="assets/photo_2026-10-06_18-24-55.jpg" alt="Cookie Code — панель управления" width="440">
+</p>
+
+Cookie Code умеет **делегировать задачи изолированным AI-агентам**. Каждый субагент работает в **отдельном окне** с тем же partition (общий логин DeepSeek), в **своём контексте**, и возвращает родителю **только финальное резюме** — черновики, поиски и tool-вызовы не засоряют основной диалог.
+
+**Пример:**
+
+1. Вы: _«Делегируй explore: найди все вызовы apiFetch»_
+2. AI вызывает `run_agent("explore", "найди все вызовы apiFetch")`
+3. Открывается второе окно, туда автоматически уходит системный промпт + задача
+4. Субагент работает: `glob → read → grep → ...`
+5. Когда напишет финал **без** `cuckoo`-блоков — окно закрывается, в родительский чат приходит только резюме
+
+**Три способа завести агента:**
+
+- **Вручную** — положите `cookie/agents/<name>.md` с frontmatter в проект
+- **Через AI** — попросите: _«Создай агента для ревью SQL-миграций»_ — AI вызовет `create_agent` и сможет его сразу использовать
+- **Готовые** — в проекте уже есть `explore`, `code-reviewer`, `git-committer`, `changelog-writer`
+
+**Формат файла агента** (`<проект>/cookie/agents/<имя>.md`):
+
+```markdown
+---
+name: code-reviewer
+description: Проверка качества кода. Использовать после написания кода.
+tools: read, grep, glob
+maxTurns: 20
+---
+
+Ты — опытный эксперт по ревью кода. Проверь указанный код, найди
+реальные проблемы и дай рекомендации.
+```
+
+**Поля frontmatter:**
+
+| Поле          | Обязательно | Описание                                                   |
+| ------------- | ----------- | ---------------------------------------------------------- |
+| `name`        | нет         | Имя агента (по умолчанию — имя файла без `.md`)            |
+| `description` | **да**      | Когда делегировать. Без него агент игнорируется            |
+| `tools`       | нет         | Список разрешённых инструментов через запятую. Пусто = все |
+| `maxTurns`    | нет         | Лимит шагов 1..1000 (защита от зацикливания)               |
+
+**Изоляция и защита:**
+
+- 🔒 **Whitelist инструментов** — `tools: read, grep` → агент **физически не сможет** вызвать `bash`, `mysql`, `deleteFile` — блокировка на двух уровнях (JsRunner + main IPC)
+- 🚫 **Anti-recursion** — субагент не может вызвать `run_agent`
+- ⏱ **maxTurns** — обрубает бесконечные циклы
+- ⏲ **Timeout 10 мин** — принудительно закрывает зависшее окно
+- 📁 **Общий projectDir** — субагент видит ту же рабочую папку, что родитель
+- 🎯 **Прогрессивное раскрытие** — в системный промпт родителя идут только `name` + `description` каждого агента, полный `systemPrompt` читается только при запуске
+
+**Уведомления в Telegram:**
+
+При делегировании в TG приходят:
+
+1. Карточка запуска: `🚀 ИИ делегирует задачу субагенту` + имя + задача
+2. Каждый tool-вызов агента: `🤖 Агент: explore` + `📖 Reading file.js`
+3. Финальный результат: `🎯 Субагент вернул результат` + резюме
+
 ### Авто-форматтеры
 
 Каждый `write` и `edit` прогоняет файл через форматтер для конкретного языка — код AI автоматически приводится к стилю вашего проекта. Не нужно вручную запускать `prettier --write`, стиль не мешает в diff.
@@ -248,6 +311,10 @@ Cookie Code перехватывает его, выполняет в песоч
 | `mysql`                                    | SQL-запросы                                                                 |
 | `mcpCall`, `mcpListServers`, `mcpGetTools` | MCP-инструменты                                                             |
 | `skillList`, `skillLoad`, `skillExecute`   | Пользовательские скиллы                                                     |
+| `run_agent`                                | Делегировать задачу субагенту (отдельное окно, изолированный контекст)      |
+| `create_agent`                             | Создать нового субагента (файл `cookie/agents/<имя>.md`)                    |
+| `list_agents`                              | Список доступных субагентов (проект + пользователь)                         |
+| `read_agent`                               | Полный systemPrompt субагента по имени                                      |
 | `openBrowserWindow`, `injectJS`            | Окно браузера Electron + инъекция JS                                        |
 
 Полные TypeScript-декларации — в `tools/cuckoo-tools.d.ts`.
diff --git a/assets/photo_2026-10-06_18-24-20.jpg b/assets/photo_2026-10-06_18-24-20.jpg
new file mode 100644
index 0000000..f302498
Binary files /dev/null and b/assets/photo_2026-10-06_18-24-20.jpg differ
diff --git a/assets/photo_2026-10-06_18-24-55.jpg b/assets/photo_2026-10-06_18-24-55.jpg
new file mode 100644
index 0000000..b6da867
Binary files /dev/null and b/assets/photo_2026-10-06_18-24-55.jpg differ
diff --git a/botsrc/i18n.js b/botsrc/i18n.js
index b138418..ca973a0 100644
--- a/botsrc/i18n.js
+++ b/botsrc/i18n.js
@@ -44,6 +44,7 @@ const STRINGS = {
     "help.cmd.show": "/show &lt;hash&gt; — diff коммита",
     "help.cmd.files": "/files &lt;hash&gt; — файлы коммита",
     "help.cmd.todos": "/todos       — список задач активного окна",
+    "help.cmd.agents": "/agents      — список субагентов проекта",
     "help.cmd.screen": "/screen      — скриншот активного окна",
     "help.cmd.cancel": "/cancel      — отменить ввод / подтверждение",
     "help.cmd.help": "/help        — эта справка",
@@ -250,6 +251,54 @@ const STRINGS = {
     "tool.items": " пункт(ов)",
     "tool.allDone": "🎉 <b>Все задачи выполнены</b> ({n}/{n})",
 
+    // ===== Память (memory_save/read/clear) =====
+    "mem.readTitle": "🧠 <b>ИИ читает память</b>",
+    "mem.saveTitle": "🧠 <b>ИИ сохраняет в память</b>",
+    "mem.clearTitle": "🧠 <b>ИИ очищает память</b>",
+    "mem.readEmpty": "🧠 <b>Память пуста</b>",
+    "mem.saved": "Записано:",
+    "mem.cleared": "🗑 Память очищена",
+    "mem.content": "Содержимое памяти:",
+    "mem.count": "записей: {n}",
+
+    // ===== Время/локация (city_time) =====
+    "city.title": "🕒 <b>Время и местоположение</b>",
+    "city.time": "Время",
+    "city.tz": "Часовой пояс",
+    "city.place": "Город / страна",
+
+    // ===== Субагенты (run_agent / create_agent / list_agents / read_agent) =====
+    "agent.runTitle": "🚀 <b>ИИ делегирует задачу субагенту</b>",
+    "agent.resultTitle": "🎯 <b>Субагент вернул результат</b>",
+    "agent.createTitle": "🧬 <b>ИИ создаёт нового субагента</b>",
+    "agent.listTitle": "📋 <b>ИИ смотрит список субагентов</b>",
+    "agent.readTitle": "🔍 <b>ИИ читает описание субагента</b>",
+    "agent.name": "Агент",
+    "agent.task": "Задача",
+    "agent.tools": "Инструменты",
+    "agent.maxTurns": "Лимит шагов",
+    "agent.noTools": "все разрешены",
+    "agent.noLimit": "без лимита",
+    "agent.noResult": "(пустой результат)",
+    "agent.failed": "❌ <b>Субагент завершился с ошибкой</b>",
+    "agent.created": "Агент создан",
+    "agent.existing": "Агент обновлён",
+    "agent.prompt": "Системный промпт",
+    "agents.cmd.title": "🤖 <b>Субагенты проекта</b>",
+    "agents.cmd.empty":
+      "🤖 <b>Субагентов нет</b>\n\nДобавьте .md-файл в cookie/agents/ или попросите AI: «Создай агента для …».",
+    "agents.cmd.noProject":
+      "📂 <b>Проект не выбран</b>\n\nСначала выберите проект в главном окне — субагенты привязаны к проекту.",
+    "agents.cmd.header": "🤖 <b>Субагенты проекта</b> — {n} шт.",
+    "agents.cmd.itemTools": "🧰 Инструменты",
+    "agents.cmd.itemTurns": "🔁 Шагов",
+    "agents.cmd.itemSource": "📍 Источник",
+    "agents.cmd.itemNoTools": "все разрешены",
+    "agents.cmd.itemNoLimit": "без лимита",
+    "agents.cmd.hint":
+      '💡 Делегируйте задачу: <code>run_agent("name", "задача")</code>',
+    "agents.cmd.more": "…и ещё {n}",
+
     // ===== Approval =====
     "approval.title": "🔐 <b>Подтверждение команды</b>",
     "approval.jsScript": "JS-скрипт",
@@ -338,6 +387,7 @@ const STRINGS = {
     "help.cmd.show": "/show &lt;hash&gt; — commit diff",
     "help.cmd.files": "/files &lt;hash&gt; — commit files",
     "help.cmd.todos": "/todos       — tasks of the active window",
+    "help.cmd.agents": "/agents      — project subagents list",
     "help.cmd.screen": "/screen      — screenshot of the active window",
     "help.cmd.cancel": "/cancel      — cancel input / approval",
     "help.cmd.help": "/help        — this help",
@@ -545,6 +595,54 @@ const STRINGS = {
     "tool.items": " item(s)",
     "tool.allDone": "🎉 <b>All tasks completed</b> ({n}/{n})",
 
+    // ===== Memory (memory_save/read/clear) =====
+    "mem.readTitle": "🧠 <b>AI reads memory</b>",
+    "mem.saveTitle": "🧠 <b>AI saves to memory</b>",
+    "mem.clearTitle": "🧠 <b>AI clears memory</b>",
+    "mem.readEmpty": "🧠 <b>Memory is empty</b>",
+    "mem.saved": "Saved:",
+    "mem.cleared": "🗑 Memory cleared",
+    "mem.content": "Memory content:",
+    "mem.count": "entries: {n}",
+
+    // ===== Time/location (city_time) =====
+    "city.title": "🕒 <b>Time & location</b>",
+    "city.time": "Time",
+    "city.tz": "Timezone",
+    "city.place": "City / country",
+
+    // ===== Subagents (run_agent / create_agent / list_agents / read_agent) =====
+    "agent.runTitle": "🚀 <b>AI delegates a task to a subagent</b>",
+    "agent.resultTitle": "🎯 <b>Subagent returned a result</b>",
+    "agent.createTitle": "🧬 <b>AI creates a new subagent</b>",
+    "agent.listTitle": "📋 <b>AI views the subagent list</b>",
+    "agent.readTitle": "🔍 <b>AI reads subagent details</b>",
+    "agent.name": "Agent",
+    "agent.task": "Task",
+    "agent.tools": "Tools",
+    "agent.maxTurns": "Max turns",
+    "agent.noTools": "all allowed",
+    "agent.noLimit": "no limit",
+    "agent.noResult": "(empty result)",
+    "agent.failed": "❌ <b>Subagent failed</b>",
+    "agent.created": "Agent created",
+    "agent.existing": "Agent updated",
+    "agent.prompt": "System prompt",
+    "agents.cmd.title": "🤖 <b>Project subagents</b>",
+    "agents.cmd.empty":
+      '🤖 <b>No subagents</b>\n\nAdd a .md file to cookie/agents/ or ask the AI: "Create an agent for …".',
+    "agents.cmd.noProject":
+      "📂 <b>No project selected</b>\n\nPick a project in the main window first — subagents are project-scoped.",
+    "agents.cmd.header": "🤖 <b>Project subagents</b> — {n} total",
+    "agents.cmd.itemTools": "🧰 Tools",
+    "agents.cmd.itemTurns": "🔁 Steps",
+    "agents.cmd.itemSource": "📍 Source",
+    "agents.cmd.itemNoTools": "all allowed",
+    "agents.cmd.itemNoLimit": "no limit",
+    "agents.cmd.hint":
+      '💡 Delegate a task: <code>run_agent("name", "task")</code>',
+    "agents.cmd.more": "…and {n} more",
+
     // ===== Approval =====
     "approval.title": "🔐 <b>Command approval</b>",
     "approval.jsScript": "JS script",
diff --git a/botsrc/index.js b/botsrc/index.js
index d941277..f3d71a7 100644
--- a/botsrc/index.js
+++ b/botsrc/index.js
@@ -124,7 +124,12 @@ function _log(level, ...args) {
  */
 async function _sendToChat(text) {
   try {
-    const win = windowState.getMainWindow();
+    // ВАЖНО: шлём в родительское (не-субагентское) окно. Если открыто
+    // окно субагента, оно могло стать «активным» — но команды пользователя
+    // из TG всегда должны попадать в главный чат.
+    const win = windowState.getParentWindow
+      ? windowState.getParentWindow()
+      : windowState.getMainWindow();
     if (!win || win.isDestroyed())
       return { success: false, error: "нет активного окна" };
 
@@ -165,9 +170,11 @@ async function _sendToChat(text) {
   }
 }
 
-/** Выполнить JS в активном окне и вернуть результат. */
+/** Выполнить JS в родительском (не-субагентском) окне. */
 async function _evalInWindow(script) {
-  const win = windowState.getMainWindow();
+  const win = windowState.getParentWindow
+    ? windowState.getParentWindow()
+    : windowState.getMainWindow();
   if (!win || win.isDestroyed())
     return { success: false, error: "нет активного окна" };
   try {
@@ -178,10 +185,12 @@ async function _evalInWindow(script) {
   }
 }
 
-/** Получить контекст активного окна (профиль/сессия/projectDir). */
+/** Получить контекст родительского (не-субагентского) окна. */
 function _activeContext() {
   try {
-    const win = windowState.getMainWindow();
+    const win = windowState.getParentWindow
+      ? windowState.getParentWindow()
+      : windowState.getMainWindow();
     if (win && !win.isDestroyed() && win.webContents) {
       return windowState.getContextByWebContents(win.webContents);
     }
@@ -189,10 +198,12 @@ function _activeContext() {
   return null;
 }
 
-/** Получить id активного окна (для доступа к его todo-списку). */
+/** Получить id родительского (не-субагентского) окна (для todo-списка). */
 function _activeSenderId() {
   try {
-    const win = windowState.getMainWindow();
+    const win = windowState.getParentWindow
+      ? windowState.getParentWindow()
+      : windowState.getMainWindow();
     if (win && !win.isDestroyed() && win.webContents) return win.webContents.id;
   } catch (_) {}
   return null;
@@ -1473,7 +1484,9 @@ async function _handleSettingsCallback(data, cbq) {
 async function _cmdStop() {
   let count = 0;
   try {
-    const win = windowState.getMainWindow();
+    const win = windowState.getParentWindow
+      ? windowState.getParentWindow()
+      : windowState.getMainWindow();
     if (
       win &&
       !win.isDestroyed() &&
@@ -1506,7 +1519,9 @@ async function _cmdScreen() {
   if (!cfg.enabled || !cfg.token || !cfg.chatId)
     return { success: false, skipped: true };
 
-  const win = windowState.getMainWindow();
+  const win = windowState.getParentWindow
+    ? windowState.getParentWindow()
+    : windowState.getMainWindow();
   if (!win || win.isDestroyed()) {
     await telegramBot.sendMessage(_t("screen.noWindow"));
     return { success: false, error: "noWindow" };
@@ -1546,7 +1561,9 @@ async function _cmdStatus() {
   } catch (_) {}
   lines.push(_t("status.version", { v: escapeHtml(version) }));
 
-  const win = windowState.getMainWindow();
+  const win = windowState.getParentWindow
+    ? windowState.getParentWindow()
+    : windowState.getMainWindow();
   const winOk = !!(win && !win.isDestroyed());
   lines.push(
     _t("status.window") +
@@ -1614,7 +1631,9 @@ async function _cmdStatus() {
 async function _cmdNew() {
   const win = (() => {
     try {
-      return windowState.getMainWindow();
+      return windowState.getParentWindow
+        ? windowState.getParentWindow()
+        : windowState.getMainWindow();
     } catch (_) {
       return null;
     }
@@ -1761,6 +1780,73 @@ async function _cmdTodos(chatId, page) {
   });
 }
 
+/** /agents — список субагентов проекта (из cookie/agents/*.md). */
+async function _cmdAgents() {
+  let agents = [];
+  let projectDir = null;
+  try {
+    projectDir = _projectDir();
+    if (projectDir) {
+      const { scanAgents } = require("../src/main/agents");
+      agents = scanAgents(projectDir);
+    }
+  } catch (err) {
+    _log("error", "/agents error:", err.message);
+  }
+
+  // Проект не выбран — подсказываем.
+  if (!projectDir) {
+    return telegramBot.sendMessage(_t("agents.cmd.noProject"), {
+      parseMode: "HTML",
+    });
+  }
+
+  // Проект есть, но агентов нет.
+  if (!Array.isArray(agents) || agents.length === 0) {
+    return telegramBot.sendMessage(_t("agents.cmd.empty"), {
+      parseMode: "HTML",
+    });
+  }
+
+  const lines = [];
+  lines.push(_t("agents.cmd.header", { n: agents.length }));
+  lines.push("");
+
+  const MAX = 15; // ограничим вывод, чтобы не улететь за лимит TG
+  const shown = agents.slice(0, MAX);
+  for (let i = 0; i < shown.length; i++) {
+    const a = shown[i];
+    const tools =
+      a.tools && a.tools.length
+        ? a.tools.map((x) => "<code>" + escapeHtml(x) + "</code>").join(", ")
+        : "<i>" + escapeHtml(_t("agents.cmd.itemNoTools")) + "</i>";
+    const turns = a.maxTurns
+      ? escapeHtml(String(a.maxTurns))
+      : "<i>" + escapeHtml(_t("agents.cmd.itemNoLimit")) + "</i>";
+    const sourceEmoji = a.source === "project" ? "📦" : "🏠";
+    lines.push(
+      "<b>" + (i + 1) + ". " + escapeHtml(a.name) + "</b> " + sourceEmoji,
+    );
+    if (a.description) {
+      lines.push(escapeHtml(a.description));
+    }
+    lines.push("   " + escapeHtml(_t("agents.cmd.itemTools")) + ": " + tools);
+    lines.push("   " + escapeHtml(_t("agents.cmd.itemTurns")) + ": " + turns);
+    lines.push("");
+  }
+  if (agents.length > MAX) {
+    lines.push(
+      "<i>" +
+        escapeHtml(_t("agents.cmd.more", { n: agents.length - MAX })) +
+        "</i>",
+    );
+    lines.push("");
+  }
+  lines.push(_t("agents.cmd.hint"));
+
+  return telegramBot.sendMessage(lines.join("\n"), { parseMode: "HTML" });
+}
+
 /** Текущий projectDir активного окна. */
 function _projectDir() {
   const ctx = _activeContext();
@@ -1887,7 +1973,9 @@ function _projectKeyboard() {
 async function _setProject(chatId, dir) {
   const win = (() => {
     try {
-      return windowState.getMainWindow();
+      return windowState.getParentWindow
+        ? windowState.getParentWindow()
+        : windowState.getMainWindow();
     } catch (_) {
       return null;
     }
@@ -2210,6 +2298,7 @@ async function _cmdHelp() {
     _t("help.cmd.show"),
     _t("help.cmd.files"),
     _t("help.cmd.todos"),
+    _t("help.cmd.agents"),
     _t("help.cmd.screen"),
     _t("help.cmd.cancel"),
     _t("help.cmd.help"),
@@ -2350,7 +2439,9 @@ async function _sendInWindow(win) {
 async function _insertImageToWindow(absPath, caption, send) {
   try {
     const { clipboard, nativeImage } = require("electron");
-    const win = windowState.getMainWindow();
+    const win = windowState.getParentWindow
+      ? windowState.getParentWindow()
+      : windowState.getMainWindow();
     if (!win || win.isDestroyed())
       return { success: false, error: _t("common.noWindow") };
     const img = nativeImage.createFromPath(absPath);
@@ -2402,7 +2493,9 @@ async function _attachFileToWindow(absPath, caption, send) {
       UPLOAD_TIMEOUT_MS,
       MAX_FILE_SIZE,
     } = require("../tools/AttachFileTool");
-    const win = windowState.getMainWindow();
+    const win = windowState.getParentWindow
+      ? windowState.getParentWindow()
+      : windowState.getMainWindow();
     if (!win || win.isDestroyed())
       return { success: false, error: _t("common.noWindow") };
     const stat = fs.statSync(absPath);
@@ -2698,6 +2791,11 @@ async function _handleIncoming(chatId, text, msg) {
     await _cmdScreen();
     return;
   }
+  // Команда /agents — список субагентов проекта.
+  if (cmd === "/agents" || cmd === "/agent") {
+    await _cmdAgents();
+    return;
+  }
 
   // ---- Ожидание ввода значения настройки ----
   if (_settingsWaiting.has(chatId)) {
@@ -2772,7 +2870,7 @@ function formatToolArgs(toolName, args) {
       const old = a.old_string != null ? String(a.old_string) : "";
       let s = "";
       if (file) s += "📄 " + file + "\n";
-      
+
       // Построчный diff вместо двух больших блоков.
       if (old || neu) {
         try {
@@ -2780,14 +2878,14 @@ function formatToolArgs(toolName, args) {
           const rows = buildLineDiff(old, neu);
           const MAX_LINES = 30; // показываем до 30 строк diff
           const slice = rows.slice(0, MAX_LINES);
-          const lines = slice.map(r => {
-            if (r.type === 'added') return '+ ' + r.text;
-            if (r.type === 'removed') return '- ' + r.text;
-            return '  ' + r.text;
+          const lines = slice.map((r) => {
+            if (r.type === "added") return "+ " + r.text;
+            if (r.type === "removed") return "- " + r.text;
+            return "  " + r.text;
           });
-          s += lines.join('\n');
+          s += lines.join("\n");
           if (rows.length > MAX_LINES) {
-            s += '\n' + _t("tool.truncatedTotal", { n: rows.length });
+            s += "\n" + _t("tool.truncatedTotal", { n: rows.length });
           }
         } catch (err) {
           // Fallback на старый формат при ошибке.
@@ -2970,10 +3068,19 @@ function _techFlush() {
   if (!b) return null;
 
   const suffix = b.count > 1 ? " (×" + b.count + ")" : "";
-  // Заголовок: «🔧 Editing path (×N)» либо «💻 terminal (×N)» без детали.
-  const header = b.command
+  // Заголовок: «🤖 Агент: explore // 🔧 Editing path (×N)» — если из субагента.
+  // Иначе просто «🔧 Editing path (×N)».
+  const body_line = b.command
     ? b.emoji + " " + b.label + suffix
     : b.emoji + " " + b.label + " " + _techTrunc(b.detail) + suffix;
+  const agentLine = b.agentName
+    ? "🤖 " +
+      escapeHtml(_t("agent.name")) +
+      ": <b>" +
+      escapeHtml(b.agentName) +
+      "</b>\n"
+    : "";
+  const header = agentLine + body_line;
 
   // Тело: 1) команда/путь, 2) результат — каждый блок своей цитатой.
   let msg = header;
@@ -3015,11 +3122,24 @@ const TECH_SERVICE_TOOLS = new Set([
   "exitplanmode",
 ]);
 
+// Агентские инструменты: имеют собственное оформление (см. _render*Agent),
+// в общий батч «🔧 tool ×N» не идут, но уведомления им нужны.
+const AGENT_TOOLS = new Set([
+  "run_agent",
+  "runagent",
+  "create_agent",
+  "createagent",
+  "list_agents",
+  "listagents",
+  "read_agent",
+  "readagent",
+]);
+
 /**
  * Поставить уведомление в батч: если пришло такое же действие в течение
  * TECH_BATCH_MS — увеличиваем счётчик (×N), иначе шлём предыдущее и начинаем новое.
  */
-function _techQueue(toolName, args, preview) {
+function _techQueue(toolName, args, preview, agentName) {
   const icon = _techIcon(toolName);
   const detail = _techDetail(toolName, args);
   const name = String(toolName || "").toLowerCase();
@@ -3028,13 +3148,15 @@ function _techQueue(toolName, args, preview) {
       ? String((args && args.command) || "")
       : "";
   const result = String(preview || "");
+  const agent = agentName ? String(agentName).trim() : null;
 
   if (
     _techBatch &&
     _techBatch.emoji === icon.emoji &&
     _techBatch.label === icon.label &&
     _techBatch.detail === detail &&
-    _techBatch.command === command
+    _techBatch.command === command &&
+    _techBatch.agentName === agent
   ) {
     _techBatch.count++;
     // Результат последнего вызова в серии — показываем его.
@@ -3049,6 +3171,7 @@ function _techQueue(toolName, args, preview) {
       preview: result,
       args,
       count: 1,
+      agentName: agent,
     };
     if (prev) _techFlush();
     if (_techBatchTimer) clearTimeout(_techBatchTimer);
@@ -3060,25 +3183,419 @@ function _techQueue(toolName, args, preview) {
   return null;
 }
 
+// ==================== Спец-оформление для memory/city_time ====================
+//
+// Память и время/локация получают собственный «человеческий» формат вместо
+// общего 🔧 <label> <path>. Сообщение отправляется сразу (без батчинга).
+
+/**
+ * Красивое сообщение для memory_save / memory_read / memory_clear.
+ * @returns {string|null}  HTML-сообщение или null, если не наш инструмент
+ */
+function _renderMemory(toolName, ok, args, preview) {
+  const name = String(toolName || "").toLowerCase();
+  if (
+    name !== "memory_save" &&
+    name !== "memory_read" &&
+    name !== "memory_clear"
+  ) {
+    return null;
+  }
+  if (!ok) return null; // ошибки уходят общим путём
+
+  const body = _stripResultWrapper(String(preview || "")).trim();
+
+  if (name === "memory_clear") {
+    return _t("mem.clearTitle") + "\n\n" + escapeHtml(_t("mem.cleared"));
+  }
+
+  if (name === "memory_save") {
+    // Результат: "Сохранено в память: - [дата] текст" — берём часть после ":".
+    const idx = body.indexOf(":");
+    const entry = (idx >= 0 ? body.slice(idx + 1) : body).trim();
+    // Дополнительно: сам текст из args.text, если в body пусто.
+    const text = entry || String((args && args.text) || "").trim();
+    return (
+      _t("mem.saveTitle") +
+      "\n\n<b>" +
+      escapeHtml(_t("mem.saved")) +
+      "</b>\n<blockquote expandable>" +
+      escapeHtml(text) +
+      "</blockquote>"
+    );
+  }
+
+  // memory_read — сам файл памяти.
+  const isEmpty =
+    !body ||
+    body === "(память пуста)" ||
+    (/^#\s*Память Cookie Code\s*$/m.test(body) && !/^-\s*\[/m.test(body));
+  if (isEmpty) {
+    return _t("mem.readEmpty");
+  }
+  // Отрезаем служебный заголовок файла (# Память... + пояснение + пустая строка),
+  // оставляя только строки-записи "- [...] ...".
+  const lines = body.split(/\r?\n/);
+  const entries = lines.filter((l) => /^-\s*\[/.test(l));
+  const shown = entries.length > 0 ? entries.join("\n") : body;
+  return (
+    _t("mem.readTitle") +
+    "\n\n<b>" +
+    escapeHtml(_t("mem.content")) +
+    "</b>\n<blockquote expandable>" +
+    escapeHtml(_techTruncLong(shown)) +
+    "</blockquote>\n<i>" +
+    escapeHtml(_t("mem.count", { n: entries.length })) +
+    "</i>"
+  );
+}
+
+/**
+ * Красивое сообщение для city_time: переоформляем "ключ: значение" в блоки.
+ * @returns {string|null}
+ */
+function _renderCityTime(toolName, ok, args, preview) {
+  const name = String(toolName || "").toLowerCase();
+  if (name !== "city_time" && name !== "citytime") return null;
+  if (!ok) return null;
+
+  const body = String(preview || "").trim();
+  if (!body) return _t("city.title");
+
+  // Ожидаемый формат:
+  //   时间: <human> (<iso>)
+  //   时区: <tz>
+  //   城市 / 国家: <place>   (может быть "未确定")
+  const pick = (label) => {
+    const re = new RegExp("^" + label + "\\s*:\\s*(.+)$", "m");
+    const m = body.match(re);
+    return m ? m[1].trim() : "";
+  };
+  const time = pick("时间") || pick("Время") || pick("Time");
+  const tz = pick("时区") || pick("Timezone");
+  const place =
+    pick("城市 / 国家") || pick("Город / страна") || pick("City / country");
+
+  const rows = [];
+  if (time)
+    rows.push(
+      "⏰ " + escapeHtml(_t("city.time")) + ": <b>" + escapeHtml(time) + "</b>",
+    );
+  if (tz)
+    rows.push(
+      "🌍 " +
+        escapeHtml(_t("city.tz")) +
+        ": <code>" +
+        escapeHtml(tz) +
+        "</code>",
+    );
+  if (place)
+    rows.push("📍 " + escapeHtml(_t("city.place")) + ": " + escapeHtml(place));
+
+  if (rows.length === 0) {
+    // Не распознали — отдаём как есть, но в цитате.
+    return (
+      _t("city.title") +
+      "\n\n<blockquote expandable>" +
+      escapeHtml(body) +
+      "</blockquote>"
+    );
+  }
+  return _t("city.title") + "\n\n" + rows.join("\n");
+}
+
+/**
+ * Красивое сообщение для run_agent: карточка с именем агента и задачей.
+ * Вызывается из notifyToolResult при старте (args) — а результат агента
+ * отдельным сообщением ловит `agent_result` (через notifyAgentResult).
+ * @returns {string|null}  HTML-сообщение или null, если не наш инструмент
+ */
+function _renderRunAgent(toolName, ok, args, preview) {
+  const name = String(toolName || "").toLowerCase();
+  if (name !== "run_agent" && name !== "runagent") return null;
+
+  const a = args && typeof args === "object" ? args : {};
+  const agentName = String(a.name || a.agent || "").trim();
+  const task = String(a.task || "").trim();
+
+  if (!agentName) return null;
+
+  const lines = [];
+  lines.push(_t("agent.runTitle"));
+  lines.push("");
+  lines.push(
+    "🤖 " +
+      escapeHtml(_t("agent.name")) +
+      ": <b>" +
+      escapeHtml(agentName) +
+      "</b>",
+  );
+  if (task) {
+    lines.push(
+      "📌 " +
+        escapeHtml(_t("agent.task")) +
+        ":\n<blockquote expandable>" +
+        escapeHtml(_techTruncLong(task, 700)) +
+        "</blockquote>",
+    );
+  }
+  if (!ok) {
+    // Ошибка запуска (агент не найден, context lost и т.п.)
+    // _t() уже возвращает HTML — не экранируем.
+    lines.push("");
+    lines.push(_t("agent.failed"));
+    if (preview) {
+      lines.push(
+        "<blockquote expandable>" +
+          escapeHtml(_techTrunc(String(preview), 400)) +
+          "</blockquote>",
+      );
+    }
+  }
+  return lines.join("\n");
+}
+
+/**
+ * Красивое сообщение для create_agent: карточка нового агента (имя, tools, лимит).
+ * Результат содержит путь к файлу и подсказку «теперь можно вызвать».
+ * @returns {string|null}
+ */
+function _renderCreateAgent(toolName, ok, args, preview) {
+  const name = String(toolName || "").toLowerCase();
+  if (name !== "create_agent" && name !== "createagent") return null;
+  if (!ok) return null;
+
+  const a = args && typeof args === "object" ? args : {};
+  const agentName = String(a.name || "").trim();
+  const description = String(a.description || "").trim();
+  const tools = Array.isArray(a.tools) ? a.tools.filter(Boolean) : [];
+  const maxTurns = a.maxTurns;
+  const overwrite = a.overwrite === true;
+
+  const lines = [];
+  lines.push(_t("agent.createTitle"));
+  lines.push("");
+  lines.push(
+    "🤖 " +
+      escapeHtml(_t("agent.name")) +
+      ": <b>" +
+      escapeHtml(agentName) +
+      "</b>",
+  );
+  if (description) {
+    lines.push("📝 " + escapeHtml(description));
+  }
+  lines.push(
+    "🧰 " +
+      escapeHtml(_t("agent.tools")) +
+      ": " +
+      (tools.length > 0
+        ? tools.map((x) => "<code>" + escapeHtml(x) + "</code>").join(", ")
+        : "<i>" + escapeHtml(_t("agent.noTools")) + "</i>"),
+  );
+  lines.push(
+    "🔁 " +
+      escapeHtml(_t("agent.maxTurns")) +
+      ": <code>" +
+      (maxTurns
+        ? escapeHtml(String(maxTurns))
+        : escapeHtml(_t("agent.noLimit"))) +
+      "</code>",
+  );
+  lines.push("");
+  lines.push(
+    "<i>" +
+      escapeHtml(overwrite ? _t("agent.existing") : _t("agent.created")) +
+      "</i>",
+  );
+  return lines.join("\n");
+}
+
+/**
+ * Красивое сообщение для list_agents: сам список приходит в preview.
+ * @returns {string|null}
+ */
+function _renderListAgents(toolName, ok, args, preview) {
+  const name = String(toolName || "").toLowerCase();
+  if (name !== "list_agents" && name !== "listagents") return null;
+  if (!ok) return null;
+  const body = _stripResultWrapper(String(preview || "")).trim();
+  if (!body) return _t("agent.listTitle") + "\n\n<i>(пусто)</i>";
+  return (
+    _t("agent.listTitle") +
+    "\n\n<blockquote expandable>" +
+    escapeHtml(_techTruncLong(body, 3000)) +
+    "</blockquote>"
+  );
+}
+
+/**
+ * Красивое сообщение для read_agent: имя агента + его systemPrompt.
+ * @returns {string|null}
+ */
+function _renderReadAgent(toolName, ok, args, preview) {
+  const name = String(toolName || "").toLowerCase();
+  if (name !== "read_agent" && name !== "readagent") return null;
+  if (!ok) return null;
+  const a = args && typeof args === "object" ? args : {};
+  const agentName = String(a.name || "").trim();
+  const body = _stripResultWrapper(String(preview || "")).trim();
+  const lines = [];
+  lines.push(_t("agent.readTitle"));
+  if (agentName) {
+    lines.push("");
+    lines.push(
+      "🤖 " +
+        escapeHtml(_t("agent.name")) +
+        ": <b>" +
+        escapeHtml(agentName) +
+        "</b>",
+    );
+  }
+  if (body) {
+    lines.push(
+      "\n<blockquote expandable>" +
+        escapeHtml(_techTruncLong(body, 3000)) +
+        "</blockquote>",
+    );
+  }
+  return lines.join("\n");
+}
+
+/** Обрезка длинного текста для спец-сообщений (мягкий лимит 3500 симв.). */
+function _techTruncLong(s, max) {
+  const limit = max || 3500;
+  const str = String(s == null ? "" : s);
+  if (str.length <= limit) return str;
+  return str.slice(0, limit) + "\n…(обрезано)";
+}
+
+/**
+ * Уведомление о СТАРТЕ делегирования субагенту.
+ * Вызывается раннером (index.js) ДО открытия дочернего окна, чтобы
+ * пользователь в TG сразу видел карточку «делегирую задачу».
+ * @param {string} agentName
+ * @param {string} task
+ */
+async function notifyAgentStarted(agentName, task) {
+  try {
+    const cfg = _read();
+    if (!cfg.enabled || !cfg.notifyTools)
+      return { success: false, skipped: true };
+    const lines = [];
+    lines.push(_t("agent.runTitle"));
+    lines.push("");
+    lines.push(
+      "🤖 " +
+        escapeHtml(_t("agent.name")) +
+        ": <b>" +
+        escapeHtml(agentName || "agent") +
+        "</b>",
+    );
+    if (task) {
+      lines.push(
+        "📌 " +
+          escapeHtml(_t("agent.task")) +
+          ":\n<blockquote expandable>" +
+          escapeHtml(_techTruncLong(task, 700)) +
+          "</blockquote>",
+      );
+    }
+    return await telegramBot.sendMessage(lines.join("\n"), {
+      parseMode: "HTML",
+    });
+  } catch (err) {
+    console.error("[bot] notifyAgentStarted failed:", err.message);
+    return { success: false, error: err.message };
+  }
+}
+
 /** Уведомление о результате tool (компактный стиль «Tech»). */
 async function notifyToolResult(toolName, ok, detail) {
   const cfg = _read();
   if (!cfg.enabled || !cfg.notifyTools)
     return { success: false, skipped: true };
+  const _toolLower = String(toolName || "").toLowerCase();
   // Служебные вызовы (вопрос к пользователю и т.п.) в уведомления не шлём —
   // у них есть собственное сообщение.
-  const _toolLower = String(toolName || "").toLowerCase();
   if (TECH_SERVICE_TOOLS.has(_toolLower)) {
     return { success: false, skipped: true };
   }
+
+  const args = detail && typeof detail === "object" ? detail.args : null;
+  const preview =
+    detail && typeof detail === "object" ? detail.preview : detail;
+
+  // ===== Агентские инструменты: собственная карточка, минуя batch/notifyIgnore =====
+  if (AGENT_TOOLS.has(_toolLower)) {
+    try {
+      const isRunAgent =
+        _toolLower === "run_agent" || _toolLower === "runagent";
+
+      if (isRunAgent) {
+        // Карточка запуска уже отправлена раннером (notifyAgentStarted).
+        // Здесь шлём ТОЛЬКО результат (или ошибку субагента).
+        if (ok && preview) {
+          const body = _stripResultWrapper(String(preview || "")).trim();
+          if (body) {
+            const shown =
+              body.length > 3500 ? body.slice(0, 3500) + "\n…(обрезано)" : body;
+            const resultMsg =
+              _t("agent.resultTitle") +
+              "\n\n<blockquote expandable>" +
+              escapeHtml(shown) +
+              "</blockquote>";
+            await telegramBot.sendMessage(resultMsg, { parseMode: "HTML" });
+          }
+        } else if (!ok && preview) {
+          const errMsg =
+            _t("agent.failed") +
+            "\n\n<blockquote expandable>" +
+            escapeHtml(_techTrunc(String(preview), 800)) +
+            "</blockquote>";
+          await telegramBot.sendMessage(errMsg, { parseMode: "HTML" });
+        }
+        return { success: true, special: true };
+      }
+
+      const createMsg = _renderCreateAgent(toolName, ok, args, preview);
+      const listMsg = createMsg
+        ? null
+        : _renderListAgents(toolName, ok, args, preview);
+      const readMsg =
+        createMsg || listMsg
+          ? null
+          : _renderReadAgent(toolName, ok, args, preview);
+      const special = createMsg || listMsg || readMsg;
+      if (special) {
+        await telegramBot.sendMessage(special, { parseMode: "HTML" });
+        return { success: true, special: true };
+      }
+    } catch (err) {
+      console.error("[bot] agent render failed:", err.message);
+    }
+  }
+
   // Умные уведомления: пропускаем инструменты из списка исключений.
   if (cfg.notifyIgnore.length > 0 && cfg.notifyIgnore.includes(_toolLower)) {
     return { success: false, skipped: true };
   }
 
-  const args = detail && typeof detail === "object" ? detail.args : null;
-  const preview =
-    detail && typeof detail === "object" ? detail.preview : detail;
+  // Спец-оформление: память и время/локация — своими красивыми сообщениями,
+  // без общего стиля «🔧 label path» и без батчинга.
+  if (ok) {
+    let special = null;
+    try {
+      special = _renderMemory(toolName, ok, args, preview);
+      if (!special) special = _renderCityTime(toolName, ok, args, preview);
+    } catch (err) {
+      console.error("[bot] special render failed:", err.message);
+      special = null;
+    }
+    if (special) {
+      return telegramBot.sendMessage(special, { parseMode: "HTML" });
+    }
+  }
 
   // Ошибка — шлём сразу, отдельным сообщением, с обрезанным текстом ошибки.
   if (!ok) {
@@ -3096,7 +3613,10 @@ async function notifyToolResult(toolName, ok, detail) {
   }
 
   // Успех — в батч (одинаковые подряд схлопываются в ×N).
-  _techQueue(toolName, args, preview);
+  // Если вызов из субагента — в заголовок попадёт «🤖 Агент: <имя>».
+  const agentName =
+    detail && typeof detail === "object" ? detail.agentName || null : null;
+  _techQueue(toolName, args, preview, agentName);
   return { success: true, batched: true };
 }
 
@@ -3163,6 +3683,7 @@ async function _registerCommands() {
       switch: "переключить сессию",
       diagnostics: "диагностика",
       todos: "список задач",
+      agents: "субагенты проекта",
       screen: "скриншот окна",
       cancel: "отменить ввод",
     },
@@ -3181,6 +3702,7 @@ async function _registerCommands() {
       switch: "switch session",
       diagnostics: "diagnostics",
       todos: "todo list",
+      agents: "project subagents",
       screen: "window screenshot",
       cancel: "cancel",
     },
@@ -3261,6 +3783,7 @@ module.exports = {
   ping,
   testSend,
   notifyToolResult,
+  notifyAgentStarted,
   notifyAIResponse,
   startTyping,
   stopTyping,
diff --git a/cookie/agents/changelog-writer.md b/cookie/agents/changelog-writer.md
new file mode 100644
index 0000000..06fd33c
--- /dev/null
+++ b/cookie/agents/changelog-writer.md
@@ -0,0 +1,233 @@
+---
+name: changelog-writer
+description: Ведёт CHANGELOG.md по правилам проекта. Добавляет записи о новых версиях. Использовать когда нужно задокументировать изменения перед релизом.
+tools: read, readLines, edit, write, glob, grep, bash
+maxTurns: 25
+---
+
+Ты — релиз-инженер, отвечающий за `CHANGELOG.md` и `CHANGELOG_GUIDE.md`.
+Твоя задача — превратить набор изменений в правильно оформленную запись,
+которую корректно распарсит `src/main/changelog-parser.js` и покажет в What's New.
+
+## Первым делом
+
+**Прочитай `CHANGELOG_GUIDE.md`** — там описан точный формат, который понимает парсер.
+Правила в гайде — истина в последней инстанции.
+
+Затем прочитай текущий `CHANGELOG.md` (первые 40 строк), чтобы:
+
+- понять стиль проекта (русский, эмодзи, жирные заголовки);
+- узнать последнюю версию в файле (она скоро будет заменена);
+- посмотреть, как выглядели прошлые записи — но **в новом файле их не будет**.
+
+## Ключевое правило: версия = последний git-тег + 1 в patch
+
+**В этом проекте после каждого push автоматически бампается PATCH-версия на +1.**
+Major и minor задаются вручную только при крупных релизах. Твоя задача —
+просто увеличить последнее число.
+
+Примеры:
+
+- последний тег `v5.0.1` → новая версия `5.0.2`
+- последний тег `v5.0.9` → новая версия `5.0.10`
+- последний тег `v5.1.3` → новая версия `5.1.4`
+
+### Как узнать базу
+
+```cuckoo
+// 1. Последний git-тег — единственный источник истины о версии
+const latestTag = await bash("git describe --tags --abbrev=0");
+log("latest tag: " + latestTag);
+
+// 2. Все теги (для проверки, если latestTag странный)
+const tags = await bash("git tag --sort=-v:refname");
+log(tags);
+
+// 3. Коммиты, ещё не попавшие в релиз
+const pending = await bash("git log " + latestTag + "..HEAD --oneline");
+log("commits since tag: " + pending);
+```
+
+### Алгоритм
+
+1. **База** = последний git-тег. Пример: `v5.0.1` → `5.0.1`.
+2. **Версия** = база + 1 в patch. Пример: `5.0.1` → `5.0.2`.
+3. **CHANGELOG.md НЕ является источником версии.** Даже если в файле запись новее последнего git-тега (например, файл `[5.1.0]`, а тег `v5.0.1`) — **игнорируй файл** и всё равно считай от тега: `5.0.1 → 5.0.2`. Мы перезаписываем CHANGELOG целиком, поэтому прошлое содержимое не имеет значения. **Единственный источник истины — git-тег.**
+4. **Проверка дубликата:** если в CHANGELOG уже есть запись для выбранной версии — **не перезаписывай**. Возьми следующую по semver.
+5. **Соответствие тега:** версия X.Y.Z → будущий git-тег `vX.Y.Z`. Укажи в отчёте.
+
+**Исключения (редко):**
+
+- Если пользователь **явно просит** minor/major (`«сделай minor-релиз»`, `«breaking change — это v6»`) — используй его указание.
+- Если коммит содержит `feat!` или `BREAKING CHANGE:` — в отчёте **упомяни** это как замечание, но **всё равно поставь patch+1**. Major делается отдельно и вручную.
+
+**НЕ останавливайся и НЕ спрашивай, если:**
+
+- в CHANGELOG есть версия новее последнего тега (мы перезаписываем файл);
+- `git describe` вернул старый тег (используй `git tag --sort=-v:refname` и бери максимум);
+- набор изменений «выглядит как minor» — правило patch+1 всё равно важнее, если пользователь не сказал иного.
+
+## Дата — строго из системы
+
+**Не выдумывай дату.** Возьми её из системы:
+
+```cuckoo
+const d = await cityTime();
+log(d);
+```
+
+Формат даты — ISO: `YYYY-MM-DD`. Только она идёт в заголовок `## [X.Y.Z] - YYYY-MM-DD`.
+
+**Никогда:**
+
+- не ставь дату из прошлого релиза;
+- не округляй месяц/день;
+- если `cityTime()` вернул нестандартный формат — приведи вручную к `YYYY-MM-DD`.
+
+## Разведка изменений
+
+Узнай, что изменилось с последнего релиза:
+
+```cuckoo
+const latestTag = await bash("git describe --tags --abbrev=0");
+const log1 = await bash("git log " + latestTag + "..HEAD --oneline");
+log(log1);
+const diff = await bash("git diff --stat " + latestTag + "..HEAD");
+log(diff);
+```
+
+Собери из истории коммитов понимание: какие фичи, фиксы, рефакторинг.
+
+## Составь запись
+
+Строго по шаблону из гайда:
+
+```markdown
+## [X.Y.Z] - YYYY-MM-DD
+
+### Added
+
+- **Краткое название фичи** — что и зачем. Детали:
+  - подпункт;
+  - ещё подпункт.
+
+### Changed
+
+- **Что изменилось** — было → стало. Причины.
+
+### Fixed
+
+- Что было сломано и как починили.
+
+### Removed
+
+- Что удалили и почему.
+```
+
+**Правила оформления:**
+
+- Секции `###` (три решётки), только `Added`/`Changed`/`Fixed`/`Removed`.
+- Пункты — `- ` или `* `, никогда нумерованные.
+- Язык русский, стиль существующего CHANGELOG.
+- Названия фич **жирным**, имена кода в `бэктиках`.
+- Детали — вложенными пунктами (отступ 2 пробела).
+- Не выдумывай фичи — только то, что реально видно в diff/логе.
+
+## Перепиши CHANGELOG.md — оставь ТОЛЬКО последнюю версию
+
+**КРИТИЧНО:** файл `CHANGELOG.md` должен содержать **ровно одну** запись —
+последнюю версию. Все старые записи (предыдущие релизы) **удаляются**.
+
+Формат файла — **всегда такой**:
+
+```markdown
+# Changelog
+
+## [X.Y.Z] - YYYY-MM-DD
+
+### Added
+
+...
+
+### Changed
+
+...
+
+### Fixed
+
+...
+```
+
+**Никаких `## [5.0.0]`, `## [4.0.37]` и т.п. ниже.** Сразу после последней
+секции — конец файла.
+
+### Как переписать
+
+1. Прочитай текущий `CHANGELOG.md` (весь, но тебе нужен только заголовок `# Changelog`).
+2. Собери новую запись (см. выше — на базе последнего git-тега +1 в patch).
+3. Используй `write` (НЕ `edit`) — полностью перезапиши файл:
+
+```cuckoo
+const header = "# Changelog";
+const body = `
+## [5.0.2] - 2026-10-06
+
+### Added
+
+- **Что добавили** — описание.
+
+### Changed
+
+- **Что изменилось** — было → стало.
+
+### Fixed
+
+- Что починили.
+`;
+await write("CHANGELOG.md", header + "\n" + body);
+```
+
+## Проверь парсером
+
+```cuckoo
+const check = await bash(
+  "node -e \"const fs=require('fs'); const {parseChangelog}=require('./src/main/changelog-parser'); const e=parseChangelog(fs.readFileSync('CHANGELOG.md','utf8')); console.log(e.slice(0,5).map(x=>x.version).join(', '));\""
+);
+log(check);
+```
+
+Новая версия должна быть **первой** в выводе.
+
+## Жёсткие правила
+
+1. **НЕ трогай `package.json`** — версию туда выставит CI из git-тега.
+2. **НЕ создавай коммит и НЕ пушь** — это делает родительский диалог отдельно.
+3. **НЕ выдумывай изменения** — только то, что реально видно в git history.
+4. **В CHANGELOG.md должна остаться ровно ОДНА запись** — последняя версия. Все старые записи **удаляются** (перезаписывай файл целиком через `write`).
+5. **НЕ меняй `CHANGELOG_GUIDE.md`** — если найдёшь проблему, сообщи в отчёте.
+6. Формат заголовка — **строго** `## [X.Y.Z] - YYYY-MM-DD`.
+7. **Версия = последний git-тег + 1 в patch** (по умолчанию). Не выдумывай minor/major сам.
+8. **НЕ вставляй "Unreleased"** — эта секция не покажется в What's New.
+9. **НЕ добавляй историю старых версий** — ни `## [5.0.0]`, ни предыдущих. Только текущая.
+
+## Формат отчёта родителю
+
+```
+Добавлена версия X.Y.Z (дата YYYY-MM-DD).
+Git-тег для push: vX.Y.Z
+Базовая версия (последний git-тег): A.B.C
+Инкремент: patch (+1 в последнюю цифру)
+
+Секции:
+- Added: N пунктов
+- Changed: N пунктов
+- Fixed: N пунктов
+- Removed: N пунктов
+
+Проверка парсером: ✅ новая версия первая в списке.
+
+Что НЕ вошло (сомнительные изменения):
+- ...
+```
+
+Если не смог определить версию или изменения неоднозначны — **спроси**, не гадай.
diff --git a/cookie/agents/code-reviewer.md b/cookie/agents/code-reviewer.md
new file mode 100644
index 0000000..88eca36
--- /dev/null
+++ b/cookie/agents/code-reviewer.md
@@ -0,0 +1,20 @@
+---
+name: code-reviewer
+description: Проверка качества кода. Использовать после написания кода.
+tools: read, readLines, glob, grep
+maxTurns: 20
+---
+
+Ты — опытный эксперт по ревью кода. Проверь указанный код, найди реальные проблемы и дай рекомендации.
+
+## Что смотреть
+
+1. Корректность (edge cases, ошибки логики)
+2. Безопасность (инъекции, утечки, небезопасные API)
+3. Сопровождаемость (дублирование, сложность)
+
+## Формат
+
+- Сначала критичные проблемы
+- Затем второстепенные
+- Для каждой: файл:строка + конкретное предложение
diff --git a/cookie/agents/explore.md b/cookie/agents/explore.md
new file mode 100644
index 0000000..35e8f09
--- /dev/null
+++ b/cookie/agents/explore.md
@@ -0,0 +1,18 @@
+---
+name: explore
+description: Только чтение — исследование кодовой базы: широкий поиск, локализация, анализ структуры. Ничего не изменяет.
+tools: read, readLines, glob, grep
+---
+
+Ты — эксперт по исследованию кодовой базы. Работаешь только на чтение, **никогда** не изменяй файлы.
+
+## Как работаешь
+
+- Сначала glob/grep — понять структуру, затем читать ключевые файлы
+- Выдаёшь сжатые выводы (они вернутся в родительский диалог как резюме)
+
+## Формат вывода
+
+- Сначала вывод
+- Ключевые места: файл:строка
+- Неуверенные места помечай явно
diff --git a/cookie/agents/git-committer.md b/cookie/agents/git-committer.md
new file mode 100644
index 0000000..0449dd0
--- /dev/null
+++ b/cookie/agents/git-committer.md
@@ -0,0 +1,195 @@
+---
+name: git-committer
+description: Профи по Git-коммитам и push. Анализирует изменения, пишет осмысленный commit message в Conventional Commits, безопасно пушит. Использовать когда нужно закоммитить/запушить работу.
+tools: read, readLines, bash, grep, glob, todoWrite
+maxTurns: 40
+---
+
+Ты — эксперт по Git workflow. Твоя задача — превратить текущие изменения в чистую,
+осмысленную историю коммитов и безопасно отправить её в удалённый репозиторий.
+
+## Принципы
+
+- **Никогда не коммить мусор.** Перед коммитом всегда проверяй, что попадает в индекс.
+- **Никогда не пушь force без явной просьбы пользователя.** По умолчанию — обычный push.
+- **Не коммить секреты.** Проверяй diff на .env, ключи, токены, пароли.
+- **Атомарность.** Если изменения разнородны — разбей на несколько коммитов по смыслу.
+- **Conventional Commits.** Формат: `type(scope): subject`.
+
+## Алгоритм работы
+
+### 1. Разведка
+
+```cuckoo
+await bash("git status");
+await bash("git diff --stat");
+await bash("git diff --staged");
+await bash("git log --oneline -10");
+```
+
+Пойми:
+
+- Какие файлы изменены/новые/удалены
+- Есть ли чужие незакоммиченные изменения (не твои)
+- В какой ветке работаешь
+- Стиль сообщений в истории (чтобы не ломать конвенцию проекта)
+
+### 2. Проверка безопасности
+
+Перед `git add`:
+
+- Убедись, что `.gitignore` покрывает `node_modules/`, `dist/`, `.env`, временные файлы.
+- Если видишь файл, похожий на секрет (строки `API_KEY=`, `token:`, `-----BEGIN`, длинные base64) — **остановись** и сообщи пользователю.
+- Не коммить файлы >1 МБ без подтверждения.
+
+### 3. Группировка и staging
+
+Если изменения разнородны — группируй:
+
+```cuckoo
+await bash("git add path/to/feature-files");   // только фича
+```
+
+Не используй `git add .` вслепую, если в `git status` есть чужие файлы.
+
+### 4. Commit message (Conventional Commits)
+
+Формат:
+
+```
+type(scope): краткое описание в императиве
+
+Опциональное тело: что и зачем (не как). Максимум 72 символа в строке.
+Футеры: Closes #123, Co-authored-by: ...
+```
+
+**Типы:**
+
+| Тип        | Когда                                    |
+| ---------- | ---------------------------------------- |
+| `feat`     | новая функциональность                   |
+| `fix`      | исправление бага                         |
+| `refactor` | рефакторинг без изменения поведения      |
+| `perf`     | оптимизация производительности           |
+| `docs`     | документация                             |
+| `test`     | тесты                                    |
+| `chore`    | сборка, зависимости, конфиги             |
+| `style`    | форматирование, пробелы, точки с запятой |
+| `build`    | сборка, CI                               |
+| `ci`       | CI-конфиги                               |
+
+**Правила subject:**
+
+- Императив: «add», «fix», «remove» (не «added», «fixes»).
+- Строчная первая буква, без точки в конце.
+- До 72 символов.
+- Английский (если в истории проекта не принят другой язык).
+
+**Примеры хороших:**
+
+- `feat(auth): add JWT refresh token rotation`
+- `fix(chat): prevent duplicate messages on reconnect`
+- `refactor(tools): extract registry into separate module`
+- `chore(deps): bump electron to 33.4.11`
+
+**Плохие (не делай):**
+
+- `update code` (нет типа, нет смысла)
+- `fix: fixed the bug` (прошедшее время)
+- `WIP` (никогда не коммить WIP в основную ветку)
+- `feat: added new feature and refactored stuff and fixed bug` (многоцелевое)
+
+### 5. Коммит
+
+```cuckoo
+await bash('git commit -m "feat(scope): subject" -m "Optional body."');
+```
+
+При многострочном — используй два `-m`. Не пихай `\n` в одну строку.
+
+### 6. Push
+
+```cuckoo
+await bash("git rev-parse --abbrev-ref HEAD");   // текущая ветка
+await bash("git push");                           // обычный push
+```
+
+- Первый push новой ветки: `git push -u origin <branch>`.
+- **Никогда не делай `git push --force`** без прямой просьбы пользователя.
+- Если push отклонён (`non-fast-forward`) — **не форсируй**. Скажи пользователю и предложи `git pull --rebase`.
+
+### 7. Собрать ссылки на коммит и репозиторий
+
+После push **обязательно** собери ссылки:
+
+```cuckoo
+// Полный SHA коммита (для ссылки)
+const sha = await bash("git rev-parse HEAD");
+log(sha);
+
+// URL удалённого репозитория — нормализуем в https-формат для ссылки
+const remote = await bash("git remote get-url origin");
+log(remote);
+
+// Текущая ветка
+const branch = await bash("git rev-parse --abbrev-ref HEAD");
+log(branch);
+```
+
+**Преобразование SSH → HTTPS** (если `origin` в формате git@github.com:...):
+
+- `git@github.com:user/repo.git` → `https://github.com/user/repo`
+- `https://github.com/user/repo.git` → `https://github.com/user/repo`
+
+**Формирование ссылок:**
+
+- **Репозиторий:** `<repo_url>`
+- **Коммит:** `<repo_url>/commit/<full_sha>`
+- **Для GitHub:** `https://github.com/<owner>/<repo>/commit/<sha>`
+- **Для GitLab:** `https://gitlab.com/<owner>/<repo>/-/commit/<sha>`
+- **Для Bitbucket:** `https://bitbucket.org/<owner>/<repo>/commits/<sha>`
+
+Используй `git config --get remote.origin.url` если `git remote get-url origin` недоступен.
+Для мультиплатформенности можно получить хост через `git remote show origin` — но проще
+парсить URL регулярно: определить хост (github/gitlab/bitbucket) и подставить правильный путь.
+
+## Что ты НЕ делаешь
+
+- Не пуш в `main`/`master` напрямую, если проект работает через PR (проверь по истории `git log --first-parent`).
+- Не меняешь уже существующие коммиты (`git commit --amend` только если пользователь явно просит).
+- Не резолвишь конфликты молча — сообщай.
+- Не делаешь `git reset --hard` без предупреждения.
+- Не создаёшь коммиты с сообщениями типа «wip», «fix», «temp».
+
+## Формат отчёта в родительский диалог
+
+Верни **структурированную** сводку с обязательными **ссылками**:
+
+```
+Закоммичено и запушено.
+
+Репозиторий: https://github.com/user/repo
+Ветка: feature/auth-jwt
+
+Коммиты:
+1. https://github.com/user/repo/commit/abc1234...
+   feat(auth): add JWT refresh token rotation (3 файла)
+2. https://github.com/user/repo/commit/def5678...
+   fix(chat): prevent duplicate messages on reconnect (1 файл)
+```
+
+**Обязательные элементы отчёта:**
+
+1. **Ссылка на репозиторий** — `<repo_url>` (нормализованный в https).
+2. **Ссылка на каждый коммит** — `<repo_url>/commit/<full_sha>` (или аналог для GitLab/Bitbucket).
+3. **Ветка** — куда запушено.
+4. **Краткое описание** каждого коммита (subject).
+5. **Список файлов** — количество или перечисление.
+
+Если push **не удался**:
+
+- Чётко напиши ошибку.
+- НЕ выдумывай ссылки — покажи только то, что реально существует локально (SHA есть, ссылка — нет, т.к. коммит не на удалённом).
+- Предложи действие: `git pull --rebase` / ручной push / разбор конфликта.
+
+Если остановился из-за секрета — сообщи: какой файл, что нашёл, что нужно от пользователя.
diff --git a/src/main/agents-window-state.js b/src/main/agents-window-state.js
new file mode 100644
index 0000000..4fdfcb2
--- /dev/null
+++ b/src/main/agents-window-state.js
@@ -0,0 +1,12 @@
+/**
+ * Определение «окно является субагентом» — для защиты от рекурсии.
+ * Достаётся из windowState (поле isSubagent в контексте окна).
+ */
+const windowState = require("./window");
+
+function isSubagentWindow(windowId) {
+  const ctx = windowState.getWindowContext(windowId);
+  return !!(ctx && ctx.isSubagent);
+}
+
+module.exports = { isSubagentWindow };
diff --git a/src/main/agents/frontmatter.js b/src/main/agents/frontmatter.js
new file mode 100644
index 0000000..ad92588
--- /dev/null
+++ b/src/main/agents/frontmatter.js
@@ -0,0 +1,81 @@
+/**
+ * Парсер YAML-frontmatter (минимальный, без внешних зависимостей).
+ *
+ * Ожидаемый формат:
+ *   ---
+ *   name: value
+ *   description: some text
+ *   tools: read, grep, glob
+ *   maxTurns: 20
+ *   ---
+ *   <тело>
+ *
+ * Поддерживает: строки (без кавычек), строки в одинарных/двойных кавычках,
+ * массивы в виде "- item" на отдельной строке, массив через запятую в одной
+ * строке. Вложенные объекты и блоки "|" НЕ поддерживаются (нам не нужны).
+ */
+
+function stripQuotes(s) {
+  if (typeof s !== "string") return s;
+  const t = s.trim();
+  if (t.length >= 2) {
+    const a = t[0],
+      b = t[t.length - 1];
+    if ((a === '"' && b === '"') || (a === "'" && b === "'")) {
+      return t.slice(1, -1);
+    }
+  }
+  return s;
+}
+
+/**
+ * Распарсить frontmatter.
+ * @param {string} raw
+ * @returns {{data: Object, body: string}}
+ */
+function parseFrontmatter(raw) {
+  const text = String(raw || "");
+  // Frontmatter должен начинаться с первой строки "---"
+  if (!/^---\s*\r?\n/.test(text)) {
+    return { data: {}, body: text };
+  }
+  const rest = text.replace(/^---\s*\r?\n/, "");
+  const endMatch = rest.match(/\r?\n---\s*(\r?\n|$)/);
+  if (!endMatch) return { data: {}, body: text };
+  const fmRaw = rest.slice(0, endMatch.index);
+  const body = rest.slice(endMatch.index + endMatch[0].length);
+
+  const data = {};
+  let lastKey = null;
+  for (const rawLine of fmRaw.split(/\r?\n/)) {
+    if (!rawLine.trim()) continue;
+    // Массив "- item"
+    if (/^\s*-\s+/.test(rawLine) && lastKey) {
+      const item = stripQuotes(rawLine.replace(/^\s*-\s+/, ""));
+      if (!Array.isArray(data[lastKey])) data[lastKey] = [];
+      data[lastKey].push(item);
+      continue;
+    }
+    const m = rawLine.match(/^([A-Za-z0-9_-]+)\s*:\s*(.*)$/);
+    if (!m) continue;
+    const key = m[1];
+    const valueRaw = m[2];
+    lastKey = key;
+    if (valueRaw === "") {
+      data[key] = "";
+      continue;
+    }
+    // Массив в одну строку через запятую (для tools)
+    if (key === "tools" || key === "paths") {
+      data[key] = valueRaw
+        .split(",")
+        .map((s) => stripQuotes(s.trim()))
+        .filter(Boolean);
+    } else {
+      data[key] = stripQuotes(valueRaw);
+    }
+  }
+  return { data, body };
+}
+
+module.exports = { parseFrontmatter };
diff --git a/src/main/agents/index.js b/src/main/agents/index.js
new file mode 100644
index 0000000..a186f12
--- /dev/null
+++ b/src/main/agents/index.js
@@ -0,0 +1,12 @@
+/**
+ * Точка входа модуля субагентов.
+ */
+const { scanAgents, mergeAgents, scanAgentsRoot } = require("./scanner");
+const { buildAgentsSection } = require("./prompt");
+
+module.exports = {
+  scanAgents,
+  mergeAgents,
+  scanAgentsRoot,
+  buildAgentsSection,
+};
diff --git a/src/main/agents/prompt.js b/src/main/agents/prompt.js
new file mode 100644
index 0000000..b502d72
--- /dev/null
+++ b/src/main/agents/prompt.js
@@ -0,0 +1,40 @@
+/**
+ * Секция "Доступные субагенты" для системного промпта.
+ *
+ * Прогрессивное раскрытие: только name + description. Как именно вызывать —
+ * описано в prompt-section самого инструмента run_agent.
+ */
+
+function formatAgentLine(a) {
+  return "- " + a.name + "：" + a.description;
+}
+
+/**
+ * Собрать секцию. Пустой список -> пустая строка (не занимает промпт).
+ * @param {Array<{name:string, description:string}>} agents
+ * @returns {string}
+ */
+function buildAgentsSection(agents) {
+  const list = Array.isArray(agents) ? agents : [];
+  if (list.length === 0) return "";
+  const lines = [];
+  lines.push("## Доступные субагенты (Agents)");
+  lines.push("");
+  lines.push(
+    "Когда задача подходит для делегирования, вызови run_agent(name, task),",
+  );
+  lines.push(
+    "чтобы передать её соответствующему субагенту. Субагент работает в отдельном",
+  );
+  lines.push("контексте и возвращает только итоговое резюме.");
+  lines.push(
+    "Подходит для делегирования: широкий поиск/анализ, независимые подзадачи —",
+  );
+  lines.push("чтобы не засорять текущий контекст.");
+  lines.push("");
+  for (const a of list) lines.push(formatAgentLine(a));
+  lines.push("");
+  return lines.join("\n");
+}
+
+module.exports = { buildAgentsSection };
diff --git a/src/main/agents/scanner.js b/src/main/agents/scanner.js
new file mode 100644
index 0000000..cf2ccfd
--- /dev/null
+++ b/src/main/agents/scanner.js
@@ -0,0 +1,117 @@
+/**
+ * Сканер субагентов: проектные + пользовательские каталоги -> AgentMeta[].
+ *
+ * Правила:
+ *  - Сканируется только <base>/cookie/agents/ — один уровень, только .md
+ *  - Имя: frontmatter.name || basename(file, '.md')
+ *  - Описание: frontmatter.description || первый непустой абзац тела
+ *  - Без имени/описания — агент пропускается (нельзя показать в промпте)
+ *  - При совпадении имён: project > user
+ */
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { parseFrontmatter } = require("./frontmatter");
+
+/** Первый непустой не-заголовочный абзац тела -> fallback description */
+function firstParagraph(body) {
+  for (const raw of String(body || "").split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line) continue;
+    if (line.startsWith("#")) continue;
+    return line;
+  }
+  return "";
+}
+
+/**
+ * Просканировать одну папку agents (без рекурсии).
+ * @param {string} agentsDir абсолютный путь к cookie/agents
+ * @param {'project'|'user'} source
+ * @returns {AgentMeta[]}
+ */
+function scanAgentsRoot(agentsDir, source) {
+  let entries;
+  try {
+    entries = fs.readdirSync(agentsDir, { withFileTypes: true });
+  } catch (_) {
+    return [];
+  }
+  const out = [];
+  for (const ent of entries) {
+    if (!ent.isFile()) continue;
+    if (!ent.name.toLowerCase().endsWith(".md")) continue;
+    const agentPath = path.join(agentsDir, ent.name);
+    let raw = "";
+    try {
+      raw = fs.readFileSync(agentPath, "utf-8");
+    } catch (_) {
+      continue;
+    }
+    const { data, body } = parseFrontmatter(raw);
+    const name =
+      (data.name && String(data.name).trim()) || ent.name.replace(/\.md$/i, "");
+    const description = String(
+      data.description || firstParagraph(body) || "",
+    ).trim();
+    if (!name.trim() || !description) continue;
+
+    let tools;
+    if (data.tools) {
+      const arr = Array.isArray(data.tools)
+        ? data.tools
+        : String(data.tools)
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+      tools = arr.map((s) => String(s).trim()).filter(Boolean);
+      if (tools.length === 0) tools = undefined;
+    }
+
+    let maxTurns;
+    if (data.maxTurns != null && data.maxTurns !== "") {
+      const n = Number(data.maxTurns);
+      if (Number.isInteger(n) && n > 0 && n <= 1000) maxTurns = n;
+    }
+
+    out.push({
+      name: name.trim(),
+      description,
+      tools,
+      maxTurns,
+      agentPath,
+      systemPrompt: String(body || "").trim(),
+      source,
+    });
+  }
+  return out;
+}
+
+/** Слить списки по имени: project > user (plugin не поддержан) */
+function mergeAgents(project, user) {
+  const byName = new Map();
+  for (const a of user) byName.set(a.name, a);
+  for (const a of project) byName.set(a.name, a);
+  return Array.from(byName.values());
+}
+
+/**
+ * Просканировать все каталоги субагентов.
+ * @param {string|null} projectDir корень проекта (может быть null)
+ * @returns {AgentMeta[]}
+ */
+function scanAgents(projectDir) {
+  let userHome = "";
+  try {
+    userHome = os.homedir();
+  } catch (_) {}
+  const user = userHome
+    ? scanAgentsRoot(path.join(userHome, "cookie", "agents"), "user")
+    : [];
+  const project = projectDir
+    ? scanAgentsRoot(path.join(projectDir, "cookie", "agents"), "project")
+    : [];
+  return mergeAgents(project, user);
+}
+
+module.exports = { scanAgents, mergeAgents, scanAgentsRoot };
diff --git a/src/main/agents/types.js b/src/main/agents/types.js
new file mode 100644
index 0000000..73a3981
--- /dev/null
+++ b/src/main/agents/types.js
@@ -0,0 +1,24 @@
+/**
+ * Agent (субагент) — типы и документация.
+ *
+ * Формат: markdown-файл с frontmatter, размещённый в:
+ *   - <projectDir>/cookie/agents/<name>.md   (проектный, приоритет выше)
+ *   - ~/cookie/agents/<name>.md              (пользовательский)
+ *
+ * Frontmatter-поля:
+ *   - name        : имя агента (по умолчанию — имя файла без .md)
+ *   - description : когда делегировать (обязательно, иначе агент пропускается)
+ *   - tools       : список разрешённых инструментов через запятую (по умолчанию — все)
+ *   - maxTurns    : лимит шагов 1..1000 (по умолчанию — без лимита)
+ *
+ * @typedef {Object} AgentMeta
+ * @property {string} name
+ * @property {string} description
+ * @property {string[]|undefined} tools
+ * @property {number|undefined} maxTurns
+ * @property {string} agentPath      — абсолютный путь к файлу
+ * @property {string} systemPrompt   — тело без frontmatter
+ * @property {'project'|'user'} source
+ */
+
+module.exports = {};
diff --git a/src/main/index.js b/src/main/index.js
index 5fde39f..49e3118 100644
--- a/src/main/index.js
+++ b/src/main/index.js
@@ -107,6 +107,12 @@ if (RENDERER_LOG_DIR) {
 
 const { registerIpcHandlers } = require("./ipc");
 const whatsNew = require("./whats-new");
+const subagent = require("./subagent");
+const {
+  injectAgentRunner,
+  injectSubagentChecker,
+} = require("../../tools/RunAgentTool");
+const { isSubagentWindow } = require("./agents-window-state");
 
 // Whats-new: проверить факт обновления ДО создания окна.
 // Внутри — атомарное сохранение новой lastSeenVersion, чтобы повторный
@@ -146,10 +152,19 @@ function createWindow(profile) {
     windowState,
   );
 
+  // Субагент-конфиг передаётся дочернему окну через additionalArguments.
+  // Bridge в preload сам распознаёт, что это окно-субагент, и запускает цикл.
+  const subagentArg = profileData.subagentConfig
+    ? "--cuckoo-subagent=" +
+      encodeURIComponent(JSON.stringify(profileData.subagentConfig))
+    : null;
+
   const mainWindow = new BrowserWindow({
     width: 1280,
     height: 900,
-    title: "Cookie Code Pro - " + provider.name + " - " + profileData.name,
+    title: profileData.isSubagent
+      ? "Cookie Code Pro - " + provider.name + " - " + profileData.name
+      : "Cookie Code Pro - " + provider.name + " - " + profileData.name,
     icon: APP_ICON,
     webPreferences: {
       preload: path.join(__dirname, "..", "..", "preload.js"),
@@ -158,7 +173,9 @@ function createWindow(profile) {
       sandbox: false,
       partition: profileData.partition, // 每个 profile 独立持久化 session
       backgroundThrottling: false,
-      additionalArguments: ["--cuckoo-user-data=" + app.getPath("userData")],
+      additionalArguments: subagentArg
+        ? ["--cuckoo-user-data=" + app.getPath("userData"), subagentArg]
+        : ["--cuckoo-user-data=" + app.getPath("userData")],
     },
   });
 
@@ -166,7 +183,14 @@ function createWindow(profile) {
   const winSession = mainWindow.webContents.session;
 
   // Регистрируем контекст окна — providerId жёстко 'deepseek'.
-  windowState.addWindow(mainWindow, profileData.id, "deepseek", sessionStore);
+  windowState.addWindow(
+    mainWindow,
+    profileData.id,
+    "deepseek",
+    sessionStore,
+    profileData.isSubagent,
+    profileData.subagentConfig,
+  );
   sessionsToFlush.add(winSession);
 
   // 更新主窗口引用
@@ -281,6 +305,9 @@ function createWindow(profile) {
     sessionsToFlush.delete(winSession);
     windowState.removeWindow(mainWindow.id);
   });
+
+  // Возвращаем id окна: нужно для субагента (родитель ждёт дочернее окно по id).
+  return mainWindow.id;
 }
 
 // ========== 应用菜单 ==========
@@ -412,6 +439,34 @@ function setupAppMenu() {
 // ========== IPC 处理器 ==========
 registerIpcHandlers();
 
+// ========== Субагенты (Agents) ==========
+// Инжектим в tool runAgent реальный раннер и определитель «окно-субагент»,
+// чтобы tools-слой не зависел от main-слоя (инверсия зависимости).
+subagent.injectSubagentDeps({ createWindow, profileManager });
+injectAgentRunner(async ({ agent, task, currentWindowId, projectDir }) => {
+  const ctx = windowState.getWindowContext(currentWindowId);
+  if (!ctx) throw new Error("Контекст окна не найден");
+
+  // Уведомляем TG о старте делегирования ДО открытия дочернего окна —
+  // чтобы пользователь сразу видел карточку «делегирую задачу»,
+  // а не ждал до конца работы субагента.
+  try {
+    require("../../botsrc").notifyAgentStarted(agent.name, task);
+  } catch (_) {}
+
+  return subagent.runAgent({
+    parentProfileId: ctx.profileId,
+    parentWindowId: currentWindowId,
+    agentName: agent.name,
+    task,
+    systemPrompt: agent.systemPrompt,
+    tools: agent.tools,
+    maxTurns: agent.maxTurns,
+    projectDir, // приоритетный источник рабочей папки
+  });
+});
+injectSubagentChecker(isSubagentWindow);
+
 // ========== Telegram-бот (botsrc/) — применяем настройки при старте ==========
 try {
   require("../../botsrc")
diff --git a/src/main/ipc.js b/src/main/ipc.js
index a50e755..f3ba4ac 100644
--- a/src/main/ipc.js
+++ b/src/main/ipc.js
@@ -19,6 +19,7 @@ const { decodeOutput, normalizeCommand } = require("../../tools/decodeOutput");
 const gitDiff = require("./git-diff");
 const todoStore = require("./todo-store");
 const planMode = require("./plan-mode");
+const subagent = require("./subagent");
 
 /**
  * Если у окна все задачи выполнены (и список непустой) — пингуем Telegram один раз.
@@ -328,6 +329,22 @@ function tryOpenInVSCode(filePath) {
 }
 
 function registerIpcHandlers() {
+  // ===== Субагенты: bridge дочернего окна сообщает финальный текст =====
+  ipcMain.handle("subagent-response", async (event, payload) => {
+    try {
+      const ctx = windowState.getContextByWebContents(event.sender);
+      if (ctx && ctx.win && !ctx.win.isDestroyed()) {
+        subagent.onSubagentResponse(
+          ctx.win.id,
+          (payload && payload.text) || "",
+        );
+      }
+      return { success: true };
+    } catch (err) {
+      return { success: false, error: err.message };
+    }
+  });
+
   // Мост Telegram → окно: ответ на вопрос из TG резолвит тот же promise.
   try {
     const bot = require("../../botsrc");
@@ -899,12 +916,34 @@ function registerIpcHandlers() {
         }
       }
 
+      // Whitelist для субагента: прямое выполнение tool-вызова тоже
+      // должно проходить проверку (не только через JsRunner).
+      if (ctx && Array.isArray(ctx.toolsWhitelist)) {
+        const ALIAS = { __bash: "bash" };
+        const name = ALIAS[toolName] || toolName;
+        if (ctx.toolsWhitelist.indexOf(name) === -1) {
+          return {
+            callId,
+            success: false,
+            error:
+              "Инструмент «" +
+              name +
+              "» не разрешён этому агенту. " +
+              "Разрешены: " +
+              ctx.toolsWhitelist.join(", ") +
+              ".",
+          };
+        }
+      }
+
       const taskToken = beginTask(event.sender.id);
       try {
         const result = await toolRegistry.execute(toolName, {
           ...params,
           projectDir: selectedDir,
           senderId: event.sender.id,
+          currentWindowId:
+            ctx && ctx.win && !ctx.win.isDestroyed() ? ctx.win.id : null,
           askUserQuestion: (questions) =>
             requestUserQuestion(event.sender, questions),
           pasteImage: (filePath, caption, send) =>
@@ -1087,6 +1126,8 @@ function registerIpcHandlers() {
     const ctx = windowState.getContextByWebContents(event.sender);
     const store = ctx ? ctx.sessionStore : null;
     const selectedDir = store ? store.state.selectedProjectDir : null;
+    const currentWindowId =
+      ctx && ctx.win && !ctx.win.isDestroyed() ? ctx.win.id : null;
     const taskToken = beginTask(event.sender.id);
     try {
       const before = JSON.stringify(todoStore.getList(event.sender.id));
@@ -1100,6 +1141,9 @@ function registerIpcHandlers() {
         (plan) => requestExitPlanMode(event.sender, plan),
         sessionIdOf(event),
         (payload) => attachFileToChat(event.sender, payload),
+        currentWindowId,
+        ctx && Array.isArray(ctx.toolsWhitelist) ? ctx.toolsWhitelist : null,
+        (ctx && ctx.subagentConfig && ctx.subagentConfig.agentName) || null,
       );
       if (isTaskCanceled(event.sender.id, taskToken)) {
         return {
@@ -1195,8 +1239,14 @@ function registerIpcHandlers() {
   });
 
   // Ответ AI → в Telegram (для просмотра с телефона).
-  ipcMain.handle("telegram-notify-ai", async (_event, { text } = {}) => {
+  // ВАЖНО: если ответ пришёл из окна-субагента — НЕ шлём (у субагента
+  // отдельное оформление: notifyAgentStarted + результат через notifyToolResult).
+  ipcMain.handle("telegram-notify-ai", async (event, { text } = {}) => {
     try {
+      const ctx = windowState.getContextByWebContents(event.sender);
+      if (ctx && ctx.isSubagent) {
+        return { success: false, skipped: true, reason: "subagent window" };
+      }
       const bot = require("../../botsrc");
       return await bot.notifyAIResponse(text);
     } catch (err) {
@@ -1523,6 +1573,43 @@ function registerIpcHandlers() {
     }
   });
 
+  // ========== Память AI (userData/memory.md) ==========
+  // Файл заметок о пользователе/его системе; читается/пишется через
+  // инструменты memory_save / memory_read / memory_clear (tools/MemoryTool.js).
+  const memoryStore = require("./memory-store");
+
+  ipcMain.handle("cuckoo-memory-open-file", async () => {
+    try {
+      const file = memoryStore.ensureFile();
+      const errMsg = await shell.openPath(file);
+      if (errMsg) return { success: false, error: errMsg };
+      return { success: true, path: file };
+    } catch (err) {
+      console.error("[Cookie Code] открытие файла памяти失败:", err.message);
+      return { success: false, error: err.message };
+    }
+  });
+
+  ipcMain.handle("cuckoo-memory-clear", async () => {
+    try {
+      const r = memoryStore.clearMemory();
+      if (!r.ok) return { success: false, error: r.error };
+      return { success: true };
+    } catch (err) {
+      console.error("[Cookie Code] очистка памяти失败:", err.message);
+      return { success: false, error: err.message };
+    }
+  });
+
+  ipcMain.handle("cuckoo-memory-stats", async () => {
+    try {
+      const stats = memoryStore.getStats();
+      return { success: true, path: memoryStore.getMemoryPath(), ...stats };
+    } catch (err) {
+      return { success: false, error: err.message };
+    }
+  });
+
   // ========== Пользовательские шрифты (userData/fonts) ==========
   // Папка: <userData>/fonts — пользователь кладёт туда .ttf/.otf/.woff/.woff2,
   // они автоматически появляются в выборе шрифта в настройках.
diff --git a/src/main/memory-store.js b/src/main/memory-store.js
new file mode 100644
index 0000000..235f9a6
--- /dev/null
+++ b/src/main/memory-store.js
@@ -0,0 +1,116 @@
+/**
+ * Хранилище долговременной памяти AI-ассистента.
+ *
+ * Файл: <userData>/memory.md — общий для всех профилей и проектов.
+ * Формат: append-заметка с датой, одна запись — одна строка:
+ *   - [YYYY-MM-DD] текст записи
+ *
+ * Модуль живёт в main-процессе; инструменты (tools/MemoryTool.js) ходят
+ * сюда через toolRegistry.
+ */
+const fs = require("fs");
+const path = require("path");
+const { app } = require("electron");
+
+// Максимальная длина одной записи (символов). Слишком длинные тексты режем.
+const MAX_ENTRY_LEN = 2000;
+
+const HEADER =
+  "# Память Cookie Code\n\nЗаметки о пользователе, его системе и предпочтениях.\nФормат: - [YYYY-MM-DD] текст\n\n";
+
+function getMemoryPath() {
+  return path.join(app.getPath("userData"), "memory.md");
+}
+
+function ensureFile() {
+  const file = getMemoryPath();
+  if (!fs.existsSync(file)) {
+    fs.writeFileSync(file, HEADER, "utf-8");
+  }
+  return file;
+}
+
+/** Прочитать содержимое памяти (пустая строка, если файла нет). */
+function readMemory() {
+  try {
+    const file = getMemoryPath();
+    if (!fs.existsSync(file)) return "";
+    return fs.readFileSync(file, "utf-8");
+  } catch (err) {
+    console.error("[MemoryStore] чтение памяти失败:", err.message);
+    return "";
+  }
+}
+
+/** Текущая дата в формате YYYY-MM-DD (локально). */
+function todayStamp() {
+  const d = new Date();
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return y + "-" + m + "-" + day;
+}
+
+/**
+ * Добавить одну запись в память.
+ * @param {string} text  непустой текст (trim); длиннее MAX_ENTRY_LEN — обрезается
+ * @returns {{ok: true, entry: string} | {ok: false, error: string}}
+ */
+function appendMemory(text) {
+  try {
+    if (typeof text !== "string")
+      return { ok: false, error: "text must be a string" };
+    let t = text.trim();
+    if (!t) return { ok: false, error: "text must be a non-empty string" };
+    if (t.length > MAX_ENTRY_LEN) t = t.slice(0, MAX_ENTRY_LEN) + "…";
+    // Однострочная запись: переносы заменяем пробелами.
+    t = t.replace(/\s*\r?\n\s*/g, " ");
+    const entry = "- [" + todayStamp() + "] " + t;
+    ensureFile();
+    const file = getMemoryPath();
+    let existing = fs.readFileSync(file, "utf-8");
+    if (existing.length > 0 && !existing.endsWith("\n")) existing += "\n";
+    fs.writeFileSync(file, existing + entry + "\n", "utf-8");
+    console.log("[MemoryStore] добавлена запись: " + entry);
+    return { ok: true, entry };
+  } catch (err) {
+    console.error("[MemoryStore] запись памяти失败:", err.message);
+    return { ok: false, error: err.message };
+  }
+}
+
+/** Полностью очистить память (файл остаётся с заголовком). */
+function clearMemory() {
+  try {
+    fs.writeFileSync(getMemoryPath(), HEADER, "utf-8");
+    console.log("[MemoryStore] память очищена");
+    return { ok: true };
+  } catch (err) {
+    console.error("[MemoryStore] очистка памяти失败:", err.message);
+    return { ok: false, error: err.message };
+  }
+}
+
+/** Статистика: существует ли файл, размер в байтах, число записей. */
+function getStats() {
+  try {
+    const file = getMemoryPath();
+    if (!fs.existsSync(file)) return { exists: false, bytes: 0, entries: 0 };
+    const raw = fs.readFileSync(file, "utf-8");
+    const bytes = Buffer.byteLength(raw, "utf-8");
+    const entries = raw.split(/\r?\n/).filter((l) => /^-\s*\[/.test(l)).length;
+    return { exists: true, bytes, entries };
+  } catch (err) {
+    return { exists: false, bytes: 0, entries: 0, error: err.message };
+  }
+}
+
+module.exports = {
+  MAX_ENTRY_LEN,
+  getMemoryPath,
+  ensureFile,
+  readMemory,
+  appendMemory,
+  clearMemory,
+  getStats,
+};
diff --git a/src/main/plan-mode.js b/src/main/plan-mode.js
index 94d616b..0b5f7a2 100644
--- a/src/main/plan-mode.js
+++ b/src/main/plan-mode.js
@@ -9,15 +9,27 @@
  * Ключ = `${senderId}::${sessionId}`. Для нового чата (sessionId ещё нет)
  * используется суффикс 'new'. Флаг хранится в памяти процесса.
  */
-const path = require('path');
+const path = require("path");
 
 const active = new Set();
-const PLAN_FILE = 'plan.md';
+const PLAN_FILE = "plan.md";
 
 const MUTATING_TOOLS = new Set([
-  'write', 'file_write', 'edit', 'file_edit', 'delete_file', 'file_delete',
-  'bash', '__bash', 'pwsh',
-  'mysql', 'inject_js', 'mcp_call', 'skill_execute',
+  "write",
+  "file_write",
+  "edit",
+  "file_edit",
+  "delete_file",
+  "file_delete",
+  "bash",
+  "__bash",
+  "pwsh",
+  "mysql",
+  "inject_js",
+  "mcp_call",
+  "skill_execute",
+  "memory_save",
+  "memory_clear",
 ]);
 
 /**
@@ -27,7 +39,7 @@ const MUTATING_TOOLS = new Set([
  * @returns {string}
  */
 function keyOf(senderId, sessionId) {
-  return String(senderId) + '::' + (sessionId || 'new');
+  return String(senderId) + "::" + (sessionId || "new");
 }
 
 function setPlanMode(senderId, sessionId, enabled) {
@@ -46,27 +58,36 @@ function clearPlanMode(senderId, sessionId) {
 
 function isPlanFile(filePath) {
   if (!filePath) return false;
-  return path.basename(String(filePath).replace(/\\/g, '/')) === PLAN_FILE;
+  return path.basename(String(filePath).replace(/\\/g, "/")) === PLAN_FILE;
 }
 
 function checkBlocked(op, args) {
-  const name = String(op || '');
+  const name = String(op || "");
   if (!MUTATING_TOOLS.has(name)) return { blocked: false };
-  if (name === 'write' || name === 'file_write') {
-    const filePath = (args && (args.file_path || args.filePath || args.path)) || '';
+  if (name === "write" || name === "file_write") {
+    const filePath =
+      (args && (args.file_path || args.filePath || args.path)) || "";
     if (isPlanFile(filePath)) return { blocked: false };
   }
   return {
     blocked: true,
     error:
-      'Режим плана включён: изменяющие операции заблокированы. ' +
-      'Запрещено редактировать/записывать файлы, запускать shell, SQL и т.п. ' +
-      'Единственное исключение — запись плана в ' + PLAN_FILE + '. ' +
-      'Заверши план и вызови exit_plan_mode().',
+      "Режим плана включён: изменяющие операции заблокированы. " +
+      "Запрещено редактировать/записывать файлы, запускать shell, SQL и т.п. " +
+      "Единственное исключение — запись плана в " +
+      PLAN_FILE +
+      ". " +
+      "Заверши план и вызови exit_plan_mode().",
   };
 }
 
 module.exports = {
-  PLAN_FILE, MUTATING_TOOLS,
-  keyOf, setPlanMode, isPlanMode, clearPlanMode, isPlanFile, checkBlocked,
+  PLAN_FILE,
+  MUTATING_TOOLS,
+  keyOf,
+  setPlanMode,
+  isPlanMode,
+  clearPlanMode,
+  isPlanFile,
+  checkBlocked,
 };
diff --git a/src/main/project-context.js b/src/main/project-context.js
index 1285647..06c5fb4 100644
--- a/src/main/project-context.js
+++ b/src/main/project-context.js
@@ -438,6 +438,21 @@ async function buildInitPrompt(selectedDir, providerId) {
     "Skill 位于 <projectDir>/.cuckoo/skills/<skill-name>/，其中 SKILL.md 为指令文件，tool.js 可选导出可执行函数。",
   ].join("\n");
 
+  // Agents (субагенты) — прогрессивное раскрытие: только name + description.
+  // Сами определения (systemPrompt, tools, maxTurns) живут в .cuckoo/agents/*.md
+  // и подгружаются в момент вызова run_agent.
+  let agentsSection = "";
+  try {
+    const { scanAgents, buildAgentsSection } = require("./agents");
+    const agents = scanAgents(selectedDir);
+    agentsSection = buildAgentsSection(agents);
+    if (agents.length > 0) {
+      console.log("[Cookie Code] Найдено субагентов:", agents.length);
+    }
+  } catch (err) {
+    console.error("[Cookie Code] Ошибка сканирования субагентов:", err.message);
+  }
+
   const placeholders = {
     "{{TOOL_API_TYPES}}": toolApiTypes,
     "{{TOOLS_LIST}}": toolsDescription,
@@ -447,6 +462,7 @@ async function buildInitPrompt(selectedDir, providerId) {
     "{{PROJECT_INTRO_SECTION}}": projectIntroSection,
     "{{SKILL_SECTION}}": skillSection,
     "{{MCP_SECTION}}": mcpSection,
+    "{{AGENTS_SECTION}}": agentsSection,
   };
   let combined = templateContent;
   for (const [key, value] of Object.entries(placeholders)) {
diff --git a/src/main/session-store.js b/src/main/session-store.js
index bbe91bf..b4d1a77 100644
--- a/src/main/session-store.js
+++ b/src/main/session-store.js
@@ -123,9 +123,19 @@ function createSessionStore(profileId, storeDir, windowState) {
       }
     } else {
       state.currentSessionId = null;
-      state.selectedProjectDir = null;
-      if (win && !win.isDestroyed()) {
-        win.webContents.send("project-dir-updated", null);
+      // Если есть pendingProjectDir (например, в дочернем окне субагента
+      // мы заранее задали рабочую папку), НЕ затираем selectedProjectDir —
+      // иначе инструменты до появления sessionId увидят null.
+      if (!state.pendingProjectDir) {
+        state.selectedProjectDir = null;
+        if (win && !win.isDestroyed()) {
+          win.webContents.send("project-dir-updated", null);
+        }
+      } else {
+        state.selectedProjectDir = state.pendingProjectDir;
+        if (win && !win.isDestroyed()) {
+          win.webContents.send("project-dir-updated", state.pendingProjectDir);
+        }
       }
     }
   }
diff --git a/src/main/subagent.js b/src/main/subagent.js
new file mode 100644
index 0000000..026843f
--- /dev/null
+++ b/src/main/subagent.js
@@ -0,0 +1,295 @@
+/**
+ * Раннер субагентов (оркестрация на стороне main-процесса).
+ *
+ * Алгоритм:
+ *   1) создать дочернее окно с тем же partition (общая сессия DeepSeek)
+ *   2) проставить в его sessionStore projectDir + pendingLineage
+ *   3) передать конфиг через additionalArguments (--cuckoo-subagent=...)
+ *   4) ждать IPC subagent-response (или таймаут)
+ *   5) закрыть окно, вернуть текст родителю
+ *
+ * Зависимости (createWindow) инжектируются из index.js — чтобы избежать
+ * циклического require main → subagent → main.
+ */
+const windowState = require("./window");
+const { buildInitPrompt } = require("./project-context");
+
+let _createWindow = null;
+let _profileManager = null;
+
+/** Инжектировать зависимости из index.js */
+function injectSubagentDeps(deps) {
+  _createWindow = deps.createWindow;
+  _profileManager = deps.profileManager;
+}
+
+/** Ожидающие окна: windowId -> resolve(text) */
+const pending = new Map();
+
+/** Счётчик работающих субагентов на profileId (для блокировки уведомлений и т.п.) */
+const runningByProfile = new Map();
+
+function hasRunningSubagent(profileId) {
+  return !!profileId && (runningByProfile.get(profileId) || 0) > 0;
+}
+
+function incRunning(profileId) {
+  if (!profileId) return;
+  runningByProfile.set(profileId, (runningByProfile.get(profileId) || 0) + 1);
+}
+
+function decRunning(profileId) {
+  if (!profileId) return;
+  const n = (runningByProfile.get(profileId) || 0) - 1;
+  if (n <= 0) runningByProfile.delete(profileId);
+  else runningByProfile.set(profileId, n);
+}
+
+/** Вызывается из IPC при получении subagent-response */
+function onSubagentResponse(windowId, text) {
+  const resolve = pending.get(windowId);
+  if (resolve) {
+    pending.delete(windowId);
+    resolve(String(text || ""));
+  }
+}
+
+/**
+ * Подготовить финальный промпт субагента:
+ *   полный системный промпт Cookie Code (инструменты, формат cuckoo)
+ *   + секция агента (systemPrompt + task).
+ * Отправляется в дочернее окно через initial-prompt (прелоад слушает канал).
+ */
+function buildAgentPrompt(agentSystemPrompt, task) {
+  const parts = [];
+  if (agentSystemPrompt) parts.push(String(agentSystemPrompt).trim());
+  parts.push("");
+  parts.push("---");
+  parts.push("Задача: " + task);
+  parts.push("");
+  parts.push(
+    "Когда закончишь, дай сразу финальный результат (не вызывай больше инструментов).",
+  );
+  return parts.join("\n");
+}
+
+/**
+ * Дождаться готовности дочернего окна и отправить в него initial-prompt
+ * (system prompt Cookie Code + промпт агента + task).
+ */
+function sendInitPromptWhenReady(win, projectDir, extraPrompt, timeoutMs) {
+  return new Promise((resolve) => {
+    if (!win || win.isDestroyed()) return resolve(false);
+    let sent = false;
+    const send = async () => {
+      if (sent) return;
+      if (!win || win.isDestroyed()) return;
+      try {
+        const base = await buildInitPrompt(
+          projectDir || process.cwd(),
+          "deepseek",
+        );
+        const combined = base + "\n\n" + extraPrompt;
+        win.webContents.send("initial-prompt", combined);
+        sent = true;
+        console.log(
+          "[Subagent] initial-prompt отправлен в окно (len=" +
+            combined.length +
+            ")",
+        );
+        resolve(true);
+      } catch (err) {
+        console.error(
+          "[Subagent] не удалось собрать initial-prompt:",
+          err && err.message,
+        );
+        resolve(false);
+      }
+    };
+    win.webContents.once("did-finish-load", () => setTimeout(send, 1200));
+    // На случай, если страница уже загрузилась до подписки
+    setTimeout(send, 3000);
+    // Абсолютный таймаут
+    setTimeout(
+      () => {
+        if (!sent) resolve(false);
+      },
+      Math.min(timeoutMs, 60000),
+    );
+  });
+}
+
+/** Ожидание завершения субагента с таймаутом */
+function waitForDone(windowId, timeoutMs) {
+  return new Promise((resolve) => {
+    let done = false;
+    const timer = setTimeout(() => {
+      if (done) return;
+      done = true;
+      pending.delete(windowId);
+      resolve("__SUBAGENT_TIMEOUT__");
+    }, timeoutMs);
+    pending.set(windowId, (text) => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      resolve(text);
+    });
+  });
+}
+
+/**
+ * Запустить субагента.
+ * @param {Object} opts
+ * @param {string} opts.parentProfileId  — profileId родителя (общий partition)
+ * @param {number} opts.parentWindowId   — windowId родителя
+ * @param {string} opts.agentName
+ * @param {string} opts.task
+ * @param {string} opts.systemPrompt
+ * @param {string[]|undefined} opts.tools
+ * @param {number|undefined} opts.maxTurns
+ * @param {string} [opts.projectDir]     — рабочая папка (приоритетно из RunAgentTool)
+ * @param {number} [opts.timeoutMs=600000]
+ * @returns {Promise<string>}
+ */
+async function runAgent(opts) {
+  if (!_createWindow || !_profileManager)
+    throw new Error("Зависимости субагента не инжектированы");
+  const timeoutMs = opts.timeoutMs || 600000; // 10 минут
+
+  const parentCtx = windowState.getWindowContext(opts.parentWindowId);
+  if (!parentCtx) throw new Error("Контекст родительского окна не найден");
+  const parentStore = parentCtx.sessionStore;
+
+  // Рабочая папка: приоритет — явно переданная из RunAgentTool,
+  // fallback — из sessionStore родителя.
+  const projectDir =
+    opts.projectDir ||
+    (parentStore &&
+      parentStore.state &&
+      parentStore.state.selectedProjectDir) ||
+    null;
+
+  if (!projectDir) {
+    throw new Error(
+      "Не задана рабочая папка проекта. Инициализируй проект в родительском окне (кнопка «Инициализировать проект») и повтори.",
+    );
+  }
+  // Проверяем, что папка существует и это каталог — иначе субагент не сможет читать.
+  try {
+    const fs = require("fs");
+    const st = fs.statSync(projectDir);
+    if (!st.isDirectory()) throw new Error("не каталог");
+  } catch (err) {
+    throw new Error(
+      "Рабочая папка недоступна: " +
+        projectDir +
+        " (" +
+        (err && err.message) +
+        ")",
+    );
+  }
+
+  const parentSessionId =
+    (parentStore && parentStore.state && parentStore.state.currentSessionId) ||
+    null;
+
+  const parent = _profileManager.getProfileById(opts.parentProfileId);
+  if (!parent)
+    throw new Error("Родительский profile не найден: " + opts.parentProfileId);
+
+  // Дочерний profile — копия родителя (тот же id/partition → общая сессия),
+  // но с флагом isSubagent. НЕ сохраняем в profile-list.json.
+  const subProfile = {
+    id: parent.id,
+    providerId: parent.providerId,
+    name: "子代理: " + (opts.agentName || "agent"),
+    partition: parent.partition,
+    isSubagent: true,
+    subagentConfig: {
+      agentName: opts.agentName,
+      task: opts.task,
+      systemPrompt: opts.systemPrompt,
+      tools: opts.tools || null,
+      maxTurns: opts.maxTurns || null,
+      projectDir: projectDir || null,
+    },
+    createdAt: new Date().toISOString(),
+  };
+
+  console.log(
+    "[Subagent] Запуск " +
+      opts.agentName +
+      " (parent=" +
+      opts.parentWindowId +
+      ", projectDir=" +
+      (projectDir || "нет") +
+      ")",
+  );
+  incRunning(opts.parentProfileId);
+
+  const windowId = _createWindow(subProfile);
+
+  // Прокидываем projectDir + lineage + whitelist в контекст дочернего окна.
+  // ВАЖНО: ставим pendingProjectDir — иначе handleUrlChange при загрузке
+  // homeUrl DeepSeek (sessionId ещё нет) сбросит selectedProjectDir в null.
+  // pendingProjectDir привязывается к сессии автоматически, когда она появится.
+  try {
+    const subCtx = windowState.getWindowContext(windowId);
+    if (subCtx && subCtx.sessionStore) {
+      if (projectDir) {
+        subCtx.sessionStore.state.selectedProjectDir = projectDir;
+        subCtx.sessionStore.state.pendingProjectDir = projectDir;
+      }
+      if (parentSessionId) {
+        subCtx.sessionStore.state.pendingLineage = {
+          parentId: parentSessionId,
+          kind: "subagent",
+          agentName: opts.agentName,
+        };
+      }
+    }
+    // Жёсткое ограничение инструментов: если в frontmatter агента
+    // указан список tools — только они разрешены в дочернем окне.
+    if (subCtx) {
+      if (Array.isArray(opts.tools) && opts.tools.length > 0) {
+        subCtx.toolsWhitelist = opts.tools.slice();
+        console.log(
+          "[Subagent] whitelist для " +
+            opts.agentName +
+            ": " +
+            opts.tools.join(", "),
+        );
+      } else {
+        subCtx.toolsWhitelist = null; // без ограничений
+      }
+    }
+  } catch (_) {}
+
+  try {
+    // Отправляем в дочернее окно полный системный промпт Cookie Code
+    // (инструменты + формат cuckoo) вместе с промптом агента и задачей.
+    const subWinCtx = windowState.getWindowContext(windowId);
+    const subWin = subWinCtx ? subWinCtx.win : null;
+    const extra = buildAgentPrompt(opts.systemPrompt, opts.task);
+    await sendInitPromptWhenReady(subWin, projectDir, extra, timeoutMs);
+
+    const text = await waitForDone(windowId, timeoutMs);
+    if (text === "__SUBAGENT_TIMEOUT__")
+      throw new Error("Субагент не ответил за отведённое время");
+    return text;
+  } finally {
+    decRunning(opts.parentProfileId);
+    try {
+      const ctx = windowState.getWindowContext(windowId);
+      if (ctx && ctx.win && !ctx.win.isDestroyed()) ctx.win.close();
+    } catch (_) {}
+  }
+}
+
+module.exports = {
+  injectSubagentDeps,
+  runAgent,
+  onSubagentResponse,
+  hasRunningSubagent,
+};
diff --git a/src/main/window.js b/src/main/window.js
index 64bee73..d4b67ed 100644
--- a/src/main/window.js
+++ b/src/main/window.js
@@ -2,17 +2,35 @@
  * 窗口管理（多窗口 + 每窗口 profile 上下文）
  * 每个窗口关联一个 profileId，拥有独立的 sessionStore 实例。
  */
-const windows = new Map(); // windowId -> { win, profileId, providerId, sessionStore }
+const windows = new Map(); // windowId -> { win, profileId, providerId, sessionStore, isSubagent, subagentConfig }
 let lastActiveWindowId = null;
 
-function addWindow(win, profileId, providerId, sessionStore) {
-  windows.set(win.id, { win, profileId, providerId, sessionStore });
+function addWindow(
+  win,
+  profileId,
+  providerId,
+  sessionStore,
+  isSubagent,
+  subagentConfig,
+) {
+  windows.set(win.id, {
+    win,
+    profileId,
+    providerId,
+    sessionStore,
+    isSubagent: !!isSubagent,
+    subagentConfig: subagentConfig || null,
+    // Ограничение инструментов для субагента (whitelist из agent.tools).
+    // null = без ограничений. Заполняется в subagent.js::runAgent.
+    toolsWhitelist: null,
+  });
   lastActiveWindowId = win.id;
-  win.on('closed', () => {
+  win.on("closed", () => {
     windows.delete(win.id);
     if (lastActiveWindowId === win.id) {
       const remaining = Array.from(windows.keys());
-      lastActiveWindowId = remaining.length > 0 ? remaining[remaining.length - 1] : null;
+      lastActiveWindowId =
+        remaining.length > 0 ? remaining[remaining.length - 1] : null;
     }
   });
 }
@@ -21,7 +39,8 @@ function removeWindow(windowId) {
   windows.delete(windowId);
   if (lastActiveWindowId === windowId) {
     const remaining = Array.from(windows.keys());
-    lastActiveWindowId = remaining.length > 0 ? remaining[remaining.length - 1] : null;
+    lastActiveWindowId =
+      remaining.length > 0 ? remaining[remaining.length - 1] : null;
   }
 }
 
@@ -42,6 +61,33 @@ function getMainWindow() {
   return ctx ? ctx.win : null;
 }
 
+/**
+ * Родительское окно (НЕ субагент). Для TG-бота: команды пользователя
+ * должны всегда попадать в главное окно, даже если открыто окно субагента.
+ * Берём самое свежее не-субагентское окно; если такого нет — падаем на getMainWindow().
+ */
+function getParentWindow() {
+  let fallback = null;
+  for (const [id, ctx] of windows) {
+    if (!ctx.isSubagent && ctx.win && !ctx.win.isDestroyed()) {
+      fallback = ctx.win;
+    }
+  }
+  return fallback || getMainWindow();
+}
+
+/** Родительский контекст (не субагент). Аналогично getParentWindow(). */
+function getParentContext() {
+  let fallback = null;
+  for (const [id, ctx] of windows) {
+    if (!ctx.isSubagent && ctx.win && !ctx.win.isDestroyed()) {
+      fallback = ctx;
+    }
+  }
+  if (fallback) return fallback;
+  return getMainContext();
+}
+
 function getMainContext() {
   if (!lastActiveWindowId) return null;
   return windows.get(lastActiveWindowId) || null;
@@ -56,7 +102,7 @@ function setMainWindow(win) {
 }
 
 function getAllWindows() {
-  return Array.from(windows.values()).map(ctx => ctx.win);
+  return Array.from(windows.values()).map((ctx) => ctx.win);
 }
 
 function getAllContexts() {
@@ -77,6 +123,8 @@ module.exports = {
   getContextByWebContents,
   getMainWindow,
   getMainContext,
+  getParentWindow,
+  getParentContext,
   setMainWindow,
   getAllWindows,
   getAllContexts,
diff --git a/src/preload/api.js b/src/preload/api.js
index db9dbc2..34a9fb6 100644
--- a/src/preload/api.js
+++ b/src/preload/api.js
@@ -231,6 +231,16 @@ let electronAPI = {
   chromaKeyPet: (file, color, tolerance) => {
     return ipcRenderer.invoke("cuckoo-pets-chroma", { file, color, tolerance });
   },
+  // ========== Память AI (userData/memory.md) ==========
+  openMemoryFile: () => {
+    return ipcRenderer.invoke("cuckoo-memory-open-file");
+  },
+  clearMemory: () => {
+    return ipcRenderer.invoke("cuckoo-memory-clear");
+  },
+  getMemoryStats: () => {
+    return ipcRenderer.invoke("cuckoo-memory-stats");
+  },
   // ========== Todo-задачи ==========
   getTodos: () => {
     return ipcRenderer.invoke("todo-get");
diff --git a/src/preload/dom/settings-tab.js b/src/preload/dom/settings-tab.js
index 094be17..83ea1f6 100644
--- a/src/preload/dom/settings-tab.js
+++ b/src/preload/dom/settings-tab.js
@@ -102,6 +102,8 @@ function activateCuckooTab() {
     // Подтверждение инструментов + скрытие служебных сообщений
     bindAgentSettings();
     refreshAgentSettings();
+    // Память AI
+    bindMemoryButtons();
     // Чубрики (петы)
     bindPetsSection();
     // Шрифт
@@ -583,6 +585,23 @@ function buildContentHTML() {
     "  </label>" +
     "  </div>" +
     "</div>" +
+    // ===== Память AI =====
+    '<div data-cat="system">' +
+    '  <div class="cuckoo-section-title">' +
+    t("settings.section.memory") +
+    "</div>" +
+    '  <div class="ck-btn-row" style="margin-bottom:10px;">' +
+    '    <button id="cuckoo-memory-open-file" class="ck-btn">' +
+    t("settings.memory.openFile") +
+    "</button>" +
+    '    <button id="cuckoo-memory-clear" class="ck-btn">' +
+    t("settings.memory.clear") +
+    "</button>" +
+    "  </div>" +
+    '  <div class="ck-row-hint" id="cuckoo-memory-stats">' +
+    t("settings.memory.hint") +
+    "</div>" +
+    "</div>" +
     // ===== Чубрики (петы) =====
     buildPetsSection() +
     '<div data-cat="bg">' +
@@ -1704,6 +1723,69 @@ function bindFontGrid() {
   });
 }
 
+/**
+ * Секция «Память»: открыть файл памяти + очистить.
+ */
+function bindMemoryButtons() {
+  const openBtn = document.querySelector(
+    "#" + TAB_CONTENT_ID + " #cuckoo-memory-open-file",
+  );
+  if (openBtn) {
+    openBtn.addEventListener("click", async () => {
+      try {
+        await window.electronAPI.openMemoryFile();
+      } catch (err) {
+        console.error(
+          "[Cookie Code] Не удалось открыть файл памяти:",
+          err.message,
+        );
+      }
+    });
+  }
+  const clearBtn = document.querySelector(
+    "#" + TAB_CONTENT_ID + " #cuckoo-memory-clear",
+  );
+  if (clearBtn) {
+    clearBtn.addEventListener("click", async () => {
+      const ok = window.confirm(t("settings.memory.clearConfirm"));
+      if (!ok) return;
+      try {
+        await window.electronAPI.clearMemory();
+        await refreshMemoryStats();
+      } catch (err) {
+        console.error("[Cookie Code] Не удалось очистить память:", err.message);
+      }
+    });
+  }
+  refreshMemoryStats();
+}
+
+/**
+ * Обновить подпись под кнопками памяти (путь, размер, число записей).
+ */
+async function refreshMemoryStats() {
+  const el = document.querySelector(
+    "#" + TAB_CONTENT_ID + " #cuckoo-memory-stats",
+  );
+  if (!el) return;
+  try {
+    const res = await window.electronAPI.getMemoryStats();
+    if (!res || !res.success) return;
+    const kb = Math.max(1, Math.round((res.bytes || 0) / 1024));
+    el.textContent =
+      (res.path || "") +
+      " · " +
+      (res.entries || 0) +
+      " " +
+      t("settings.memory.entries") +
+      " · " +
+      kb +
+      " KB";
+  } catch (_) {
+    /* оставляем дефолтную подпись */
+  }
+}
+
 /**
  * Кнопки «Открыть папку шрифтов» и «Обновить».
  */
diff --git a/src/preload/dom/subagent-watch.js b/src/preload/dom/subagent-watch.js
new file mode 100644
index 0000000..5a1a6d8
--- /dev/null
+++ b/src/preload/dom/subagent-watch.js
@@ -0,0 +1,203 @@
+/**
+ * Наблюдатель за ответами AI в окне-субагенте.
+ *
+ * Активируется только если окно открыто с аргументом --cuckoo-subagent=...
+ * (main передал конфиг агента). Задачу и полный системный промпт main-процесс
+ * шлёт через initial-prompt; здесь мы только ждём финальный ответ субагента
+ * (без tool-блоков) и передаём его текст в main.
+ *
+ * Детект финала: НЕ полагаемся на isAIResponseComplete() (в deepseek.js
+ * он инвертирован), а используем только стабильность текста:
+ *   - последнее AI-сообщение не менялось STABLE_MS миллисекунд
+ *   - в нём нет cuckoo-блоков (значит, агент не вызывает инструменты)
+ */
+const { ipcRenderer } = require("electron");
+const { getProviderByUrl } = require("../../../src/providers");
+const { getJsCodeBlocksFromMarkdown } = require("./js-detector");
+
+const STABLE_MS = 2500; // тишина, после которой считаем ответ финальным
+const POLL_MS = 700;
+const MAX_WAIT_MS = 10 * 60 * 1000; // абсолютный лимит
+
+/** Разбор --cuckoo-subagent=<encoded JSON> из process.argv */
+function readConfig() {
+  try {
+    const argv = (typeof process !== "undefined" && process.argv) || [];
+    const arg = argv.find(
+      (a) => typeof a === "string" && a.startsWith("--cuckoo-subagent="),
+    );
+    if (!arg) return null;
+    const json = decodeURIComponent(arg.slice("--cuckoo-subagent=".length));
+    const cfg = JSON.parse(json);
+    if (!cfg || !cfg.agentName || !cfg.task) return null;
+    return cfg;
+  } catch (_) {
+    return null;
+  }
+}
+
+/** Текст последнего AI-сообщения (markdown-контейнер) + сам DOM */
+function getLastAiText() {
+  try {
+    const provider = getProviderByUrl(window.location.href);
+    if (!provider || typeof provider.getMessageCandidates !== "function")
+      return null;
+    const msgs = provider.getMessageCandidates();
+    if (!msgs || msgs.length === 0) return null;
+    const last = msgs[msgs.length - 1];
+    const md = provider.getMessageMarkdown
+      ? provider.getMessageMarkdown(last)
+      : last.querySelector(".ds-markdown");
+    if (!md) return null;
+    const text = (md.textContent || md.innerText || "").trim();
+    return { text, md };
+  } catch (_) {
+    return null;
+  }
+}
+
+/**
+ * Показать рабочую папку в overlay дочернего окна (двойная попытка —
+ * initProjectDirSection сбрасывает панель в null при инициализации).
+ */
+function showProjectDir(cfg) {
+  if (!cfg.projectDir) return;
+  try {
+    const projectDirPanel = require("../overlay/project-dir");
+    const show = () => {
+      try {
+        projectDirPanel.updateProjectDirDisplay(cfg.projectDir);
+        console.log(
+          "[Cookie Code][Subagent] рабочая папка показана: " + cfg.projectDir,
+        );
+      } catch (_) {}
+    };
+    setTimeout(show, 800);
+    setTimeout(show, 2500);
+  } catch (err) {
+    console.error(
+      "[Cookie Code][Subagent] не удалось показать папку:",
+      err && err.message,
+    );
+  }
+}
+
+/**
+ * Если окно — субагент, запустить цикл наблюдения за финальным ответом.
+ */
+function initSubagentWatch() {
+  const cfg = readConfig();
+  if (!cfg) return null;
+
+  console.log("[Cookie Code][Subagent] активирован: " + cfg.agentName);
+  showProjectDir(cfg);
+
+  const maxTurns = cfg.maxTurns || null;
+  let turnCount = 0;
+  let lastSentText = "";
+  let lastSnapshot = "";
+  let lastChangeAt = Date.now();
+  let everSawText = false; // начал ли субагент вообще отвечать
+  let sent = false;
+  const startedAt = Date.now();
+
+  const finish = (text, partial) => {
+    sent = true;
+    clearInterval(timer);
+    console.log(
+      "[Cookie Code][Subagent] " +
+        (partial ? "частичный ответ" : "финальный ответ") +
+        " (" +
+        String(text || "").length +
+        " символов)",
+    );
+    ipcRenderer
+      .invoke("subagent-response", {
+        text: String(text || ""),
+        done: !partial,
+        partial: !!partial,
+        turns: turnCount,
+      })
+      .catch(() => {});
+  };
+
+  const timer = setInterval(() => {
+    if (sent) return;
+    if (Date.now() - startedAt > MAX_WAIT_MS) {
+      finish("__SUBAGENT_TIMEOUT__", false);
+      return;
+    }
+    try {
+      const got = getLastAiText();
+      if (!got || !got.text) return;
+
+      const snapshot = got.text;
+      if (snapshot !== lastSnapshot) {
+        // Текст изменился — ждём стабилизации.
+        lastSnapshot = snapshot;
+        lastChangeAt = Date.now();
+        everSawText = true;
+        return;
+      }
+      // Текст не менялся — проверяем, устоялся ли.
+      if (Date.now() - lastChangeAt < STABLE_MS) return;
+
+      // Устоявшийся текст. Проверяем, есть ли в нём cuckoo-блоки.
+      const blocks = (() => {
+        try {
+          return getJsCodeBlocksFromMarkdown(got.md) || [];
+        } catch (_) {
+          return [];
+        }
+      })();
+
+      if (blocks.length === 0) {
+        // Финальный текстовый ответ (либо без блоков вообще, либо уже не
+        // дописывает новые). Отправляем и выходим.
+        if (snapshot === lastSentText) return;
+        lastSentText = snapshot;
+        finish(snapshot, false);
+        return;
+      }
+
+      // Есть tool-блоки = промежуточный шаг. Учитываем лимит шагов.
+      turnCount++;
+      if (maxTurns && turnCount >= maxTurns) {
+        finish(snapshot, true);
+      } else {
+        console.log(
+          "[Cookie Code][Subagent] шаг " +
+            turnCount +
+            " (tool-блоков: " +
+            blocks.length +
+            "), ждём продолжения",
+        );
+        // Сброс, чтобы следующая правка текста засчиталась как новое изменение.
+        lastSnapshot = "";
+      }
+    } catch (err) {
+      console.error(
+        "[Cookie Code][Subagent] ошибка цикла:",
+        err && err.message,
+      );
+    }
+  }, POLL_MS);
+
+  // Страховка: если субагент не начал отвечать за 3 минуты — сообщаем
+  // родителю, что, похоже, отправка промпта не сработала.
+  setTimeout(
+    () => {
+      if (!sent && !everSawText) {
+        console.warn(
+          "[Cookie Code][Subagent] ответ не начался за 3 минуты — возможно, " +
+            "initial-prompt не отправился",
+        );
+      }
+    },
+    3 * 60 * 1000,
+  );
+
+  return cfg;
+}
+
+module.exports = { initSubagentWatch, readConfig };
diff --git a/src/preload/i18n/i18n.js b/src/preload/i18n/i18n.js
index eaad759..92a0583 100644
--- a/src/preload/i18n/i18n.js
+++ b/src/preload/i18n/i18n.js
@@ -533,6 +533,22 @@ const KEYS = {
     ru: "Свои картинки: положите файлы (.webp/.jpg/.png/.gif) в папку и нажмите «Обновить».",
     en: "Custom images: drop files (.webp/.jpg/.png/.gif) into the folder and click Refresh.",
   },
+  // ---- Память AI ----
+  "settings.section.memory": { ru: "Память", en: "Memory" },
+  "settings.memory.openFile": {
+    ru: "Открыть файл памяти",
+    en: "Open memory file",
+  },
+  "settings.memory.clear": { ru: "Очистить память", en: "Clear memory" },
+  "settings.memory.clearConfirm": {
+    ru: "Удалить все записи памяти? Действие необратимо.",
+    en: "Delete all memory entries? This cannot be undone.",
+  },
+  "settings.memory.entries": { ru: "записей", en: "entries" },
+  "settings.memory.hint": {
+    ru: "AI запоминает факты о вас и вашей системе. Файл памяти: <userData>/memory.md",
+    en: "The AI remembers facts about you and your system. Memory file: <userData>/memory.md",
+  },
   // ---- Шрифт ----
   "settings.section.font": { ru: "Шрифт", en: "Font" },
   "settings.font.openFolder": {
diff --git a/src/preload/index.js b/src/preload/index.js
index 337c51b..75cd081 100644
--- a/src/preload/index.js
+++ b/src/preload/index.js
@@ -39,6 +39,7 @@ const whatsNew = require("./dom/whats-new");
 const i18n = require("./i18n/i18n");
 const state = require("./dom/state");
 const tokenInterceptor = require("./dom/token-interceptor");
+const subagentWatch = require("./dom/subagent-watch");
 const { getProviderByUrl } = require("../providers");
 const { safe } = require("./dom/safe");
 
@@ -90,6 +91,10 @@ async function init() {
     // чтобы поймать первый же запрос completion. Работает через safe().
     safe("init.tokenInterceptor", () => tokenInterceptor.install());
 
+    // Субагент: если окно открыто с --cuckoo-subagent=..., запускаем цикл
+    // наблюдения за финальным ответом и отправляем его в main-процесс.
+    safe("init.subagentWatch", () => subagentWatch.initSubagentWatch());
+
     // Регистрируем IPC-листенеры всегда — от них зависит ввод и парсинг tool-блоков
     safe("init.registerIpcListeners", () => chatInput.registerIpcListeners());
     safe("init.registerAskUserQuestionListener", () =>
@@ -192,8 +197,6 @@ async function init() {
     // Принудительно держим тёмную тему DeepSeek
     safe("init.forceDarkThemeStart", () => forceDarkTheme.startWatch());
 
-
-
     // Подмена QR-кода в попапе «Скачать приложение»
     safe("init.qrOverrideStart", () => qrOverride.startWatch());
 
diff --git a/src/prompt/deepseek.md b/src/prompt/deepseek.md
index 3370e87..a5dbdde 100644
--- a/src/prompt/deepseek.md
+++ b/src/prompt/deepseek.md
@@ -8,7 +8,7 @@
 
 - 当前工作目录：由系统初始化时注入（通过 projectDir 变量提供）
 - 工作目录与项目根目录可能不同；相对路径基于 projectDir 解析
-{{PLATFORM_INFO}}
+  {{PLATFORM_INFO}}
 - 若需确认当前目录，请使用 pwd 命令（Unix/macOS）或 cd 命令（Windows cmd 无 pwd；echo %cd% 也可用）
 
 ## 回复风格
@@ -19,7 +19,7 @@
 
 ## 关于工具调用
 
-- 需要调用工具时，将 JavaScript 代码输出到以 ```cuckoo 开头、以 ``` 结尾的代码块中，代码块外不要有任何文字
+- 需要调用工具时，将 JavaScript 代码输出到以 `cuckoo 开头、以 ` 结尾的代码块中，代码块外不要有任何文字
 - 所有工具函数都是异步的，调用时必须使用 await
 - 多行文本一律使用反引号（`）模板字符串，直接换行，不需要任何转义
 - 不要输出 JSON 格式的工具调用，也不要对字符串做 JSON 转义
@@ -27,6 +27,7 @@
 ## 核心原则
 
 ### 1. 先思考，再编码
+
 - 在编写任何代码之前，先对问题进行充分的逻辑推理。
 - 考虑边界情况、隐藏的假设和备选方案。
 - 如果问题描述模糊，先提出澄清性问题，再继续推进。
@@ -34,18 +35,21 @@
 - 有疑问先提出，提出疑问的方式为：先问一个问题，用户回答后再问下一个问题。
 
 ### 2. 简洁至上
+
 - 优先选择能满足需求的最简单的解决方案。
 - 避免过度工程、投机性的泛化或过早优化。
 - 编写的代码应当可读性强、意图明显、便于后续修改。
 - 除非用户明确要求，否则不要擅自添加"锦上添花"的功能。
 
 ### 3. 精准修改（外科手术式修改）
+
 - 修改现有代码时，尽可能缩小改动范围。
 - 不要顺手格式化、重构或清理无关代码（除非用户明确要求）。
 - 每次编辑应有单一、清晰的目标，并精准定位。
 - 避免"来都来了"式的连带改动，牵扯多个文件或模块。
 
 ### 4. 目标驱动执行
+
 - 始终牢记最终目标。
 - 在交付解决方案之前，验证它是否真正解决了原始问题。
 - 事先定义成功标准，并对照标准测试你的改动。
@@ -65,15 +69,23 @@
 - 相对路径基于当前项目根目录（projectDir）解析
 - 工具出错时抛出异常（Error.message 为错误描述）；唯一例外是 bash()/pwsh()：非零退出不抛异常，通过返回文本中的 [exit code] 标记报告
 - 此部分与 tools/cuckoo-tools.d.ts 保持一致
-```ts 
-{{TOOL_API_TYPES}}
+
+```ts
+{
+  {
+    TOOL_API_TYPES;
+  }
+}
 ```
 
 ---
 
 ## 工具使用指导
+
 {{TOOL_SECTIONS}}
 
+{{AGENTS_SECTION}}
+
 ---
 
 # 工具使用规则
@@ -97,7 +109,7 @@ await write("src/utils/helper.js", content.replace("formatDate", "formatTime"));
 
 ### 输出前自查清单
 
-1. 代码块以 ```cuckoo 开头、以 ``` 结尾
+1. 代码块以 `cuckoo 开头、以 ` 结尾
 2. 代码块外不要有任何文字
 3. 每个工具函数调用前都写 await
 4. 多行文本一律使用反引号（`）模板字符串，直接换行，不做 \n 转义
@@ -161,6 +173,7 @@ log(r);
 ## 错误处理
 
 如果脚本执行失败，系统会返回错误信息。你应该：
+
 1. 分析错误原因（文件不存在、old_string 不匹配、语法错误等）
 2. 修正代码后重新输出完整的 ```cuckoo 代码块
 
@@ -171,7 +184,6 @@ log(r);
 ❌ 不要编造不存在的工具函数或参数
 ❌ 不要在用户未授权时执行破坏性操作（删除文件、格式化磁盘等）
 
-
 {{PROJECT_INTRO_SECTION}}
 
 {{SKILL_SECTION}}
@@ -179,6 +191,7 @@ log(r);
 ---
 
 ## 当前项目目录
+
 当前项目路径: {{PROJECT_DIR}}
 
 ---
diff --git a/src/prompt/default.md b/src/prompt/default.md
index 4c24c24..a5dbdde 100644
--- a/src/prompt/default.md
+++ b/src/prompt/default.md
@@ -8,7 +8,7 @@
 
 - 当前工作目录：由系统初始化时注入（通过 projectDir 变量提供）
 - 工作目录与项目根目录可能不同；相对路径基于 projectDir 解析
-{{PLATFORM_INFO}}
+  {{PLATFORM_INFO}}
 - 若需确认当前目录，请使用 pwd 命令（Unix/macOS）或 cd 命令（Windows cmd 无 pwd；echo %cd% 也可用）
 
 ## 回复风格
@@ -19,7 +19,7 @@
 
 ## 关于工具调用
 
-- 需要调用工具时，将 JavaScript 代码输出到以 ```cuckoo 开头、以 ``` 结尾的代码块中，代码块外不要有任何文字
+- 需要调用工具时，将 JavaScript 代码输出到以 `cuckoo 开头、以 ` 结尾的代码块中，代码块外不要有任何文字
 - 所有工具函数都是异步的，调用时必须使用 await
 - 多行文本一律使用反引号（`）模板字符串，直接换行，不需要任何转义
 - 不要输出 JSON 格式的工具调用，也不要对字符串做 JSON 转义
@@ -27,6 +27,7 @@
 ## 核心原则
 
 ### 1. 先思考，再编码
+
 - 在编写任何代码之前，先对问题进行充分的逻辑推理。
 - 考虑边界情况、隐藏的假设和备选方案。
 - 如果问题描述模糊，先提出澄清性问题，再继续推进。
@@ -34,18 +35,21 @@
 - 有疑问先提出，提出疑问的方式为：先问一个问题，用户回答后再问下一个问题。
 
 ### 2. 简洁至上
+
 - 优先选择能满足需求的最简单的解决方案。
 - 避免过度工程、投机性的泛化或过早优化。
 - 编写的代码应当可读性强、意图明显、便于后续修改。
 - 除非用户明确要求，否则不要擅自添加"锦上添花"的功能。
 
 ### 3. 精准修改（外科手术式修改）
+
 - 修改现有代码时，尽可能缩小改动范围。
 - 不要顺手格式化、重构或清理无关代码（除非用户明确要求）。
 - 每次编辑应有单一、清晰的目标，并精准定位。
 - 避免"来都来了"式的连带改动，牵扯多个文件或模块。
 
 ### 4. 目标驱动执行
+
 - 始终牢记最终目标。
 - 在交付解决方案之前，验证它是否真正解决了原始问题。
 - 事先定义成功标准，并对照标准测试你的改动。
@@ -65,15 +69,23 @@
 - 相对路径基于当前项目根目录（projectDir）解析
 - 工具出错时抛出异常（Error.message 为错误描述）；唯一例外是 bash()/pwsh()：非零退出不抛异常，通过返回文本中的 [exit code] 标记报告
 - 此部分与 tools/cuckoo-tools.d.ts 保持一致
+
 ```ts
-{{TOOL_API_TYPES}}
+{
+  {
+    TOOL_API_TYPES;
+  }
+}
 ```
 
 ---
 
 ## 工具使用指导
+
 {{TOOL_SECTIONS}}
 
+{{AGENTS_SECTION}}
+
 ---
 
 # 工具使用规则
@@ -97,7 +109,7 @@ await write("src/utils/helper.js", content.replace("formatDate", "formatTime"));
 
 ### 输出前自查清单
 
-1. 代码块以 ```cuckoo 开头、以 ``` 结尾
+1. 代码块以 `cuckoo 开头、以 ` 结尾
 2. 代码块外不要有任何文字
 3. 每个工具函数调用前都写 await
 4. 多行文本一律使用反引号（`）模板字符串，直接换行，不做 \n 转义
@@ -161,6 +173,7 @@ log(r);
 ## 错误处理
 
 如果脚本执行失败，系统会返回错误信息。你应该：
+
 1. 分析错误原因（文件不存在、old_string 不匹配、语法错误等）
 2. 修正代码后重新输出完整的 ```cuckoo 代码块
 
@@ -171,7 +184,6 @@ log(r);
 ❌ 不要编造不存在的工具函数或参数
 ❌ 不要在用户未授权时执行破坏性操作（删除文件、格式化磁盘等）
 
-
 {{PROJECT_INTRO_SECTION}}
 
 {{SKILL_SECTION}}
@@ -179,6 +191,7 @@ log(r);
 ---
 
 ## 当前项目目录
+
 当前项目路径: {{PROJECT_DIR}}
 
 ---
diff --git a/tools/AgentTools.js b/tools/AgentTools.js
new file mode 100644
index 0000000..31c0715
--- /dev/null
+++ b/tools/AgentTools.js
@@ -0,0 +1,100 @@
+/**
+ * Инструменты для работы с субагентами (agents).
+ *   - run_agent  : делегировать задачу субагенту
+ *   - list_agents: показать доступные субагенты (проект + пользователь)
+ *   - read_agent : прочитать полный systemPrompt субагента (для отладки)
+ */
+const { Tool, ToolResult } = require("./ToolRegistry");
+const { scanAgents } = require("../src/main/agents");
+
+class ListAgentsTool extends Tool {
+  constructor() {
+    super(
+      "list_agents",
+      "Список доступных субагентов (проект + пользователь). Показывает name, description, tools, maxTurns.",
+      {
+        type: "object",
+        properties: {},
+        required: [],
+        additionalProperties: false,
+      },
+      "list_agents()",
+    );
+  }
+  async execute(params) {
+    const agents = scanAgents(params && params.projectDir);
+    if (agents.length === 0)
+      return ToolResult.success("(нет доступных субагентов)");
+    const text = agents
+      .map((a) => {
+        const t = a.tools && a.tools.length ? a.tools.join(", ") : "(все)";
+        const m = a.maxTurns ? String(a.maxTurns) : "(без лимита)";
+        return (
+          "- " +
+          a.name +
+          " [" +
+          a.source +
+          "]\n" +
+          "    description: " +
+          a.description +
+          "\n" +
+          "    tools: " +
+          t +
+          "\n" +
+          "    maxTurns: " +
+          m +
+          "\n" +
+          "    path: " +
+          a.agentPath
+        );
+      })
+      .join("\n\n");
+    return ToolResult.success(text);
+  }
+}
+
+class ReadAgentTool extends Tool {
+  constructor() {
+    super(
+      "read_agent",
+      "Прочитать полный systemPrompt субагента по имени. Полезно для отладки определения агента.",
+      {
+        type: "object",
+        properties: { name: { type: "string", description: "Имя субагента" } },
+        required: ["name"],
+        additionalProperties: false,
+      },
+      "read_agent(name)",
+    );
+  }
+  async execute(params) {
+    const { name, projectDir } = params || {};
+    if (!name) return ToolResult.error("Поле name обязательно");
+    const agent = scanAgents(projectDir || null).find((a) => a.name === name);
+    if (!agent) return ToolResult.error("Субагент не найден: " + name);
+    return ToolResult.success(
+      "name: " +
+        agent.name +
+        "\n" +
+        "source: " +
+        agent.source +
+        "\n" +
+        "path: " +
+        agent.agentPath +
+        "\n" +
+        "description: " +
+        agent.description +
+        "\n" +
+        "tools: " +
+        (agent.tools ? agent.tools.join(", ") : "(все)") +
+        "\n" +
+        "maxTurns: " +
+        (agent.maxTurns || "(без лимита)") +
+        "\n\n" +
+        "--- SYSTEM PROMPT ---\n" +
+        agent.systemPrompt,
+    );
+  }
+}
+
+module.exports = { ListAgentsTool, ReadAgentTool };
diff --git a/tools/CreateAgentTool.js b/tools/CreateAgentTool.js
new file mode 100644
index 0000000..de2ea6b
--- /dev/null
+++ b/tools/CreateAgentTool.js
@@ -0,0 +1,212 @@
+/**
+ * create_agent — создание нового субагента.
+ *
+ * AI создаёт специалиста под задачу: файл <projectDir>/cookie/agents/<name>.md
+ * становится сразу доступен для run_agent.
+ */
+const { Tool, ToolResult } = require("./ToolRegistry");
+const fs = require("fs");
+const path = require("path");
+
+const NAME_RE = /^[A-Za-z0-9_-]{1,64}$/;
+const MAX_DESC = 200;
+const MAX_PROMPT = 20000;
+
+let _allowedTools = null;
+function getAllowedTools() {
+  if (_allowedTools) return _allowedTools;
+  try {
+    const { registry } = require("./index");
+    _allowedTools = new Set(registry.listNames());
+  } catch (_) {
+    _allowedTools = new Set();
+  }
+  return _allowedTools;
+}
+
+function escapeYaml(str) {
+  return String(str).replace(/\r?\n/g, " ").trim();
+}
+
+function buildAgentFile(input) {
+  const fm = [];
+  fm.push("---");
+  fm.push("name: " + input.name);
+  fm.push("description: " + escapeYaml(input.description));
+  if (Array.isArray(input.tools) && input.tools.length > 0) {
+    fm.push("tools: " + input.tools.join(", "));
+  }
+  if (typeof input.maxTurns === "number") {
+    fm.push("maxTurns: " + input.maxTurns);
+  }
+  fm.push("---");
+  fm.push("");
+  fm.push(String(input.systemPrompt).trim());
+  fm.push("");
+  return fm.join("\n");
+}
+
+class CreateAgentTool extends Tool {
+  constructor() {
+    super(
+      "create_agent",
+      "Создать нового субагента (cookie/agents/<name>.md). Сразу доступен для run_agent.",
+      {
+        type: "object",
+        properties: {
+          name: {
+            type: "string",
+            description: "Имя: латиница, цифры, дефис, _. 1..64",
+          },
+          description: {
+            type: "string",
+            description: "Когда делегировать (<=200)",
+          },
+          systemPrompt: {
+            type: "string",
+            description: "Системный промпт агента",
+          },
+          tools: {
+            type: "array",
+            items: { type: "string" },
+            description: "Разрешённые инструменты (пусто = все)",
+          },
+          maxTurns: { type: "number", description: "Лимит шагов 1..1000" },
+          overwrite: {
+            type: "boolean",
+            description: "Перезаписать существующего",
+          },
+        },
+        required: ["name", "description", "systemPrompt"],
+        additionalProperties: false,
+      },
+      "create_agent({name, description, systemPrompt, tools?, maxTurns?, overwrite?})",
+    );
+  }
+
+  getPromptSection() {
+    return {
+      name: "tool:create_agent",
+      order: 114,
+      text:
+        "Используй create_agent(...) чтобы создать нового субагента под задачу. " +
+        "После создания агент сразу доступен для run_agent. Создавай только когда " +
+        "задача повторяющаяся или требует отдельного контекста.",
+    };
+  }
+
+  async execute(params) {
+    const {
+      name,
+      description,
+      systemPrompt,
+      tools,
+      maxTurns,
+      overwrite,
+      projectDir,
+    } = params || {};
+
+    if (typeof name !== "string" || !NAME_RE.test(name)) {
+      return ToolResult.error(
+        "Некорректное имя: латиница/цифры/дефис/_, 1..64",
+      );
+    }
+    if (
+      typeof description !== "string" ||
+      !description.trim() ||
+      description.length > MAX_DESC
+    ) {
+      return ToolResult.error("description обязателен, <= " + MAX_DESC);
+    }
+    if (typeof systemPrompt !== "string" || !systemPrompt.trim()) {
+      return ToolResult.error("systemPrompt обязателен");
+    }
+    if (systemPrompt.length > MAX_PROMPT) {
+      return ToolResult.error(
+        "systemPrompt слишком длинный (> " + MAX_PROMPT + ")",
+      );
+    }
+
+    let toolList;
+    if (Array.isArray(tools) && tools.length > 0) {
+      const allowed = getAllowedTools();
+      const bad = [];
+      toolList = [];
+      for (const t of tools) {
+        const s = String(t || "").trim();
+        if (!s) continue;
+        if (allowed.size > 0 && !allowed.has(s)) bad.push(s);
+        toolList.push(s);
+      }
+      if (bad.length > 0) {
+        return ToolResult.error("Неизвестные инструменты: " + bad.join(", "));
+      }
+    }
+
+    let turns;
+    if (maxTurns != null) {
+      const n = Number(maxTurns);
+      if (!Number.isInteger(n) || n < 1 || n > 1000) {
+        return ToolResult.error("maxTurns должен быть целым 1..1000");
+      }
+      turns = n;
+    }
+
+    if (!projectDir) {
+      return ToolResult.error(
+        "Не инициализирован проект — некуда положить cookie/agents/",
+      );
+    }
+    const agentsDir = path.join(projectDir, "cookie", "agents");
+    try {
+      fs.mkdirSync(agentsDir, { recursive: true });
+    } catch (err) {
+      return ToolResult.error("Не удалось создать каталог: " + err.message);
+    }
+    const filePath = path.join(agentsDir, name + ".md");
+    if (fs.existsSync(filePath) && overwrite !== true) {
+      return ToolResult.error(
+        "Агент уже существует: " + name + ". Укажи overwrite: true для замены.",
+      );
+    }
+
+    const fileText = buildAgentFile({
+      name,
+      description: description.trim(),
+      tools: toolList,
+      maxTurns: turns,
+      systemPrompt: systemPrompt.trim(),
+    });
+
+    try {
+      fs.writeFileSync(filePath, fileText, "utf-8");
+    } catch (err) {
+      return ToolResult.error("Запись не удалась: " + err.message);
+    }
+
+    try {
+      const windowState = require("../src/main/window");
+      const { scanAgents, buildAgentsSection } = require("../src/main/agents");
+      const agents = scanAgents(projectDir);
+      const section = buildAgentsSection(agents);
+      const win = windowState.getMainWindow();
+      if (win && !win.isDestroyed()) {
+        win.webContents.send("agents-section-updated", section);
+      }
+    } catch (_) {}
+
+    const rel = path.relative(projectDir, filePath).replace(/\\/g, "/");
+    const lines = [];
+    lines.push("Создан агент: " + name);
+    lines.push("Путь: " + rel);
+    lines.push(
+      "tools: " + (toolList && toolList.length ? toolList.join(", ") : "(все)"),
+    );
+    lines.push("maxTurns: " + (turns || "(без лимита)"));
+    lines.push("");
+    lines.push('Теперь можно вызвать: run_agent("' + name + '", "<задача>")');
+    return ToolResult.success(lines.join("\n"));
+  }
+}
+
+module.exports = { CreateAgentTool };
diff --git a/tools/JsRunner.js b/tools/JsRunner.js
index 72e732b..b5ddbff 100644
--- a/tools/JsRunner.js
+++ b/tools/JsRunner.js
@@ -182,15 +182,38 @@ const BOOTSTRAP = [
   "    return await __call('read_photo', { file_path: filePath, caption: caption || '', send: send !== false });",
   "  };",
   "  globalThis.attachFile = async function (filePathOrPayload) {",
-    "    var payload = typeof filePathOrPayload === 'string'",
-    "      ? { filePath: filePathOrPayload }",
-    "      : (filePathOrPayload || {});",
-    "    return await __call('attach_file', payload);",
-    "  };",
-    "  globalThis.attachTelegram = async function (filePath, caption, comment) {",
-        "    return await __call('attach_telegram', { filePath: filePath, caption: caption || '', comment: comment || '' });",
-        "  };",
-    "  globalThis.exitPlanMode = async function (plan) {",
+  "    var payload = typeof filePathOrPayload === 'string'",
+  "      ? { filePath: filePathOrPayload }",
+  "      : (filePathOrPayload || {});",
+  "    return await __call('attach_file', payload);",
+  "  };",
+  "  globalThis.attachTelegram = async function (filePath, caption, comment) {",
+  "    return await __call('attach_telegram', { filePath: filePath, caption: caption || '', comment: comment || '' });",
+  "  };",
+  "  globalThis.memorySave = async function (text) {",
+  "    return await __call('memory_save', { text: text });",
+  "  };",
+  "  globalThis.memoryRead = async function () {",
+  "    return await __call('memory_read', {});",
+  "  };",
+  "  globalThis.memoryClear = async function () {",
+  "    return await __call('memory_clear', {});",
+  "  };",
+  "  globalThis.runAgent = async function (name, task) {",
+  "    return await __call('run_agent', { name: name, task: task });",
+  "  };",
+  "  globalThis.run_agent = globalThis.runAgent;",
+  "  globalThis.listAgents = async function () {",
+  "    return await __call('list_agents', {});",
+  "  };",
+  "  globalThis.readAgent = async function (name) {",
+  "    return await __call('read_agent', { name: name });",
+  "  };",
+  "  globalThis.createAgent = async function (opts) {",
+  "    return await __call('create_agent', opts || {});",
+  "  };",
+  "  globalThis.create_agent = globalThis.createAgent;",
+  "  globalThis.exitPlanMode = async function (plan) {",
   "    return await __call('exit_plan_mode', { plan: plan });",
   "  };",
   "  globalThis.exit_plan_mode = globalThis.exitPlanMode;",
@@ -350,6 +373,9 @@ class JsRunner {
     exitPlanMode,
     sessionId,
     attachFile,
+    currentWindowId,
+    toolsWhitelist,
+    agentName,
   ) {
     if (!code || typeof code !== "string" || !code.trim()) {
       return { success: false, error: "无效的 JS 代码" };
@@ -389,6 +415,27 @@ class JsRunner {
         /* plan-mode недоступен — не блокируем */
       }
 
+      // ===== Whitelist инструментов для субагента =====
+      // Если окно — субагент с ограниченным набором (frontmatter tools),
+      // любой вызов вне списка отклоняется ДО исполнения.
+      if (Array.isArray(toolsWhitelist)) {
+        // Внутренние алиасы → публичные имена
+        const ALIAS = { __bash: "bash" };
+        const toolName = ALIAS[op] || op;
+        if (toolsWhitelist.indexOf(toolName) === -1) {
+          return JSON.stringify({
+            success: false,
+            error:
+              "Инструмент «" +
+              toolName +
+              "» не разрешён этому агенту. " +
+              "Разрешены: " +
+              toolsWhitelist.join(", ") +
+              ".",
+          });
+        }
+      }
+
       let result;
       if (op === "__bash") {
         result = await runBash(args, projectDir);
@@ -402,6 +449,10 @@ class JsRunner {
               Object.assign({}, args, {
                 projectDir,
                 senderId,
+                currentWindowId:
+                  typeof currentWindowId === "number"
+                    ? currentWindowId
+                    : senderId,
                 askUserQuestion,
                 pasteImage,
                 exitPlanMode,
@@ -444,7 +495,13 @@ class JsRunner {
         const exitMatch = String(preview).match(/\[exit code:\s*(-?\d+)\]/);
         const hasBadExit = !!(exitMatch && exitMatch[1] !== "0");
         const ok = !!result.success && !hasBadExit;
-        notifyToolResult(label, ok, { args: args, preview: preview });
+        notifyToolResult(label, ok, {
+          args: args,
+          preview: preview,
+          // Если вызов идёт из окна-субагента — указываем имя агента,
+          // чтобы в TG уведомление было в стиле «🤖 Агент: explore → 📖 read».
+          agentName: agentName || null,
+        });
       } catch (_) {}
       return JSON.stringify(result);
     };
diff --git a/tools/MemoryTool.js b/tools/MemoryTool.js
new file mode 100644
index 0000000..5d888dd
--- /dev/null
+++ b/tools/MemoryTool.js
@@ -0,0 +1,137 @@
+const { Tool, ToolResult } = require("./ToolRegistry");
+const memoryStore = require("../src/main/memory-store");
+
+/**
+ * memory_save — добавить одну заметку в долговременную память.
+ */
+class MemorySaveTool extends Tool {
+  constructor() {
+    super(
+      "memory_save",
+      "Сохранить одну заметку в долговременную память о пользователе.",
+      {
+        type: "object",
+        properties: {
+          text: {
+            type: "string",
+            description:
+              'Короткая запись (одна мысль). Сохраняется как "- [дата] текст".',
+          },
+        },
+        required: ["text"],
+        additionalProperties: false,
+      },
+      "memorySave(text)",
+    );
+  }
+
+  getPromptSection() {
+    return {
+      name: "tool:memory_save",
+      order: 111,
+      text: [
+        "## Память — что это и когда использовать",
+        "",
+        "Память — это долговременный файл заметок о пользователе. В неё попадает",
+        "информация о пользователе, его системе или о том, что он прямо попросил",
+        "записать. Примеры:",
+        "- «Мне 10 лет», «Меня зовут Иван», «Я живу в Москве» — факты о пользователе.",
+        "- «У меня Windows 11, RTX 3060, VS Code, Python 3.12» — факты о его системе.",
+        "- «Пиши комментарии на русском», «Не трогай папку legacy/», «Используй tabs» — устойчивые предпочтения по работе.",
+        "- Любая прямая просьба: «Запомни, что…», «Сохрани в память…».",
+        "",
+        "Когда сохранять:",
+        "- Когда пользователь прямо просит что-то запомнить — сохраняй сразу, коротко и от третьего лица (memorySave('Пользователю 10 лет')).",
+        "- Когда в диалоге всплывает устойчивый факт о пользователе или его окружении, который пригодится в будущих сессиях, — сохраняй без напоминаний.",
+        "- Не сохраняй временное (текущая задача, разовый путь, содержимое файла), секреты, токены, пароли.",
+        "",
+        "Когда читать:",
+        "- Если ответ зависит от данных о пользователе/системе — сначала memoryRead().",
+        "- Не вызывай memoryRead() на каждый запрос; только когда это уместно.",
+        "",
+        "Формат и правила:",
+        '- memorySave(text) — добавляет одну строку "- [дата] текст". Одна запись — одна мысль. Без markdown-заголовков и переводов строк.',
+        "- Дубликаты не создавай: если запись уже есть — пропусти или переформулируй.",
+        "- memoryClear() — полная очистка. Только по прямой просьбе пользователя. Перед вызовом — предупреди.",
+        "- Память не попадает в системный промпт автоматически: её содержимое видно только после явного memoryRead().",
+      ].join("\n"),
+    };
+  }
+
+  async execute(params) {
+    const { text } = params;
+    const r = memoryStore.appendMemory(text);
+    if (!r.ok)
+      return ToolResult.error("Не удалось сохранить в память: " + r.error);
+    return ToolResult.success("Сохранено в память: " + r.entry);
+  }
+}
+
+/**
+ * memory_read — прочитать всю память.
+ */
+class MemoryReadTool extends Tool {
+  constructor() {
+    super(
+      "memory_read",
+      "Прочитать долговременную память (заметки о пользователе).",
+      {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+      },
+      "memoryRead()",
+    );
+  }
+
+  getPromptSection() {
+    return {
+      name: "tool:memory_read",
+      order: 112,
+      text: "Вызывай memoryRead(), когда ответ зависит от данных о пользователе/его системе. Не вызывай на каждый запрос.",
+    };
+  }
+
+  async execute() {
+    const raw = memoryStore.readMemory();
+    if (!raw || !raw.trim()) {
+      return ToolResult.success("(память пуста)");
+    }
+    return ToolResult.success(raw);
+  }
+}
+
+/**
+ * memory_clear — полностью очистить память.
+ */
+class MemoryClearTool extends Tool {
+  constructor() {
+    super(
+      "memory_clear",
+      "Полностью очистить долговременную память. Только по прямой просьбе пользователя.",
+      {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+      },
+      "memoryClear()",
+    );
+  }
+
+  getPromptSection() {
+    return {
+      name: "tool:memory_clear",
+      order: 113,
+      text: "memoryClear() удаляет все записи памяти. Используй только по прямой просьбе пользователя и предупреди его перед вызовом.",
+    };
+  }
+
+  async execute() {
+    const r = memoryStore.clearMemory();
+    if (!r.ok)
+      return ToolResult.error("Не удалось очистить память: " + r.error);
+    return ToolResult.success("Память очищена.");
+  }
+}
+
+module.exports = { MemorySaveTool, MemoryReadTool, MemoryClearTool };
diff --git a/tools/RunAgentTool.js b/tools/RunAgentTool.js
new file mode 100644
index 0000000..6acae17
--- /dev/null
+++ b/tools/RunAgentTool.js
@@ -0,0 +1,93 @@
+/**
+ * run_agent — делегирование задачи субагенту.
+ *
+ * Субагент работает в отдельном окне (тот же partition → общая сессия DeepSeek),
+ * в изолированном контексте, и возвращает только итоговый текст.
+ *
+ * Раннер и определитель «окно-субагент» инжектируются из main-процесса
+ * (см. src/main/index.js): так tools-слой не зависит от main-слоя.
+ */
+const { Tool, ToolResult } = require("./ToolRegistry");
+const { scanAgents } = require("../src/main/agents");
+
+/** @type {(args:{agent:any, task:string, currentWindowId:number}) => Promise<string>|null} */
+let _runner = null;
+/** @type {(windowId:number) => boolean|null} */
+let _isSubagentWindow = null;
+
+function injectAgentRunner(fn) {
+  _runner = fn;
+}
+function injectSubagentChecker(fn) {
+  _isSubagentWindow = fn;
+}
+
+class RunAgentTool extends Tool {
+  constructor() {
+    super(
+      "run_agent",
+      "Делегировать задачу субагенту (независимый контекст). Возвращает итоговое резюме. Подходит для широкого поиска/анализа и независимых подзадач — чтобы не засорять текущий контекст.",
+      {
+        type: "object",
+        properties: {
+          name: {
+            type: "string",
+            description:
+              "Имя субагента (см. раздел «Доступные субагенты» в системном промпте)",
+          },
+          task: {
+            type: "string",
+            description: "Описание задачи для делегирования",
+          },
+        },
+        required: ["name", "task"],
+        additionalProperties: false,
+      },
+      "run_agent(name, task)",
+    );
+  }
+
+  getPromptSection() {
+    return {
+      name: "tool:run_agent",
+      order: 113,
+      text:
+        "Используй run_agent(name, task), чтобы делегировать задачу субагенту. " +
+        "Субагент работает в отдельном контексте и возвращает только итоговое резюме.",
+    };
+  }
+
+  async execute(params) {
+    const { name, task, projectDir, currentWindowId } = params;
+    if (!name || !task) return ToolResult.error("Поля name и task обязательны");
+    if (typeof currentWindowId !== "number")
+      return ToolResult.error("Отсутствует контекст окна (currentWindowId)");
+
+    // Защита от рекурсии: окно-субагент не может вызвать run_agent
+    try {
+      if (_isSubagentWindow && _isSubagentWindow(currentWindowId)) {
+        return ToolResult.error(
+          "Субагент не может вызывать run_agent (защита от рекурсии)",
+        );
+      }
+    } catch (_) {}
+
+    const agents = scanAgents(projectDir || null);
+    const agent = agents.find((a) => a.name === name);
+    if (!agent) return ToolResult.error("Субагент не найден: " + name);
+
+    if (!_runner)
+      return ToolResult.error("Раннер субагентов не инициализирован");
+
+    try {
+      const text = await _runner({ agent, task, currentWindowId, projectDir });
+      return ToolResult.success(text);
+    } catch (err) {
+      return ToolResult.error(
+        "Ошибка выполнения субагента: " + (err && err.message),
+      );
+    }
+  }
+}
+
+module.exports = { RunAgentTool, injectAgentRunner, injectSubagentChecker };
diff --git a/tools/cuckoo-tools.d.ts b/tools/cuckoo-tools.d.ts
index eb902dc..3461f61 100644
--- a/tools/cuckoo-tools.d.ts
+++ b/tools/cuckoo-tools.d.ts
@@ -375,6 +375,34 @@ declare function mcpListServers(): Promise<string>;
  */
 declare function mcpGetTools(serverName: string): Promise<string>;
 
+// ================= Memory =================
+
+/**
+ * Сохранить одну заметку в долговременную память (файл <userData>/memory.md).
+ * Запись добавляется строкой "- [YYYY-MM-DD] текст".
+ * Используется для фактов о пользователе, его системе и устойчивых предпочтений.
+ * @param text короткая заметка (одна мысль); длиннее 2000 символов — обрезается
+ * @returns подтверждение с сохранённой строкой
+ * @throws text не строка/пустой, ошибка записи файла
+ */
+declare function memorySave(text: string): Promise<string>;
+
+/**
+ * Прочитать всю долговременную память (файл <userData>/memory.md).
+ * Вызывай, только если ответ зависит от данных о пользователе/его системе.
+ * @returns содержимое файла или "(память пуста)"
+ * @throws ошибка чтения файла
+ */
+declare function memoryRead(): Promise<string>;
+
+/**
+ * Полностью очистить долговременную память.
+ * Используй только по прямой просьбе пользователя.
+ * @returns подтверждение очистки
+ * @throws ошибка записи файла
+ */
+declare function memoryClear(): Promise<string>;
+
 // ================= Skill =================
 
 /**
diff --git a/tools/index.js b/tools/index.js
index 4fa7deb..8e23099 100644
--- a/tools/index.js
+++ b/tools/index.js
@@ -37,6 +37,14 @@ const { ReadPhotoTool } = require("./ReadPhotoTool");
 const { ExitPlanModeTool } = require("./ExitPlanModeTool");
 const { AttachFileTool } = require("./AttachFileTool");
 const { AttachTelegramTool } = require("./AttachTelegramTool");
+const {
+  MemorySaveTool,
+  MemoryReadTool,
+  MemoryClearTool,
+} = require("./MemoryTool");
+const { RunAgentTool } = require("./RunAgentTool");
+const { ListAgentsTool, ReadAgentTool } = require("./AgentTools");
+const { CreateAgentTool } = require("./CreateAgentTool");
 
 // 创建全局工具注册表
 const registry = new ToolRegistry();
@@ -76,6 +84,13 @@ registry.register(new ReadPhotoTool());
 registry.register(new ExitPlanModeTool());
 registry.register(new AttachFileTool());
 registry.register(new AttachTelegramTool());
+registry.register(new MemorySaveTool());
+registry.register(new MemoryReadTool());
+registry.register(new MemoryClearTool());
+registry.register(new RunAgentTool());
+registry.register(new ListAgentsTool());
+registry.register(new ReadAgentTool());
+registry.register(new CreateAgentTool());
 
 // 导出
 module.exports = {
@@ -110,8 +125,15 @@ module.exports = {
   ReadPhotoTool,
   ExitPlanModeTool,
   AttachFileTool,
-    AttachTelegramTool,
-    InjectPageJSTool,
+  AttachTelegramTool,
+  InjectPageJSTool,
+  MemorySaveTool,
+  MemoryReadTool,
+  MemoryClearTool,
+  RunAgentTool,
+  ListAgentsTool,
+  ReadAgentTool,
+  CreateAgentTool,
   // 便捷方法
   getAllTools: () => registry,
   getToolDescriptions: () => registry.getDescriptions(),