bashstats 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,186 @@
+# bashstats
+<img width="1727" height="916" alt="bashstats2" src="https://github.com/user-attachments/assets/4029e711-f559-4771-9490-dedd4aeec1ee" />
+
+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.
+  
+## Install
+
+```bash
+npm install -g bashstats
+bashstats init
+```
+
+`bashstats init` installs Claude Code hooks and creates the local database at `~/.bashstats/bashstats.db`. Stats begin recording immediately.
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `bashstats init` | Install hooks and set up database |
+| `bashstats stats` | Quick stat summary in your terminal |
+| `bashstats achievements` | List all badges with progress bars |
+| `bashstats streak` | Show current and longest daily streak |
+| `bashstats web` | Launch the browser dashboard |
+| `bashstats export` | Export all data as JSON |
+| `bashstats reset` | Wipe all data |
+| `bashstats uninstall` | Remove hooks and data |
+
+### Options
+
+```bash
+bashstats web --port 8080    # Custom port (default: 17900)
+bashstats web --no-open      # Don't auto-open browser
+```
+
+## Dashboard
+
+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
+- **Timeline** - Activity heatmap and session history with sparkline charts
+
+## What Gets Tracked
+
+bashstats hooks into 12 Claude Code events:
+
+| Event | What it records |
+|---|---|
+| SessionStart | Session creation, project, agent type |
+| UserPromptSubmit | Prompt content, character/word counts |
+| PreToolUse | Tool invocations (Bash, Read, Edit, etc.) |
+| PostToolUse | Tool results and exit codes |
+| PostToolUseFailure | Failed tool calls |
+| Stop | Session end time and duration |
+| Notification | Errors and rate limits |
+| SubagentStart | Subagent spawns |
+| SubagentStop | Subagent completions |
+| PreCompact | Context compactions |
+| PermissionRequest | Permission prompts |
+| Setup | Initialization 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.
+
+### Volume
+- **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
+- **Shell Lord** - Execute Bash commands
+- **Bookworm** - Read files
+- **Editor-in-Chief** - Edit files
+- **Architect** - Create files
+- **Detective** - Search with Grep and Glob
+- **Web Crawler** - Fetch web pages
+- **Delegator** - Spawn subagents
+
+### Time & Streaks
+- **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
+- **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
+- **Clean Hands** - Longest error-free tool streak
+- **Resilient** - Survive errors
+- **Rate Limited** - Hit rate limits
+
+### Shipping & Projects
+- **Shipper** - Make commits via Claude
+- **PR Machine** - Create pull requests
+- **Empire** - Work on unique projects
+- **Polyglot** - Use different programming languages
+
+### Multi-Agent
+- **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."
+
+### Secret
+10 hidden badges unlocked by specific behaviors. Discover them yourself.
+
+## Rank System
+
+XP is earned from badge tiers. Your rank progresses through:
+
+| Rank | XP Required |
+|---|---|
+| Bronze | 0 |
+| Silver | 1,000 |
+| Gold | 5,000 |
+| Diamond | 25,000 |
+| Obsidian | 100,000 |
+
+## Agent Support
+
+bashstats detects which CLI agent is running:
+
+- Claude Code (default)
+- Gemini CLI
+- Copilot CLI
+- OpenCode
+
+## 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)
+- `prompts` - Prompt content and word/char counts
+- `daily_activity` - Aggregated daily stats
+- `achievement_unlocks` - Badge tier unlock timestamps
+
+## Tech Stack
+
+- TypeScript + Node.js 18+
+- SQLite via `better-sqlite3`
+- Express for the dashboard server
+- Commander for the CLI
+- tsup for bundling
+- vitest for tests
+
+## Development
+
+```bash
+git clone https://github.com/GhostPeony/bashstats.git
+cd bashstats
+npm install
+npm run build
+npm link
+bashstats init
+```
+
+## License
+
+MIT

package/dist/{chunk-2KXMOTBO.js → chunk-OYLQHCOY.js}

