ccwrap 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ccwrapped contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# ccwrap
+
+Your Claude Code usage stats, meme-ified into a shareable video. Like Spotify Wrapped, but for your AI coding assistant.
+
+## Quick Start
+
+```bash
+npx ccwrap
+```
+
+Or install globally:
+
+```bash
+npm install -g ccwrap
+```
+
+## Usage
+
+```bash
+# Last month (default)
+ccwrap
+
+# Last week
+ccwrap --period week
+
+# Last quarter
+ccwrap --period quarter
+
+# All time
+ccwrap --period all
+
+# Custom date range
+ccwrap --since 2025-06-01
+ccwrap --since 2025-06-01 --until 2025-12-31
+
+# Dark mode - environmental impact commentary
+ccwrap --mode dark
+
+# Custom output path
+ccwrap -o my-wrapped.mp4
+
+# Just print stats, no video
+ccwrap --stats-only
+
+# Output stats as JSON
+ccwrap --json
+```
+
+## Time Periods
+
+By default, ccwrap recaps the **last 30 days**. Use `--period` for presets or `--since`/`--until` for custom ranges.
+
+| Flag | Period |
+|---|---|
+| `--period week` | Last 7 days |
+| `--period month` | Last 30 days (default) |
+| `--period quarter` | Last 90 days |
+| `--period all` | All time |
+| `--since YYYY-MM-DD` | Custom start date (until today) |
+| `--since ... --until ...` | Custom date range |
+
+## AI Commentary
+
+Set `ANTHROPIC_API_KEY` to get AI-generated personalized commentary on each slide. Without it, pre-written fallback quips are used.
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+ccwrap
+```
+
+## Modes
+
+| Sassy (default) | Dark (`--mode dark`) |
+|---|---|
+| Purple/cyan neon aesthetic | Blood red/stone aesthetic |
+| Meme humor ("that's 50 coffees") | Environmental impact ("4.5L of water used") |
+| Affectionate roasting | Uncomfortable truths, but funny |
+
+## Video Slides
+
+1. **Intro** - Claude Code Wrapped with period-aware tagline
+2. **Tokens** - Total tokens with counting animation
+3. **Cost** - Dollar amount + fun equivalents
+4. **Model** - Favorite model reveal + usage breakdown
+5. **Busiest Day** - Peak day with activity chart
+6. **Sessions** - Marathon stats, streaks, scores
+7. **Peak Hours** - 24h activity histogram
+8. **Archetype** - Your coding personality
+9. **Summary** - Shareable card with all stats
+
+## Requirements
+
+- Node.js >= 18
+- Chrome/Chromium (auto-downloaded by Remotion if not found)
+- Claude Code usage data in `~/.claude/projects/`
+
+## License
+
+[MIT](LICENSE)

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { loadAndComputeStats } from "./data/parser.js";
+import { generateCommentary } from "./data/commentary.js";
+import { renderVideo } from "./render.js";
+function resolveDateRange(options) {
+    const now = new Date();
+    const today = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 23, 59, 59, 999);
+    if (options.since && options.period) {
+        console.error(chalk.red("Error: --period and --since are mutually exclusive. Use one or the other."));
+        process.exit(1);
+    }
+    // Default --period to "month" when neither --period nor --since is provided
+    if (!options.period && !options.since) {
+        options.period = "month";
+    }
+    if (options.until && !options.since) {
+        console.error(chalk.red("Error: --until requires --since."));
+        process.exit(1);
+    }
+    // Custom date range
+    if (options.since) {
+        const since = new Date(options.since + "T00:00:00");
+        if (isNaN(since.getTime())) {
+            console.error(chalk.red(`Error: Invalid --since date "${options.since}". Use YYYY-MM-DD format.`));
+            process.exit(1);
+        }
+        let until = today;
+        if (options.until) {
+            until = new Date(options.until + "T23:59:59.999");
+            if (isNaN(until.getTime())) {
+                console.error(chalk.red(`Error: Invalid --until date "${options.until}". Use YYYY-MM-DD format.`));
+                process.exit(1);
+            }
+        }
+        // Clamp future dates
+        if (until > today)
+            until = today;
+        if (since > today) {
+            console.error(chalk.red("Error: --since date is in the future."));
+            process.exit(1);
+        }
+        if (since > until) {
+            console.error(chalk.red("Error: --since date is after --until date."));
+            process.exit(1);
+        }
+        const fmtOpts = { month: "short", day: "numeric" };
+        const sinceStr = since.toLocaleDateString("en-US", fmtOpts);
+        const untilYear = until.getFullYear();
+        const sinceYear = since.getFullYear();
+        const untilStr = until.toLocaleDateString("en-US", { ...fmtOpts, year: sinceYear !== untilYear ? "numeric" : undefined });
+        const periodLabel = `${sinceStr} – ${untilStr}, ${untilYear}`;
+        return { range: { since, until }, periodLabel };
+    }
+    // Preset period
+    const period = (["week", "month", "quarter", "all"].includes(options.period ?? "") ? options.period : "month");
+    if (period === "all") {
+        return { range: undefined, periodLabel: "Your all-time" };
+    }
+    const daysBack = period === "week" ? 7 : period === "quarter" ? 90 : 30;
+    const since = new Date(today);
+    since.setDate(since.getDate() - daysBack);
+    since.setHours(0, 0, 0, 0);
+    const labels = {
+        week: "Your week",
+        month: "Your month",
+        quarter: "Your quarter",
+    };
+    return { range: { since, until: today }, periodLabel: labels[period] };
+}
+const banner = `
+  ██████╗ ██████╗██╗    ██╗██████╗  █████╗ ██████╗ ██████╗ ███████╗██████╗
+ ██╔════╝██╔════╝██║    ██║██╔══██╗██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔══██╗
+ ██║     ██║     ██║ █╗ ██║██████╔╝███████║██████╔╝██████╔╝█████╗  ██║  ██║
+ ██║     ██║     ██║███╗██║██╔══██╗██╔══██║██╔═══╝ ██╔═══╝ ██╔══╝  ██║  ██║
+ ╚██████╗╚██████╗╚███╔███╔╝██║  ██║██║  ██║██║     ██║     ███████╗██████╔╝
+  ╚═════╝ ╚═════╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝     ╚══════╝╚═════╝
+`;
+const darkBanner = `
+  ██████╗ ██████╗██╗    ██╗██████╗  █████╗ ██████╗ ██████╗ ███████╗██████╗
+ ██╔════╝██╔════╝██║    ██║██╔══██╗██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔══██╗
+ ██║     ██║     ██║ █╗ ██║██████╔╝███████║██████╔╝██████╔╝█████╗  ██║  ██║
+ ██║     ██║     ██║███╗██║██╔══██╗██╔══██║██╔═══╝ ██╔═══╝ ██╔══╝  ██║  ██║
+ ╚██████╗╚██████╗╚███╔███╔╝██║  ██║██║  ██║██║     ██║     ███████╗██████╔╝
+  ╚═════╝ ╚═════╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝     ╚══════╝╚═════╝
+`;
+program
+    .name("ccwrap")
+    .description("Claude Code Wrapped - Your AI coding stats, meme-ified into a shareable video")
+    .version("0.1.0")
+    .option("-o, --output <path>", "Output video file path", "ccwrapped.mp4")
+    .option("-m, --mode <mode>", "Commentary mode: sassy or dark", "sassy")
+    .option("-p, --period <period>", "Time period: week, month, quarter, all (default: month)")
+    .option("--since <date>", "Start date (YYYY-MM-DD), mutually exclusive with --period")
+    .option("--until <date>", "End date (YYYY-MM-DD), requires --since")
+    .option("--json", "Output stats as JSON instead of video")
+    .option("--stats-only", "Print stats to console without rendering video")
+    .action(async (options) => {
+    const mode = options.mode === "dark" ? "dark" : "sassy";
+    const isDark = mode === "dark";
+    console.log(isDark ? chalk.red(darkBanner) : chalk.hex("#7c3aed")(banner));
+    console.log(chalk.gray(isDark
+        ? "  Your AI usage. The planet remembers.\n"
+        : "  Your AI-assisted coding, recapped.\n"));
+    // Resolve date range
+    const { range, periodLabel } = resolveDateRange(options);
+    // Step 1: Load and compute stats
+    const periodHint = range
+        ? chalk.gray(` (${periodLabel})`)
+        : "";
+    const spinner = ora({ text: `Scanning Claude Code usage data...${periodHint}`, color: isDark ? "red" : "magenta" }).start();
+    let stats;
+    try {
+        stats = await loadAndComputeStats(range, periodLabel);
+        spinner.succeed(chalk.green("Usage data loaded!"));
+    }
+    catch (err) {
+        spinner.fail(chalk.red(`Failed to load data: ${err.message}`));
+        process.exit(1);
+    }
+    // Print summary
+    console.log();
+    const h = isDark ? chalk.red : chalk.hex("#7c3aed");
+    console.log(h("═══ Your Stats ═══"));
+    console.log(chalk.white(`  Tokens:      ${chalk.hex("#f59e0b").bold(stats.totalTokens.toLocaleString())}`));
+    console.log(chalk.white(`  Cost:        ${chalk.hex("#10b981").bold(`$${stats.totalCost.toFixed(2)}`)}`));
+    console.log(chalk.white(`  Sessions:    ${chalk.hex("#7c3aed").bold(stats.totalSessions.toString())}`));
+    console.log(chalk.white(`  Messages:    ${chalk.hex("#ec4899").bold(stats.totalMessages.toLocaleString())}`));
+    console.log(chalk.white(`  Days Active: ${chalk.hex("#06b6d4").bold(stats.totalDaysActive.toString())}`));
+    console.log(chalk.white(`  Fav Model:   ${chalk.hex("#f43f5e").bold(stats.favoriteModel)}`));
+    console.log(chalk.white(`  Archetype:   ${h.bold(stats.archetype)}`));
+    if (isDark) {
+        console.log(chalk.white(`  Water:       ${chalk.hex("#06b6d4").bold(`${stats.waterLiters.toFixed(1)}L`)}`));
+        console.log(chalk.white(`  CO₂:        ${chalk.gray.bold(`${(stats.co2Grams / 1000).toFixed(1)}kg`)}`));
+        console.log(chalk.white(`  Energy:      ${chalk.hex("#f59e0b").bold(`${stats.kwhUsed.toFixed(1)} kWh`)}`));
+    }
+    console.log(chalk.gray(`  "${stats.archetypeDescription}"`));
+    console.log();
+    if (options.json) {
+        console.log(JSON.stringify(stats, null, 2));
+        return;
+    }
+    if (options.statsOnly) {
+        return;
+    }
+    // Step 2: Generate AI commentary
+    const commentarySpinner = ora({
+        text: isDark ? "Generating dark commentary..." : "Generating sassy commentary...",
+        color: isDark ? "red" : "magenta",
+    }).start();
+    let commentary;
+    try {
+        commentary = await generateCommentary(stats, mode);
+        commentarySpinner.succeed(chalk.green("Commentary generated!"));
+    }
+    catch (err) {
+        commentarySpinner.fail(chalk.yellow(`Commentary generation failed, using fallbacks`));
+        // Fallbacks are handled inside generateCommentary
+        commentary = await generateCommentary(stats, mode);
+    }
+    // Step 3: Render video
+    const renderSpinner = ora({ text: "Rendering your Wrapped video...", color: isDark ? "red" : "magenta" }).start();
+    try {
+        const outputPath = await renderVideo(stats, commentary, mode, options.output);
+        renderSpinner.succeed(chalk.green(`Video rendered!`));
+        console.log();
+        console.log(h(`  🎬 ${chalk.white.bold(outputPath)}`));
+        console.log(chalk.gray(isDark
+            ? "  Share it and make your coworkers contemplate their carbon footprint."
+            : "  Share it in Slack and flex on your coworkers."));
+        console.log();
+    }
+    catch (err) {
+        renderSpinner.fail(chalk.red(`Render failed: ${err.message}`));
+        console.error(err);
+        process.exit(1);
+    }
+});
+program.parse();

package/dist/data/commentary.d.ts

@@ -0,0 +1,13 @@
+import type { WrappedStats } from "./types";
+export interface Commentary {
+    tokensLine: string;
+    costLine: string;
+    modelLine: string;
+    busiestDayLine: string;
+    sessionLine: string;
+    peakHoursLine: string;
+    archetypeLine: string;
+    summaryLine: string;
+}
+export type Mode = "sassy" | "dark";
+export declare function generateCommentary(stats: WrappedStats, mode: Mode): Promise<Commentary>;

package/dist/data/commentary.js

@@ -0,0 +1,102 @@
+import Anthropic from "@anthropic-ai/sdk";
+function buildPrompt(stats, mode) {
+    const modeDescription = mode === "dark"
+        ? `DARK MODE: Your commentary should be darkly humorous with environmental/existential undertones.
+       Think: water usage, carbon footprint, e-waste, heat death of the universe, humanity's dependence on AI.
+       Examples of the vibe:
+       - "That's 100 gallons of water gone. We're not finding Nemo now."
+       - "Those tokens generated enough heat to melt a small glacier. You're welcome, polar bears."
+       - "You spent $X talking to a machine. Your therapist charges less and at least pretends to care."
+       - "Your longest session was 8 hours. The data center fans were begging for mercy."
+       Make it funny but with that uncomfortable kernel of truth. Dark comedy, not depressing.`
+        : `SASSY MODE: Your commentary should be hilariously sassy, roasty, and meme-culture aware.
+       Think: unhinged twitter energy, gen-z humor, affectionate bullying.
+       Examples of the vibe:
+       - "Bestie you spent more on tokens than my monthly grocery bill. Touch grass."
+       - "Opus? Oh we got a trust fund baby over here."
+       - "You coded at 3am on a Tuesday. That's not dedication, that's a cry for help."
+       Make it genuinely funny. Internet humor. The kind of thing people screenshot and share.`;
+    const periodContext = stats.periodLabel.startsWith("Your ")
+        ? `This recap covers ${stats.periodLabel.toLowerCase().replace("your ", "the user's last ")} of usage.`
+        : `This recap covers the period ${stats.periodLabel}.`;
+    return `You are writing short, punchy one-liner commentary for a "Claude Code Wrapped" recap video — a shareable stats recap of someone's AI coding assistant usage. Each line appears as a caption on an animated slide.
+
+${periodContext}
+
+${modeDescription}
+
+Here are the user's stats:
+- Total tokens: ${stats.totalTokens.toLocaleString()} (${stats.warAndPeaceEquivalent.toFixed(1)}x War and Peace)
+- Total estimated cost: $${stats.totalCost.toFixed(2)} (${stats.coffeeEquivalent} coffees worth)
+- Favorite model: ${stats.favoriteModel}
+- Busiest day: ${stats.busiestDay.date} with ${stats.busiestDay.tokenCount.toLocaleString()} tokens and ${stats.busiestDay.messageCount} messages
+- Longest session: ${Math.round(stats.longestSession.durationMinutes)} minutes (${(stats.longestSession.durationMinutes / 60).toFixed(1)} hours)
+- Total sessions: ${stats.totalSessions}
+- Total messages: ${stats.totalMessages.toLocaleString()}
+- Active days: ${stats.totalDaysActive}
+- Peak coding hour: ${stats.busiestHour}:00
+- Night owl score: ${stats.nightOwlScore}% (% of tokens during 10pm-5am)
+- Weekend warrior score: ${stats.weekendWarriorScore}%
+- Longest streak: ${stats.streakDays} consecutive days
+- Archetype: "${stats.archetype}" - ${stats.archetypeDescription}
+
+Generate exactly 8 one-liner captions (max 120 chars each). They should be FUNNY and SHAREABLE.
+Output as JSON with these exact keys: tokensLine, costLine, modelLine, busiestDayLine, sessionLine, peakHoursLine, archetypeLine, summaryLine
+
+Return ONLY the JSON object, no markdown fences or other text.`;
+}
+// Hardcoded dark mode fallbacks
+const darkFallbacks = {
+    tokensLine: "Each token consumed water, power, and a tiny piece of the planet. You're welcome, Earth.",
+    costLine: "You paid for the privilege of accelerating compute demand. The grid felt that.",
+    modelLine: "You picked the model. The data center picked up the energy bill.",
+    busiestDayLine: "Your biggest day kept servers spinning hot enough to heat a small apartment.",
+    sessionLine: "That session burned more electricity than your fridge uses in a week. Priorities.",
+    peakHoursLine: "Late-night prompts mean late-night cooling systems. The night shift thanks you.",
+    archetypeLine: "Every archetype is just a fun way to say 'heavy compute consumer.' But sure, it's personality.",
+    summaryLine: "You coded with AI. The ice caps continued to melt. Coincidence? Definitely. Probably.",
+};
+// Hardcoded sassy fallbacks
+const sassyFallbacks = {
+    tokensLine: "That's a LOT of tokens bestie. Your AI dependency is showing.",
+    costLine: "You could've bought something nice. Instead you bought robot words. No regrets though.",
+    modelLine: "Your model choice says a lot about you. We won't say what, but it says A LOT.",
+    busiestDayLine: "Your biggest day was UNHINGED. The vibes were immaculate, the productivity was concerning.",
+    sessionLine: "That marathon session? Iconic. Unhealthy, but iconic.",
+    peakHoursLine: "Your peak hours reveal things about your sleep schedule that we're choosing not to address.",
+    archetypeLine: "This archetype was chosen for you by math. The math doesn't lie. You might not like the math.",
+    summaryLine: "Outsourcing your thinking at scale. Honestly? Respect. Keep going.",
+};
+export async function generateCommentary(stats, mode) {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        console.log("  No ANTHROPIC_API_KEY found, using pre-written commentary.");
+        return mode === "dark" ? darkFallbacks : sassyFallbacks;
+    }
+    try {
+        const client = new Anthropic({ apiKey });
+        const message = await client.messages.create({
+            model: "claude-haiku-4-5-20251001",
+            max_tokens: 1024,
+            messages: [{ role: "user", content: buildPrompt(stats, mode) }],
+        });
+        const text = message.content[0]?.type === "text" ? message.content[0].text : "";
+        const parsed = JSON.parse(text);
+        // Validate all keys exist
+        const keys = [
+            "tokensLine", "costLine", "modelLine", "busiestDayLine",
+            "sessionLine", "peakHoursLine", "archetypeLine", "summaryLine",
+        ];
+        const fallback = mode === "dark" ? darkFallbacks : sassyFallbacks;
+        for (const key of keys) {
+            if (!parsed[key] || typeof parsed[key] !== "string") {
+                parsed[key] = fallback[key];
+            }
+        }
+        return parsed;
+    }
+    catch (err) {
+        console.log(`  AI commentary failed (${err.message}), using pre-written commentary.`);
+        return mode === "dark" ? darkFallbacks : sassyFallbacks;
+    }
+}

package/dist/data/parser.d.ts

@@ -0,0 +1,2 @@
+import type { WrappedStats, DateRange } from "./types.js";
+export declare function loadAndComputeStats(range?: DateRange, periodLabel?: string): Promise<WrappedStats>;