---

name: codebase-search description: Semantic code search by meaning. Use codebase_peek to find WHERE code is (saves tokens), codebase_search to see actual code. For exact identifiers, use grep instead.

Codebase Search Skill

When to Use What

Recommended Workflow

1. Locate with peek: codebase_peek("authentication flow") → get file locations
2. Read what matters: Read the specific files you need
3. Drill down with grep: grep "validateToken" for exact matches

Tools

codebase_peek

Find WHERE code is. Returns metadata only (file, line, name, type).

Copycodebase_peek(query="validation logic", chunkType="function", directory="src/utils")

codebase_search

Find code with full content. Use when you need to see implementation.

Copycodebase_search(query="error handling middleware", fileType="ts", contextLines=2)

find_similar

Find code similar to a given snippet. Use for duplicate detection, pattern discovery, refactoring.

Copyfind_similar(code="function validate(input) { return input.length > 0; }", excludeFile="src/current.ts")

index_codebase

Create/update index. Required before first search. Incremental (~50ms when unchanged).

index_status

Check if indexed and ready.

Query Tips

Describe behavior, not syntax:

• Good: "function that hashes passwords securely"
• Bad: "hashPassword" (use grep for exact names)

Filters