bashstats 0.2.0 → 0.2.2

package/README.md

@@ -1,9 +1,10 @@
 # bashstats
-<img width="1727" height="916" alt="bashstats2" src="https://github.com/user-attachments/assets/4029e711-f559-4771-9490-dedd4aeec1ee" />
+<img alt="bashstats dashboard" src="docs/dashboard.png" />
 
-Track every prompt, tool call, and late-night coding session. Earn badges. Build streaks. Watch your rank climb from Bronze to Obsidian.
-bashstats hooks into Claude Code and quietly records everything — sessions, prompts, tool usage, errors, and streaks. It then turns it all into stats,
-achievements, and a dashboard you'll check way too often.
+Track every prompt, tool call, and late-night coding session. Earn badges. Build streaks. Climb 500 ranks from Bronze to System Anomaly.
+
+bashstats hooks into Claude Code and quietly records everything — sessions, prompts, tool usage, errors, tokens, and streaks. It turns all of it into stats,
+124 achievements, weekly goals, and a dashboard you'll check way too often.
   
 ## Install
 
@@ -40,7 +41,7 @@ The browser dashboard at `http://localhost:17900` includes:
 
 - **Overview** - Recent badges, rank progress, stat cards, activity heatmap, and recent sessions at a glance
 - **Stats** - Lifetime totals, tool breakdowns, time analysis, session records, and project stats in a 2x2 grid
-- **Achievements** - All 53 badges with tier progress, organized by category
+- **Achievements** - All 124 badges with tier progress, organized by category
 - **Timeline** - Activity heatmap and session history with sparkline charts
 
 ## What Gets Tracked
@@ -65,16 +66,16 @@ bashstats hooks into 12 Claude Code events:
 ## Achievements
 <img width="1732" height="917" alt="bashstats" src="https://github.com/user-attachments/assets/63591b76-54ff-4659-b81a-e6310810e364" />
 
-53 badges across 10 categories, each with 5 tiers: Bronze, Silver, Gold, Diamond, Obsidian.
+124 badges across 16 categories, each with 5 tiers: Bronze, Silver, Gold, Diamond, Singularity. Tiers are calibrated for year-long progression — Bronze in your first week, Singularity after 12+ months.
 
-### Volume
+### Volume (5)
 - **First Prompt** - Submit prompts to Claude
 - **Tool Time** - Make tool calls
 - **Marathon** - Spend hours in sessions
 - **Wordsmith** - Type characters in prompts
 - **Session Vet** - Complete sessions
 
-### Tool Mastery
+### Tool Mastery (7)
 - **Shell Lord** - Execute Bash commands
 - **Bookworm** - Read files
 - **Editor-in-Chief** - Edit files
@@ -83,83 +84,195 @@ bashstats hooks into 12 Claude Code events:
 - **Web Crawler** - Fetch web pages
 - **Delegator** - Spawn subagents
 
-### Time & Streaks
+### Time & Patterns (10)
 - **Iron Streak** - Maintain a daily streak
 - **Night Owl** - Prompts between midnight and 5am
 - **Early Bird** - Prompts between 5am and 8am
 - **Weekend Warrior** - Weekend sessions
-
-### Behavioral
+- **Witching Hour** - Prompts between 2am and 4am
+- **Lunch Break Coder** - Sessions during lunch hour
+- **Monday Motivation** - Monday sessions
+- **Friday Shipper** - Git commits on Friday
+- **Timezone Traveler** - Unique hours with activity in a day
+- **Seasonal Coder** - Code through all four seasons
+
+### Session Behavior (6)
+- **One More Thing** - Extended sessions (1hr+, 15+ prompts)
+- **Quick Draw** - Sessions under 2 minutes with tool use
+- **The Pivot** - Sessions using 5+ distinct tool types
+- **Context Crunch** - Context compaction events
+- **Permission Slip** - Permission request events
+- **The Returner** - Days with 5+ sessions on the same project
+
+### Behavioral (5)
 - **Creature of Habit** - Repeat your most-used prompt
 - **Explorer** - Use unique tool types
 - **Planner** - Use plan mode
 - **Novelist** - Write prompts over 1000 characters
 - **Speed Demon** - Complete sessions in under 5 minutes
 
-### Resilience
+### Prompt Patterns (6)
+- **Minimalist** - Short prompts (under 10 words)
+- **Question Master** - Prompts ending with a question mark
+- **The Apologizer** - Prompts containing "sorry"
+- **CAPS LOCK ENERGY** - Fully uppercase prompts
+- **Emoji Whisperer** - Prompts with emoji
+- **Code Dump** - Prompts with 50+ lines
+
+### Resilience (3)
 - **Clean Hands** - Longest error-free tool streak
 - **Resilient** - Survive errors
 - **Rate Limited** - Hit rate limits
 
