Search code across public repositories using Sourcegraph's GraphQL API.

WHEN TO USE THIS TOOL:

- Use when you need to find code examples or implementations across public repositories
- Helpful for researching how others have solved similar problems
- Useful for discovering patterns and best practices in open source code

HOW TO USE:

- Provide a search query using Sourcegraph's query syntax
- Optionally specify the number of results to return (default: 10)
- Optionally set a timeout for the request

QUERY SYNTAX:

- Basic search: "fmt.Println" searches for exact matches
- File filters: "file:.go fmt.Println" limits to Go files
- Repository filters: "repo:^github\.com/golang/go$ fmt.Println" limits to specific repos
- Language filters: "lang:go fmt.Println" limits to Go code
- Boolean operators: "fmt.Println AND log.Fatal" for combined terms
- Regular expressions: "fmt\.(Print|Printf|Println)" for pattern matching
- Quoted strings: "\"exact phrase\"" for exact phrase matching
- Exclude filters: "-file:test" or "-repo:forks" to exclude matches

ADVANCED FILTERS:

- Repository filters:
  - "repo:name" - Match repositories with name containing "name"
  - "repo:^github\.com/org/repo$" - Exact repository match
  - "repo:org/repo@branch" - Search specific branch
  - "repo:org/repo rev:branch" - Alternative branch syntax
  - "-repo:name" - Exclude repositories
  - "fork:yes" or "fork:only" - Include or only show forks
  - "archived:yes" or "archived:only" - Include or only show archived repos
  - "visibility:public" or "visibility:private" - Filter by visibility

- File filters:
  - "file:\.js$" - Files with .js extension
  - "file:internal/" - Files in internal directory
  - "-file:test" - Exclude test files
  - "file:has.content(Copyright)" - Files containing "Copyright"
  - "file:has.contributor([email protected])" - Files with specific contributor

- Content filters:
  - "content:\"exact string\"" - Search for exact string
  - "-content:\"unwanted\"" - Exclude files with unwanted content
  - "case:yes" - Case-sensitive search

- Type filters:
  - "type:symbol" - Search for symbols (functions, classes, etc.)
  - "type:file" - Search file content only
  - "type:path" - Search filenames only
  - "type:diff" - Search code changes
  - "type:commit" - Search commit messages

- Commit/diff search:
  - "after:\"1 month ago\"" - Commits after date
  - "before:\"2023-01-01\"" - Commits before date
  - "author:name" - Commits by author
  - "message:\"fix bug\"" - Commits with message

- Result selection:
  - "select:repo" - Show only repository names
  - "select:file" - Show only file paths
  - "select:content" - Show only matching content
  - "select:symbol" - Show only matching symbols

- Result control:
  - "count:100" - Return up to 100 results
  - "count:all" - Return all results
  - "timeout:30s" - Set search timeout

EXAMPLES:

- "file:.go context.WithTimeout" - Find Go code using context.WithTimeout
- "lang:typescript useState type:symbol" - Find TypeScript React useState hooks
- "repo:^github\.com/kubernetes/kubernetes$ pod list type:file" - Find Kubernetes files related to pod listing
- "repo:sourcegraph/sourcegraph$ after:\"3 months ago\" type:diff database" - Recent changes to database code
- "file:Dockerfile (alpine OR ubuntu) -content:alpine:latest" - Dockerfiles with specific base images
- "repo:has.path(\.py) file:requirements.txt tensorflow" - Python projects using TensorFlow

BOOLEAN OPERATORS:

- "term1 AND term2" - Results containing both terms
- "term1 OR term2" - Results containing either term
- "term1 NOT term2" - Results with term1 but not term2
- "term1 and (term2 or term3)" - Grouping with parentheses

LIMITATIONS:

- Only searches public repositories
- Rate limits may apply
- Complex queries may take longer to execute
- Maximum of 20 results per query

TIPS:

- Use specific file extensions to narrow results
- Add repo: filters for more targeted searches
- Use type:symbol to find function/method definitions
- Use type:file to find relevant files