git-logs

Git Logs

You have access to a set of MCP tools (prefixed git_logs_) that explore git history and summarize development activity. Use them to answer questions about what was built, who worked on what, and where risks or bottlenecks exist.

Available Tools

Activity & History

• get_log_summary - Categorized commit summary for a time period (features, fixes, refactors, docs, chores). Requires since; optional: until, repo_path, author, branch.
• get_log_detail - Individual commits with full messages, diff stats, ticket references, and file paths. Requires since; optional: until, repo_path, author, branch, path_filter, max_commits (default 100).
• get_log_by_file - Per-file activity breakdown ranked by commit count. Requires since; optional: until, repo_path, author, branch, top_n (default 20).
• list_authors - Authors with commit counts for a time period. Requires since; optional: until, repo_path, branch.
• get_line_stats - Lines-of-code metrics (insertions, deletions, net) grouped by author, branch, or author_branch. Requires since; optional: until, repo_path, author, branch, group_by.

Ticket Tracking

• get_commits_by_ticket - Commits grouped by Jira-style ticket references (e.g., AUTH-142) extracted from commit messages. Also surfaces untagged commits. Requires since; optional: until, repo_path, author, branch, ticket_pattern.

Branch Health

• get_branch_status - Branch staleness and health (active/idle/stale), ahead/behind counts, merge status. Optional: repo_path, base_branch (default "main"), author, include_merged.

Velocity & Quality Metrics

• get_commit_velocity - Commit frequency over time bucketed by day or week. Zero-activity periods are included. Requires since; optional: until, repo_path, author, branch, bucket.
• get_code_churn - Files with high rewrite rates (churn_ratio = insertions / max(net, 1)). Higher = more rework. Requires since; optional: until, repo_path, author, branch, top_n.
• get_commit_size_distribution - Commit size stats (small/medium/large buckets, avg/median/max) by author or branch. Requires since; optional: until, repo_path, author, branch, group_by.

Architecture & Ownership

• get_file_coupling - File pairs that frequently change together. High coupling between unrelated files suggests hidden dependencies. Requires since; optional: until, repo_path, branch, min_commits (default 3), top_n.
• get_knowledge_map - Ownership concentration and bus factor per file or directory. Bus factor of 1 = single-person risk. Optional: since, until, repo_path, branch, path_prefix, group_by (file or directory), top_n.

Workflow Guidelines

1. Start broad, then drill down. Use get_log_summary or list_authors first to understand the landscape, then use get_log_detail, get_log_by_file, or get_line_stats for specifics.
2. All tools default to all branches. Pass a specific branch to narrow scope.
3. Use relative dates. The since parameter accepts expressions like "1 week ago", "3 days ago", "2 months ago" in addition to ISO dates.
4. Combine tools for richer answers. For example, use get_commits_by_ticket + get_branch_status to correlate ticket work with branch health.
5. Present results clearly. Format output as tables or bulleted lists. Include line stats (+insertions / -deletions) when relevant.
6. Bus factor and churn are warning signals. Proactively highlight bus-factor-1 areas and high-churn files when reporting on project health.

Example Queries

• "What was built in the last two weeks?"
• "What has Alice been working on this month?"
• "Which tickets have commits this sprint?"
• "Are there stale branches we should clean up?"
• "Which files keep getting rewritten?"
• "What's our bus factor by directory?"
• "Who's making large commits that are hard to review?"
• "Which files always change together?"