Remcode

Turn Your AI Assistant Into a Codebase Expert

Remcode gives your AI assistant deep understanding of your code patterns, architecture, and conventions through intelligent vectorization and semantic search.

⚡ 30-Second Setup

1. Install

npx remcode

2. Add to AI Assistant

{
  "mcpServers": {
    "remcode": {
      "command": "npx",
      "args": ["remcode"],
      "env": {
        "PINECONE_API_KEY": "your_key_here",
        "HUGGINGFACE_TOKEN": "your_token_here",
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

{
  "remcode": {
    "command": "npx remcode",
    "env": {
      "PINECONE_API_KEY": "your_key_here",
      "HUGGINGFACE_TOKEN": "your_token_here",
      "GITHUB_TOKEN": "your_github_token"
    }
  }
}

{
  "mcpServers": {
    "remcode": {
      "command": "npx", 
      "args": ["remcode"],
      "env": {
        "PINECONE_API_KEY": "your_key_here",
        "HUGGINGFACE_TOKEN": "your_token_here",
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

3. Get API Keys

4. Start Using

Ask your AI assistant: "What authentication patterns are used in this codebase?"

🚀 Key Features

• 🧠 Codebase Intelligence: AI understands your code structure and patterns
• 🔍 Semantic Search: Find code by meaning, not just keywords
• 🤖 SWE Best Practices: Built-in software engineering guidance
• 🔗 MCP Protocol: Direct integration with AI assistants
• ⚡ Zero Configuration: Works out of the box with smart defaults
• 🛡️ Privacy First: Your code stays in your environment

🎯 How It Works

1. Analyzes Your Code: Remcode understands your codebase structure and patterns
2. Creates Embeddings: Generates semantic representations using CodeBERT
3. Enables AI Search: Your assistant can find and understand code contextually
4. Provides Guidance: Offers software engineering best practices specific to your code

🧪 Testing

Quick Test:

npx remcode inspector

Opens MCP Inspector for interactive testing of all tools.

Full Test Suite:

npm test

📚 Documentation

• Contributing Guide - How to contribute
• Strategy Framework - Development planning and session management
• License - MIT License

🛠️ Development

Remcode uses a strategy-driven development framework for systematic progress tracking:

• Session Management: All development work is tracked through strategic sessions
• Multiple Strategies: LLM optimization, production readiness, community growth
• Automated Validation: Pre-commit hooks ensure session documentation
• Progress Tracking: Real-time metrics and compliance monitoring

# View current strategies and progress
cd sessions && npm run strategies
cd sessions && npm run status

For development workflow, see Strategy Framework Documentation.

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📦 Tech Stack

• TypeScript - Type-safe development
• CodeBERT - Code-specific embeddings
• Pinecone - Vector database
• Model Context Protocol - AI assistant integration
• GitHub Actions - Automated processing

📄 License

MIT License - see LICENSE for details.

Made with ❤️ for developers who want smarter AI assistants