---

name: history description: "Git data you can use, not parse. Understand why code exists." allowed-tools: mcp__history__blame_file, mcp__history__file_history, mcp__history__recent_changes, mcp__history__commit_info, mcp__history__search_commits, mcp__history__diff_file, mcp__history__branch_diff, mcp__history__changed_symbols, mcp__history__git_status, mcp__history__git_add, mcp__history__git_commit

history

Structured git data. No output parsing. Understand intent, not just changes.

First: Depends on Task

• Understand code: blame_file({ file_path })
• Make a commit: git_status({})
• Review for PR: branch_diff({ base: 'main' })

Why This Wins

Quick Reference

Common Workflows

Understand Why Code Exists

Copyblame_file({ file_path: 'src/auth.ts' })

Track Bug Introduction

Copyfile_history({ file_path: 'src/broken.ts', limit: 10 })
commit_info({ ref: 'abc123' })

Review Changes for PR

Copybranch_diff({ base: 'main' })
changed_symbols({ from_ref: 'main' })  // What functions changed?

Create a Commit

Copygit_status({})
git_add({ paths: ['src/feature.ts'] })
git_commit({ message: 'feat: add feature' })

Unique Value: changed_symbols

Shows WHAT functions/classes changed, not just line diffs:

Copychanged_symbols({ from_ref: 'main', to_ref: 'HEAD' })
// Returns: added, modified, deleted symbols with locations

Works with any git repository

Auto-detects git root from any subdirectory.