Repositories & Git

`list_repos`

Lists repositories indexed by Sourcebot with optional filtering and pagination. Parameters:

Name	Required	Description
`query`	no	Filter repositories by name (case-insensitive).
`page`	no	Page number for pagination (min 1, default: 1).
`perPage`	no	Results per page for pagination (min 1, max 100, default: 30).
`sort`	no	Sort repositories by ‘name’ or ‘pushed’ (most recent commit). Default: ‘name’.
`direction`	no	Sort direction: ‘asc’ or ‘desc’ (default: ‘asc’).

`list_branches`

You can list a repository’s branches, sorted by latest commit date (newest first). Results come from Sourcebot’s local snapshot, not live from the code host. You see branches created or deleted on the code host only after Sourcebot next syncs the repository. For each branch, you get its name, head commit SHA, latest commit time, isDefault (whether it is the repository’s default branch), and isIndexed (whether code search can search that branch). Parameters:

Name	Required	Description
`repo`	yes	The name of the repository to list branches for.
`query`	no	Filter branches by name (case-insensitive).
`page`	no	Page number for pagination (min 1, default: 1).
`perPage`	no	Results per page for pagination (min 1, max 100, default: 50).

`list_commits`

Get a list of commits for a given repository. Parameters:

Name	Required	Description
`repo`	yes	The name of the repository to list commits for.
`query`	no	Search query to filter commits by message content (case-insensitive).
`since`	no	Show commits more recent than this date. Supports ISO 8601 (e.g., ‘2024-01-01’) or relative formats (e.g., ‘30 days ago’).
`until`	no	Show commits older than this date. Supports ISO 8601 (e.g., ‘2024-12-31’) or relative formats (e.g., ‘yesterday’).
`author`	no	Filter commits by author name or email (case-insensitive).
`ref`	no	Commit SHA, branch or tag name to list commits of. If not provided, uses the default branch.
`page`	no	Page number for pagination (min 1, default: 1).
`perPage`	no	Results per page for pagination (min 1, max 100, default: 50).

`get_diff`

Returns a structured diff between two refs in a repository using a two-dot comparison. Parameters:

Name	Required	Description
`repo`	yes	The fully-qualified repository name.
`base`	yes	The base git ref (branch, tag, or commit SHA) to diff from.
`head`	yes	The head git ref (branch, tag, or commit SHA) to diff to.

Overview

Tools

Repositories & Git

`list_repos`

`list_branches`

`list_commits`

`get_diff`

​list_repos

​list_branches

​list_commits

​get_diff

`list_repos`

`list_branches`

`list_commits`

`get_diff`