vibestats 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,80 @@
1
+ # @wolfaidev/claude-wrapped
2
+
3
+ Generate your **Claude Code Wrapped 2025** - a Spotify Wrapped-style annual summary of your Claude Code usage.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install -g @wolfaidev/claude-wrapped
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```bash
14
+ claude-wrapped
15
+ ```
16
+
17
+ This reads your local Claude Code stats from `~/.claude/stats-cache.json` and displays:
18
+
19
+ - Total sessions, tokens, and estimated cost
20
+ - Longest and current coding streaks
21
+ - Peak coding hour and favorite day
22
+ - Model usage breakdown
23
+ - Words generated estimate
24
+ - Shareable URL to view your wrapped online
25
+
26
+ ## CLI Flags
27
+
28
+ | Flag | Description |
29
+ |------|-------------|
30
+ | `--json` | Output raw JSON stats |
31
+ | `--quiet`, `-q` | Only output the shareable URL |
32
+ | `--url <url>` | Custom base URL for the wrapped page |
33
+ | `--init` | Create a default config file |
34
+ | `--config` | Show current config location and values |
35
+
36
+ ## Config File
37
+
38
+ Create a config file to set persistent defaults:
39
+
40
+ ```bash
41
+ claude-wrapped --init
42
+ ```
43
+
44
+ This creates `~/.claude-wrapped.json`:
45
+
46
+ ```json
47
+ {
48
+ "baseUrl": "https://wrapped.wolfai.dev",
49
+ "outputFormat": "normal",
50
+ "theme": {
51
+ "enabled": true
52
+ },
53
+ "hideCost": false
54
+ }
55
+ ```
56
+
57
+ ### Config Options
58
+
59
+ | Option | Type | Default | Description |
60
+ |--------|------|---------|-------------|
61
+ | `baseUrl` | string | `https://wrapped.wolfai.dev` | Base URL for shareable links |
62
+ | `outputFormat` | `"normal"` \| `"json"` \| `"quiet"` | `"normal"` | Default output format |
63
+ | `theme.enabled` | boolean | `true` | Enable terminal colors |
64
+ | `statsCachePath` | string | `~/.claude/stats-cache.json` | Custom stats file path |
65
+ | `hideCost` | boolean | `false` | Hide cost from output |
66
+
67
+ CLI flags always override config file values.
68
+
69
+ ## Requirements
70
+
71
+ - Node.js 18+
72
+ - Claude Code must have been used at least once (to generate stats)
73
+
74
+ ## View Online
75
+
76
+ Visit [wrapped.wolfai.dev](https://wrapped.wolfai.dev) to view your wrapped in the browser.
77
+
78
+ ## License
79
+
80
+ MIT
@@ -0,0 +1 @@
1
+ #!/usr/bin/env node