Skip to content

memory-sync.md

Latest commit

 

History

History
66 lines (48 loc) · 5.34 KB

memory-sync.md

File metadata and controls

66 lines (48 loc) · 5.34 KB

Memory Sync: Синхронизация памяти проекта с claude.ai через Git

Memory Sync — это механизм автоматической синхронизации базы знаний проекта (из Obsidian Vault) с Project Knowledge / Files в веб-интерфейсе claude.ai. Он полностью избавляет от необходимости вручную копировать и вставлять файлы passport.md, handoff.md и логи сессий.

Как это работает

Obsidian Vault (папка памяти)  ──>  Приватный GitHub-репо (<slug>-vault)  ──>  claude.ai (Project Knowledge)
      [автопуш при /mm save]                 [git push]                    [ручной или авто-рефреш в UI]
  1. Локальные изменения (сохранение сессий через /mm save, автообновление handoff.md и dashboard.md) автоматически накапливаются в папке памяти проекта.
  2. Если для проекта настроена синхронизация, /mm save в конце процесса автоматически коммитит и пушит эти файлы в приватный репозиторий на GitHub.
  3. Подключенный репозиторий в claude.ai считывает изменения. Для обновления контекста в текущем чате достаточно нажать одну кнопку Sync now на панели Files/Knowledge в claude.ai.

Шаг 1. Первичная настройка (/mm vault)

Чтобы включить синхронизацию для текущего проекта:

  1. Откройте терминал в папке проекта.
  2. Выполните команду: 
    /mm vault
  3. Скилл автоматически:
    • Определит папку памяти проекта в Obsidian Vault.
    • Проверит файлы на отсутствие секретов по правилам SECRET-PATTERNS.md.
    • Создаст корректный .gitignore (чтобы не пушить мусорные файлы .obsidian/, .trash/ и т.д.).
    • Инициализирует Git репозиторий локально в папке памяти.
    • Создаст приватный репозиторий на GitHub с именем <slug>-vault (например, для проекта markdown-memory это будет markdown-memory-vault) под вашей организацией/аккаунтом.
    • Сделает первый коммит и запушит ветку main.

Шаг 2. Единственный ручной шаг (Подключение в claude.ai)

Интеграция GitHub и claude.ai требует однократной ручной настройки в браузере:

  1. Откройте нужный Project в веб-интерфейсе claude.ai.
  2. В правой панели найдите раздел Project Knowledge (или вкладку Files).
  3. Нажмите кнопку "+" (Add Content) -> выберите GitHub.
  4. В появившемся списке репозиториев выберите созданный приватный репозиторий: <owner>/<slug>-vault.
  5. Отметьте галочками файлы для синхронизации:
    • passport.md
    • handoff.md
    • dashboard.md
    • Папку sessions/ (и все файлы сессий внутри неё)
  6. Важно: Снимите галочку с добавления файла .gitignore (его не нужно скачивать в контекст Клода).
  7. Подтвердите добавление, нажав Add to Project.

Шаг 3. Поддержание актуальности

  • Автопуш: Каждый раз, когда вы завершаете сессию с помощью команды /mm save (или /mm end), изменения будут автоматически проверены на секреты, закоммичены и отправлены в ваш GitHub-репозиторий.
  • Обновление в claude.ai: В веб-интерфейсе claude.ai откройте вкладку Files (или Project Knowledge) и нажмите Sync now (или значок обновления рядом с репозиторием), чтобы подтянуть свежие сессии и handoff. Это гарантирует, что следующий созданный чат начнется с актуального состояния.

Конвенции безопасности

  • Все создаваемые репозитории памяти всегда создаются как приватные (--private).
  • Перед каждым пушем (как при первой инициализации, так и при автоматическом сохранении сессий) принудительно запускается Secret-Scan по паттернам из docs/SECRET-PATTERNS.md для предотвращения утечки токенов/ключей.