ShellWrapped - Your Terminal's Spotify Wrapped. 🎁

Run instantly with npx: => npx shellwrapped

ShellWrapped analyzes your shell history and transforms it into a beautiful "Wrapped" style summary—right in your terminal.

See your most-used commands, peak productivity hours, and coding personality, all presented with smooth animations and lo-fi beats playing in the background.

Built for developers who live in the terminal.

Usage:

install globally:

-> npm install -g shellwrapped

=> shellwrapped

Analyze a specific year:

=> shellwrapped --year 2025

Key Features:

• Command Analytics: Total command count, most-used tools, and frequency breakdowns.

• Productivity Insights: Discover your most active days and hours—when you're really in the zone.

• Developer Persona: Get assigned a personality type based on your terminal habits (e.g., "The Deployer," "The Git Wizard").

• Lo-fi Vibes: Background music plays while you explore your stats (requires mpv).

• Shareable Cards: Generate a summary you can screenshot and share.

• 100% Local: Your shell history never leaves your machine—all processing happens locally.

Prerequisites:

For the full experience with background music,

Install mpv:

• macOS: brew install mpv

• Linux: sudo apt install mpv

• Windows: choco install mpv or download from mpv.io

How It Works:

ShellWrapped reads your ~/.bash_history or ~/.zsh_history, parses timestamps and commands, then calculates your stats—all locally on your device.

Cross-platform: Works on macOS, Linux, and Windows.

👉 Try it now:

===> npx shellwrapped