Skip to content

Intina47/context-sync

BranchesTags

Repository files navigation

Context Sync 🧠

Context Sync - AI Context Management



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


Cursor Claude Desktop VS Code

npm stars downloads Setup time Token usage

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

Context Sync - Persistent AI memory across Claude Desktop & Cursor IDE | 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 and Claude Desktop automatically.



🎯 Who This Is For

✅ Perfect For You If:

  • You use Cursor AND Claude Desktop
  • 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 or Claude Desktop
  • 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:

  1. Install: npm install -g @context-sync/server
  2. Restart Claude Desktop:
    • Mac: ⌘ + Q (force quit from menu)
    • Windows: Right-click tray icon → Exit
  3. In Claude Desktop, type: "help context-sync"
  4. Follow the guided setup! ✅ You're done!

🔧 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

  1. Open Cursor: Settings → MCP

  2. Add this configuration:

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

  1. Refresh MCP servers

  2. Test: "What's my current project?"

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

Start in Cursor, continue in Claude Desktop. Context follows you automatically.

This is the main feature

🧠

Perfect Memory

Close everything. Come back next week. AI remembers your entire project.

Never re-explain again

🔒

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.



🆚 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:

  1. Stores structured summaries (not full conversations)
  2. AI queries for details on-demand via MCP
  3. 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?

Coming in v0.6.0! (Next 6-8 weeks)

VS Code extension is our most requested feature from launch day.

Want to be notified when it's ready?

  • ⭐ Star the repo
  • 👀 Watch releases
  • 💬 Join discussions

Currently works with:

  • ✅ 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:

  1. VS Code extension
  2. Claude Code CLI
  3. 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.5.0 - Current

Released October 2025

✓ Cross-platform sync
✓ TODO management
✓ Code analysis tools
✓ Git integration
✓ 50+ MCP tools

🔄 v0.6.0 - Next

6-8 weeks

• VS Code extension
• Claude Code CLI
• Better onboarding
• Improved docs
• Performance optimization

🔮 Future

Coming later

• Mobile support
• Team collaboration
• Analytics dashboard
• More 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

Discussions Product Hunt Twitter



Show your support: Give us a ⭐ on GitHub!


Star


🔧 Troubleshooting

Claude Desktop doesn't see Context Sync
  1. Verify installation:
context-sync --version
  1. Check config file:
# Mac/Linux
cat ~/.config/Claude/claude_desktop_config.json

# Windows
type %APPDATA%\Claude\claude_desktop_config.json
  1. Restart Claude completely:
  • Mac: ⌘ + Q (force quit)
  • Windows: Right-click tray icon → Exit
  1. Check MCP servers in Claude: Look for Context Sync in settings

Still stuck? Create an issue

Cursor doesn't see Context Sync

  1. Open Cursor settings: Settings → MCP

  2. Verify configuration exists:

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

  1. Refresh MCP servers in Cursor

  2. 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
  1. Check platform status:
You: "Check platform status"

  1. Verify both platforms are configured

  2. 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:

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

About

MCP server that gives Claude persistent memory and workspace file access

Topics

github typescript sqlite npm-package file-access workspace developer-tools cursor copilot producthunt claude-ai mcp-server context-sync

Resources

Readme

License

MIT license

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

29 stars

Watchers

2 watching

Forks

1 fork
Report repository

Releases 5

Global Todo List Management Latest
Oct 22, 2025
+ 4 releases

Packages

No packages published

Languages