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
Built with