Context Sync

Local-first memory layer for AI development tools via MCP.

Install and auto-config (60 seconds)

1. Install globally:

npm install -g @context-sync/server

2. Auto-config runs on install. Restart your AI tool.

3. Verify tools:

• Claude Desktop: Tools list
• Cursor: Tools list
• VS Code/Copilot: Copilot Chat -> Agent mode -> Tools
• Continue.dev: open Continue panel
• Codex CLI: codex mcp list
• Claude Code: claude mcp list

If auto-config fails, see docs/TROUBLESHOOTING.md and docs/CONFIG.md. If you installed locally (non-global), auto-config does not run.

Optional: Notion setup

context-sync-setup
# or
npx context-sync-setup

Supported platforms

• Claude Desktop
• Cursor
• VS Code + GitHub Copilot
• Continue.dev
• Zed
• Windsurf
• Codeium
• TabNine
• Codex CLI
• Claude Code
• Antigravity (Google Gemini IDE)

First-time workflow

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

Tool reference: docs/TOOLS.md

Data and config

• Database: ~/.context-sync/data.db
• Config: ~/.context-sync/config.json
• Install status: ~/.context-sync/install-status.json
• Custom DB: context-sync --db-path /absolute/path/to/db or CONTEXT_SYNC_DB_PATH

More details: docs/DATA.md

Git hooks

When you run set_project inside a git repo, Context Sync installs hooks:

• post-commit
• pre-push
• post-merge
• post-checkout

Hooks are marked with "Context Sync Auto-Hook" and existing hooks are backed up.

Docs

• Release notes: docs/RELEASE_NOTES.md
• Manual config: docs/CONFIG.md
• Tools: docs/TOOLS.md
• Troubleshooting: docs/TROUBLESHOOTING.md
• Data and storage: docs/DATA.md