opencode-token-tracker 1.0.0 → 1.1.0

package/README.md

@@ -8,6 +8,7 @@ Real-time token usage and cost tracking plugin for [OpenCode](https://opencode.a
 
 - **Real-time Toast notifications** - See token usage and cost after each AI response
 - **Session statistics** - Track cumulative usage across your entire session
+- **CLI statistics tool** - Query usage by day/week/month with breakdowns by model/agent
 - **Cost calculation** - Automatic cost estimation based on model pricing
 - **JSONL logging** - All usage data saved locally for analysis
 - **Multi-model support** - Claude, GPT, DeepSeek, Gemini, and more
@@ -27,6 +28,8 @@ Restart OpenCode and the plugin will be automatically installed.
 
 ## Usage
 
+### Toast Notifications
+
 Once installed, you'll see Toast notifications after each AI response:
 
 ```
@@ -41,6 +44,56 @@ Session: 45.2K tokens
 $0.156 | 8 msgs | 5min
 ```
 
+### CLI Statistics
+
+Query your token usage from the command line:
+
+```bash
+# All-time summary
+opencode-tokens
+
+# Today's usage
+opencode-tokens today
+
+# This week's usage with model breakdown
+opencode-tokens week --by model
+
+# This month with all breakdowns
+opencode-tokens month --by all
+
+# Day-by-day breakdown
+opencode-tokens --by daily
+```
+
+Example output:
+
+```
+  Today's Usage
+  ──────────────────────────────────────────────────
+  Total Tokens:           2.81M
+    Input:                2.74M
+    Output:               72.9K
+    Reasoning:             7.1K
+  Cache Read:            12.62M
+  Total Cost:            $32.93
+  Messages:                 230
+
+  By Model
+  ─────────────────────────────────────────────────────
+  Model                Tokens        Cost    Msgs
+  ---------------  ----------  ----------  ------
+  claude-opus-4.5       2.70M      $32.93     206
+  deepseek-chat         23.4K     $0.0025       6
+  gpt-5.2               86.9K     $0.0000      18
+```
+
+Breakdown options (`--by`):
+- `model` - Group by model (e.g., claude-opus-4.5)
+- `agent` - Group by agent (e.g., sisyphus, coder)
+- `provider` - Group by provider (e.g., anthropic, openai)
+- `daily` - Show day-by-day breakdown
+- `all` - Show all breakdowns
+
 ## Log Files
 
 Token usage is logged to:

package/dist/bin/opencode-tokens.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/opencode-tokens.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const LOG_FILE = join(homedir(), ".config", "opencode", "logs", "token-tracker", "tokens.jsonl");
+// ============================================================================
+// Helpers
+// ============================================================================
+function formatTokens(tokens) {
+    if (tokens >= 1_000_000)
+        return `${(tokens / 1_000_000).toFixed(2)}M`;
+    if (tokens >= 1_000)
+        return `${(tokens / 1_000).toFixed(1)}K`;
+    return tokens.toString();
+}
+function formatCost(cost) {
+    if (cost < 0.01)
+        return `$${cost.toFixed(4)}`;
+    if (cost < 1)
+        return `$${cost.toFixed(3)}`;
+    return `$${cost.toFixed(2)}`;
+}
+function padRight(str, len) {
+    return str.length >= len ? str : str + " ".repeat(len - str.length);
+}
+function padLeft(str, len) {
+    return str.length >= len ? str : " ".repeat(len - str.length) + str;
+}
+function getStartOfDay(date) {
+    const d = new Date(date);
+    d.setHours(0, 0, 0, 0);
+    return d.getTime();
+}
+function getStartOfWeek(date) {
+    const d = new Date(date);
+    const day = d.getDay();
+    const diff = d.getDate() - day + (day === 0 ? -6 : 1); // Monday as start
+    d.setDate(diff);
+    d.setHours(0, 0, 0, 0);
+    return d.getTime();
+}
+function getStartOfMonth(date) {
+    const d = new Date(date);
+    d.setDate(1);
+    d.setHours(0, 0, 0, 0);
+    return d.getTime();
+}
+// ============================================================================
+// Data Loading
+// ============================================================================
+function loadEntries(since) {
+    if (!existsSync(LOG_FILE)) {
+        return [];
+    }
+    const content = readFileSync(LOG_FILE, "utf-8");
+    const lines = content.trim().split("\n").filter(Boolean);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            if (entry.type !== "tokens")
+                continue;
+            if (since && entry._ts < since)
+                continue;
+            if (!entry.input && !entry.output)
+                continue; // Skip empty entries
+            entries.push(entry);
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return entries;
+}
+// ============================================================================
+// Stats Aggregation
+// ============================================================================
+function createEmptyStats() {
+    return { input: 0, output: 0, reasoning: 0, cacheRead: 0, cacheWrite: 0, cost: 0, count: 0 };
+}
+function aggregateStats(entries) {
+    const stats = createEmptyStats();
+    for (const e of entries) {
+        stats.input += e.input ?? 0;
+        stats.output += e.output ?? 0;
+        stats.reasoning += e.reasoning ?? 0;
+        stats.cacheRead += e.cacheRead ?? 0;
+        stats.cacheWrite += e.cacheWrite ?? 0;
+        stats.cost += e.cost ?? 0;
+        stats.count += 1;
+    }
+    return stats;
+}
+function groupBy(entries, keyFn) {
+    const groups = new Map();
+    for (const e of entries) {
+        const key = keyFn(e);
+        if (!groups.has(key)) {
+            groups.set(key, createEmptyStats());
+        }
+        const stats = groups.get(key);
+        stats.input += e.input ?? 0;
+        stats.output += e.output ?? 0;
+        stats.reasoning += e.reasoning ?? 0;
+        stats.cacheRead += e.cacheRead ?? 0;
+        stats.cacheWrite += e.cacheWrite ?? 0;
+        stats.cost += e.cost ?? 0;
+        stats.count += 1;
+    }
+    return groups;
+}
+// ============================================================================
+// Display
+// ============================================================================
+function printSummary(title, stats) {
+    const totalTokens = stats.input + stats.output;
+    console.log();
+    console.log(`  ${title}`);
+    console.log(`  ${"─".repeat(50)}`);
+    console.log(`  Total Tokens:    ${padLeft(formatTokens(totalTokens), 12)}`);
+    console.log(`    Input:         ${padLeft(formatTokens(stats.input), 12)}`);
+    console.log(`    Output:        ${padLeft(formatTokens(stats.output), 12)}`);
+    if (stats.reasoning > 0) {
+        console.log(`    Reasoning:     ${padLeft(formatTokens(stats.reasoning), 12)}`);
+    }
+    console.log(`  Cache Read:      ${padLeft(formatTokens(stats.cacheRead), 12)}`);
+    console.log(`  Total Cost:      ${padLeft(formatCost(stats.cost), 12)}`);
+    console.log(`  Messages:        ${padLeft(stats.count.toString(), 12)}`);
+    console.log();
+}
+function printTable(title, groups, labelHeader) {
+    // Sort by cost descending
+    const sorted = Array.from(groups.entries()).sort((a, b) => b[1].cost - a[1].cost);
+    if (sorted.length === 0) {
+        console.log(`\n  No data for ${title}\n`);
+        return;
+    }
+    // Calculate column widths
+    const labelWidth = Math.max(labelHeader.length, ...sorted.map(([k]) => k.length));
+    const tokensWidth = 10;
+    const costWidth = 10;
+    const countWidth = 6;
+    console.log();
+    console.log(`  ${title}`);
+    console.log(`  ${"─".repeat(labelWidth + tokensWidth + costWidth + countWidth + 12)}`);
+    // Header
+    console.log(`  ${padRight(labelHeader, labelWidth)}  ${padLeft("Tokens", tokensWidth)}  ${padLeft("Cost", costWidth)}  ${padLeft("Msgs", countWidth)}`);
+    console.log(`  ${"-".repeat(labelWidth)}  ${"-".repeat(tokensWidth)}  ${"-".repeat(costWidth)}  ${"-".repeat(countWidth)}`);
+    // Rows
+    for (const [label, stats] of sorted) {
+        const totalTokens = stats.input + stats.output;
+        console.log(`  ${padRight(label, labelWidth)}  ${padLeft(formatTokens(totalTokens), tokensWidth)}  ${padLeft(formatCost(stats.cost), costWidth)}  ${padLeft(stats.count.toString(), countWidth)}`);
+    }
+    console.log();
+}
+function printDailyBreakdown(entries) {
+    const byDay = groupBy(entries, (e) => {
+        const date = new Date(e._ts);
+        return date.toISOString().slice(0, 10); // YYYY-MM-DD
+    });
+    // Sort by date descending
+    const sorted = Array.from(byDay.entries()).sort((a, b) => b[0].localeCompare(a[0]));
+    if (sorted.length === 0) {
+        console.log("\n  No data\n");
+        return;
+    }
+    const dateWidth = 12;
+    const tokensWidth = 10;
+    const costWidth = 10;
+    const countWidth = 6;
+    console.log();
+    console.log(`  Daily Breakdown`);
+    console.log(`  ${"─".repeat(dateWidth + tokensWidth + costWidth + countWidth + 12)}`);
+    console.log(`  ${padRight("Date", dateWidth)}  ${padLeft("Tokens", tokensWidth)}  ${padLeft("Cost", costWidth)}  ${padLeft("Msgs", countWidth)}`);
+    console.log(`  ${"-".repeat(dateWidth)}  ${"-".repeat(tokensWidth)}  ${"-".repeat(costWidth)}  ${"-".repeat(countWidth)}`);
+    for (const [date, stats] of sorted) {
+        const totalTokens = stats.input + stats.output;
+        console.log(`  ${padRight(date, dateWidth)}  ${padLeft(formatTokens(totalTokens), tokensWidth)}  ${padLeft(formatCost(stats.cost), costWidth)}  ${padLeft(stats.count.toString(), countWidth)}`);
+    }
+    console.log();
+}
+// ============================================================================
+// Commands
+// ============================================================================
+function cmdStats(period, breakdown) {
+    const now = new Date();
+    let since;
+    let title;
+    switch (period) {
+        case "today":
+            since = getStartOfDay(now);
+            title = "Today's Usage";
+            break;
+        case "week":
+            since = getStartOfWeek(now);
+            title = "This Week's Usage";
+            break;
+        case "month":
+            since = getStartOfMonth(now);
+            title = "This Month's Usage";
+            break;
+        case "all":
+        default:
+            since = undefined;
+            title = "All-Time Usage";
+            break;
+    }
+    const entries = loadEntries(since);
+    if (entries.length === 0) {
+        console.log(`\n  No data for ${title.toLowerCase()}\n`);
+        return;
+    }
+    // Overall summary
+    const total = aggregateStats(entries);
+    printSummary(title, total);
+    // Breakdown
+    switch (breakdown) {
+        case "model":
+            printTable("By Model", groupBy(entries, (e) => e.model ?? "unknown"), "Model");
+            break;
+        case "agent":
+            printTable("By Agent", groupBy(entries, (e) => e.agent ?? "unknown"), "Agent");
+            break;
+        case "provider":
+            printTable("By Provider", groupBy(entries, (e) => e.provider ?? "unknown"), "Provider");
+            break;
+        case "day":
+        case "daily":
+            printDailyBreakdown(entries);
+            break;
+        case "all":
+            printTable("By Model", groupBy(entries, (e) => e.model ?? "unknown"), "Model");
+            printTable("By Agent", groupBy(entries, (e) => e.agent ?? "unknown"), "Agent");
+            printTable("By Provider", groupBy(entries, (e) => e.provider ?? "unknown"), "Provider");
+            break;
+    }
+}
+function cmdHelp() {
+    console.log(`
+  opencode-tokens - Token usage statistics CLI
+
+  Usage:
+    opencode-tokens [period] [--by <breakdown>]
+
+  Period:
+    today       Show today's usage
+    week        Show this week's usage  
+    month       Show this month's usage
+    all         Show all-time usage (default)
+
+  Breakdown (--by):
+    model       Group by model (e.g., claude-opus-4.5)
+    agent       Group by agent (e.g., sisyphus, coder)
+    provider    Group by provider (e.g., anthropic, openai)
+    daily       Show day-by-day breakdown
+    all         Show all breakdowns
+
+  Examples:
+    opencode-tokens                  # All-time summary
+    opencode-tokens today            # Today's summary
+    opencode-tokens week --by model  # This week, grouped by model
+    opencode-tokens month --by all   # This month, all breakdowns
+    opencode-tokens --by daily       # All-time, day by day
+`);
+}
+// ============================================================================
+// Main
+// ============================================================================
+function main() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        cmdHelp();
+        return;
+    }
+    // Parse arguments
+    let period = "all";
+    let breakdown;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--by" || arg === "-b") {
+            breakdown = args[++i];
+        }
+        else if (["today", "week", "month", "all"].includes(arg)) {
+            period = arg;
+        }
+    }
+    cmdStats(period, breakdown);
+}
+main();

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "opencode-token-tracker",
-  "version": "1.0.0",
-  "description": "Real-time token usage and cost tracking plugin for OpenCode with Toast notifications",
+  "version": "1.1.0",
+  "description": "Real-time token usage and cost tracking plugin for OpenCode with Toast notifications and CLI stats",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "bin": {
+    "opencode-tokens": "./dist/bin/opencode-tokens.js"
+  },
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build"