Coreon

Universal code intelligence for AI assistants

Coreon gives Claude, ChatGPT, and other AI assistants deep understanding of your codebase through AST parsing, semantic search, and architecture analysis.

📦 Installation

npm install -g coreon-mcp

After installation, use the coreon command from any directory.

Questions or Issues? Join our Discord: https://discord.gg/2YnqKyvNrb

🎯 Pricing Tiers

V1 Free Tier

• ✅ Core code search and indexing
• ✅ Architecture understanding
• ✅ Basic MCP integration
• ✅ 30 requests/minute rate limit
• ✅ 500 requests/hour rate limit
• ✅ 5,000 requests/day rate limit

V2 Premium Tier

• ✅ All V1 features
• ✅ Semantic search
• ✅ Advanced refactoring tools
• ✅ Multi-branch indexing
• ✅ API uploads
• ✅ 100 requests/minute rate limit
• ✅ 5,000 requests/hour rate limit
• ✅ 50,000 requests/day rate limit

Upgrade: https://coreon.ai/subscribe

🚀 Quick Start

Prerequisites

• Node.js: 18.x, 20.x, or 21.x (Node 24+ requires C++20 compiler)
• Recommended: Node.js 20 LTS

1. Install Coreon

npm install -g coreon-mcp

2. Index Your Repository

cd /path/to/your/project
coreon init .

This will:

• Scan your codebase
• Parse code with AST (Abstract Syntax Trees)
• Extract functions, classes, methods, and dependencies
• Create a local SQLite database

3. Start the MCP Server

coreon serve

4. Connect to Your AI Assistant

Option A: Claude Desktop

Run setup helper:

coreon setup-claude

Or manually add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "coreon": {
      "command": "coreon",
      "args": ["serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

Restart Claude Desktop.

Option B: ChatGPT Desktop (Developer Mode)

Run setup helper:

coreon setup-chatgpt

This will show you the exact configuration file location and setup steps.

Prerequisites:

• ChatGPT Plus subscription
• Developer Mode enabled in ChatGPT settings

5. Start Asking Your AI Assistant

Try these queries:

• "Explain the architecture of this repo."
• "Trace the execution path when the login route is called."
• "Show all functions related to authentication."
• "Find all API endpoints in this codebase."
• "What files handle error handling?"

📖 Core Features (V1)

1. Repository Indexing

Command: coreon init <path>

• AST-based parsing (not just text search)
• Extracts functions, classes, methods, variables
• Tracks dependencies and imports
• Smart change detection (only re-indexes changed files)
• Supports 60+ programming languages

2. Code Search

Three powerful search modes:

• Symbol Search - Find functions, classes, methods by name
• Contextual Search - Understand intent, not just keywords
• Regex Search - Pattern-based code finding

3. Architecture Understanding

• Explain Architecture - Understand how your system works
• Trace Execution Path - Follow function calls from entry point to database

4. MCP Integration

Works seamlessly with:

• Claude Desktop
• ChatGPT Desktop (Developer Mode)
• Cursor
• Any MCP-compatible AI assistant

📋 CLI Commands

| Command | Description | |---------|-------------| | coreon init <path> | Initialize and index a repository | | coreon serve | Start the MCP server | | coreon status | Show indexing statistics | | coreon reindex | Re-index the repository | | coreon doctor | Run diagnostics | | coreon setup-claude | Show Claude Desktop setup instructions | | coreon setup-chatgpt | Show ChatGPT Desktop setup instructions |

🛠️ How It Works

1. Scans your codebase for source files
2. Parses using AST parsers (Tree-sitter + Babel) for deep understanding
3. Extracts functions, classes, methods, dependencies
4. Indexes into local SQLite database
5. Serves via MCP protocol for AI assistants

🌍 Language Support

Full AST Parsing:

• JavaScript/TypeScript
• Python
• Go
• Rust
• Java
• Objective-C
• Zig

Regex-based Parsing:

• 50+ additional languages (C/C++, Ruby, PHP, Swift, Kotlin, Scala, C#, and more)

🔒 Privacy First

• 100% Local - All processing happens on your machine
• No Cloud Dependency - Works completely offline
• Your Code Stays Private - Nothing is sent to external servers

📚 Documentation

After running coreon init, check .coreon/QUICKSTART.md for detailed getting started instructions.

🐛 Troubleshooting

Run coreon doctor to diagnose issues:

coreon doctor

Need Help? Join our Discord community for questions, bug reports, and support: 👉 https://discord.gg/2YnqKyvNrb

Installation Issues

Error: "C++20 or later required"

• Cause: Node.js 24+ requires C++20 to compile native addons
• Solution: Use Node.js 20 LTS instead:

  # Using nvm (recommended)
  nvm install 20
  nvm use 20
  npm install -g coreon-mcp

• Alternative: If you must use Node 24+, ensure your compiler supports C++20

📄 License

MIT

💬 Community & Support

Questions, bugs, or need help? Join our Discord community: 👉 https://discord.gg/2YnqKyvNrb

Made with for developers who want AI to truly understand their code