Mem-Palace-skill
drewOrc/Mem-Palace-skillПлагин для Claude Code и Cowork, дающий AI-ассистенту персистентную память между разговорами. Организует знания по метафоре «дворца памяти» (крылья, заметки, туннели), чтобы каждая новая сессия продолжала предыдущую.
Установка
git clone https://github.com/drewOrc/Mem-Palace-skill.gitREADME
Memory Palace
Кросс-сессионная память для AI-ассистентов. Больше никакой потери контекста.
Основан на MemPalace авторства Milla Jovovich и Ben Sigman. Их работа по структурированной памяти для AI (крылья, комнаты, туннели, пробуждение ChromaDB) — фундамент, который этот проект адаптирует для Claude Code и Cowork.
Memory Palace — это open-source скилл/плагин для Claude Code и Cowork, дающий AI-ассистенту персистентную память между разговорами. Он использует метафору «дворца памяти» из MemPalace (крылья, заметки, туннели) для организации знаний, чтобы каждая новая сессия продолжала с того места, где закончилась предыдущая.
Впервые здесь? Откройте welcome.html в браузере для интерактивного руководства.
Проблема
Вы час обсуждаете архитектурные решения с Claude. Следующий разговор? Он ничего не помнит. Вы снова объясняете, снова передаёте контекст, тратите время впустую.
Решение
Memory Palace сохраняет ключевые моменты разговоров в структурированной иерархии файлов, которую AI читает в начале каждой новой сессии:
memory/
├── PALACE.md # Горячий кэш: глобальный статус (~200 строк, всегда загружается)
├── wings/
│ ├── my-project/
│ │ ├── 2026-04-08_api-design-decisions.md
│ │ └── 2026-04-10_benchmark-results.md
│ ├── research/
│ │ └── 2026-04-08_harness-engineering.md
│ └── ...
└── tunnels/
└── routing-patterns-across-layers.md # Связи между темами
Wings (крылья) = основные темы (как этажи здания)
Notes (заметки) = итоги сессий (как комнаты на этаже)
Tunnels (туннели) = межтематические связи (как тайные переходы между этажами)
Быстрый старт
Вариант 1: Установка как плагин Cowork
Скачайте файл .skill из Releases и установите его в Cowork.
Вариант 2: Использование единого CLI
Клонируйте репозиторий и используйте команду palace для всех операций:
# Клонировать в директорию скиллов проекта
git clone https://github.com/drewOrc/Mem-Palace-skill.git .claude/skills/memory-palace
# Инициализировать новый дворец
cd /path/to/your/project
.claude/skills/memory-palace/palace init ./memory --wings paper1 paper2 research --name "My Project"
# Все операции через единый CLI
.claude/skills/memory-palace/palace search ./memory "keyword"
.claude/skills/memory-palace/palace health ./memory
.claude/skills/memory-palace/palace stats ./memory
.claude/skills/memory-palace/palace map ./memory
.claude/skills/memory-palace/palace archive ./memory --dry-runИли добавьте директорию скилла в PATH для более короткого синтаксиса:
export PATH="/path/to/Mem-Palace-skill:$PATH"
palace init ./memory --wings project,research
palace search ./memory "keyword"Вариант 3: Просто используйте структуру
Скилл вообще не обязателен. Скопируйте директорию example/ в ваш проект как memory/, добавьте сниппет CLAUDE.md в проект — и готово.
Использование
После установки просто общайтесь с Claude естественным образом:
| Что вы говорите | Что происходит |
|---|---|
| «Что мы обсуждали в прошлый раз?» | Claude читает ваш дворец и резюмирует последние активности |
| «Сохрани в дворец» | Claude записывает ключевые находки дня в нужное крыло |
| «Покажи карту дворца» | Генерирует визуальную Mermaid-диаграмму структуры памяти |
| «Статистика дворца» | Показывает количество токенов, заметок и временную шкалу активности |
| «Экспортируй дворец» | Экспортирует в формат Markdown или хранилище Obsidian |
| «Продолжи работу над X» | Claude автоматически загружает контекст нужного крыла |
Справочник CLI
Все команды запускаются через palace <command>. Используйте palace help для просмотра всех опций.
| Команда | Назначение |
|---|---|
palace init | Создать новую структуру дворца |
palace search | Полнотекстовый поиск по заметкам |
palace health | Проверить структуру, найти устаревшие заметки |
palace stats | Показать метрики дворца (крылья, заметки, токены) |
palace map | Сгенерировать Mermaid-визуализацию |
palace archive | Переместить старые заметки в архив |
palace export | Экспортировать в Markdown или формат Obsidian |
palace import | Импортировать из транскриптов разговоров |
palace autosave | Включить/выключить хуки автосохранения |
Примечание: Вы также можете запускать отдельные скрипты напрямую из scripts/ (например, python scripts/palace_search.py ./memory "query").
Возможности
Основное: чтение и запись памяти
- Автоматическая загрузка дворца в начале разговора
- Сохранение заметок в структурированном формате (ключевое содержимое, связи, ссылки)
- Обновление таблицы горячего кэша в
PALACE.md
Автосохранение
Память сохраняется автоматически без ручных запросов на сохранение. palace_autosave.py интегрируется с хуками разговора для обнаружения значимых находок и их фиксации в дворце. Это ключевое отличие от ручных систем памяти — ваши идеи сохраняются, даже если вы забыли сказать «сохрани в дворец».
# Хуки автоматически срабатывают по завершении разговора
# Ручное вмешательство не требуетсяАрхив
Поддерживайте дворец в порядке, архивируя старые или завершённые заметки:
palace archive ./memory --older-than 90 # дней
# Или сначала просмотрите изменения
palace archive ./memory --older-than 90 --dry-runУстаревшие заметки перемещаются в memory/archive/ с сохранением ссылок.
Автоподсказка туннелей
Claude проактивно предлагает межкрыльевые связи при сохранении заметок. Если новая находка относится к нескольким крыльям, скилл автоматически создаёт записи туннелей для их связывания. Это выявляет неожиданные паттерны и предотвращает изоляцию знаний.
Классификация залов
Опциональная подорганизация внутри крыльев для перегруженных пространств памяти. Группируйте связанные заметки под «залом» (поддиректорией), сохраняя ту же структуру индекса PALACE.md.
wings/my-project/
├── hall_architecture/
│ ├── 2026-04-01_initial-design.md
│ └── 2026-04-05_revised-schema.md
└── hall_experiments/
└── 2026-04-08_benchmark-v1.md
Сниппет CLAUDE.md
Добавьте это в CLAUDE.md вашего проекта, чтобы Claude автоматически загружал дворец:
## Memory Palace
At the start of each conversation, read `memory/PALACE.md` for context.
When saving insights, use the wing structure in `memory/wings/`.
Create tunnel entries in `memory/tunnels/` for cross-wing connections.Структура проекта
Mem-Palace-skill/
├── palace # Единый CLI (точка входа)
├── scripts/
│ ├── palace_init.py # Инициализация структуры дворца
│ ├── palace_search.py # Полнотекстовый поиск
│ ├── palace_health.py # Проверка структуры
│ ├── palace_stats.py # Метрики и аналитика
│ ├── palace_map.py # Mermaid-визуализация
│ ├── palace_archive.py # Архивирование старых заметок
│ ├── palace_export.py # Экспорт в Markdown/Obsidian
│ ├── palace_import.py # Импорт из транскриптов
│ └── palace_autosave.py # Хуки автосохранения
├── example/ # Пример структуры дворца
├── welcome.html # Интерактивное руководство
├── CLAUDE.md # Инструкции для AI
└── README.md
Благодарности
Основан на MemPalace авторства Milla Jovovich и Ben Sigman. Концепции структурированной памяти AI, метафора дворца памяти и подход к организации знаний — их оригинальная работа.
Лицензия
MIT — подробности в файле LICENSE.