https://github.com/dhth/commits
Glance at git commits through a simple TUI
https://github.com/dhth/commits
git tui
Last synced: 3 months ago
JSON representation
Glance at git commits through a simple TUI
- Host: GitHub
- URL: https://github.com/dhth/commits
- Owner: dhth
- License: mit
- Created: 2024-04-16T17:01:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-14T15:25:29.000Z (3 months ago)
- Last Synced: 2025-08-14T16:24:20.985Z (3 months ago)
- Topics: git, tui
- Language: Go
- Homepage: https://tools.dhruvs.space/commits
- Size: 70.3 KB
- Stars: 11
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
commits
`commits` lets you glance at git commits through a simple TUI.
🛠️ Pre-requisites
---
- `git` (only if you want to use `commits` to see diffs)
💾 Installation
---
**go**:
```sh
go install github.com/dhth/commits@latest
```
⚡️ Usage
---
`commits` can receive its configuration via command line flags, and/or a TOML
config file. The default location for this config file is
`~/.config/commits/commits.toml`.
```toml
# commit messages that match "ignore_pattern" will not be shown in the TUI list
ignore_pattern = '^\[regex\]'
# editor_command is run when you press ctrl+d; {{revision}} is replaced at
# runtime with a revision range
editor_command = [ "nvim", "-c", ":DiffviewOpen {{revision}}" ]
```
```bash
commits -path='/path/to/git/repo'
commits -ignore-pattern='^\[regex\]'
commits -config-file-path='/path/to/config/file.toml'
```
Reference Manual
---
```
commits Reference Manual
commits has 4 views:
- Commit List View
- Commit Details View
- Branch List View
- Help View
Keyboard Shortcuts
General
Switch focus between Commit List View and Commit Details View
Open commit/revision range in your text editor (depends
on editor_command in your config file)
Clear revision range selection
Change branch
? Show help view
Commit List View
Show commit/revision range
Choose revision range start/end
Show git log
Commit Details View
Show commit/revision range
h/[ Go to previous commit
l/] Go to next commit
Branch List View
Pick branch
/ Start filtering
```
Screenshots
---
Acknowledgements
---
`commits` is built using [bubbletea][1].
[1]: https://github.com/charmbracelet/bubbletea