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: about 22 hours 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 7 years ago)
• Default Branch: master
• Last Pushed: 2022-07-05T01:53:53.000Z (over 2 years ago)
• Last Synced: 2024-12-17T22:08:50.763Z (8 days ago)
• Topics: cli, git, visualization
• Language: Shell
• Homepage:
• Size: 290 KB
• Stars: 295
• Watchers: 7
• Forks: 15
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# git-heatmap

> Display a heatmap for oft-edited files

![screenshot of git heatmap](screenshot.png)

## 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

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://jez.io/MIT-LICENSE.txt)