@context-sync/server

Context Sync 🧠

Build in Cursor. Continue in Claude Desktop. Code in VS Code. Your AI remembers everything.

20+ GitHub stars in 24 hours • 400+ downloads Launch Week • #17 Product Hunt

Stop re-explaining your projects to AI. Build seamlessly across Cursor and Claude Desktop.

_{Local-first • 2-minute setup • Works with your existing workflow}

😤 You Know This Pain

You're building with AI. You've explained your project architecture, tech stack, and design decisions.

Then you hit a limit. New chat. Claude forgot everything.

❌ Without Context Sync Monday in Cursor: You: "Building TaskFlow - Next.js app with Supabase" AI: "Great! Let's start..." *3 hours of coding* Tuesday in Claude Desktop: You: "Continue TaskFlow" AI: "What's TaskFlow? Please explain your project" 😡 You spend 30 minutes re-explaining. Every. Single. Day.

✅ With Context Sync Monday in Cursor: You: "Building TaskFlow - Next.js app with Supabase" AI: "Great! Let's start..." *3 hours of coding* Tuesday in Claude Desktop: You: "Continue TaskFlow" AI: "Continuing your Next.js app with Supabase. What feature should we add next?" 😊 AI just remembers. Works everywhere.

Context Sync syncs your AI context between Cursor, Claude Desktop, and VS Code automatically.

🎯 Who This Is For

✅ Perfect For You If: You use Cursor, Claude Desktop, or VS Code Building long-term projects (weeks/months) Tired of re-explaining context Switch between AI tools frequently Freelancer juggling multiple projects Want AI that actually remembers

❌ Not For You If: Only use AI for one-off questions Don't use Cursor, Claude Desktop, or VS Code Happy manually copying context Casual AI user (not building projects) Prefer cloud-based solutions

🚀 2-Minute Setup

No configuration files. No API keys. No complexity.

1️⃣ Install ⏱️ 30 seconds npm install -g @context-sync/server One command. Global install.

2️⃣ Restart ⏱️ 30 seconds Claude Desktop: Mac: ⌘ + Q Windows: Right-click tray Cursor: Refresh MCP servers

3️⃣ Done! ✨ ⏱️ 1 minute You: "help context-sync" Context Sync is running! Follow the guided setup!

Total time: 2 minutes • Zero configuration • Works immediately

👋 First Time? Start Here!

Complete beginner setup:

• Install: npm install -g @context-sync/server
• Choose your platform:
  • Claude Desktop: Restart app → type "help context-sync"
  • VS Code + Copilot: Restart VS Code → open Copilot Chat → look for context-sync tools
  • Cursor: Refresh MCP → test with "help context-sync"
• Follow the guided setup! ✅ You're done!
  

🔧 Setup for VS Code + GitHub Copilot

Quick Setup for VS Code (30 seconds)

After installing Context Sync globally:

• Restart VS Code completely
• Open Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
• Switch to Agent mode (if available)
• Look for context-sync in the Tools list
• Test: Ask Copilot "help me get started with context-sync"

Context Sync should appear in available tools! ✨

🔧 Setup for Cursor

Quick Setup for Cursor (30 seconds)

After installing Context Sync, in Claude Desktop type:

setup cursor

Claude will give you OS-specific instructions! ✨

Manual Cursor Setup

• Open Cursor: Settings → MCP

• Add this configuration:

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

• Refresh MCP servers

• Test: "Help me get started with context-sync"

Done! ✅

🔄 How It Works

┌─────────────┐                    ┌──────────────────┐                    ┌─────────────┐
│   Cursor    │ ────────────────>  │  Context Sync    │ <──────────────── │   Claude    │
│     IDE     │   Saves context    │   (Your Machine) │   Loads context   │   Desktop   │
└─────────────┘                    └──────────────────┘                    └─────────────┘
                                            │
                                            │ SQLite Database
                                            │ ~/.context-sync/
                                            ▼
                                    ┌──────────────────┐
                                    │  • Projects      │
                                    │  • Decisions     │
                                    │  • Architecture  │
                                    │  • TODOs         │
                                    │  • Code Context  │
                                    └──────────────────┘

100% Local • You Own Your Data • No Cloud • Open Source

⚡ Key Features

🔄 Cross-Platform Sync Cursor ↔ Claude Desktop ↔ VS Code. Context follows you everywhere. Works across all platforms

🧠 Perfect Memory Close everything. Come back next week. AI remembers your entire project. Never re-explain again

⚡ Fast & Safe Async operations, file size limits, cache invalidation. Built for performance. v0.6.0 optimizations

🔒 Local & Private SQLite database on your machine. No cloud. No tracking. You own everything. 100% under your control

📦 What Gets Synced:

• ✅ Project name, description, tech stack
• ✅ Architecture decisions and reasoning
• ✅ TODOs and task lists
• ✅ Code context (files, dependencies, types)
• ✅ Conversation summaries
• ✅ Git status and branches

