English Français العربية

io.github.Intina47/context-sync

السجل الرسمي الذكاء الاصطناعي والوكلاء

Universal AI Memory - Sync context across Claude, VsCode, Cursor, Continue, Windsurf, Zed & more

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.Intina47/context-sync؟

  • set_project
  • remember
  • recall
  • read_file
  • search
  • structure
  • git
  • notion

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @context-sync/server
Claude Code 
claude mcp add context-sync -- npx -y @context-sync/server@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "context-sync": {
            "command": "npx",
            "args": [
                "-y",
                "@context-sync/server@1.0.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Context Sync
  2. What It Does
  3. Install
  4. Verify
  5. Optional Notion Setup
  6. First-Time Workflow
  7. Git Integration
  8. Data And Config
  9. Supported Platforms
  10. Docs

Context Sync

Local-first project memory for AI coding tools over MCP.

Context Sync gives an agent a persistent memory layer for a codebase:

  • project identity and tech stack
  • active work, decisions, constraints, and caveats
  • structured file exploration
  • git-aware context
  • optional read-only Notion lookup

What It Does

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.

The current core tools are:

  • set_project
  • remember
  • recall
  • read_file
  • search
  • structure
  • git
  • notion

Install

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.

Verify

Check that context-sync appears in your MCP tool list:

  • Claude Desktop: open the tools list
  • Cursor: open the tools list
  • VS Code / Copilot Chat Agent mode: check tools
  • Continue.dev: open the Continue panel
  • Codex CLI: codex mcp list
  • Claude Code: claude mcp list

If auto-config fails, use docs/TROUBLESHOOTING.md and docs/CONFIG.md.

Optional Notion Setup

Run the setup wizard if you want Notion integration:

context-sync-setup

or:

npx context-sync-setup

Notion support is intentionally read-only at the tool surface:

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

First-Time Workflow

Start every new session by setting the project first:

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

Recommended pattern:

  • set_project once per project/session start
  • recall to recover context
  • structure and search to explore
  • read_file for focused inspection
  • remember when something should survive the current session

Git Integration

When you run set_project inside a git repository, Context Sync can install hooks for automatic context capture.

Installed hooks:

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

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

The git tool supports:

  • status
  • context
  • hotspots
  • coupling
  • blame
  • analysis

Data And Config

Default locations:

  • Database: ~/.context-sync/data.db
  • Config: ~/.context-sync/config.json
  • Install status: ~/.context-sync/install-status.json

Custom database options:

  • CLI: context-sync --db-path /absolute/path/to/db
  • Env var: CONTEXT_SYNC_DB_PATH

See docs/DATA.md for storage details.

Supported Platforms

  • Claude Desktop
  • Cursor
  • VS Code + GitHub Copilot
  • Continue.dev
  • Zed
  • Windsurf
  • Codeium
  • TabNine
  • Codex CLI
  • Claude Code
  • Antigravity

Docs

الأسئلة الشائعة

ما هو io.github.Intina47/context-sync؟

Universal AI Memory - Sync context across Claude, VsCode, Cursor, Continue, Windsurf, Zed & more

كيف أثبّت io.github.Intina47/context-sync؟

يعمل على جهازك. في Claude Code: claude mcp add context-sync -- npx -y @context-sync/server@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Intina47/context-sync إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.Intina47/context-sync مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Intina47/context-sync؟

ينشره Intina47. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.