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