Production-grade Node.js code intelligence engine powered by Tree-sitter.
- Tree-sitter parsing — incremental, error-tolerant AST parsing
- Lazy grammar loading — grammars loaded on first use per language
- Symbol extraction — functions, classes, methods, variables, imports, exports
- Streaming file reads — handles multi-GB projects without loading files entirely into memory
- Directory walking — respects ignore lists (node_modules, .git, etc.)
- Content hashing — caches parse results for unchanged files
- Extensible architecture — modular design for easy language and feature additions
code-engine/
├── src/
│ ├── api/ # Public API (Phase 6)
│ │ └── index.js
│ ├── cache/ # File-level parse cache
│ │ └── index.js
│ ├── database/ # SQLite storage (Phase 2)
│ │ └── index.js
│ ├── indexer/ # Project indexing (Phase 2)
│ │ └── index.js
│ ├── parser/ # Tree-sitter parsing & symbol extraction
│ │ ├── parser.js
│ │ ├── language-loader.js
│ │ └── javascript-extractor.js
│ ├── search/ # Symbol & full-text search (Phase 3)
│ │ └── index.js
│ ├── utils/
│ │ └── file-stream.js
│ ├── workers/ # Worker thread pool (Phase 5)
│ │ └── index.js
│ ├── constants.js
│ └── index.js # CLI entry point
├── package.json
└── README.md
npm install
# Parse a single file
node src/index.js parse ./path/to/file.js
# Walk a directory
node src/index.js walk ./path/to/project
# Show supported languages
node src/index.js info
# Parse from stdinecho"function hello() { return 42; }"| node src/index.js source javascript| Language | Extensions |
|---|---|
| JavaScript | .js, .mjs, .cjs, .jsx |
More languages coming in Phase 4: TypeScript, Python, PHP, Java, C#, C++, Go, Rust, HTML, CSS, JSON.
| Phase | Status | Description |
|---|---|---|
| 1 | ✅ | Project structure, Parser, JavaScript support |
| 2 | ✅ | SQLite database, Indexer |
| 3 | ✅ | Symbol & full-text search |
| 4 | ✅ | Multi-language support (13 languages) |
| 5 | ✅ | Worker threads for parallel parsing |
| 6 | ✅ | Retriever API, public API, and AI context queries |
import{createEngine}from'./src/api/index.js';constengine=awaitcreateEngine('/path/to/project');awaitengine.indexProject();constsymbols=awaitengine.searchSymbols('myFunction');constrefs=awaitengine.findReferences('myFunction');MIT