https://github.com/sideshowbarker/gh-shortlog

🐝 Explore contributor info for a repo interactively (GitHub CLI extension TUI)
https://github.com/sideshowbarker/gh-shortlog

contributors fzf gh-extension git-log github-cli github-stats tui

Last synced: about 2 months ago
JSON representation

🐝 Explore contributor info for a repo interactively (GitHub CLI extension TUI)

• Host: GitHub
• URL: https://github.com/sideshowbarker/gh-shortlog
• Owner: sideshowbarker
• License: mit
• Created: 2025-02-10T09:13:49.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2025-03-04T12:23:30.000Z (3 months ago)
• Last Synced: 2025-04-06T13:14:55.119Z (about 2 months ago)
• Topics: contributors, fzf, gh-extension, git-log, github-cli, github-stats, tui
• Language: Shell
• Homepage: http://sideshowbarker.net/gh-shortlog/
• Size: 356 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# An interactive git shortlog (GitHub CLI extension TUI)

[fzf](https://github.com/junegunn/fzf#installation)-built [GitHub CLI](https://github.com/cli/cli) extension [TUI](https://en.wikipedia.org/wiki/Text-based_user_interface) `git shortlog` frontend — to interactively explore contributor data for any repo



## Install

Make sure you have the [GitHub CLI](https://github.com/cli/cli#installation) (the `gh` command) and [fzf](https://github.com/junegunn/fzf#installation) installed. Then:

```sh

# install

gh ext install sideshowbarker/gh-shortlog

# upgrade

gh ext upgrade sideshowbarker/gh-shortlog

# uninstall

gh ext remove sideshowbarker/gh-shortlog

```

## Usage

```

gh shortlog [--no-mouse]

```

- Type a date into the prompt and then do `Ctrl-O`: then, `gh-shortlog` will change to showing a log/history for only those changes made after your specified date.

- Type a name or e-mail address into the prompt: then, `gh-shortlog` will dynamically filter the list of authors down to just those who match what you typed into the prompt.

| Key    | Action                                                        |

| ------ | ------------------------------------------------------------- |

| `Ctrl‑O`     | Filter the log down to use the commits made after the date entered into the prompt.|

| `Enter`      | Show a diffs-included log of all commits by the author at the current pointer. |

| `Ctrl‑W`     | Open GitHub log in a web browser |

| `Ctrl‑C`     | Exit `gh-shortlog`, or else go back to the previous screen within `gh-shortlog`. |

| `Ctrl‑F`     | Scroll the preview window one page forward. |

| `Ctrl‑B`     | Scroll the preview window one page back. |

| `Ctrl‑J`     | Scroll the pointer in the main window to the next name down. |

| `Ctrl‑K`     | Scroll the pointer in the main window to the next name up. |

| `Ctrl‑N`     | Scroll the pointer in the main window to the next name down. |

| `Ctrl‑P`     | Scroll the pointer in the main window to the next name up. |

| `Ctrl‑U`     | Clear the prompt. |

| `tab`        | Toggle selection of the item (author name) at the pointer and move to the next name down. |

| `shift‑tab`  | Toggle selection of the item (author name) at the pointer and move to the next name up. |

| `Ctrl‑Q`     | Exit (or go back one screen) — and then, on final program exit, output the list of items selected. |

You can also use your mouse: click in main window moves the selection; double-click has the same effect as the `Enter` key; mouse scroll in either main window or preview window scrolls the window contents.

If you don’t want that mouse behavior, use the `--no-mouse` option.