vibestats 1.0.3 → 1.0.5

package/README.md

@@ -1,79 +1,98 @@
-# @wolfaidev/claude-wrapped
+# vibestats
 
-Generate your **Claude Code Wrapped 2025** - a Spotify Wrapped-style annual summary of your Claude Code usage.
+AI coding stats CLI for **Claude Code** and **OpenAI Codex**. Track your usage and generate annual "Spotify Wrapped" style summaries.
 
 ## Installation
 
 ```bash
-npm install -g @wolfaidev/claude-wrapped
+npm install -g vibestats
+# or run directly
+npx vibestats
 ```
 
 ## Usage
 
 ```bash
-claude-wrapped
+# Usage stats (default)
+vibestats              # Daily usage table
+vibestats --monthly    # Monthly aggregation
+vibestats --model      # Aggregate by model
+vibestats --total      # Show only totals
+
+# Wrapped summary
+vibestats --wrapped    # Annual wrapped summary
 ```
 
-This reads your local Claude Code stats from `~/.claude/stats-cache.json` and displays:
+## CLI Flags
 
-- Total sessions, tokens, and estimated cost
-- Longest and current coding streaks
-- Peak coding hour and favorite day
-- Model usage breakdown
-- Words generated estimate
-- Shareable URL to view your wrapped online
+### Usage Mode (default)
 
-## CLI Flags
+| Flag | Description |
+|------|-------------|
+| `--monthly` | Aggregate by month |
+| `--model` | Aggregate by model |
+| `--total` | Show only totals |
+| `--since YYYY-MM-DD` | Filter from date |
+| `--until YYYY-MM-DD` | Filter to date |
+| `--compact`, `-c` | Compact table (hide cache columns) |
+| `--json` | Output raw JSON |
+
+### Wrapped Mode
 
 | Flag | Description |
 |------|-------------|
+| `--wrapped` | Generate wrapped summary |
 | `--json` | Output raw JSON stats |
 | `--quiet`, `-q` | Only output the shareable URL |
-| `--url <url>` | Custom base URL for the wrapped page |
-| `--init` | Create a default config file |
-| `--config` | Show current config location and values |
+| `--no-short` | Disable shortlink generation |
 
-## Config File
+### Data Source
 
-Create a config file to set persistent defaults:
+| Flag | Description |
+|------|-------------|
+| `--codex` | OpenAI Codex only |
+| `--combined` | Claude + Codex combined |
+
+### Config
+
+| Flag | Description |
+|------|-------------|
+| `--init` | Create config file |
+| `--config` | Show current config |
+| `--url <url>` | Custom base URL |
+
+## Config File
 
 ```bash
-claude-wrapped --init
+vibestats --init
 ```
 
-This creates `~/.claude-wrapped.json`:
+Creates `~/.vibestats.json`:
 
 ```json
 {
-  "baseUrl": "https://wrapped.wolfai.dev",
+  "baseUrl": "https://vibestats.wolfai.dev",
   "outputFormat": "normal",
-  "theme": {
-    "enabled": true
-  },
+  "theme": { "enabled": true },
   "hideCost": false
 }
 ```
 
-### Config Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `baseUrl` | string | `https://wrapped.wolfai.dev` | Base URL for shareable links |
-| `outputFormat` | `"normal"` \| `"json"` \| `"quiet"` | `"normal"` | Default output format |
-| `theme.enabled` | boolean | `true` | Enable terminal colors |
-| `statsCachePath` | string | `~/.claude/stats-cache.json` | Custom stats file path |
-| `hideCost` | boolean | `false` | Hide cost from output |
+## Data Sources
 
-CLI flags always override config file values.
+| Source | Location |
+|--------|----------|
+| Claude Code | `~/.claude/projects/**/*.jsonl` |
+| OpenAI Codex | `~/.codex/sessions/*.jsonl` |
 
 ## Requirements
 
 - Node.js 18+
-- Claude Code must have been used at least once (to generate stats)
+- Claude Code or OpenAI Codex CLI usage data
 
 ## View Online
 
