-
Notifications
You must be signed in to change notification settings - Fork 3.5k
Open
Description
Describe the feature or problem you'd like to solve
There's no way to compare two branches or commits to see what changed between them. Agents can fetch individual commits but can't answer "what's different between main and feature-x?" without manually iterating through commit history.
I ran into this when trying to generate release notes. My agent needed to see the diff between v1.0.0 and v1.1.0 but had to fall back to listing every commit, then filtering — slow and error-prone.
Proposed solution
Add a compare_commits tool wrapping:
GET /repos/{owner}/{repo}/compare/{basehead}
Where basehead is base...head (e.g., main...feature-branch or v1.0.0...v1.1.0).
Returns:
- Commits between the two refs
- Files changed with diff stats
- Ahead/behind counts
Example prompts or workflows
- "What commits are in
developthat aren't inmainyet?" - "Show me the files changed between v1.0.0 and v1.1.0"
- "How many commits ahead is this feature branch?"
- "Generate release notes by comparing the last two tags"
- "Check if staging is up to date with production"
Additional context
This is a single REST endpoint with high utility — it's foundational for release automation, PR analysis, and branch management. Happy to submit a PR if this feature is accepted.
Metadata
Metadata
Assignees
Labels
No labels