Coreon

Universal code intelligence for AI assistants

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

🎯 Pricing Tiers

$3

- ✅ 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

$3

- ✅ 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

$3

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

$3

``bash
npm install -g @aryav/coreon
`

$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

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

`json
{
"mcpServers": {
"coreon": {
"command": "sh",
"args": [
"-c",
"cd /path/to/your/project && coreon serve"
]
}
}
}
`

Restart Claude Desktop.

$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
- 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 |

🛠️ 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
`

$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 @aryav/coreon
``
- Alternative: If you must use Node 24+, ensure your compiler supports C++20

📄 License

MIT

---

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