How intina47/context-sync works
Context Sync is a local-first MCP server that gives AI coding tools persistent, project-specific memory and codebase context. The main session workflow is to select a project, recover stored context, explore its files, and save new decisions or work so they can be recalled later. Separate tool branches provide git-aware analysis and optional read-only Notion lookup. The graph reflects README capabilities and sampled engine behavior; some handler-to-engine wiring is inferred from module roles, while unsampled internal call details are omitted.
Main entry points: server.ts MCP server · read-file-engine.ts File context · workspace-tool-handler.ts Workspace tools · core-tools.ts Memory tools
Components 22
MCP Interface
- MCP server
src/server.ts - Project selection
src/workspace-tool-handler.ts - Memory tools
src/core-tools.ts - Workspace tools
src/workspace-tool-handler.ts - Git tool
src/git-tool-handler.ts - Notion tool
src/notion-tool-handler.ts
Project Memory
- Project detection
src/project-detector.ts - Project profiling
src/project-profiler.ts - Remember engine
src/remember-engine.ts - Recall engine
src/recall-engine.ts - SQLite storage
src/storage.ts
Workspace Tools
- File context
src/read-file-engine.ts - Search engine
src/search-engine.ts - Structure engine
src/structure-engine.ts
Integrations
- Git status
src/git-status-engine.ts - Git context
src/git-context-engine.ts - Git hooks
src/git-hook-manager.ts - Notion handlers
src/notion-handlers.ts
Other components
- AI coding tool
- Notion API
- Project files
- Git repository
Connections 29
- AI coding tool → MCP server: uses MCP
- MCP server → Project selection: dispatches tools
- MCP server → Memory tools: dispatches tools
- MCP server → Workspace tools: dispatches tools
- MCP server → Git tool: dispatches tools
- MCP server → Notion tool: dispatches tools
- Project selection → Project detection: selects project
- Project detection → Project profiling: profiles project
- Memory tools → Remember engine: stores context
- Memory tools → Recall engine: recovers context
- Remember engine → SQLite storage: writes memory
- Recall engine → SQLite storage: reads memory
- Workspace tools → Search engine: searches files
- Workspace tools → Structure engine: maps structure
- Workspace tools → File context: reads file context
- Search engine → File context: enriches matches
- Structure engine → File context: analyzes context
- File context → Project files: reads files
- Search engine → Project files: searches files
- Structure engine → Project files: scans directories
- Git tool → Git status: gets status
- Git tool → Git context: gets context
- Git status → Git repository: reads status
- Git context → Git repository: reads history
- Git status → File context: enriches changes
- Git context → File context: adds file context
- Project selection → Git hooks: can install hooks
- Notion tool → Notion handlers: handles lookup
- Notion handlers → Notion API: searches and reads