Platform
Understand the noodlbox platform and its core concepts
noodlbox transforms your codebase into an intelligent knowledge graph that understands code relationships, not just files.
Core Philosophy
Traditional code navigation is file-based: directories, imports, grep. But developers think in features, flows, and functionality.
noodlbox reimagines code understanding:
| Traditional | noodlbox |
|---|---|
| Directories | Structural relationships |
| Manual navigation | Graph queries |
| Imports | Relationships |
| Grep | Semantic search |
Core Concepts
How It Works
Analysis
noodl analyze /path/to/reponoodlbox extracts:
- Symbols - Functions, classes, methods, variables
- Relationships - Calls, imports, contains
- Structure - Files, modules, packages
Knowledge Graph
Everything is stored in LanceDB - a unified storage layer for both graph queries and full-text search:
- Graph Storage - Relationships and traversals via lance-graph
- Full-Text Search - BM25-ranked code search with Tantivy
// Find all functions that call authentication code
MATCH (caller)-[:CALLS]->(auth:CODE_SYMBOL)
WHERE auth.name CONTAINS 'auth'
RETURN caller.name, auth.nameCLI Commands
| Command | Description |
|---|---|
noodl analyze <path> | Analyze a repository |
noodl list | List analyzed repositories |
noodl delete <repo> | Delete an analyzed repository |
noodl configure | Configure AI agents (global) |
noodl status | Check authentication |
See the CLI Reference for the complete command list.
Accessing the Graph
Via MCP (recommended):
@noodlbox:map://owner/my-repoVia Cypher:
MATCH (s:CODE_SYMBOL)-[:CALLS]->(t:CODE_SYMBOL)
RETURN s.name, t.name LIMIT 10Learn More
- Knowledge Graph - Graph structure and queries