Git VSCode Stats
Track, compare, and visualize repository activity directly inside VS Code.
Git VSCode Stats adds a dedicated activity bar view with ready-made reports for commit trends, contributors, branches, and repository history. It is built for developers who want quick insight into project patterns without switching tools.
What You Get
- Organized stats explorer in the VS Code activity bar
- Rich report views rendered in an interactive webview
- Date and author filtering for most reports
- Charts for trend analysis and distribution views
- Comparison mode for branches and time periods
- Saved report configurations and reusable custom queries
- Export options for CSV, JSON, and HTML
Available Reports
- Detailed Git Stats
- Commits by Author
- Commits by Hour/Day
- Commits by Hour/Week
- Commits by Month
- Commits by Weekday
- Commits by Year
- Contributor Stats
- Branch Stats
- Changelog
- Code Suggestors
- Git Effort
- Git Activity
- Comparison View
- Git Insights
Screenshots
Installation
Install from the VS Code Marketplace:
https://marketplace.visualstudio.com/items?itemName=git-quick-stats.git-vscode-stats
Or clone and run locally for development:
git clone https://github.com/git-quick-stats/git-vscode-stats.git
cd git-vscode-stats
npm install
How to Use
- Open a folder that contains a Git repository.
- Click the Git Quick Stats icon in the activity bar.
- Pick a report from the Git Stats tree.
- Apply filters (date range, author) in the webview.
- Export or save the current setup if needed.
Saved Configurations and Custom Queries
- Save the current filter + report combination to run it again quickly.
- Save custom Git queries and execute them from the sidebar.
- Custom query execution is restricted to read-only Git subcommands for safety.
Development
Requirements
- Node.js 18+
- npm
- VS Code 1.80+
Commands
npm install
npm run compile
npm test
npm run compile: builds TypeScript to dist/npm test: runs Node-based test suite in test/
Run the Extension Locally
- Open the project in VS Code.
- Run
npm install and npm run compile.
- Press
F5 to launch the Extension Development Host.
Troubleshooting
- If no data appears, verify the opened workspace is a valid Git repository.
- If charts do not load, run
npm install to ensure bundled dependencies are present.
- If results look incomplete, widen date filters or clear author filtering.
License
This project is licensed under the terms of the LICENSE file in the repository root.
