codebase-search

Semantic local search powered by MorphLLM — an RL-trained subagent that runs ~15-30 internal grep+read operations to answer natural language questions about any project files (code, config, docs, markdown, YAML, JSON, and other text files). Unlike simple grep, it understands intent and traces cross-file flows.

Requires MORPH_API_KEY environment variable.

When to Use

• Understanding how a feature works across multiple files (e.g., "how does the auth middleware validate tokens?")
• Tracing data flow end-to-end (e.g., "what happens when a user clicks checkout?")
• Exploring unfamiliar projects where you don't know what to grep for
• Answering architectural questions (e.g., "how is the database layer organized?")
• Debugging cross-file interactions where the connection isn't obvious
• Finding information in non-code files — config, docs, markdown, YAML, JSON (e.g., "how are the plugin hooks configured?")

When NOT to Use

• Simple keyword or symbol searches (e.g., finding all uses of handleSubmit) — use Grep
• Finding files by name or pattern — use Glob