https://github.com/git-quick-stats/git-vscode-stats
Track and visualize your Git activity directly from VS Code. A lightweight extension and CLI tool that analyzes your Git commits, tracks coding statistics, and helps you understand your productivity patterns — all within your favorite code editor.
https://github.com/git-quick-stats/git-vscode-stats
git git-statistics vscode vscode-extension vscode-git vscode-git-stats
Last synced: about 1 month ago
JSON representation
Track and visualize your Git activity directly from VS Code. A lightweight extension and CLI tool that analyzes your Git commits, tracks coding statistics, and helps you understand your productivity patterns — all within your favorite code editor.
- Host: GitHub
- URL: https://github.com/git-quick-stats/git-vscode-stats
- Owner: git-quick-stats
- License: mit
- Created: 2025-07-12T16:15:26.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2026-04-06T10:31:09.000Z (2 months ago)
- Last Synced: 2026-04-30T16:32:27.309Z (about 1 month ago)
- Topics: git, git-statistics, vscode, vscode-extension, vscode-git, vscode-git-stats
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=git-quick-stats.git-vscode-stats
- Size: 79.1 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```bash
git clone https://github.com/git-quick-stats/git-vscode-stats.git
cd git-vscode-stats
npm install
```
## How to Use
1. Open a folder that contains a Git repository.
2. Click the Git Quick Stats icon in the activity bar.
3. Pick a report from the Git Stats tree.
4. Apply filters (date range, author) in the webview.
5. 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
```bash
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
1. Open the project in VS Code.
2. Run `npm install` and `npm run compile`.
3. 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.