@@ -111,7 +111,11 @@ CREATE TABLE IF NOT EXISTS sessions (
   tool_count INTEGER DEFAULT 0,
   error_count INTEGER DEFAULT 0,
   project TEXT,
-  duration_seconds INTEGER
+  duration_seconds INTEGER,
+  input_tokens INTEGER DEFAULT 0,
+  output_tokens INTEGER DEFAULT 0,
+  cache_creation_input_tokens INTEGER DEFAULT 0,
+  cache_read_input_tokens INTEGER DEFAULT 0
 );
 
 CREATE TABLE IF NOT EXISTS prompts (
@@ -130,7 +134,11 @@ CREATE TABLE IF NOT EXISTS daily_activity (
   prompts INTEGER DEFAULT 0,
   tool_calls INTEGER DEFAULT 0,
   errors INTEGER DEFAULT 0,
-  duration_seconds INTEGER DEFAULT 0
+  duration_seconds INTEGER DEFAULT 0,
+  input_tokens INTEGER DEFAULT 0,
+  output_tokens INTEGER DEFAULT 0,
+  cache_creation_input_tokens INTEGER DEFAULT 0,
+  cache_read_input_tokens INTEGER DEFAULT 0
 );
 
 CREATE TABLE IF NOT EXISTS achievement_unlocks (
@@ -159,16 +167,30 @@ var BashStatsDB = class {
   constructor(dbPath) {
     this.db = new Database(dbPath);
     this.db.pragma("journal_mode = WAL");
+    this.db.pragma("busy_timeout = 5000");
     this.db.pragma("foreign_keys = ON");
     this.db.exec(SCHEMA);
     this.migrate();
   }
   migrate() {
-    const columns = this.db.pragma("table_info(sessions)");
-    const hasAgent = columns.some((c) => c.name === "agent");
-    if (!hasAgent) {
+    const sessionCols = this.db.pragma("table_info(sessions)");
+    const sessionColNames = new Set(sessionCols.map((c) => c.name));
+    if (!sessionColNames.has("agent")) {
       this.db.exec("ALTER TABLE sessions ADD COLUMN agent TEXT NOT NULL DEFAULT 'claude-code'");
     }
+    const tokenCols = ["input_tokens", "output_tokens", "cache_creation_input_tokens", "cache_read_input_tokens"];
+    for (const col of tokenCols) {
+      if (!sessionColNames.has(col)) {
+        this.db.exec(`ALTER TABLE sessions ADD COLUMN ${col} INTEGER DEFAULT 0`);
+      }
+    }
+    const dailyCols = this.db.pragma("table_info(daily_activity)");
+    const dailyColNames = new Set(dailyCols.map((c) => c.name));
+    for (const col of tokenCols) {
+      if (!dailyColNames.has(col)) {
+        this.db.exec(`ALTER TABLE daily_activity ADD COLUMN ${col} INTEGER DEFAULT 0`);
+      }
+    }
   }
   close() {
     this.db.close();
@@ -243,6 +265,11 @@ var BashStatsDB = class {
     params.push(id);
     this.db.prepare(`UPDATE sessions SET ${sets.join(", ")} WHERE id = ?`).run(...params);
   }
+  updateSessionTokens(id, tokens) {
+    this.db.prepare(`
+      UPDATE sessions SET input_tokens = ?, output_tokens = ?, cache_creation_input_tokens = ?, cache_read_input_tokens = ? WHERE id = ?
+    `).run(tokens.input_tokens, tokens.output_tokens, tokens.cache_creation_input_tokens, tokens.cache_read_input_tokens, id);
+  }
   incrementSessionCounters(id, counters) {
     const sets = [];
     const params = [];
@@ -275,21 +302,29 @@ var BashStatsDB = class {
   // === Daily Activity ===
   incrementDailyActivity(date, increments) {
     this.db.prepare(`
-      INSERT INTO daily_activity (date, sessions, prompts, tool_calls, errors, duration_seconds)
-      VALUES (?, ?, ?, ?, ?, ?)
+      INSERT INTO daily_activity (date, sessions, prompts, tool_calls, errors, duration_seconds, input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT(date) DO UPDATE SET
         sessions = sessions + excluded.sessions,
         prompts = prompts + excluded.prompts,
         tool_calls = tool_calls + excluded.tool_calls,
         errors = errors + excluded.errors,
-        duration_seconds = duration_seconds + excluded.duration_seconds
+        duration_seconds = duration_seconds + excluded.duration_seconds,
+        input_tokens = input_tokens + excluded.input_tokens,
+        output_tokens = output_tokens + excluded.output_tokens,
+        cache_creation_input_tokens = cache_creation_input_tokens + excluded.cache_creation_input_tokens,
+        cache_read_input_tokens = cache_read_input_tokens + excluded.cache_read_input_tokens
     `).run(
       date,
       increments.sessions ?? 0,
       increments.prompts ?? 0,
       increments.tool_calls ?? 0,
       increments.errors ?? 0,
-      increments.duration_seconds ?? 0
+      increments.duration_seconds ?? 0,
+      increments.input_tokens ?? 0,
+      increments.output_tokens ?? 0,
+      increments.cache_creation_input_tokens ?? 0,
+      increments.cache_read_input_tokens ?? 0
     );
   }
   getDailyActivity(date) {
@@ -550,7 +585,7 @@ var BashStatsWriter = class {
       errors: success === 0 ? 1 : 0
     });
   }
-  recordSessionEnd(sessionId, stopReason) {
+  recordSessionEnd(sessionId, stopReason, tokens) {
     const timestamp = this.now();
     const session = this.db.getSession(sessionId);
     let durationSeconds;
@@ -564,6 +599,9 @@ var BashStatsWriter = class {
       stop_reason: stopReason,
       duration_seconds: durationSeconds
     });
+    if (tokens) {
+      this.db.updateSessionTokens(sessionId, tokens);
+    }
     this.db.insertEvent({
       session_id: sessionId,
       hook_type: "Stop",
@@ -576,8 +614,18 @@ var BashStatsWriter = class {
       project: null,
       timestamp
     });
+    const dailyIncrements = {};
     if (durationSeconds !== void 0) {
-      this.db.incrementDailyActivity(this.today(), { duration_seconds: durationSeconds });
+      dailyIncrements.duration_seconds = durationSeconds;
+    }
+    if (tokens) {
+      dailyIncrements.input_tokens = tokens.input_tokens;
+      dailyIncrements.output_tokens = tokens.output_tokens;
+      dailyIncrements.cache_creation_input_tokens = tokens.cache_creation_input_tokens;
+      dailyIncrements.cache_read_input_tokens = tokens.cache_read_input_tokens;
+    }
+    if (Object.keys(dailyIncrements).length > 0) {
+      this.db.incrementDailyActivity(this.today(), dailyIncrements);
     }
   }
   recordNotification(sessionId, message, notificationType) {
@@ -635,7 +683,49 @@ var BashStatsWriter = class {
 // src/hooks/handler.ts
 import path3 from "path";
 import os2 from "os";
+import fs3 from "fs";
+
+// src/hooks/transcript.ts
 import fs2 from "fs";
+import readline from "readline";
+async function extractTokenUsage(transcriptPath) {
+  try {
+    if (!fs2.existsSync(transcriptPath)) return null;
+    const stream = fs2.createReadStream(transcriptPath, { encoding: "utf-8" });
+    const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let cacheCreation = 0;
+    let cacheRead = 0;
+    let found = false;
+    for await (const line of rl) {
+      if (!line.trim()) continue;
+      try {
+        const entry = JSON.parse(line);
+        const usage = entry.usage ?? entry.response?.usage ?? entry.message?.usage;
+        if (usage && typeof usage === "object") {
+          inputTokens += usage.input_tokens ?? 0;
+          outputTokens += usage.output_tokens ?? 0;
+          cacheCreation += usage.cache_creation_input_tokens ?? 0;
+          cacheRead += usage.cache_read_input_tokens ?? 0;
+          found = true;
+        }
+      } catch {
+      }
+    }
+    if (!found) return null;
+    return {
+      input_tokens: inputTokens,
+      output_tokens: outputTokens,
+      cache_creation_input_tokens: cacheCreation,
+      cache_read_input_tokens: cacheRead
+    };
+  } catch {
+    return null;
+  }
+}
+
+// src/hooks/handler.ts
 function detectAgent() {
   if (process.env.GEMINI_CLI || process.env.GEMINI_API_KEY) return "gemini-cli";
   if (process.env.GITHUB_COPILOT_CLI) return "copilot-cli";
@@ -676,7 +766,7 @@ async function handleHookEvent(hookType) {
   const event = parseHookEvent(raw);
   if (!event) return;
   const dataDir = getDataDir();
-  fs2.mkdirSync(dataDir, { recursive: true });
+  fs3.mkdirSync(dataDir, { recursive: true });
   const dbPath = getDbPath();
   const db = new BashStatsDB(dbPath);
   const writer = new BashStatsWriter(db);
@@ -717,7 +807,10 @@ async function handleHookEvent(hookType) {
         break;
       }
       case "Stop": {
-        writer.recordSessionEnd(sessionId, "stopped");
+        const rawPath = event.transcript_path ?? "";
+        const transcriptPath = rawPath && rawPath.endsWith(".jsonl") ? path3.resolve(rawPath) : "";
+        const tokens = transcriptPath ? await extractTokenUsage(transcriptPath) : null;
+        writer.recordSessionEnd(sessionId, "stopped", tokens);
         break;
       }
       case "Notification": {
@@ -809,6 +902,19 @@ var StatsEngine = class {
     const totalRateLimits = this.queryScalar(
       "SELECT COUNT(*) as c FROM events WHERE hook_type = 'Notification' AND tool_input LIKE '%rate_limit%'"
     );
+    const totalInputTokens = this.queryScalar(
+      "SELECT COALESCE(SUM(input_tokens), 0) as c FROM sessions"
+    );
+    const totalOutputTokens = this.queryScalar(
+      "SELECT COALESCE(SUM(output_tokens), 0) as c FROM sessions"
+    );
+    const totalCacheCreationTokens = this.queryScalar(
+      "SELECT COALESCE(SUM(cache_creation_input_tokens), 0) as c FROM sessions"
+    );
+    const totalCacheReadTokens = this.queryScalar(
+      "SELECT COALESCE(SUM(cache_read_input_tokens), 0) as c FROM sessions"
+    );
+    const totalTokens = totalInputTokens + totalOutputTokens;
     return {
       totalSessions,
       totalDurationSeconds,
@@ -825,7 +931,12 @@ var StatsEngine = class {
       totalSubagents,
       totalCompactions,
       totalErrors,
-      totalRateLimits
+      totalRateLimits,
+      totalInputTokens,
+      totalOutputTokens,
+      totalCacheCreationTokens,
+      totalCacheReadTokens,
+      totalTokens
     };
   }
   getToolBreakdown() {
@@ -939,6 +1050,12 @@ var StatsEngine = class {
     const avgToolsPerSession = this.queryScalar(
       "SELECT COALESCE(AVG(tool_count), 0) as c FROM sessions"
     );
+    const mostTokensInSession = this.queryScalar(
+      "SELECT COALESCE(MAX(COALESCE(input_tokens, 0) + COALESCE(output_tokens, 0)), 0) as c FROM sessions"
+    );
+    const avgTokensPerSession = this.queryScalar(
+      "SELECT COALESCE(AVG(COALESCE(input_tokens, 0) + COALESCE(output_tokens, 0)), 0) as c FROM sessions"
+    );
     return {
       longestSessionSeconds,
       mostToolsInSession,
@@ -946,7 +1063,9 @@ var StatsEngine = class {
       fastestSessionSeconds,
       avgDurationSeconds: Math.round(avgDurationSeconds),
       avgPromptsPerSession: Math.round(avgPromptsPerSession * 100) / 100,
-      avgToolsPerSession: Math.round(avgToolsPerSession * 100) / 100
+      avgToolsPerSession: Math.round(avgToolsPerSession * 100) / 100,
+      mostTokensInSession,
+      avgTokensPerSession: Math.round(avgTokensPerSession)
     };
   }
   getProjectStats() {
@@ -1367,4 +1486,4 @@ export {
   TIER_NAMES,
   AchievementEngine
 };
-//# sourceMappingURL=chunk-2KXMOTBO.js.map
+//# sourceMappingURL=chunk-OYLQHCOY.js.map