noodlbox

Analyze

Analyze a repository and build its knowledge graph

The noodlbox_analyze tool indexes a repository, extracting code entities, relationships, and building a queryable knowledge graph.

Parameters

ParameterTypeRequiredDefaultDescription
pathstringYes-Absolute path to the repository
forcebooleanNofalseRe-analyze even if already analyzed
include_docsbooleanNotrueInclude markdown documentation analysis

Usage

Analyze the repository at /path/to/my-project

The agent will call noodlbox_analyze with the path.

When to Use

  • First-time setup: Index a new repository before querying
  • After major changes: Re-analyze with force: true after significant refactoring
  • Adding documentation: Enable include_docs to link markdown files to code symbols

What Gets Analyzed

The analysis extracts:

EntityDescription
SymbolsFunctions, classes, methods, variables
FilesSource files with metadata
RelationshipsCalls, imports, contains, inherits
CommunitiesAuto-detected clusters of related code
ProcessesExecution flows through your application
DocumentsMarkdown files linked to code symbols (if include_docs: true)

Example

Use noodlbox_analyze to index /Users/me/projects/my-app with documentation included

Response:

Analysis complete for owner/my-app:
- 1,247 symbols extracted
- 3,892 relationships discovered
- 42 communities detected
- 156 processes identified
- 23 documents linked

On this page