CodeMind 🧠

World's first Redis-powered MCP server for permanent codebase memory

Index once, query forever—across unlimited sessions, context restarts, and conversations. Sub-millisecond graph queries on 100k+ functions.

The Problem

AI assistants forget your codebase every session restart. You re-explain the same architecture. Every. Single. Time.

You: "What does processPayment do?"
AI: *reads file, parses AST, builds context...*
AI: "It calls validateOrder and updateDatabase"

[Session restarts]

You: "What calls processPayment?"
AI: "I don't have access to our previous conversation..."

This is insane.

The Solution

CodeMind indexes your codebase into a Redis graph. AI assistants query it in <1ms. Forever.

# Index once
codemind-index /path/to/your/project

# Query forever (even after 100 session restarts)
"What does processPayment do?"
→ Redis: 0.5ms → File: payment.js, Line: 42, Calls: [validateOrder, updateDatabase]

"What breaks if I change validateOrder?"
→ Redis: 0.3ms → Affected: [processPayment, checkout, retryPayment]

No re-reading. No re-parsing. Permanent memory.

Features

• ⚡ Sub-millisecond queries - Redis graph storage for instant function lookups
• 🔄 Survives session restarts - Permanent memory that persists across conversations
• 📊 Call graph analysis - Trace dependencies and find affected functions
• 🔍 Incremental indexing - Only re-index changed files
• 🎯 JavaScript/TypeScript support - Powered by Babel parser
• 🔌 MCP integration - Works with Cursor, Claude Desktop, any MCP client
• 📈 Production-grade - Structured logging, error handling, battle-tested

Quick Start

1. Install

npm install -g codemind

2. Start Redis

redis-server

3. Index Your Code

# Interactive mode
codemind

# Or command line
codemind-index /path/to/your/project

4. Query Functions

# Find a function
codemind-query find processPayment

# Trace dependencies
codemind-query trace processPayment --depth 3

# Find what breaks
codemind-query affected validateOrder

# Show stats
npm run stats

MCP Integration (Cursor, Claude Desktop)

Setup

Add to ~/.cursor/mcp.json (or Claude config):

{
  "mcpServers": {
    "codemind": {
      "command": "node",
      "args": ["$(npm root -g)/codemind/src/mcp/server.js"],
      "env": {
        "REDIS_URL": "redis://127.0.0.1:6379"
      }
    }
  }
}

Usage

In Cursor chat:

"Use codemind to index /path/to/my/project"
"What does startApp do?"
"Trace dependencies of processPayment"
"What breaks if I change sendEmail?"

The AI answers instantly from Redis. Every time. Forever.

CLI Commands

| Command | Description | |---------|-------------| | codemind | Interactive mode with prompts | | codemind-index <path> | Index a codebase | | codemind-query find <name> | Find function details | | codemind-query trace <name> | Trace dependencies | | codemind-query affected <name> | Find affected functions | | codemind-query list | List all functions | | codemind-query stats | Show statistics |

How It Works

Your Code Files
       ↓
Babel Parser (extracts functions & calls)
       ↓
Redis Graph Storage
  ├── function:NAME → metadata (HASH)
  ├── function:NAME:calls → SET
  └── function:NAME:called_by → SET
       ↓
MCP Tools / CLI query Redis
       ↓
AI gets instant answers (<1ms)
       ↓
SURVIVES SESSION RESTARTS ✨

Redis Schema

# Function metadata
HGETALL function:processPayment
{
  file: "/path/to/payment.js",
  line: "42",
  params: '["order", "userId"]',
  isAsync: "1"
}

# Call graph
SMEMBERS function:processPayment:calls
["validateOrder", "updateDatabase"]

SMEMBERS function:validateOrder:called_by
["processPayment", "checkout"]

Configuration

Create .env:

REDIS_URL=redis://localhost:6379
LOG_LEVEL=info
IGNORE_PATTERNS=node_modules,.git,dist,build
MAX_FILE_SIZE_MB=5

Performance

| Operation | Time | Description | |-----------|------|-------------| | Index 100 files | ~5s | Parse + store | | Index 1000 files | ~50s | Incremental available | | Query function | <1ms | Redis lookup | | Trace deps (5 levels) | <10ms | Graph traversal | | Find affected | <5ms | Reverse lookup |

Tested on 20k+ functions. Scales to 100k+.

Examples

Find Function

$ codemind-query find startApp

📍 Function: startApp
  File: /path/to/app.js
  Lines: 1-5
  
Calls:
  → initDatabase
  → startServer
  → log

Trace Dependencies

$ codemind-query trace startApp

🔗 Dependency tree:

● startApp
  → initDatabase
    → connectToDB
    → runMigrations
  → startServer
    → listenOnPort

Find Affected

$ codemind-query affected sendEmail

⚠️  3 functions would be affected:
  • sendConfirmation
  • processPayment
  • notifyAdmin

Stats Dashboard

$ npm run stats

📊 CodeMind Stats Dashboard

📁 Database Overview
  Files indexed:      22
  Functions indexed:  76
  
🔗 Call Graph Metrics
  Functions with calls:  72
  Avg calls per function: 3.7
  
💚 Codebase Health Score
  ████████░░ 80%

Why CodeMind?

vs. Reading Files Every Time

• 1000x faster (Redis vs file I/O + parsing)
• Zero context consumed (no need to load files into AI context)
• Permanent (survives restarts)

vs. Bigger Context Windows

• More efficient (query graph vs read everything)
• More accurate (structured data vs text search)
• Unlimited (Redis stores any amount)

vs. Other Code Indexers

• MCP native (works with any AI assistant)
• Redis-powered (battle-tested, scalable)
• Sub-millisecond (in-memory graph queries)

Extending

Add Python Support

// parsers/python-parser.js
import BaseParser from './base-parser.js';

class PythonParser extends BaseParser {
  canParse(filePath) {
    return /\.py$/.test(filePath);
  }
  
  async parse(filePath, content) {
    // Use Python AST parser
    return { functions: [], imports: [], classes: [] };
  }
}

// Register in codebase-indexer.js
this.parserRegistry.register(new PythonParser());

Troubleshooting

Redis Connection Failed

# Start Redis
redis-server

# Check connection
redis-cli ping  # Should return PONG

No Functions Found

# Re-index with force flag
codemind-index /path/to/project -f

MCP Not Working

1. Check ~/.cursor/mcp.json config
2. Restart Cursor completely (Cmd+Q)
3. Verify in Settings → Features → MCP

Roadmap

• [ ] Python, Go, Java parsers
• [ ] Semantic search with embeddings
• [ ] Class/import tracking
• [ ] Watch mode (auto re-index on file changes)
• [ ] Web dashboard
• [ ] Multi-repo support

Contributing

PRs welcome! CodeMind is built to be extended.

1. Fork the repo
2. Create a feature branch
3. Make your changes
4. Submit a PR

License

MIT © Rohan Sawai

Credits

Built with:

• @babel/parser - AST parsing
• ioredis - Redis client
• @modelcontextprotocol/sdk - MCP integration
• pino - Logging

Give AI permanent code memory. Index once. Query forever. 🧠✨