Code Explorer Task Agent
The Code Explorer Task Agent analyzes, parses, and maps HDL codebases. It serves as the project-awareness engine, helping you understand complex RTL projects and extracting the underlying design hierarchy.
It works efficiently on large source directories, discovering module boundaries, dependencies, and structural metadata without requiring a full compiler setup.
Key Features
- Hierarchical Mapping: Discovers module names, instantiations, and structural metadata across an entire source directory.
- Broad HDL Support: Extracts metadata from Verilog, SystemVerilog, and VHDL files.
- Project Awareness: Empowers orchestrator agents (like the Design Agent) to navigate unfamiliar codebases safely and understand the broader scope before making changes.
- Fast Analysis: Relies on lightweight parsing techniques to traverse the repository structure quickly.
Command Options
The Code Explorer task agent supports the following command-line option:
| Option | Description |
|---|---|
--source-dir |
Required. Path to the source directory containing the HDL files you want to explore. |
Usage
Use the Code Explorer task agent through the NEX CLI by specifying --agent=explorer.
Basic Command
Map the contents of an entire RTL directory:
The agent will walk the directory structure, parse the source files, and return a comprehensive view of the discovered modules and their metadata.
Orchestrated Usage
While the CLI provides a quick way to audit a directory, the real power of the Code Explorer is when it is invoked internally by NEX during an interactive session. Whenever you ask NEX to "analyze the project" or "find where the ALU is instantiated," it leverages the Code Explorer under the hood to ground its answers in the actual codebase structure.