consta 1.0.1

Git contribution statistics tool
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# ***Con***tribution ***Sta***tistics
CLI tool to get git contribution statistics for multiple repos. The project was born from the desire to track this stats for non-github/gitlab projects.

![output.png](output.png)
![grid.png](grid.png)

## Installation and launching
|                                   | Installation                                                                                                              | Launching                                                                    |
|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| If you have cargo (_recommended_) | `cargo install consta`                                                                                                    | `consta ...`                                                                 |
| If you don't have cargo           | Download the latest release for your platform from [releases page](https://github.com/GingerYouth/consta/releases/latest) | Run executable as you would do in your OS, e.g.: `consta.exe ...` on Windows |

## Supported terminals
Known to run smoothly from git bash. 
Please, submit an issue if you encounter any issues with grid symbols in other terminals.

## Examples
1) Specified repositories:
```
consta "C:\projects\project-name-1" "C:\projects\project-name-2" --author "andrei" --since "2026-01-01" --breakdown
```
2) Recursive local repositories search:
```
consta "C:\projects\" --author "andrei" --since "2026-01-01" --breakdown --recursive
```
3) Local and remote repositories with different author patterns (git identity differ for local and GitHub repos):
```
consta "C:\projects\project-name-1" "https://github.com/GingerYouth/consta" --author "andrei" --author "GingerYouth" --token "github_pat_..."
```

## CLI arguments:
* \<string...>              : Local repositories, folders or links to GitHub repositories
* `--author` \<string>      : Filter commits by author name or email (multiple allowed to search for different patterns for local and remote repos)
* `--since` \<date>         : Show commits after this date (e.g. 2026-01-01)
* `--until` \<date>         : Show commits before this date
* `--breakdown`             : Show commit breakdown (not supported for remote repositories!)
* `--grid` \<year>          : Show activity grid for a specific year
* `--recursive` \[\<depth>] : Discover repos in subdirectories (default depth = 3)
* `--token` \<string>       : GitHub personal access token (if not specified, will try to get it from `GITHUB_TOKEN` or `GH_TOKEN` environment variables)
* `--debug`                 : Print timing and debug information