💡 Smart Token Usage:

Uses only 1-3K tokens (not full conversation dumps)

Think of it like:

• ❌ Loading your entire codebase into RAM
• ✅ An IDE that loads files as you need them

Context Sync stores structured summaries. AI queries for details on-demand. You never saturate the context window.

⚡ Performance Optimizations (v0.6.0):

Faster, safer, more reliable:

• 🔒 File size limits - Prevents crashes with 5MB max file size
• 🔄 Real-time cache invalidation - File watchers automatically update caches
• ⚡ Async operations - All file I/O is non-blocking
• 🗄️ Database query optimization - Prepared statements (2-5x faster)
• 🎯 Smart file handling - Skips large files, warns on potential issues

🆚 How Is This Different?

vs Claude's /compact command

/compact command: Compresses ONE conversation Saves tokens in current chat Stays in same conversation Temporary solution

Context Sync: Works across ALL conversations Permanent memory forever Works across platforms (Cursor ↔ Claude) Complete solution

They're complementary! Use /compact for long chats, Context Sync for project memory.

vs Claude Pro subscription

Claude Pro ($20/month): ✅ More messages per day ✅ Longer context window ✅ Priority access ❌ Still forgets between chats

Context Sync (Free): ✅ Permanent memory across chats ✅ Cross-platform sync ✅ Local storage (you own it) ✅ Works with Pro or Free tier

You need both: Claude Pro for more messages, Context Sync for memory.

vs basic-memory

basic-memory: Simple context storage Claude Desktop only Basic features

Context Sync: ✅ Cross-platform (Cursor ↔ Claude) ✅ Advanced code analysis ✅ TODO management ✅ Git integration ✅ File operations ✅ Active development

Different needs: basic-memory for simple storage, Context Sync for full dev workflow.

vs Traycer

Traycer: Web wrapper around Claude Cloud-based Self-contained app

Context Sync: ✅ Works with native tools (Cursor + Claude Desktop) ✅ Local-first (your machine) ✅ Cross-platform sync ✅ Open source

Different approach: Traycer = new interface, Context Sync = enhance existing tools.

💬 Common Questions

Why isn't this built into Claude already?

Honest answer: Business incentives.

If Claude remembered everything perfectly:

• You'd have shorter conversations
• Use fewer messages
• Hit rate limits slower

Persistent memory makes AI more useful but potentially less profitable for AI companies.

That's why Context Sync is:

• Open source (no profit motive)
• Local-first (you own your data)
• Community-driven (built by developers, for developers)

Won't this fill up my context window?

No! Context Sync uses only 1-3K tokens per project.

How it works:

• Stores structured summaries (not full conversations)
• AI queries for details on-demand via MCP
• Never dumps everything into a new chat

Analogy:

• ❌ Bad: Loading 10GB codebase into RAM
• ✅ Good: IDE that loads files as needed

Example:

• Your 10K line project with 50 decisions
• Context Sync summary: ~1.5K tokens
• AI queries for specific details when needed

You never saturate because you're not copying conversations - you're giving AI access to a queryable database.

Is my data safe and private?

100% local. 100% yours.

