https://github.com/jez/git-heatmap
:bar_chart: Display a heatmap for oft-edited files
https://github.com/jez/git-heatmap
cli git visualization
Last synced: 8 months ago
JSON representation
:bar_chart: Display a heatmap for oft-edited files
- Host: GitHub
- URL: https://github.com/jez/git-heatmap
- Owner: jez
- License: mit
- Created: 2018-01-09T07:25:50.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-07-05T01:53:53.000Z (over 3 years ago)
- Last Synced: 2025-04-09T18:17:41.532Z (8 months ago)
- Topics: cli, git, visualization
- Language: Shell
- Homepage:
- Size: 290 KB
- Stars: 298
- Watchers: 6
- Forks: 16
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# git-heatmap
> Display a heatmap for oft-edited files
## Install
### Dependencies
You must have the either `barchart` or `bars` command on your system first. Pick
your poison:
```bash
# either:
npm install -g https://github.com/jez/bars.git
# or:
cargo install --git https://github.com/jez/barchart.git
```
### Installation
Download `git-heatmap` and put it on your path.
```bash
# Homebrew:
brew install jez/formulae/git-heatmap
```
## Usage
```
❯ git heatmap -h
Heatmap of oft-edited files.
Usage:
git heatmap [options] [...]
Options:
-n Limit to top files. [default: 30]
--width Limit histogram to chars.
-b , --base Compare relative to . If on ,
show heatmap for entire repo. [default: master]
-c , --char Use to draw the bars. [default: █]
-f , --filter Filter output through before creating the
the histogram.
-h Show this message.
```
## FAQ
- **How do I disable color?**
Color is automatically disabled when output is not to a TTY (for example, when
piping to another command or redirecting to a file). If you need a flag to
control this, open an issue with your use case.
- **How do I heatmap directories instead of files?**
Use `--filter 'xargs dirname'`.
## License
[](https://jez.io/MIT-LICENSE.txt)