kdeps-tools-search_local
v1.3.0Search for text patterns in local files using ripgrep. Returns matching files with a snippet, and (when the query is found) a match_id/line/revision - pass match_id to read_file to jump straight to that hit. Use for finding usages, patterns, or strings across the codebase. Requires: query (search term). path is the directory to search; leave it out to search every folder of the working project (its own and the search folders its card lists). Optional: glob (file pattern), limit (max results, default 3), index (rank results with the folder index); index also accepts fuzzy, maxDistance, indexDBPath and graphBoost.
set tools / shelf rag
LLM context: ~391 tokens when loaded (prompt or tool definition)
Where it runs
Part of the tools set, used in workflow and agent mode. What the model is told about each built-in tool: its description, usage notes and parameters. kdeps runs the tool itself.
- the agent loop builds the request
- the tool definitions are sent to the modeltools/search_local
- the model calls a tool
- kdeps runs it
- the result goes back to the model
Loaded by: kdeps (agent loop), /update, /settings, kdeps run, kdeps install, kdeps list, kdeps uninstall, kdeps update
In the code: kdeps (agent loop)agent.RegisterBuiltinToolsagent.definedAs
Install
A kdeps asset: installed with the first-run profile that includes its set, or the first time a command needs it, and updated without a new release.
Pin a version with kdeps install tools/search_local@<version>.
Contents
Search for text patterns in local files using ripgrep. Returns matching files with a snippet, and (when the query is found) a match_id/line/revision - pass match_id to read_file to jump straight to that hit. Use for finding usages, patterns, or strings across the codebase. Requires: query (search term). path is the directory to search; leave it out to search every folder of the working project (its own and the search folders its card lists). Optional: glob (file pattern), limit (max results, default 3), index (rank results with the folder index); index also accepts fuzzy, maxDistance, indexDBPath and graphBoost.
| Parameter | Type | Description |
|---|---|---|
| fuzzy | boolean | Fuzzy (Levenshtein) matching when index is true |
| glob | string | File glob filter, e.g. '*.go', '*.py' |
| graphBoost | boolean | Re-rank indexed results using the folder's reference/topic graph; requires index |
| index | boolean | Build and use the folder's TF-IDF index for ranked search instead of a content walk |
| indexDBPath | string | Index database path; defaults to the folder's kdeps data dir |
| limit | number | Maximum number of results. Default: 3 |
| maxDistance | number | Maximum edit distance for fuzzy matching. Default: 2 |
| path | string | Directory to search in (absolute path); omit to search all of the project's folders |
| query * | string | Search term or regex pattern |
aliases:
- grep
- rg
- ripgrep
- search_files
- find_in_files
- codebase_search
- grep_search
version: 1.3.0
aliases: [grep, rg, ripgrep, search_files, find_in_files, codebase_search, grep_search] # other names a model may call it by; the model is shown only this tool's name
description: 'Search for text patterns in local files using ripgrep. Returns matching files with a snippet, and (when the query is found) a match_id/line/revision - pass match_id to read_file to jump straight to that hit. Use for finding usages, patterns, or strings across the codebase. Requires: query (search term). path is the directory to search; leave it out to search every folder of the working project (its own and the search folders its card lists). Optional: glob (file pattern), limit (max results, default 3), index (rank results with the folder index); index also accepts fuzzy, maxDistance, indexDBPath and graphBoost.'
parameters:
fuzzy:
type: boolean
description: Fuzzy (Levenshtein) matching when index is true
glob:
type: string
description: File glob filter, e.g. '*.go', '*.py'
graphBoost:
type: boolean
description: Re-rank indexed results using the folder's reference/topic graph; requires index
index:
type: boolean
description: Build and use the folder's TF-IDF index for ranked search instead of a content walk
indexDBPath:
type: string
description: Index database path; defaults to the folder's kdeps data dir
limit:
type: number
description: 'Maximum number of results. Default: 3'
maxDistance:
type: number
description: 'Maximum edit distance for fuzzy matching. Default: 2'
path:
type: string
description: Directory to search in (absolute path); omit to search all of the project's folders
query:
type: string
description: Search term or regex pattern
required: true
Versions
| Version | Published | Status |
|---|---|---|
| 1.3.0 | 10/21/2026 | active |
| 1.2.0 | 10/17/2026 | active |
| 1.1.0 | 10/16/2026 | active |
| 1.0.0 | 10/11/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 1.3.0
- Published
- 10/11/2026