git.iko.soy/crush
on 8ebab21 help sign in
crush/internal/agent/tools/sourcegraph.md
55 lines 2.1 kB history raw
1Search code across public GitHub repositories via Sourcegraph; supports regex, language/repo/file filters, and symbol search (max 20 results). Only searches public repos.
3<usage>
4- Provide search query using Sourcegraph syntax
5- Optional result count (default: 10, max: 20)
6- Optional timeout for request
7</usage>
9<basic_syntax>
10- "fmt.Println" - exact matches
11- "file:.go fmt.Println" - limit to Go files
12- "repo:^github\.com/golang/go$ fmt.Println" - specific repos
13- "lang:go fmt.Println" - limit to Go code
14- "fmt.Println AND log.Fatal" - combined terms
15- "fmt\.(Print|Printf|Println)" - regex patterns
16- "\"exact phrase\"" - exact phrase matching
17- "-file:test" or "-repo:forks" - exclude matches
18</basic_syntax>
20<key_filters>
21Repository: repo:name, repo:^exact$, repo:org/repo@branch, -repo:exclude, fork:yes, archived:yes, visibility:public
22File: file:\.js$, file:internal/, -file:test, file:has.content(text)
23Content: content:"exact", -content:"unwanted", case:yes
24Type: type:symbol, type:file, type:path, type:diff, type:commit
25Time: after:"1 month ago", before:"2023-01-01", author:name, message:"fix"
26Result: select:repo, select:file, select:content, count:100, timeout:30s
27</key_filters>
29<examples>
30- "file:.go context.WithTimeout" - Go code using context.WithTimeout
31- "lang:typescript useState type:symbol" - TypeScript React useState hooks
32- "repo:^github\.com/kubernetes/kubernetes$ pod list type:file" - Kubernetes pod files
33- "file:Dockerfile (alpine OR ubuntu) -content:alpine:latest" - Dockerfiles with base images
34</examples>
36<boolean_operators>
37- "term1 AND term2" - both terms
38- "term1 OR term2" - either term
39- "term1 NOT term2" - term1 but not term2
40- "term1 and (term2 or term3)" - grouping with parentheses
41</boolean_operators>
43<limitations>
44- Only searches public repositories
45- Rate limits may apply
46- Complex queries take longer
47- Max 20 results per query
48</limitations>
50<tips>
51- Use specific file extensions to narrow results
52- Add repo: filters for targeted searches
53- Use type:symbol for function/method definitions
54- Use type:file to find relevant files
55</tips>