git-personality

Analyze a git repository's commit history and assign the developer (or team) a D&D-style personality archetype — based entirely on real signals from git data. No LLM, no API key, no magic. Pure Python + subprocess.

Installation

pip install git-personality

Or install from source:

git clone https://github.com/yourname/git-personality
cd git-personality
pip install -e .

Usage

# Analyze the current repository
git-personality

# Analyze a specific repository
git-personality --repo /path/to/repo

# Analyze a specific author
git-personality --author "Jane"

# Limit to recent history
git-personality --since "6 months ago"

# Combine options
git-personality --repo ~/projects/myapp --author "alice@example.com" --since "1 year ago"

Alignments

Dimensions Analyzed

Lawful vs. Chaotic axis

• Commit message quality — One-word commits ("fix", "wip") = Chaotic. Conventional commits ("feat:", "fix:") = Lawful.
• Commit size — Giant commits (500+ lines) = Chaotic. Small, focused commits = Lawful.
• Timing — Weekend/late-night commits = Chaotic. Business hours = Lawful.
• Consistency — Regular cadence = Lawful. Sporadic bursts = Chaotic.

Good vs. Evil axis

• Test discipline — Commits touching test files = Good. Never touching tests = Evil.
• Documentation — Commits touching README/docs = Good. Ignoring docs = Evil.
• Bug fixing — Commits that mention fixing bugs = Good. Never fixing anything = Evil.

Requirements

• Python 3.8+
• git installed and accessible on PATH
• click >= 8.0
• rich >= 13.0

License

MIT