gitaura
A Python CLI for git repository analytics. Visualize commit activity, analyze file churn, explore branch history, and discover where you work most—all from the terminal.
Installation
pip install gitaura
248 commits over 12 month(s)
2024-01 12 ▀▀▀▀▀
2024-02 28 ▀▀▀▀▀▀▀▀▀▀▀▀▀
2024-03 45 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
...
Commands
Commit Activity
| Command | Description |
|---|---|
| (default) | Bar chart of commits by period (day/week/month/year) |
-p day |
Daily granularity |
-p week |
Weekly (ISO week) |
-p month |
Monthly (default) |
-p year |
Yearly |
-f |
Fill missing dates with zero-commit bars |
File Analysis
| Command | Description |
|---|---|
--files |
File type breakdown (% JS, TS, MD, etc.) |
--churn |
File churn ranking (most modified files) |
--hotspots |
Hotspot detection (high churn + many contributors) |
--refactor |
Refactor density (balanced add/del ≈ refactoring) |
--min-churn N |
Minimum churn for hotspots (default: 50) |
Branch Analysis
| Command | Description |
|---|---|
--branches |
Active branches ranked by recency |
--stale |
Stale branches (no commits in N days) |
--stale-days N |
Staleness threshold (default: 30) |
--divergence |
Ahead/behind counts vs main |
--branch-lifetime |
Creation → merge duration for merged branches |
--merges |
Merge frequency timeline (aggregated) |
--merge-timeline |
Timeline of branch merges (date + branch name) |
--compare A B |
Compare two branches statistically |
--main BRANCH |
Main branch for divergence/lifetime/merges (default: main or master) |
Activity Map
| Command | Description |
|---|---|
--work-map |
“Where do I work most?” — directory activity map |
Global Options
Apply to most commands:
| Option | Description |
|---|---|
-a, --after DATE |
After date (e.g. 2024-01-01) |
-b, --before DATE |
Before date |
-u, --author EMAIL |
Filter by author (substring match) |
Examples
Commit bars by week, filtered by author
gitaura -p week -u "alice@company.com"
File type breakdown for 2024
gitaura --files -a 2024-01-01 -b 2024-12-31
Most modified files
gitaura --churn
Hotspots — high churn and many contributors
gitaura --hotspots --min-churn 100
Refactor vs feature density
gitaura --refactor
Stale branches (no activity in 60 days)
gitaura --stale --stale-days 60
Branch divergence from main
gitaura --divergence
Compare main and feature branch
gitaura --compare main feature-branch
gitaura --compare main origin/feature-branch
Where do I work most?
gitaura --work-map
gitaura --work-map -u "me@email.com"
Merge timeline
gitaura --merge-timeline
Output Notes
- Weekend bars are colored blue in commit activity view.
- Churn = lines added + lines deleted per file.
- Refactor density uses “balanced” edits (adds ≈ dels) as a proxy for refactoring.
- Hotspots combine churn and contributor count; files with both rank higher.
- Work map shows directories by edit count and lines changed; hierarchy is indented.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for gitaura 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| gitaura-0.1.4.tar.gz | 13.7 kB | Without provenance | Details for gitaura-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gitaura-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for gitaura-0.1.4-py3-none-any.whl |
Total release size: 26.0 kB
Release files / gitaura-0.1.4.tar.gz
| Download URL | gitaura-0.1.4.tar.gz |
|---|---|
| Size | 13.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
35606f2e5eadd4d9a0691f30a28cdee0436274d19989fea0f35dba055603ef06
|
|
BLAKE2b-256 checksum How to use checksums |
535e21c294be4b6c3504bb8199b04b11e814b6d397588cebaa51f103b00f8441
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / gitaura-0.1.4-py3-none-any.whl
| Download URL | gitaura-0.1.4-py3-none-any.whl |
|---|---|
| Size | 12.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
febda18a259df6eeab7545f5d0299277a5d868ab82205d30f68ec0f1a134debe
|
|
BLAKE2b-256 checksum How to use checksums |
8419913411bd367fb511a3e0f0b010a3fa425bb0cebb23d2a4933955c8a34c11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for gitaura 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
