Context Sync

Локальная память проекта для инструментов программирования с ИИ через MCP.

Context Sync предоставляет агенту уровень постоянной памяти для кодовой базы:

• идентификация проекта и технологический стек

• активная работа, решения, ограничения и предостережения

• структурированное исследование файлов

• контекст с учетом git

• опциональный просмотр Notion только для чтения

Что это делает

Context Sync создан для непрерывности сессий. Вместо того чтобы полагаться на модель, запоминающую предыдущие разговоры, он сохраняет важный контекст проекта и делает его доступным через небольшой набор инструментов MCP.

Текущие основные инструменты:

• set_project

• remember

• recall

• read_file

• search

• structure

• git

• notion

Установка

Установите глобально:

npm install -g @context-sync/server

Автоматическая настройка выполняется во время глобальной установки. После установки перезапустите ваш ИИ-инструмент.

Если вы устанавливаете локально, а не глобально, автонастройка не запускается. Используйте руководство по ручной настройке в docs/CONFIG.md.

Проверка

Убедитесь, что context-sync появился в вашем списке инструментов MCP:

• Claude Desktop: откройте список инструментов

• Cursor: откройте список инструментов

• VS Code / Режим агента Copilot Chat: проверьте инструменты

• Continue.dev: откройте панель Continue

• Codex CLI: codex mcp list

• Claude Code: claude mcp list

Если автонастройка не удалась, используйте docs/TROUBLESHOOTING.md и docs/CONFIG.md.

Дополнительная настройка Notion

Запустите мастер настройки, если вам нужна интеграция с Notion:

context-sync-setup

или:

npx context-sync-setup

Поддержка Notion намеренно сделана только для чтения на уровне инструментов:

• notion({ action: "search", query: "..." })

• notion({ action: "read", pageId: "..." })

Рабочий процесс для первого использования

Начинайте каждую новую сессию с установки проекта:

1. set_project({ path: "/absolute/path/to/project" })
2. recall()
3. structure({ depth: 2 })
4. read_file({ path: "src/index.ts" })
5. remember({ type: "decision", content: "Use SQLite for local storage" })

Рекомендуемый шаблон:

• set_project один раз за проект/начало сессии

• recall для восстановления контекста

• structure и search для исследования

• read_file для целенаправленного изучения

• remember когда что-то должно сохраниться после текущей сессии

Интеграция с Git

Когда вы запускаете set_project внутри репозитория git, Context Sync может установить хуки для автоматического захвата контекста.

Установленные хуки:

• post-commit

• pre-push

• post-merge

• post-checkout

Хуки помечаются как Context Sync Auto-Hook, а существующие хуки предварительно сохраняются.

Инструмент git поддерживает:

• status

• context

• hotspots

• coupling

• blame

• analysis

Данные и конфигурация

Расположения по умолчанию:

• База данных: ~/.context-sync/data.db

• Конфигурация: ~/.context-sync/config.json

• Статус установки: ~/.context-sync/install-status.json

Пользовательские параметры базы данных:

• CLI: context-sync --db-path /absolute/path/to/db

• Переменная окружения: CONTEXT_SYNC_DB_PATH

Подробности хранения см. в docs/DATA.md.

Поддерживаемые платформы

• Claude Desktop

• Cursor

• VS Code + GitHub Copilot

• Continue.dev

• Zed

• Windsurf

• Codeium

• TabNine

• Codex CLI

• Claude Code

• Antigravity

Документация

• docs/TOOLS.md

• docs/CONFIG.md

• docs/TROUBLESHOOTING.md

• docs/DATA.md

• docs/RELEASE_NOTES.md