codebase_search
Perform semantic search across an indexed codebase using natural language queries. Returns code chunks that match the described functionality.
Instructions
Semantic search across an indexed codebase. Only use after codebase_index is complete (check codebase_status first). Returns relevant code chunks matching a natural language query.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return. Default: 10 (override globally via SEARCH_DEFAULT_LIMIT env var). | |
| query | Yes | Natural language search query (e.g. 'authentication middleware', 'database connection setup'). | |
| minScore | No | Minimum RRF score threshold (0-1). Results below this are filtered out. Default: 0.10 (override globally via SEARCH_MIN_SCORE env var). Set to 0 to disable filtering. | |
| fileFilter | No | Filter results to a specific file path (relative). | |
| projectPath | No | Absolute path to the project directory. | |
| includeLinked | No | When true, also search across linked projects defined in .socraticode.json or SOCRATICODE_LINKED_PROJECTS env var. Results include a project label showing which project each result came from. Default: false. | |
| languageFilter | No | Filter results to a specific language (e.g. 'typescript', 'python'). |