git-aura

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.

Installation

npm install -g git-aura

Or run directly with npx:

npx git-aura <username>

Usage

# 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:

# 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 |

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 for details.

License

MIT