brokk-git-exploration

name	brokk-git-exploration
description	Explore change history using the Bash tool with git and gh, since bifrost does not expose git-history MCP tools.

Git Exploration

Bifrost is a code-analyzer MCP server and does not expose git-history tools. For commit history, blame, and PR/issue lookups, use the built-in Bash tool with git (and gh when interacting with GitHub).

Common idioms

Goal	Command
Recent commits in a file	git log --oneline -n 20 -- path/to/file
Recent commits across the repo	git log --oneline -n 50
Search commit messages	git log --grep='pattern' --oneline
Search commit content (added/removed lines)	git log -S 'literal' --oneline or git log -G 'regex' --oneline
Who last touched each line	git blame path/to/file
Diff between two commits	git diff <a>..<b> -- path/to/file
Find when a symbol was introduced	git log --diff-filter=A -S 'symbol_name' -- path/
List PRs that touched a file	gh pr list --state all --search 'path/to/file in:title,body'
Show a PR	gh pr view <number>
Show an issue	gh issue view <number>

Tips

• For "what changed recently in this area?", git log --oneline -n 20 -- <path> is faster than reading individual commits.
• git log -S 'string' finds commits where the count of a literal changed; -G 'regex' matches the actual diff. Use -S for adding/ removing a known identifier, -G for richer patterns.
• gh search prs/issues is broader than gh pr list --search; use it when you do not have the file path handy.
• For ongoing work, git log @{u}..HEAD shows commits on the current branch that have not been pushed yet.