Skip to content
Back to search

context-sync

Local persistent memory store for LLM applications including continue.dev, cursor, claude desktop, github copilot, codex, antigravity, etc.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/intina47--context-sync/badge.svg)](/listings/intina47--context-sync)

HTML

<a href="/listings/intina47--context-sync"><img src="/api/listings/intina47--context-sync/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install globally:

npm install -g @context-sync/server

Auto-configuration runs during global install. After install, restart your AI tool.

If you install locally instead of globally, auto-config does not run. Use the manual config guide in [docs/CONFIG.md](docs/CONFIG.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 142 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Context Sync
  2. Local-first project memory for AI coding tools over MCP.
  3. Context Sync gives an agent a persistent memory layer for a codebase:
  4. - project identity and tech stack
  5. - active work, decisions, constraints, and caveats
  6. - structured file exploration
  7. - git-aware context
  8. - optional read-only Notion lookup
  9. ![Context Sync](image.png)
  10. ## What It Does
  11. Context Sync is built for session continuity. Instead of relying on a model to remember earlier conversations, it stores the project context that matters and makes it retrievable through a small MCP tool surface.
  12. The current core tools are:
  13. - `set_project`
  14. - `remember`
  15. - `recall`
  16. - `read_file`
  17. - `search`
  18. - `structure`
  19. - `git`
  20. - `notion`
  21. ## Install
  22. Install globally:
  23. ```bash
  24. npm install -g @context-sync/server
  25. ```
  26. Auto-configuration runs during global install. After install, restart your AI tool.
  27. If you install locally instead of globally, auto-config does not run. Use the manual config guide in [docs/CONFIG.md](docs/CONFIG.md).
  28. ## Verify
  29. Check that `context-sync` appears in your MCP tool list:
  30. - Claude Desktop: open the tools list
  31. - Cursor: open the tools list
  32. - VS Code / Copilot Chat Agent mode: check tools
  33. - Continue.dev: open the Continue panel
  34. - Codex CLI: `codex mcp list`
  35. - Claude Code: `claude mcp list`
  36. If auto-config fails, use [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) and [docs/CONFIG.md](docs/CONFIG.md).
  37. ## Optional Notion Setup
  38. Run the setup wizard if you want Notion integration:
  39. ```bash
  40. context-sync-setup
  41. ```
  42. or:
  43. ```bash
  44. npx context-sync-setup
  45. ```
  46. Notion support is intentionally read-only at the tool surface:
  47. - `notion({ action: "search", query: "..." })`
  48. - `notion({ action: "read", pageId: "..." })`
  49. ## First-Time Workflow
  50. Start every new session by setting the project first:
  51. ```text
  52. 1. set_project({ path: "/absolute/path/to/project" })
  53. 2. recall()
  54. 3. structure({ depth: 2 })
  55. 4. read_file({ path: "src/index.ts" })
  56. 5. remember({ type: "decision", content: "Use SQLite for local storage" })
  57. ```
  58. Recommended pattern:
  59. - `set_project` once per project/session start
  60. - `recall` to recover context
  61. - `structure` and `search` to explore
  62. - `read_file` for focused inspection
  63. - `remember` when something should survive the current session
  64. ## Git Integration
  65. When you run `set_project` inside a git repository, Context Sync can install hooks for automatic context capture.
  66. Installed hooks:
  67. - `post-commit`
  68. - `pre-push`
  69. - `post-merge`
  70. - `post-checkout`
  71. Hooks are marked with `Context Sync Auto-Hook`, and existing hooks are backed up first.
  72. The `git` tool supports:
  73. - `status`
  74. - `context`
  75. - `hotspots`
  76. - `coupling`
  77. - `blame`
  78. - `analysis`
  79. ## Data And Config
  80. Default locations:
  81. - Database: `~/.context-sync/data.db`
  82. - Config: `~/.context-sync/config.json`
  83. - Install status: `~/.context-sync/install-status.json`
  84. Custom database options:
  85. - CLI: `context-sync --db-path /absolute/path/to/db`
  86. - Env var: `CONTEXT_SYNC_DB_PATH`
  87. See [docs/DATA.md](docs/DATA.md) for storage details.
  88. ## Supported Platforms
  89. - Claude Desktop
  90. - Cursor
  91. - VS Code + GitHub Copilot
  92. - Continue.dev
  93. - Zed
  94. - Windsurf
  95. - Codeium
  96. - TabNine
  97. - Codex CLI
  98. - Claude Code
  99. - Antigravity
  100. ## Docs
  101. - [docs/TOOLS.md](docs/TOOLS.md)
  102. - [docs/CONFIG.md](docs/CONFIG.md)
  103. - [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
  104. - [docs/DATA.md](docs/DATA.md)
  105. - [docs/RELEASE_NOTES.md](docs/RELEASE_NOTES.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.