cc-costline 0.1.1 → 0.2.0

package/README.md

@@ -1,71 +1,63 @@
 # cc-costline
 
-Enhanced statusline for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — adds 7-day and 30-day rolling cost tracking to your terminal.
+Enhanced statusline for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — adds cost tracking, usage limits, and leaderboard rank to your terminal.
 
 ```
- Token: ↑12.3k ↓45.6k | $2.34 (7d:$385) | Code: +12 -3 | 42% by Opus 4.6
+14.6k ~ $2.42 / 40% by Opus 4.6 | 5h: 45% / 7d: 8% | 30d: $866 | #2/22 $67.0
 ```
 
-## What it does
-
-Claude Code's built-in statusline shows the current session cost. cc-costline extends it with:
-
-- **Rolling cost totals** — see how much you've spent in the last 7 or 30 days
-- **Token counts** — input/output token usage for the current session
-- **Context window** — color-coded usage percentage (green → orange → red)
-- **Code changes** — lines added/removed in the session
-
-Cost calculation is self-contained — it reads your local transcript files and applies Anthropic's pricing table directly. No external API calls, no dependencies.
-
 ## Install
 
 ```bash
-npm i -g cc-costline
-cc-costline install
+npm i -g cc-costline && cc-costline install
 ```
 
-That's it. Open a new Claude Code session and you'll see the enhanced statusline.
+Open a new Claude Code session and you'll see the enhanced statusline. Requires Node.js >= 22.
+
+## What you get
+
+| Segment | Example | Description |
+|---------|---------|-------------|
+| Tokens ~ Cost / Context | `14.6k ~ $2.42 / 40% by Opus 4.6` | Session token count, cost, context usage, and model |
+| Usage limits | `5h: 45% / 7d: 8%` | Claude 5-hour and 7-day utilization (auto-colored like context) |
+| Period cost | `30d: $866` | Rolling cost total (configurable: 7d or 30d) |
+| Leaderboard | `#2/22 $67.0` | [ccclub](https://github.com/mfbx9da4/ccclub) rank (if installed) |
+
+### Colors
 
-Requires Node.js >= 22.
+- **Context & usage limits** — green (< 60%) → orange (60-79%) → red (≥ 80%)
+- **Leaderboard rank** — #1 gold, #2 white, #3 orange, others blue
+- **Period cost** — yellow
 
-## What `install` does
+### Optional integrations
 
-1. Sets `statusLine.command` → `cc-costline render` in `~/.claude/settings.json`
-2. Adds `SessionEnd` and `Stop` hooks to auto-refresh the cost cache
-3. Creates `~/.cc-costline/` with default config
-4. Runs initial cost calculation from your transcript history
+- **Claude usage limits** — reads OAuth credentials from macOS Keychain automatically. Just `claude login` and it works.
+- **ccclub leaderboard** — install [ccclub](https://github.com/mfbx9da4/ccclub) (`npm i -g ccclub && ccclub init`). Rank appears automatically.
 
-Your existing hooks and settings are preserved.
+Both are zero-config: if not available, the segment is silently omitted.
 
 ## Commands
 
 ```bash
 cc-costline install              # Set up Claude Code integration
-cc-costline uninstall            # Remove from Claude Code settings
+cc-costline uninstall            # Remove from settings
 cc-costline refresh              # Manually recalculate cost cache
-cc-costline config --period 7d   # Show 7-day cost (default)
-cc-costline config --period 30d  # Show 30-day cost
-cc-costline config --period both # Show both
+cc-costline config --period 30d  # Show 30-day cost (default)
+cc-costline config --period 7d   # Show 7-day cost
 ```
 
-## Output format
+## How it works
 
-```
- Token: ↑{in} ↓{out} | ${session} ({period}:${total}) | Code: +{add} -{del} | {ctx}% by {model}
-```
+1. `install` configures `~/.claude/settings.json` — sets the statusline command and adds session-end hooks for auto-refresh. Your existing settings are preserved.
+2. `render` reads Claude Code's stdin JSON and the cost cache, outputs the formatted statusline.
+3. `refresh` scans `~/.claude/projects/**/*.jsonl`, extracts token usage, applies per-model pricing, and writes to `~/.cc-costline/cache.json`.
+4. Claude usage is fetched from `api.anthropic.com/api/oauth/usage` with a 60s file cache at `/tmp/sl-claude-usage`.
+5. ccclub rank is fetched from `ccclub.dev/api/rank` with a 120s file cache at `/tmp/sl-ccclub-rank`.
 
-| Segment | Source | Color |
-|---------|--------|-------|
-| Token counts | Current session transcript | Gray |
-| Session cost | Claude Code stdin | Yellow |
-| Period cost | Cached calculation | Cyan |
-| Lines changed | Claude Code stdin | Green / Gray |
-| Context % | Claude Code stdin | Green (<60%) / Orange (60-80%) / Red (80%+) |
-| Model name | Claude Code stdin | Brown |
+<details>
+<summary>Pricing table</summary>
 
-## How cost is calculated
-
-cc-costline scans all `.jsonl` files under `~/.claude/projects/`, extracts token usage from assistant messages, and applies per-model pricing:
+Prices per million tokens (USD):
 
 | Model | Input | Output | Cache Write | Cache Read |
 |-------|------:|-------:|------------:|-----------:|
@@ -77,17 +69,9 @@ cc-costline scans all `.jsonl` files under `~/.claude/projects/`, extracts token
 | Haiku 4.5 | $1 | $5 | $1.25 | $0.10 |
 | Haiku 3.5 | $0.80 | $4 | $1.00 | $0.08 |
 
-Prices are per million tokens in USD. Unknown models fall back by family name (opus/sonnet/haiku), defaulting to Sonnet pricing.
-
-Entries are deduplicated by `sessionId:requestId` to avoid double-counting.
+Unknown models fall back by family name, defaulting to Sonnet pricing.
 
-## Files
-
-```
-~/.cc-costline/
-├── cache.json    # { cost7d, cost30d, updatedAt }
-└── config.json   # { period: "7d" | "30d" | "both" }
-```
+</details>
 
 ## Uninstall
 

package/dist/statusline.js

@@ -1,4 +1,7 @@
-import { readFileSync } from "node:fs";
+import { readFileSync, existsSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
 import { readCache, readConfig } from "./cache.js";
 // ANSI colors (matching original statusline.sh)
 const FG_GRAY = "\x1b[38;5;245m";
@@ -9,6 +12,7 @@ const FG_ORANGE = "\x1b[38;5;208m";
 const FG_RED = "\x1b[38;5;167m";
 const FG_MODEL = "\x1b[38;2;202;124;94m";
 const FG_CYAN = "\x1b[38;5;109m";
+const FG_WHITE = "\x1b[38;5;255m";
 const RESET = "\x1b[0m";
 function formatTokens(t) {
     if (t >= 1_000_000)
@@ -33,6 +37,102 @@ function ctxColor(pct) {
         return FG_ORANGE;
     return FG_GREEN;
 }
+// ccclub rank fetcher with 120s file cache
+function getCcclubRank() {
+    const configPath = join(homedir(), ".ccclub", "config.json");
+    if (!existsSync(configPath))
+        return null;
+    const cacheFile = "/tmp/sl-ccclub-rank";
+    const now = Date.now() / 1000;
+    if (existsSync(cacheFile)) {
+        const mtime = statSync(cacheFile).mtimeMs / 1000;
+        if (now - mtime <= 120) {
+            try {
+                return JSON.parse(readFileSync(cacheFile, "utf-8"));
+            }
+            catch { }
+        }
+    }
+    try {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        const code = config.groups?.[0];
+        const userId = config.userId;
+        if (!code || !userId)
+            return null;
+        const tz = -(new Date()).getTimezoneOffset();
+        const url = `${config.apiUrl}/api/rank/${code}?period=today&tz=${tz}`;
+        const response = execSync(`curl -sf "${url}"`, { encoding: "utf-8", timeout: 5000 });
+        if (!response)
+            return null;
+        const data = JSON.parse(response);
+        const rankings = data.rankings || [];
+        const me = rankings.find((r) => r.userId === userId);
+        if (!me)
+            return null;
+        const result = { rank: me.rank, total: rankings.length, cost: me.costUSD };
+        writeFileSync(cacheFile, JSON.stringify(result), "utf-8");
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+function rankColor(rank) {
+    if (rank === 1)
+        return FG_YELLOW;
+    if (rank === 2)
+        return FG_WHITE;
+    if (rank === 3)
+        return FG_ORANGE;
+    return FG_CYAN;
+}
+// Claude usage fetcher with 60s file cache
+function getClaudeUsage() {
+    const cacheFile = "/tmp/sl-claude-usage";
+    const now = Date.now() / 1000;
+    if (existsSync(cacheFile)) {
+        const mtime = statSync(cacheFile).mtimeMs / 1000;
+        if (now - mtime <= 60) {
+            try {
+                return JSON.parse(readFileSync(cacheFile, "utf-8"));
+            }
+            catch { }
+        }
+    }
+    try {
+        const username = process.env.USER || process.env.USERNAME;
+        const keychainCmd = `security find-generic-password -s "Claude Code-credentials" -a "${username}" -w 2>/dev/null`;
+        const credentialsJSON = execSync(keychainCmd, { encoding: "utf-8", timeout: 2000 }).trim();
+        if (!credentialsJSON)
+            return null;
+        const credentials = JSON.parse(credentialsJSON);
+        const accessToken = credentials.claudeAiOauth?.accessToken;
+        if (!accessToken)
+            return null;
+        const expiresAt = credentials.claudeAiOauth?.expiresAt;
+        if (expiresAt && Date.now() / 1000 > expiresAt)
+            return null;
+        const apiUrl = "https://api.anthropic.com/api/oauth/usage";
+        const curlCmd = `curl -sf "${apiUrl}" -H "Authorization: Bearer ${accessToken}" -H "anthropic-beta: oauth-2025-04-20" -H "User-Agent: claude-code/2.1.5"`;
+        const response = execSync(curlCmd, { encoding: "utf-8", timeout: 5000 });
+        if (!response)
+            return null;
+        const data = JSON.parse(response);
+        const parseUtil = (val) => {
+            if (typeof val === "number")
+                return Math.round(val);
+            if (typeof val === "string")
+                return Math.round(parseFloat(val.replace("%", "")));
+            return 0;
+        };
+        const result = { fiveHour: parseUtil(data.five_hour?.utilization), sevenDay: parseUtil(data.seven_day?.utilization) };
+        writeFileSync(cacheFile, JSON.stringify(result), "utf-8");
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
 export function render(input) {
     let data;
     try {
@@ -43,13 +143,10 @@ export function render(input) {
     }
     // Session data from Claude Code stdin
     const cost = data.cost?.total_cost_usd ?? 0;
-    const linesAdd = data.cost?.total_lines_added ?? 0;
-    const linesDel = data.cost?.total_lines_removed ?? 0;
     const model = data.model?.display_name ?? "—";
     const contextPct = Math.floor(data.context_window?.used_percentage ?? 0);
     // Token stats from transcript
-    let inTokens = 0;
-    let outTokens = 0;
+    let totalTokens = 0;
     const transcriptPath = data.transcript_path ?? "";
     if (transcriptPath) {
         try {
@@ -61,42 +158,35 @@ export function render(input) {
                 try {
                     const entry = JSON.parse(line);
                     if (entry.type === "assistant" && entry.message?.usage) {
-                        inTokens += entry.message.usage.input_tokens || 0;
-                        outTokens += entry.message.usage.output_tokens || 0;
+                        totalTokens += (entry.message.usage.input_tokens || 0) + (entry.message.usage.output_tokens || 0);
                     }
                 }
-                catch {
-                    // skip malformed lines
-                }
+                catch { }
             }
         }
-        catch {
-            // transcript not readable
-        }
+        catch { }
     }
-    const inFmt = formatTokens(inTokens);
-    const outFmt = formatTokens(outTokens);
-    // Cached cost data
     const cache = readCache();
     const config = readConfig();
-    let costSuffix = "";
+    const claudeUsage = getClaudeUsage();
+    const parts = [];
+    // 1. Tokens ~ cost / context % + model
+    parts.push(`${FG_GRAY_DIM}${formatTokens(totalTokens)}${RESET} ${FG_GRAY_DIM}~${RESET} ${FG_YELLOW}${formatCost(cost)}${RESET} ${FG_GRAY_DIM}/${RESET} ${ctxColor(contextPct)}${contextPct}%${RESET} ${FG_GRAY_DIM}by${RESET} ${FG_MODEL}${model}${RESET}`);
+    // 2. Claude usage limits (colored by utilization)
+    if (claudeUsage) {
+        parts.push(`${ctxColor(claudeUsage.fiveHour)}5h: ${claudeUsage.fiveHour}%${RESET} ${FG_GRAY_DIM}/${RESET} ${ctxColor(claudeUsage.sevenDay)}7d: ${claudeUsage.sevenDay}%${RESET}`);
+    }
+    // 3. Period cost (default 30d, configurable)
     if (cache) {
-        const { period } = config;
-        if (period === "7d") {
-            costSuffix = ` ${FG_CYAN}(7d:${formatCost(cache.cost7d)})${RESET}`;
-        }
-        else if (period === "30d") {
-            costSuffix = ` ${FG_CYAN}(30d:${formatCost(cache.cost30d)})${RESET}`;
-        }
-        else {
-            costSuffix = ` ${FG_CYAN}(7d:${formatCost(cache.cost7d)} 30d:${formatCost(cache.cost30d)})${RESET}`;
-        }
+        const period = config.period || "30d";
+        const periodCost = period === "7d" ? cache.cost7d : cache.cost30d;
+        parts.push(`${FG_YELLOW}${period}: ${formatCost(periodCost)}${RESET}`);
+    }
+    // 4. ccclub rank (colored by position)
+    const ccclubRank = getCcclubRank();
+    if (ccclubRank) {
+        const rc = rankColor(ccclubRank.rank);
+        parts.push(`${rc}#${ccclubRank.rank}/${ccclubRank.total} ${formatCost(ccclubRank.cost)}${RESET}`);
     }
-    const parts = [
-        `${FG_GRAY_DIM}Token: ↑${inFmt} ↓${outFmt}${RESET}`,
-        `${FG_YELLOW}${formatCost(cost)}${costSuffix}${RESET}`,
-        `${FG_GRAY_DIM}Code: ${FG_GREEN}+${linesAdd}${RESET} ${FG_GRAY_DIM}-${linesDel}${RESET}`,
-        `${ctxColor(contextPct)}${contextPct}%${RESET} ${FG_GRAY_DIM}by${RESET} ${FG_MODEL}${model}${RESET}`,
-    ];
     return "\n " + parts.join(` ${FG_GRAY}|${RESET} `) + "\n";
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cc-costline",
-  "version": "0.1.1",
-  "description": "Enhanced statusline for Claude Code with 7d/30d cost tracking",
+  "version": "0.2.0",
+  "description": "Enhanced statusline for Claude Code with cost tracking, usage limits, and leaderboard",
   "type": "module",
   "bin": {
     "cc-costline": "dist/cli.js"
@@ -24,6 +24,6 @@
   "author": "ventuss",
   "license": "MIT",
   "devDependencies": {
-    "typescript": "^5.7.0"
+    "typescript": "^5.9.3"
   }
 }