Metadata-Version: 2.4
Name: git-persona-cepi
Version: 0.1.0
Summary: Analyze your GitHub commit history and generate your Engineer Personality Diagnosis
License: MIT
License-File: LICENSE
Keywords: cli,commits,developer,git,github,personality
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: platformdirs>=4.0
Requires-Dist: rich>=13.0
Description-Content-Type: text/markdown

# git-persona

**Analyze your GitHub commit history and discover your Engineer Personality Diagnosis.**

GitHubのコミット履歴からエンジニアの仕事スタイルを16タイプに診断するCLIツール。

```
╭────────────────────────────────────────────────────────────────╮
│                                                                │
│  🕵️  The Shadow Debugger  [SNRT]                               │
│                                                                │
│  Midnight, minimal messages, maximum fixes. You materialise   │
│  in the git log like a ghost, resolve the issue, and vanish   │
│  before anyone asks questions.                                 │
│                                                                │
│  Verdict: Forensics teams would love your diffs.              │
│           Your commit messages, not so much.                  │
│                                                                │
╰────────────────────────────────────────────────────────────────╯
```

## Installation

```bash
pip install git-persona
```

## Usage

```bash
# Analyze your own account (includes private repos)
git-persona analyze --token YOUR_GITHUB_TOKEN

# Use GITHUB_TOKEN env var or gh CLI — no --token needed
git-persona analyze

# Analyze another user
git-persona analyze --username torvalds

# Full history (ignore the default 90-day window)
git-persona analyze --deep

# Japanese output
git-persona analyze --lang ja

# JSON output
git-persona analyze --output json
```

### Getting a GitHub Token

1. Go to https://github.com/settings/tokens
2. Generate a new token (classic) with `repo` scope
3. Pass it via `--token` or set `GITHUB_TOKEN` env var

## Personality Types

16 types across 4 axes:

| Axis | Left pole | Right pole |
|------|-----------|------------|
| **S/B** | Surgeon (small, precise commits) | Bulldozer (large changesets) |
| **M/N** | Morning Lark (daytime coder) | Night Owl (late-night coder) |
| **P/R** | Pioneer (new features) | Repairman (fixes & maintenance) |
| **V/T** | Verbose (detailed messages) | Terse (concise messages) |

Examples: `SNRT` = Shadow Debugger, `BMPV` = Bold Visionary, `BNPT` = Caffeine-Powered Steamroller

## Options

```
--token TEXT        GitHub personal access token
--username TEXT     GitHub username to analyze (default: authenticated user)
--days INTEGER      Days of history to analyze [default: 90]
--deep              Analyze full commit history (ignores --days)
--no-cache          Bypass local cache and fetch fresh data
--output [terminal|json]  Output format [default: terminal]
--lang [en|ja]      Output language [default: en]
--timezone TEXT     Timezone for time analysis (e.g. Asia/Tokyo)
--no-color          Disable colored output
```

## License

MIT
