Context Sync

Memoria de proyecto local para herramientas de codificación de IA a través de MCP.

Context Sync proporciona a un agente una capa de memoria persistente para una base de código:

• identidad del proyecto y pila tecnológica

• trabajo activo, decisiones, restricciones y advertencias

• exploración estructurada de archivos

• contexto consciente de git

• búsqueda opcional de solo lectura en Notion

Qué hace

Context Sync está diseñado para la continuidad de la sesión. En lugar de depender de que un modelo recuerde conversaciones anteriores, almacena el contexto del proyecto que importa y lo hace recuperable a través de una pequeña superficie de herramientas MCP.

Las herramientas principales actuales son:

• set_project

• remember

• recall

• read_file

• search

• structure

• git

• notion

Instalación

Instalar globalmente:

npm install -g @context-sync/server

La configuración automática se ejecuta durante la instalación global. Después de instalar, reinicie su herramienta de IA.

Si instala localmente en lugar de globalmente, la configuración automática no se ejecuta. Utilice la guía de configuración manual en docs/CONFIG.md.

Verificación

Compruebe que context-sync aparece en su lista de herramientas MCP:

• Claude Desktop: abra la lista de herramientas

• Cursor: abra la lista de herramientas

• VS Code / Modo Agente de Copilot Chat: compruebe las herramientas

• Continue.dev: abra el panel de Continue

• Codex CLI: codex mcp list

• Claude Code: claude mcp list

Si la configuración automática falla, utilice docs/TROUBLESHOOTING.md y docs/CONFIG.md.

Configuración opcional de Notion

Ejecute el asistente de configuración si desea la integración con Notion:

context-sync-setup

o:

npx context-sync-setup

El soporte de Notion es intencionalmente de solo lectura en la superficie de la herramienta:

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

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

Flujo de trabajo por primera vez

Comience cada sesión nueva configurando primero el proyecto:

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" })

Patrón recomendado:

• set_project una vez por proyecto/inicio de sesión

• recall para recuperar contexto

• structure y search para explorar

• read_file para una inspección enfocada

• remember cuando algo deba sobrevivir a la sesión actual

Integración con Git

Cuando ejecuta set_project dentro de un repositorio git, Context Sync puede instalar hooks para la captura automática de contexto.

Hooks instalados:

• post-commit

• pre-push

• post-merge

• post-checkout

Los hooks están marcados con Context Sync Auto-Hook, y los hooks existentes se respaldan primero.

La herramienta git admite:

• status

• context

• hotspots

• coupling

• blame

• analysis

Datos y configuración

Ubicaciones predeterminadas:

• Base de datos: ~/.context-sync/data.db

• Configuración: ~/.context-sync/config.json

• Estado de instalación: ~/.context-sync/install-status.json

Opciones de base de datos personalizada:

• CLI: context-sync --db-path /ruta/absoluta/a/db

• Variable de entorno: CONTEXT_SYNC_DB_PATH

Consulte docs/DATA.md para obtener detalles sobre el almacenamiento.

Plataformas compatibles

• Claude Desktop

• Cursor

• VS Code + GitHub Copilot

• Continue.dev

• Zed

• Windsurf

• Codeium

• TabNine

• Codex CLI

• Claude Code

• Antigravity

Documentación

• docs/TOOLS.md

• docs/CONFIG.md

• docs/TROUBLESHOOTING.md

• docs/DATA.md

• docs/RELEASE_NOTES.md