CodeMind

# CodeMind 🧠

Give GitHub Copilot memory across all your projects

CodeMind is an MCP server that gives GitHub Copilot 20 specialized tools for understanding your codebase.

Why CodeMind?

Without it:

• ❌ Copilot creates duplicate files

• ❌ Forgets decisions you just made

• ❌ Doesn't understand your project structure

With it:

• ✅ Finds existing code before creating new files

• ✅ Remembers architectural decisions

• ✅ Understands dependencies and relationships

• ✅ Warns about breaking changes

Related MCP server: CodeSense MCP

Quick Start

Option 1: Install from PyPI (Recommended)

1. Install the package

pip install mcp-codemind

2. Configure VS Code

Add to .vscode/settings.json:

{
  "mcp.servers": {
    "codemind": {
      "command": "python",
      "args": ["-m", "codemind"]
    }
  }
}

3. Reload

Press Ctrl+Shift+P → "Developer: Reload Window"

Done! 🎉

Option 2: Install from Source

1. Clone and install

git clone https://github.com/MrUnreal/codemind.git
cd codemind
pip install -r requirements.txt

2. Configure VS Code

Add to your VS Code settings (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"):

{
  "mcp.servers": {
    "codemind": {
      "command": "python",
      "args": ["/full/path/to/codemind.py"],
      "cwd": "${workspaceFolder}"
    }
  }
}

Replace /full/path/to/codemind.py with the actual path to where you cloned CodeMind.

3. Reload VS Code

Press Ctrl+Shift+P → "Developer: Reload Window"

4. Test It

Open Copilot Chat and try:

Does this project have authentication?

Done! 🎉

Need help? Check our Troubleshooting Guide

What You Get

20 AI Tools in 6 Categories:

How It Works

┌─────────────────────────────────────────────────────────────┐
│  You: "Add authentication"                                  │
└────────────────────────┬────────────────────────────────────┘
                         │
                         v
┌─────────────────────────────────────────────────────────────┐
│  Copilot (with CodeMind):                                   │
│  🔍 Searching existing code...                              │
│  âś… Found: src/auth/jwt.py (95% match)                      │
│  💡 "I found existing JWT auth. Should I extend it?"        │
└─────────────────────────────────────────────────────────────┘

Without CodeMind:
❌ Creates duplicate auth files
❌ Doesn't know about existing code
❌ No context of your architecture

You ask naturally → Copilot automatically uses CodeMind → Gets smart suggestions

No explicit tool calls needed!

Example Usage

💬 "Does this project have authentication?"
✅ Found in src/auth/jwt.py

💬 "What will break if I rename UserModel?"
⚠️ 7 files will be affected

💬 "What depends on database.py?"
📋 Used by: models/, auth/, tests/

💬 "Show me TODOs"
📝 Found 12 TODOs across 5 files

Multi-Workspace Support

Work with multiple projects simultaneously:

• Each project gets its own database

• No cross-contamination

• Isolated configurations

Documentation

Requirements

• Python 3.8 or higher

• VS Code with GitHub Copilot

• ~80MB for embedding model (downloaded automatically on first use)

• ~1-5MB per project for database

Status

• ✅ 20/20 tools operational

• ✅ 110+ tests passing (99%+ rate)

• ✅ Production ready

• ✅ Actively maintained

Contributing

Contributions welcome! See CONTRIBUTING.md

License

MIT - See LICENSE

Built with: Python, FastMCP, sentence-transformers, SQLite

Making Copilot smarter, one project at a time 🚀