cc-wrapped

Claude Code Wrapped

You already know what it is :p

Installation

claude plugin marketplace add SabhyaC26/cc-wrapped
claude plugin install cc-wrapped

Troubleshooting Installation

If you encounter an EXDEV: cross-device link not permitted error during installation, this is a known issue when /tmp and your home directory are on different filesystems. Use this manual installation workaround:

# Clone the repository directly to the plugins directory
git clone https://github.com/SabhyaC26/cc-wrapped.git ~/.claude/plugins/installed/cc-wrapped

# Install dependencies
cd ~/.claude/plugins/installed/cc-wrapped/plugin
npm install

# Install web UI dependencies
cd web
bun install  # or npm install

After manual installation, restart Claude Code and the /cc-wrapped:wrapped command should be available.

Usage

Run the /cc-wrapped:wrapped command with optional time period:

# Current year (default)
/cc-wrapped:wrapped

# Last 30 days
/cc-wrapped:wrapped month

# Last 7 days
/cc-wrapped:wrapped week

# All-time stats
/cc-wrapped:wrapped all

# Specific year
/cc-wrapped:wrapped 2025

Data Sources

Claude Code Wrapped analyzes data from:

• ~/.claude/stats-cache.json - Activity metrics, model usage, hour distribution
• ~/.claude/history.jsonl - Command history and project activity

No background tracking required - all analysis is done on-demand!

Requirements

• Node.js 14+
• Claude Code CLI
• Active Claude Code usage (to have data to analyze)

Development

Project Structure

cc-wrapped/
├── plugin/
│   ├── .claude-plugin/
│   │   └── plugin.json           # Plugin metadata
│   ├── commands/
│   │   └── wrapped.md            # /wrapped command definition
│   ├── scripts/
│   │   ├── wrapped-analyzer.js   # Main entry point
│   │   ├── data-parser.js        # Parse stats and history
│   │   ├── metrics-calculator.js # Calculate all metrics
│   │   └── ui-renderer.js        # Terminal UI rendering
│   └── lib/
│       ├── chart-generator.js    # ASCII chart utilities
│       └── date-utils.js         # Time range filtering
├── package.json
└── README.md

Running Locally

# Install dependencies
npm install

# Run directly
node plugin/scripts/wrapped-analyzer.js --period all

# Make executable
chmod +x plugin/scripts/wrapped-analyzer.js
./plugin/scripts/wrapped-analyzer.js --period week

Testing Different Time Periods

# Test all-time stats
node plugin/scripts/wrapped-analyzer.js --period all

# Test current year
node plugin/scripts/wrapped-analyzer.js --period year

# Test last 30 days
node plugin/scripts/wrapped-analyzer.js --period month

# Test last week
node plugin/scripts/wrapped-analyzer.js --period week

# Test specific year
node plugin/scripts/wrapped-analyzer.js --period 2025

Contributing

Contributions welcome! Please feel free to submit issues and pull requests.

License

MIT