GitStats

Git contribution statistics for IntelliJ Platform IDEs.

Git activity statistics for JetBrains IDEs.

GitStats turns the Git history of your current project into a clear author-level activity report inside the IDE. Review contribution trends, compare code changes across teammates, and share the visible results without leaving your development workflow.

• Author-level summaries: compare commits, added lines, deleted lines, and modified files.
• Flexible date ranges: inspect this week, the last 7 days, this month, or a custom range.
• Focused filtering: narrow reports by date range, branch scope, author, and project-relative paths.
• Two calculation modes: use Fast Summary for quick line-based ranking, or Detailed mode when commit counts matter.
• Noise control: exclude generated folders, vendor code, build outputs, or any project-relative paths.
• Shareable results: copy selected rows, copy the full table, or export the visible statistics as CSV.

Getting Started

1. Open a project backed by a Git repository in any supported JetBrains IDE.
2. Open the Git Stats tool window.
3. Choose a date range, branch scope, author, or paths to focus the report.
4. Click Refresh to calculate the report.
5. Use the settings action to switch modes or exclude noisy paths such as generated files and build outputs.

Privacy-friendly by design: GitStats uses the Git executable configured in your IDE and reads only local repository history. No source code, commit data, or statistics are sent to external services.

Why GitStats?

• Review Git contribution activity directly in the IDE.
• Filter statistics by date range, branch scope, author, and project-relative paths.
• Compare authors by commits, added lines, deleted lines, and modified files.
• Use Fast Summary mode for a quick ranking view, or Detailed mode when commit count is needed.
• Exclude noisy paths such as generated files, build outputs, or vendor directories.

Installation

• Marketplace:

  Install from JetBrains Marketplace, or open Settings/Preferences > Plugins > Marketplace, search for GitStats, then install the plugin.

• Manual installation:

  Download the latest release, then install it with Settings/Preferences > Plugins > Install plugin from disk...

Usage

1. Open a Git-backed project in an IntelliJ Platform IDE.
2. Open the Git Stats tool window.
3. Pick a date range and branch scope for the reporting range.
4. Optionally use the user or paths filters to focus the report.
5. Click Refresh to calculate the table.
6. Use the settings action to switch between Fast Summary and Detailed, or set excluded paths.

The toolbar Paths filter temporarily includes only specific project-relative files or folders in the current report. Excluded paths in settings remove noisy files from every calculation.

Roadmap

See ROADMAP.md for planned feature work and optimization areas.

Development

Requirements:

• JDK 21
• IntelliJ IDEA 2024.2+ for local plugin development
• Gradle Wrapper from this repository

Useful commands:

./gradlew runIde
./gradlew check
./gradlew buildPlugin
./gradlew verifyPlugin

The current source configuration targets IntelliJ Platform builds 242 through 261.*. Release artifacts are produced as GitStats plugin ZIP files under build/distributions/.

---

Built with the IntelliJ Platform Plugin Template.

Contributing

Feel free to dive in. Open an issue or submit a pull request.

Standard Readme follows the Contributor Covenant Code of Conduct.

Contributors

This project exists thanks to all the people who contribute.

License

MIT © MichaelSun