gitstack

Git history viewer focused on analysis and insights

Built for the AI-assisted development era - optimized for Claude Code and similar tools

Release history: see HISTORY.md.

To regenerate release history from git tags:

make history

Why gitstack?

gitstack answers questions like:

• "Who has been working on this module?"
• "Which files are changed most frequently?"
• "Which commits had the biggest impact?"
• "Are there any stale branches that should be cleaned up?"
• "How healthy is this project overall?"

Install

cargo install gitstack

Or build from source:

git clone https://github.com/Hiro-Chiba/gitstack
cd gitstack
cargo install --path .

Features

Analysis Suite

Press a single key to get instant insights:

Smart Filter

Powerful filtering with intuitive syntax:

/author:john              # Filter by author
/since:7days              # Recent commits
/until:2024-01-01         # Before date
/message:fix              # Search commit messages
/file:src/main.rs         # Commits touching specific file
/hash:abc123..def456      # Commit range

Combine filters: /author:john since:1week file:*.rs

Adaptive Layout (v3.0+)

Toggle with v to cycle through view modes:

Compact mode shows commit details alongside the graph:

┌─ Graph ─────────────────┬─ Details ────────────────────┐
│ ● abc123 feat: auth     │ Author: John Doe             │
│ │                       │ Date: 2024-01-15 10:30       │
│ ○ def456 fix: bug       │                              │
│ │                       │ feat: add authentication     │
│ ◆ ghi789 Merge          │                              │
│ │                       │ - Add login endpoint         │
│ ○ jkl012 init           │ - Add JWT validation         │
└─────────────────────────┴──────────────────────────────┘

Branch Graph

Color-coded branch visualization with smart color assignment:

• Adjacent lanes never share the same color
• Branches from the same fork point get distinct colors
• Clear merge visualization with proper line connections

Project Health Dashboard (v3.0+)

Press D to see overall project health:

┌─ Health Dashboard ─────────────────────────────────┐
│  Overall Score: 78 / 100 (Good)                    │
│  ████████░░                                        │
│                                                    │
│  Quality      ████████░░  82%                      │
│  Test Health  ██████░░░░  65%                      │
│  Bus Factor   █████████░  90%                      │
│  Tech Debt    ███████░░░  75%                      │
│                                                    │
│  ⚠ Warning: 3 stale branches need attention        │
│  ℹ Info: Test coverage could be improved           │
└────────────────────────────────────────────────────┘

Branch Recommendations (v3.0+)

The Topology view (t) now shows recommended actions for each branch:

CLI Mode (Non-Interactive)

For AI coding assistants (Claude Code, etc.) and scripting, gitstack provides JSON output:

gitstack --stats       # Author statistics
gitstack --heatmap     # File change frequency
gitstack --impact      # Commit impact scores
gitstack --coupling    # File change coupling
gitstack --health      # Project health score
gitstack --summary     # Current context summary
gitstack --pack        # AI-ready insight pack
gitstack --review-pack # AI review decision pack
gitstack --next-actions # Prioritized next actions
gitstack --verify      # Risk verdict with confidence
gitstack --why act-add-tests # Explain recommendation
gitstack --handoff --target codex # AI handoff context
gitstack --log -n 5    # Recent commits

Example output (--stats):

{
  "generated_at": "2026-02-03T10:30:00+0900",
  "total_commits": 150,
  "author_count": 3,
  "authors": [
    {"name": "Alice", "commit_count": 80, "insertions": 5000, ...}
  ]
}

Local Metrics (Opt-in, Off by Default)

Quick-action usage metrics are stored locally only and never sent externally.

Enable in ~/.config/gitstack/config.toml:

[metrics]
quick_action_usage = true

MCP Server (v3.0+)

gitstack includes an MCP (Model Context Protocol) server for AI assistants like Claude Code.

# Build the MCP server
cargo build -p gitstack-mcp --release

# Add to Claude Code's MCP configuration

Available Resources:

Available Tools:

Comparison

Keybindings

Navigation

Views

Actions

Status View (s)

Branch Select (b)

Configuration

Config file: ~/.config/gitstack/config.toml

[display]
date_format = "relative"  # or "absolute"
show_stats = true

[keybindings]
quit = "q"
help = "?"

License

MIT

日本語版 · Design Doc