npm package: @kagesora/git-aura
Description: Analyze any GitHub user's profile and generate a beautiful terminal developer card
Author: KageSora0
Latest version: 1.0.0

# git-aura

[![npm version](https://img.shields.io/npm/v/git-aura)](https://www.npmjs.com/package/git-aura)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
[![CI](https://github.com/KageSora0/gitaura/actions/workflows/ci.yml/badge.svg)](https://github.com/KageSora0/gitaura/actions/workflows/ci.yml)

Analyze any GitHub user's public profile and generate a stylized **developer card** in the terminal. git-aura fetches data from the GitHub API, computes an archetype, power level (0-1000), and traits, then renders them as a beautiful boxed card.

![git-aura demo](assets/battle.png)

## Installation

```bash
npm install -g git-aura
```

Or run directly with npx:

```bash
npx git-aura <username>
```

## Usage

```bash
# Generate a developer card
git-aura <username>

# Compare two users (battle card)
git-aura <username> --compare <other>

# Choose a color theme
git-aura <username> --theme dracula

# Output raw JSON data
git-aura <username> --json

# Compact single-line output
git-aura <username> --minimal

# Disable colors
git-aura <username> --no-color
```

## Authentication

For higher API rate limits, provide a GitHub personal access token:

```bash
# Via flag
git-aura <username> --token <YOUR_TOKEN>

# Via environment variable
export GITHUB_TOKEN=<YOUR_TOKEN>
git-aura <username>
```

Without a token, you're limited to 60 requests/hour. With a token, the limit is 5,000 requests/hour.

## Themes

git-aura ships with 6 built-in color themes:

| Theme | Description |
|-------|-------------|
| `default` | GitHub-light inspired (blue, orange, purple, green) |
| `dracula` | Classic Dracula palette |
| `nord` | Icy blues and muted tones |
| `monokai` | Vibrant Monokai colors |
| `sakura` | Cherry blossom pinks and purples |
| `midnight` | Neon cyberpunk aesthetic |

```bash
git-aura <username> --theme nord
```

## Archetypes

Every developer gets assigned a primary (and optionally secondary) archetype based on their GitHub activity:

| Archetype | Description |
|-----------|-------------|
| Shadow Architect | Designs complex systems in the dark of night |
| Flame Sprinter | Ships fast, iterates faster, never stops |
| Steel Monk | Disciplined, consistent, methodical |
| Void Walker | Explores the unknown, experimental and boundary-pushing |
| Storm Weaver | Full-stack chaos energy, touches everything |
| Frost Sentinel | Guards the codebase, reviews, tests, hardens |
| Ember Forgemaster | Builds tools other developers depend on |
| Phantom Scribe | Documentation-first, clear-minded, thorough |
| Iron Titan | Massive contributor to massive projects |
| Jade Sage | Teaches and mentors through code |
| Crimson Ronin | Solo developer, builds entire apps alone |
| Azure Tactician | Strategic, data-driven, optimized |
| README-Driven Dev | The README is done, the code... not so much |
| One-Trick Pony | One language to rule them all, forever |
| YOLO Shipper | Push to main, no tests, no regrets |
| Graveyard Keeper | Repos outnumber commits, and that is fine |
| Caffeinated Ghost | Codes between midnight and 5 AM exclusively |
| Fork Goblin | Forks everything, touches nothing |
| Tutorial Survivor | Has completed every todo-app known to humanity |
| Astral Hermit | Zero followers, zero forks, pure solitude |
| Hype Beast | More followers than lines of code |

## Power Level

Each user receives a power level from 0 to 1000, computed from six sub-scores:

- **Consistency** (max 150) — streak activity + account longevity
- **Impact** (max 350) — star count on a wide logarithmic scale
- **Volume** (max 100) — recent commits and PRs
- **Reach** (max 250) — followers + fork count (logarithmic)
- **Diversity** (max 50) — number of languages used
- **Reputation** (max 100) — average stars per repo

## Contributing

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## License

[MIT](LICENSE)