Project search
Full-text search across the workspace files.
How to open
GET /api/project/search?q=<query> returns JSON with file path, match count, and short line previews. The UI surface is the Find in project field in the sidebar (below the file finder).
What it searches
- All textlike files in the workspace.
- Skips
node_modules/,.git/,__pycache__/,dist/,build/. - Case-insensitive substring by default. Wrap your query in
/…/for regex.
Result format
Each result line shows:
- File path (clickable — opens the file at the first match).
- Match count badge.
- A 2-line preview around the first match with the matched substring highlighted.
When to use which search
| You want to find… | Use |
|---|---|
| A file by name | File tree finder |
| A function or class definition | Symbol indexer |
| A literal string anywhere in code | This (project search) |
| A concept ("auth middleware", "rate limit") | Ask the codebase |
| A command to run | Command palette |
Limits
- 10,000 files max per search.
- 1 MB per file max scan.
- 200 results returned per query.
- Timeout 5 seconds.
For very large repos, narrow the search by prefixing your query with a path filter:
@subdir:routes/ rate_limit(The @subdir: prefix is a search-only mention syntax — different from planner @-mentions.)