bb_get_diff
Retrieve raw unified diffs for a commit against its parent or between two commits, with optional path filtering and whitespace handling.
Instructions
Get the raw unified diff between commits. Use a single commit hash to diff against its parent, or "commit1..commit2" for comparing two commits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Filter diff to a single file path | |
| spec | Yes | Commit spec: a single commit hash (diffs against parent), or two commits as "commit1..commit2" | |
| topic | No | When true with two-commit spec, produces a 3-dot diff (source vs merge-base) | |
| filter | No | JMESPath expression to filter/transform structured response data. Applied before format conversion. Example: "values[].{name: full_name, lang: language}" — see https://jmespath.org for syntax | |
| context | No | Number of context lines around changes | |
| repo_slug | Yes | The repository name | |
| workspace | Yes | The workspace or username | |
| output_format | No | Response format: "text" (default, human-readable), "json" (structured JSON), or "toon" (Token-Oriented Object Notation — compact tabular format that reduces LLM token consumption by 30-60%) | |
| ignore_whitespace | No | Ignore whitespace changes |