-Visit [wrapped.wolfai.dev](https://wrapped.wolfai.dev) to view your wrapped in the browser.
+Visit [vibestats.wolfai.dev](https://vibestats.wolfai.dev) to view your wrapped in the browser.
 
 ## License
 

package/dist/index.js

@@ -1436,6 +1436,49 @@ function getModelAbbrevFromDisplayName(displayName) {
   };
   return map[displayName] || displayName.slice(0, 5).toLowerCase();
 }
+function encodeUsageToUrl(stats, baseUrl = "https://vibestats.wolfai.dev") {
+  const params = new URLSearchParams();
+  const aggMap = { daily: "d", monthly: "m", model: "mo", total: "t" };
+  params.set("agg", aggMap[stats.aggregation] || "d");
+  if (stats.source !== "claude") {
+    params.set("src", stats.source);
+  }
+  const formatDateCompact = (d) => d.replace(/-/g, "");
+  params.set("dr", `${formatDateCompact(stats.dateRange.start)}-${formatDateCompact(stats.dateRange.end)}`);
+  const rows = stats.rows.slice(0, 31).map((row) => {
+    let key = row.key;
+    if (stats.aggregation === "daily" && row.key.length === 10) {
+      key = row.key.slice(5).replace("-", "");
+    }
+    return [
+      key,
+      formatCompactNumber(row.inputTokens),
+      formatCompactNumber(row.outputTokens),
+      formatCompactNumber(row.cacheWriteTokens),
+      formatCompactNumber(row.cacheReadTokens),
+      formatCompactNumber(row.totalTokens),
+      row.cost.toFixed(2)
+    ].join(":");
+  });
+  params.set("rows", rows.join("|"));
+  const t = stats.totals;
+  params.set("tot", [
+    formatCompactNumber(t.inputTokens),
+    formatCompactNumber(t.outputTokens),
+    formatCompactNumber(t.cacheWriteTokens),
+    formatCompactNumber(t.cacheReadTokens),
+    formatCompactNumber(t.totalTokens),
+    t.cost.toFixed(2)
+  ].join(":"));
+  if (stats.modelBreakdown.length > 0) {
+    const mb = stats.modelBreakdown.slice(0, 5).map((m) => {
+      const abbr = getModelAbbrevFromDisplayName(m.model);
+      return `${abbr}:${m.percentage}:${m.cost.toFixed(2)}`;
+    });
+    params.set("mb", mb.join(","));
+  }
+  return `${baseUrl}?${params.toString()}`;
+}
 
 // src/display.ts
 var colors2 = {
@@ -1704,6 +1747,13 @@ var main = defineCommand({
       description: "Use compact table format (hide cache columns)",
       default: false
     },
+    // Share option for usage mode
+    share: {
+      type: "boolean",
+      alias: "s",
+      description: "Generate a shareable URL (usage mode)",
+      default: false
+    },
     // Wrapped-specific options
     url: {
       type: "string",
@@ -1769,6 +1819,19 @@ async function runUsage(args, config) {
     }
     process.exit(1);
   }
+  const baseUrl = args.url || config.baseUrl || "https://vibestats.wolfai.dev";
+  let shareUrl = null;
+  if (args.share) {
+    const fullUrl = encodeUsageToUrl(stats, baseUrl);
+    if (!args["no-short"]) {
+      shareUrl = await createShortlink(fullUrl, baseUrl);
+    }
+    shareUrl = shareUrl || fullUrl;
+  }
+  if (args.quiet && args.share && shareUrl) {
+    console.log(shareUrl);
+    return;
+  }
   if (args.json) {
     console.log(JSON.stringify(stats, null, 2));
   } else if (args.quiet) {
@@ -1787,6 +1850,10 @@ async function runUsage(args, config) {
       showColors: config.theme?.enabled !== false
     });
   }
+  if (args.share && shareUrl && !args.json) {
+    console.log();
+    console.log(`\u{1F517} ${shareUrl}`);
+  }
 }
 async function runWrapped(args, config) {
   const options = resolveOptions(args, config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibestats",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "AI coding stats - usage tracking and annual wrapped for Claude Code & Codex",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,11 +18,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsup src/index.ts --format esm --dts --clean --shims",
-    "prepublishOnly": "pnpm build"
-  },
   "keywords": [
     "claude",
     "claude-code",
@@ -50,5 +45,9 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup src/index.ts --format esm --dts --clean --shims"
   }
-}
+}