Getting Started

git clone https://github.com/rmhaiderali/better-git-log

uv sync

uv run main.py

Or

uv tool install git+https://github.com/rmhaiderali/better-git-log

uv tool uninstall better-git-log

Command-line arguments

Argument	Description
(optional) path	Directory to treat as the repository root. The program changes into this directory before discovering a Git repo. If omitted, the current working directory (.) is used.

Example:

uv run main.py /path/to/repo

Environment variables

Variable	Default	Description
TIME_FORMAT	local	How commit timestamps are formatted. local uses your default locale. original uses the POSIX/C locale. Any other value is passed to setlocale as a locale name (e.g. en_US.UTF-8). Invalid values exit with an error and a short hint. See setlocale(3).
TIME_ZONE	original	Which time zone is used when displaying author/committer times. original keeps each commit's stored offset. local converts to the system's local zone. Any other value is treated as an IANA time zone name (e.g. America/New_York). Invalid names exit with an error.
LIST_ALL	0	If set to 1, prints the full first-parent history from HEAD to the root without waiting for key presses. Any other value (including unset) uses interactive mode: Down, Space, or Enter for the next parent; Esc to quit.

Examples

TIME_ZONE=Europe/Berlin better-git-log

LIST_ALL=1 better-git-log

TIME_FORMAT=en_PK TIME_ZONE=local better-git-log