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 | Communities |
| Call stacks | Processes |
| Imports | Relationships |
| Grep | Semantic search |
Core Concepts
Knowledge Graph
The foundation: nodes, relationships, and graph queries
Communities
Functional groupings of related code
Processes
Execution flows through your codebase
Labels
Human-readable names for communities and processes
How It Works
Analysis
noodl analyze /path/to/reponoodlbox extracts:
- Symbols - Functions, classes, methods, variables
- Relationships - Calls, imports, contains
- Structure - Files, modules, packages
Community Detection
Using the Leiden algorithm, noodlbox identifies communities - clusters of code that work together. This reveals natural structure beyond file organization.
Process Extraction
noodlbox traces execution paths to identify processes - the flows that make your application work.
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-repo
@noodlbox:map://owner/my-repo/community/123Via Cypher:
MATCH (s:CODE_SYMBOL)-[:CALLS]->(t:CODE_SYMBOL)
RETURN s.name, t.name LIMIT 10Learn More
- Knowledge Graph - Graph structure and queries
- Communities - How code is grouped
- Processes - Execution flow tracing
- Labels - Human-readable naming system