-### Shipping & Projects
+### Error & Recovery (5)
+- **Rubber Duck** - Tool failure followed by success without edits
+- **Third Time's the Charm** - Success after 2+ consecutive failures
+- **The Undoer** - Back-to-back edits on the same file
+- **Crash Test Dummy** - Sessions with 10+ errors
+- **Phoenix** - Total lifetime errors survived
+
+### Tool Combos (5)
+- **Read-Edit-Run** - Read, Edit, Bash sequences
+- **Grep Ninja** - Total Grep and Glob searches
+- **File Factory** - Max files created in a session
+- **The Refactorer** - Max edits to a single file across all sessions
+- **Search and Destroy** - Grep/Glob followed by Edit
+
+### Shipping & Projects (4)
 - **Shipper** - Make commits via Claude
 - **PR Machine** - Create pull requests
 - **Empire** - Work on unique projects
 - **Polyglot** - Use different programming languages
 
-### Multi-Agent
+### Project Dedication (5)
+- **Monogamous** - Max sessions on a single project
+- **Project Hopper** - Max unique projects in a day
+- **The Finisher** - Projects with commits followed by inactivity
+- **Legacy Code** - Return to a project after 30+ days
+- **Greenfield** - Total unique projects initialized
+
+### Multi-Agent (12)
 - **Buddy System** - Use concurrent agents
-- **Hive Mind** - Spawn subagents total
-
-### Humor
-- **Please and Thank You** - "You're polite to the AI. When they take over, you'll be spared."
-- **Wall of Text** - "Claude read your entire novel and didn't even complain."
-- **The Fixer** - "At this point just rewrite the whole thing."
-- **What Day Is It?** - "Your chair is now a part of you."
-- **Copy Pasta** - "Maybe if I ask again it'll work differently."
-- **Error Magnet** - "At this point, the errors are a feature."
-
-### Aspirational (Obsidian-only)
-- **The Machine** - "You are no longer using the tool. You are the tool."
-- **Year of Code** - "365 days. No breaks. Absolute unit."
-- **Million Words** - "You've written more to Claude than most people write in a lifetime."
-- **Lifer** - "At this point, Claude is your cofounder."
-- **Transcendent** - "You've reached the peak. The view is nice up here."
-- **Omniscient** - "You've mastered every tool. There is nothing left to teach you."
+- **Hive Mind** - Total subagent spawns
+- **Swarm Intelligence** - Max concurrent subagents
+- **Micromanager** - Subagents stopped within 30 seconds
+- **The Orchestrator** - Total subagent spawns across all sessions
+- **Agent Smith** - Max subagents in a single session
+- **Polyglot Agent** - Use multiple CLI agents
+- **Gemini Whisperer** - Complete sessions in Gemini CLI
+- **Copilot Rider** - Complete sessions in Copilot CLI
+- **Open Source Spirit** - Complete sessions in OpenCode
+- **Agent Hopper** - Use different agents on multiple days
+- **Double Agent** - Use 2+ agents on the same day
+
+### Wild Card (12)
+- **Please and Thank You** - Polite prompts
+- **Wall of Text** - Prompts over 5,000 characters
+- **The Fixer** - Max edits to a single file
+- **What Day Is It?** - Sessions exceeding 8 hours
+- **Copy Pasta** - Duplicate prompts submitted
+- **Error Magnet** - Max errors in a single session
+- **D&eacute;j&agrave; Vu** - Same prompt submitted twice within 5 minutes
+- **Trust Issues** - Read immediately after Write on the same file
+- **Backseat Driver** - Prompts with numbered step-by-step instructions
+- **The Negotiator** - Prompts containing "try again" or "one more time"
+- **Rubber Stamp** - Max consecutive permission requests
+- **It Works On My Machine** - Bash success after a previous Bash failure
+
+### Token Usage (10)
+- **Token Burner** - Total tokens consumed across all sessions
+- **Output Machine** - Total output tokens generated
+- **Cache Royalty** - Total cache read tokens
+- **Context Crafter** - Total cache creation tokens
+- **Token Whale** - Most tokens in a single session
+- **Heavy Hitter** - Sessions exceeding 1M total tokens
+- **Featherweight** - Lean sessions under 50K tokens with tool use
+- **Token Velocity** - Average tokens per session
+- **Prolific** - Most output tokens in one session
+- **Input Flood** - Total raw input tokens
+
+### Aspirational (Singularity-only) (12)
+- **The Machine** - 100,000 total tool calls
+- **Year of Code** - 365-day consecutive streak
+- **Million Words** - 10 million characters typed
+- **Lifer** - 10,000 sessions completed
+- **Transcendent** - 100,000 total XP
+- **Omniscient** - All tool mastery badges at Singularity tier
+- **10,000 Hours** - 10,000 hours in sessions
+- **The Architect** - 1,000+ files created
+- **Eternal Flame** - 180-day consecutive streak
+- **The Collector** - Every non-secret, non-aspirational badge unlocked
+- **Centimillionaire** - 100 million characters typed
+- **Token Billionaire** - 1 billion total tokens consumed
 
 ### Secret