• ✅ SQLite database on YOUR machine
• ✅ No cloud sync (unless you configure it)
• ✅ No data sent to our servers (we don't have servers!)
• ✅ Open source - audit the code yourself
• ✅ Delete anytime - just remove ~/.context-sync/

Database location:

• Mac/Linux: ~/.context-sync/data.db
• Windows: %USERPROFILE%\.context-sync\data.db

You control everything.

Does this work with VS Code?

Yes! Available in v0.6.0! 🎉

VS Code with GitHub Copilot is now fully supported through MCP integration.

Setup instructions:

• Install Context Sync: npm install -g @context-sync/server
• Restart VS Code
• Open Copilot Chat
• Switch to Agent mode
• Look for context-sync in Tools list

Currently works with:

• ✅ VS Code + GitHub Copilot (new!)
• ✅ Cursor IDE (full support)
• ✅ Claude Desktop (full support)

Does this work with Claude Code CLI?

Also coming in v0.6.0!

Claude Code just launched and supports MCP, so integration should be straightforward.

We're prioritizing:

• VS Code extension
• Claude Code CLI
• Better onboarding

Want it sooner? Let us know in GitHub Discussions!

Can I use this on mobile?

Not yet. Mobile requires:

• Claude mobile app to support MCP (not available yet)
• OR a custom mobile app (planned for future)

Current workaround:

• Use Claude.ai web on mobile (read-only)
• Full features on desktop only

Mobile support depends on Anthropic adding MCP to their mobile app.

How much does this cost?

Context Sync is 100% free and open source (MIT License).

Why free?

• Built by developers, for developers
• Solves a problem we personally had
• Community-driven development
• No profit motive = no business incentives to limit features

You might pay for:

• Claude Pro subscription (recommended but not required)
• Your time (2 minutes to set up)

That's it!

What if I have multiple projects?

Context Sync handles multiple projects beautifully!

You: "Switch to my blog project"
AI: [loads blog context instantly]

You: "List my projects"
AI: 
  1. TaskFlow (Next.js + Supabase)
  2. Personal Blog (Astro)
  3. Client Website (WordPress)

You: "Switch to TaskFlow"
AI: [back to TaskFlow context]

Each project maintains its own:

• Architecture decisions
• Tech stack
• TODOs
• Code context
• Conversation history

🎬 Real-World Example

Freelance Developer Workflow

Monday Morning (Cursor):

You: "Initialize project 'EcommerceClient' - Next.js 14, Stripe, PostgreSQL"
AI: "Project created! ✓"
*Build product catalog for 3 hours*

Tuesday Afternoon (Claude Desktop):

You: "Continue EcommerceClient - add shopping cart"
AI: "Adding cart to your Next.js app with Stripe integration.
     Using the product schema we defined yesterday..."

Wednesday (Cursor):

You: "Switch back to Cursor. Review cart implementation"
AI: "Analyzing cart code... found 2 potential improvements..."

No re-explaining. No context loss. Just continuous progress across tools.

🗺️ Roadmap

✅ v0.6.0 - Current Released October 2025 ✓ VS Code & GitHub Copilot support ✓ Performance optimizations ✓ Async file operations ✓ File size limits & safety ✓ Real-time cache invalidation

🔄 v0.7.0 - Next 6-8 weeks • Claude Code CLI support • Enhanced VS Code integration • Better onboarding flow • Improved documentation • Additional performance optimizations

🔮 Future Coming later • Mobile support • Team collaboration • Analytics dashboard • More AI platforms • Advanced features

See detailed roadmap: ROADMAP.md

📊 Stats

Recent milestones:

• 🎉 26 stars in first 24 hours
• 📦 400+ npm downloads in launch week
• 🚀 #17 on Product Hunt
• 💬 20K+ Reddit impressions

🛠️ Advanced Features

Full Feature List

Project Management

• Initialize and switch between projects
• Track architecture and tech stack
• Store design decisions with reasoning
• Manage TODOs and priorities

Code Analysis

• Dependency graph analysis
• Function call traces
• Type definition lookup
• Find all references
• Impact analysis

File Operations

• Read project structure
• Search files and content
• Modify files (with approval)
• Preview changes before applying

Git Integration

• Status and diff viewing
• Branch information
• Commit message suggestions
• Change tracking

Cross-Platform

• Seamless Cursor ↔ Claude sync
• Platform-specific optimizations
• Context handoff automation

Developer Tools

• 50+ MCP tools
• Extensible architecture
• TypeScript + SQLite
• Open source

🤝 Contributing

We love contributions! Here's how to help:

🐛 Report Bugs Create Issue

💡 Request Features Start Discussion

🛠️ Submit Code See Guide

📚 Improve Docs Help Here

See: CONTRIBUTING.md for detailed guidelines.

🌟 Community

Show your support: Give us a ⭐ on GitHub!

🔧 Troubleshooting

Claude Desktop doesn't see Context Sync

• Verify installation:

context-sync --version

• Check config file:

# Mac/Linux
cat ~/.config/Claude/claude_desktop_config.json

# Windows
type %APPDATA%\Claude\claude_desktop_config.json

• Restart Claude completely:

• Mac: ⌘ + Q (force quit)
• Windows: Right-click tray icon → Exit

• Check MCP servers in Claude: Look for Context Sync in settings

Still stuck? Create an issue

Cursor doesn't see Context Sync

• Open Cursor settings: Settings → MCP

• Verify configuration exists:

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

• Refresh MCP servers in Cursor

• Test: Ask AI "What's my current project?"

"No active project" error

Initialize a project first:

You: "Initialize project 'test-app'"

Or switch to existing:

You: "What projects do I have?"
You: "Switch to [project-name]"

Context not syncing between platforms

• Check platform status:

You: "Check platform status"

• Verify both platforms are configured

• Try manual sync:

You: "Sync context to Cursor"

More help: TROUBLESHOOTING.md

📄 License

MIT License - see LICENSE file for details.

TL;DR: Use it however you want. Commercial, personal, modify, distribute. Just keep the license.

🙏 Acknowledgments

Built with:

• Model Context Protocol by Anthropic
• TypeScript
• SQLite

Special thanks:

• Every developer who gave feedback on launch day
• Early adopters who believed in the vision
• The Claude AI community
• Contributors who helped build this

Built by developers tired of explaining the same thing 47 times.

💝 Support the Project

If Context Sync saves you time:

• ⭐ Star the repo
• 🐦 Share on Twitter
• 👍 Upvote on Product Hunt
• 💬 Tell other developers
• 🛠️ Contribute code or docs

Every bit helps more developers discover this tool!

Made with ❤️ by developers who were tired of re-explaining their projects

⬆ Back to Top

_{© 2025 Context Sync • Open Source • MIT License}