read_directory
List files and folders in a directory to explore the file structure within accessible roots for architectural decision record analysis.
Instructions
List files and folders in a directory. Use this to explore the file structure within accessible roots.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Directory path to list (relative to project root or absolute within roots) |
Implementation Reference
- src/tools/tool-catalog.ts:1045-1064 (registration)Registers the 'read_directory' tool in the central TOOL_CATALOG with full metadata including input schema (path: string required, recursive: boolean optional). Used for dynamic tool discovery, MCP ListTools responses, and search_tools meta-tool.TOOL_CATALOG.set('read_directory', { name: 'read_directory', shortDescription: 'Read directory contents', fullDescription: 'Lists contents of a directory.', category: 'file-system', complexity: 'simple', tokenCost: { min: 100, max: 1000 }, hasCEMCPDirective: true, // Phase 4.3: Simple tool - directory read relatedTools: ['read_file', 'list_directory'], keywords: ['directory', 'read', 'list'], requiresAI: false, inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to directory' }, recursive: { type: 'boolean', default: false }, }, required: ['path'], }, });
- src/tools/tool-catalog.ts:1045-1064 (schema)Defines the input schema and complete metadata for the read_directory tool, including description 'Read directory contents and metadata', category 'file-system', and no AI requirement.TOOL_CATALOG.set('read_directory', { name: 'read_directory', shortDescription: 'Read directory contents', fullDescription: 'Lists contents of a directory.', category: 'file-system', complexity: 'simple', tokenCost: { min: 100, max: 1000 }, hasCEMCPDirective: true, // Phase 4.3: Simple tool - directory read relatedTools: ['read_file', 'list_directory'], keywords: ['directory', 'read', 'list'], requiresAI: false, inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to directory' }, recursive: { type: 'boolean', default: false }, }, required: ['path'], }, });
- src/utils/server-context-generator.ts:310-310 (registration)Lists 'read_directory' tool in the hardcoded server context generation for LLM awareness, under File System Operations category.{ name: 'read_directory', description: 'Read directory contents and metadata' },