Code search - Sourcebot

`grep`

Searches for code matching a regular expression pattern across repositories, similar to grep/ripgrep. Always case-sensitive. Results are grouped by file and include line numbers. Parameters:

Name	Required	Description
`pattern`	yes	The regex pattern to search for in file contents.
`path`	no	Directory path to scope the search to. Defaults to the repository root.
`include`	no	File glob pattern to include in the search (e.g. `.ts`, `.{ts,tsx}`).
`repo`	no	Repository name to search in. If not provided, searches all repositories. Use the full name including host (e.g. `github.com/org/repo`).
`ref`	no	Commit SHA, branch or tag name to search on. If not provided, defaults to the default branch.
`limit`	no	Maximum number of matching files to return (default: 100).

`glob`

Finds files whose paths match a glob pattern across repositories (e.g. **/*.ts, src/**/*.test.{ts,tsx}). Results are grouped by repository. Parameters:

Name	Required	Description
`pattern`	yes	Glob pattern to match file paths against (e.g. `*/.ts`, `src/*/.test.{ts,tsx}`).
`path`	no	Restrict results to files under this subdirectory.
`repo`	no	Repository name to search in. If not provided, searches all repositories. Use the full name including host (e.g. `github.com/org/repo`).
`ref`	no	Commit SHA, branch or tag name to search on. If not provided, defaults to the default branch.
`limit`	no	Maximum number of files to return (default: 100).

`list_tree`

Lists files and directories from a repository path. Directories are shown before files at each level. Parameters:

Name	Required	Description
`repo`	yes	The name of the repository to list files from.
`path`	no	Directory path (relative to repo root). If omitted, the repo root is used.
`ref`	no	Commit SHA, branch or tag name to list files from. If not provided, uses the default branch.
`depth`	no	Number of directory levels to traverse below `path` (min 1, max 10, default: 1).
`includeFiles`	no	Whether to include file entries in the output (default: true).
`includeDirectories`	no	Whether to include directory entries in the output (default: true).
`maxEntries`	no	Maximum number of entries to return before truncating (min 1, max 10000, default: 1000).

`read_file`

Reads the source code for a given file, with optional line range control for large files. Parameters:

Name	Required	Description
`repo`	yes	The repository name.
`path`	yes	The path to the file.
`ref`	no	Commit SHA, branch or tag name to fetch the source code for. If not provided, uses the default branch.
`offset`	no	Line number to start reading from (1-indexed). Omit to start from the beginning.
`limit`	no	Maximum number of lines to read (max: 500). Omit to read up to 500 lines.