loggit 🪵

Your git history, actually readable. A friendly terminal explorer that turns git log into color, graphs, and answers — zero dependencies.

Stop squinting at git log --oneline. loggit gives you a clear, colored view of what your repository is really doing — commits, authors, churn, and pace — in one command. Pure Python stdlib, works on any laptop, installs instantly.

▌ main
  17 commits

1000a50   Add Docker/GHCR badge + usage section to README
    dsk-dev-ai  ·  6m ago
    +14/-0 in 1 file(s)

✨ Features

🔧 Install

pip install loggit

No dependencies. No compiled extensions. Works on Python 3.8+ everywhere.

🐳 Docker

docker pull ghcr.io/dsk-dev-ai/loggit:latest
docker run --rm -v "$PWD:/repo" -w /repo ghcr.io/dsk-dev-ai/loggit:latest authors

🚀 Usage

loggit                        # pretty log of recent commits (default: 40)
loggit -n 100                 # show more
loggit --stat                 # add per-commit +added/-removed lines
loggit --grep "docker"        # only commits mentioning "docker"
loggit --author "ada"         # only commits by a specific developer
loggit --since "2 weeks ago"  # recent activity only
loggit authors                # per-developer commit & churn summary
loggit pace                   # overall stats + velocity
loggit json                   # JSON, one object per line (great for scripting)

See loggit --help for the full list of options.

loggit json -n 5 > commits.ndjson

{"hash": "1000a50", "author": "dsk-dev-ai", "date": "2026-08-31T02:14:39+05:30", "subject": "Add Docker/GHCR badge", "refs": "HEAD -> main"}

🧠 How it works

1. Runs git log with a stable, machine-friendly pretty-format.
2. Parses commits, refs, dates, and message bodies (stdlib only).
3. Renders a clean, terminal-aware view — colors auto-disable when piped.
4. Summarizes per-author and per-window metrics on demand.

🤝 Contributing

Have an idea or spotted a quirk? Open an issue or a pull request. Want to add a metric or a new view? It's a focused module in loggit/.

📄 License

MIT — free to use, modify, and distribute.

⭐ Support

If loggit saved you a minute of git log squinting, give it a star ⭐.

Want to help keep it free forever? Consider becoming a sponsor on GitHub.