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

``bash
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

$3

`bash
npm install -g coreon-mcp
`

$3

`bash
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

`bash
coreon serve
`

$3

#### Option A: Claude Desktop

Run setup helper:
`bash
coreon setup-claude
`

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

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

Restart Claude Desktop.

#### Option B: ChatGPT Desktop (Developer Mode)

Run setup helper:
`bash
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

$3

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)

$3

Command: coreon init

- 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

$3

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

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

$3

Works seamlessly with:
- Claude Desktop
- ChatGPT Desktop (Developer Mode)
- Cursor
- Any MCP-compatible AI assistant

📋 CLI Commands

| Command | Description |
|---------|-------------|
| coreon init | 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:

`bash
coreon doctor
`

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

$3

Error: "C++20 or later required"
- Cause: Node.js 24+ requires C++20 to compile native addons
- Solution: Use Node.js 20 LTS instead:
`bash
# 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