-10 hidden badges unlocked by specific behaviors. Discover them yourself.
+17 hidden badges unlocked by specific behaviors. Discover them yourself.
 
 ## Rank System
 
-XP is earned from badge tiers. Your rank progresses through:
+500 numbered ranks with an exponential XP curve. Early ranks come fast; the top 100 are a serious grind.
 
-| Rank | XP Required |
-|---|---|
-| Bronze | 0 |
-| Silver | 1,000 |
-| Gold | 5,000 |
-| Diamond | 25,000 |
-| Obsidian | 100,000 |
+**Formula:** `cumXP(N) = floor(10 * N^2.2)`
+
+| Tier | Ranks | Approx. Time |
+|------|-------|-------------|
+| Bronze | 1-100 | First few months |
+| Silver | 101-200 | ~3-4 months |
+| Gold | 201-300 | ~6-9 months |
+| Diamond | 301-400 | ~12-18 months |
+| Obsidian | 401-499 | Each rank takes weeks |
+| System Anomaly | 500 | 2+ years |
+
+**XP sources:** prompts (+1), sessions (+5), hours (+10/hr), streaks (+5/day), badge tier unlocks (50-1000), and weekly goals.
+
+## Weekly Goals
+
+Two systems that stack for bonus XP:
+
+**Activity Multiplier** -- XP bonus based on days active this week:
+
+| Days Active | Multiplier |
+|-------------|-----------|
+| 1-2 | 1.0x-1.1x |
+| 3-4 | 1.2x-1.3x |
+| 5-6 | 1.5x-1.75x |
+| 7 | 2.0x |
+
+**Challenge Cards** -- 3 rotating challenges generated each Monday from a pool of ~25. Complete them for bonus XP (100-300 per challenge). Examples: "Use 5+ tools in one session", "Submit 50 prompts this week", "Hit a 7-day streak".
 
 ## Agent Support
 
-bashstats detects which CLI agent is running:
+bashstats works with multiple AI coding agents. `bashstats init` auto-detects installed agents and sets up hooks for each one.
+
+| Agent | Detection | Token Tracking |
+|-------|-----------|----------------|
+| Claude Code | Always installed (default) | Full (input, output, cache) |
+| Gemini CLI | `~/.gemini` directory exists | Approximate (total only) |
+| Copilot CLI | `copilot` binary available | Not available |
+| OpenCode | `~/.config/opencode` exists | Not available |
+
+All agents share the same `~/.bashstats/bashstats.db` database. The dashboard agent dropdown filters stats by agent, and the overview tab shows a breakdown when multiple agents are in use.
+
+### How it works
+
+- **Claude Code** - Hooks installed in `~/.claude/settings.json`
+- **Gemini CLI** - Hooks installed in `~/.gemini/settings.json`
+- **Copilot CLI** - Hook config written to `~/.copilot/hooks/bashstats-hooks.json`
+- **OpenCode** - Plugin installed at `~/.config/opencode/plugins/bashstats.ts`
 
-- Claude Code (default)
-- Gemini CLI
-- Copilot CLI
-- OpenCode
+`bashstats uninstall` removes hooks from all agents.
 
 ## Data Storage
 
 All data is stored locally in `~/.bashstats/bashstats.db` (SQLite with WAL mode). Nothing is sent anywhere. Tables:
 
 - `events` - Every hook event with full context
-- `sessions` - Session lifecycle (start, end, duration, counts)
+- `sessions` - Session lifecycle (start, end, duration, counts, token usage)
 - `prompts` - Prompt content and word/char counts
 - `daily_activity` - Aggregated daily stats
 - `achievement_unlocks` - Badge tier unlock timestamps
+- `weekly_goals` - Weekly challenge cards and completion status
+- `weekly_xp` - Weekly XP totals with multiplier tracking
 
 ## Tech Stack