ck_fs_grep
Read-onlyIdempotent
Search file contents in your project using grep-style patterns. Supports fixed-string or regex search, scoped by directory or glob, and returns matching lines with file paths and line numbers.
Instructions
Search file contents inside the bound project root using grep-style pattern matching. Read-only — no files are modified. query uses fixed-string search by default; set fixed_strings: false to treat it as a regex. Scope the search with path (a relative directory or glob); omit to search the entire project. Returns matching lines with file path and line numbers. limit caps results (default 50). Use ck_fs_grep to find code patterns or strings inside files. Use ck_fs_find to locate files by name fragment. Use ck_fs_read to read a specific file by path.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | File or directory path relative to the project root. | |
| limit | No | Maximum number of results to return. | |
| query | Yes | Search query string for filtering or full-text search. | |
| session_id | No | Unique session identifier for correlating findings, proofs, budget, and audit trail. | |
| ignore_case | No | When true, perform case-insensitive matching. | |
| project_root | No | Absolute path to the project root directory on the local filesystem. | |
| fixed_strings | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | No | ||
| matches | No |