token-usage-sync 1.0.0

package/index.js

@@ -0,0 +1,349 @@
+#!/usr/bin/env node
+
+import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// 設定
+const CLAUDE_DIR = join(homedir(), '.claude');
+const PROJECTS_DIR = join(CLAUDE_DIR, 'projects');
+
+// コマンドライン引数を解析
+const args = process.argv.slice(2);
+
+function getArgValue(name) {
+  const arg = args.find(a => a.startsWith(`--${name}=`));
+  return arg ? arg.split('=')[1] : null;
+}
+
+const flags = {
+  help: args.includes('--help') || args.includes('-h'),
+  json: args.includes('--json'),
+  send: args.includes('--send'),
+  verbose: args.includes('--verbose') || args.includes('-v'),
+};
+
+// API URL（環境変数 or コマンドライン引数）
+const API_URL = process.env.SYNC_API_URL || getArgValue('api-url');
+const USER_ID = process.env.SYNC_USER_ID || getArgValue('user-id') || 'default-user';
+
+// ヘルプ表示
+if (flags.help) {
+  console.log(`
+token-usage-sync - Claude Code使用量をダッシュボードに同期
+
+使い方:
+  npx token-usage-sync [オプション]
+
+オプション:
+  --json              JSON形式で出力
+  --send              ダッシュボードに送信（--api-url必須）
+  --api-url=URL       送信先APIのURL
+  --user-id=ID        ユーザーID（デフォルト: default-user）
+  --verbose           詳細ログ出力
+  --help              このヘルプを表示
+
+環境変数:
+  SYNC_API_URL        送信先URL（--api-urlの代わり）
+  SYNC_USER_ID        ユーザーID（--user-idの代わり）
+
+例:
+  # 使用量を表示
+  npx token-usage-sync
+
+  # 自分のダッシュボードに送信
+  npx token-usage-sync --send --api-url=https://your-worker.workers.dev/api/sync-usage
+
+  # 環境変数を使用
+  export SYNC_API_URL=https://your-worker.workers.dev/api/sync-usage
+  npx token-usage-sync --send
+
+セットアップ:
+  1. リポジトリをフォーク: https://github.com/your-repo/token-usage-dashboard
+  2. Cloudflare Workersにデプロイ
+  3. 上記コマンドで同期
+`);
+  process.exit(0);
+}
+
+// JSONLファイルを再帰的に探す
+function findJsonlFiles(dir, files = []) {
+  if (!existsSync(dir)) return files;
+
+  const entries = readdirSync(dir);
+  for (const entry of entries) {
+    const fullPath = join(dir, entry);
+    const stat = statSync(fullPath);
+
+    if (stat.isDirectory()) {
+      findJsonlFiles(fullPath, files);
+    } else if (entry.endsWith('.jsonl')) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+
+// JSONLファイルを解析
+function parseJsonlFile(filePath) {
+  const content = readFileSync(filePath, 'utf-8');
+  const lines = content.trim().split('\n').filter(line => line.trim());
+
+  const entries = [];
+  for (const line of lines) {
+    try {
+      entries.push(JSON.parse(line));
+    } catch (e) {
+      // 無効な行はスキップ
+    }
+  }
+  return entries;
+}
+
+// 期間内の使用量を計算
+function calculateUsageForPeriod(entries, hoursAgo) {
+  const now = new Date();
+  const cutoff = new Date(now.getTime() - hoursAgo * 60 * 60 * 1000);
+
+  let inputTokens = 0;
+  let outputTokens = 0;
+  let cacheCreationTokens = 0;
+  let cacheReadTokens = 0;
+
+  for (const entry of entries) {
+    const timestamp = entry.timestamp || entry.message?.timestamp;
+    if (!timestamp) continue;
+
+    const entryTime = new Date(timestamp);
+    if (entryTime < cutoff) continue;
+
+    const usage = entry.message?.usage || entry.usage;
+    if (!usage) continue;
+
+    inputTokens += usage.input_tokens || 0;
+    outputTokens += usage.output_tokens || 0;
+    cacheCreationTokens += usage.cache_creation_input_tokens || 0;
+    cacheReadTokens += usage.cache_read_input_tokens || 0;
+  }
+
+  // 重み付けトークン計算（Claude API料金ベース）
+  const weightedTokens = Math.round(
+    inputTokens * 1.0 +
+    outputTokens * 1.0 +
+    cacheCreationTokens * 1.25 +
+    cacheReadTokens * 0.1
+  );
+
+  return {
+    inputTokens,
+    outputTokens,
+    cacheCreationTokens,
+    cacheReadTokens,
+    totalTokens: inputTokens + outputTokens + cacheCreationTokens + cacheReadTokens,
+    weightedTokens,
+  };
+}
+
+// 使用量を集計
+function aggregateUsage(entries) {
+  let totalInputTokens = 0;
+  let totalOutputTokens = 0;
+  let totalCacheCreationInputTokens = 0;
+  let totalCacheReadInputTokens = 0;
+  let messageCount = 0;
+
+  const byModel = {};
+  const byDate = {};
+
+  for (const entry of entries) {
+    // usage情報を持つエントリのみ処理
+    const usage = entry.message?.usage || entry.usage;
+    if (!usage) continue;
+
+    const inputTokens = usage.input_tokens || 0;
+    const outputTokens = usage.output_tokens || 0;
+    const cacheCreation = usage.cache_creation_input_tokens || 0;
+    const cacheRead = usage.cache_read_input_tokens || 0;
+
+    totalInputTokens += inputTokens;
+    totalOutputTokens += outputTokens;
+    totalCacheCreationInputTokens += cacheCreation;
+    totalCacheReadInputTokens += cacheRead;
+    messageCount++;
+
+    // モデル別集計
+    const model = entry.message?.model || entry.model || 'unknown';
+    if (!byModel[model]) {
+      byModel[model] = { inputTokens: 0, outputTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0, count: 0 };
+    }
+    byModel[model].inputTokens += inputTokens;
+    byModel[model].outputTokens += outputTokens;
+    byModel[model].cacheCreationTokens += cacheCreation;
+    byModel[model].cacheReadTokens += cacheRead;
+    byModel[model].count++;
+
+    // 日別集計
+    const timestamp = entry.timestamp || entry.message?.timestamp;
+    if (timestamp) {
+      const date = new Date(timestamp).toISOString().split('T')[0];
+      if (!byDate[date]) {
+        byDate[date] = { inputTokens: 0, outputTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0, count: 0 };
+      }
+      byDate[date].inputTokens += inputTokens;
+      byDate[date].outputTokens += outputTokens;
+      byDate[date].cacheCreationTokens += cacheCreation;
+      byDate[date].cacheReadTokens += cacheRead;
+      byDate[date].count++;
+    }
+  }
+
+  // ローリングウィンドウの使用量を計算
+  const last5Hours = calculateUsageForPeriod(entries, 5);
+  const last24Hours = calculateUsageForPeriod(entries, 24);
+  const lastWeek = calculateUsageForPeriod(entries, 24 * 7);
+
+  return {
+    summary: {
+      totalInputTokens,
+      totalOutputTokens,
+      totalTokens: totalInputTokens + totalOutputTokens,
+      cacheCreationInputTokens: totalCacheCreationInputTokens,
+      cacheReadInputTokens: totalCacheReadInputTokens,
+      messageCount,
+    },
+    // Claude Code制限と同じローリングウィンドウ
+    limits: {
+      last5Hours,
+      last24Hours,
+      lastWeek,
+    },
+    byModel,
+    byDate,
+  };
+}
+
+// メイン処理
+async function main() {
+  // ファイル検索
+  if (flags.verbose) {
+    console.error(`Searching for JSONL files in: ${PROJECTS_DIR}`);
+  }
+
+  const jsonlFiles = findJsonlFiles(PROJECTS_DIR);
+
+  if (jsonlFiles.length === 0) {
+    console.error('No JSONL files found in ~/.claude/projects/');
+    console.error('Make sure you have used Claude Code at least once.');
+    process.exit(1);
+  }
+
+  if (flags.verbose) {
+    console.error(`Found ${jsonlFiles.length} JSONL files`);
+  }
+
+  // 全ファイルを解析
+  const allEntries = [];
+  for (const file of jsonlFiles) {
+    const entries = parseJsonlFile(file);
+    allEntries.push(...entries);
+  }
+
+  if (flags.verbose) {
+    console.error(`Parsed ${allEntries.length} entries`);
+  }
+
+  // 集計
+  const usage = aggregateUsage(allEntries);
+  usage.syncedAt = new Date().toISOString();
+  usage.fileCount = jsonlFiles.length;
+
+  // JSON出力
+  if (flags.json) {
+    console.log(JSON.stringify(usage, null, 2));
+    return;
+  }
+
+  // 送信
+  if (flags.send) {
+    // API URLが指定されていない場合はエラー
+    if (!API_URL) {
+      console.error('✗ --api-url is required for --send');
+      console.error('');
+      console.error('Usage:');
+      console.error('  npx token-usage-sync --send --api-url=https://your-worker.workers.dev/api/sync-usage');
+      console.error('');
+      console.error('Or set environment variable:');
+      console.error('  export SYNC_API_URL=https://your-worker.workers.dev/api/sync-usage');
+      process.exit(1);
+    }
+
+    try {
+      const response = await fetch(API_URL, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-User-Id': USER_ID,
+        },
+        body: JSON.stringify(usage),
+      });
+
+      if (response.ok) {
+        console.log('✓ Usage data synced successfully!');
+        const result = await response.json();
+        if (result.dashboardUrl) {
+          console.log(`  View at: ${result.dashboardUrl}`);
+        }
+      } else {
+        console.error(`✗ Failed to sync: ${response.status} ${response.statusText}`);
+        process.exit(1);
+      }
+    } catch (e) {
+      console.error(`✗ Failed to sync: ${e.message}`);
+      process.exit(1);
+    }
+    return;
+  }
+
+  // デフォルト: 簡易表示
+  console.log('\n📊 Claude Code Usage Summary\n');
+
+  // 制限値
+  // 5時間: 重み付けトークン（cache_read=0.1x）
+  // 週間: 生トークン
+  const LIMIT_5H_WEIGHTED = 4_000_000;  // 5時間制限: 4M weighted tokens
+  const LIMIT_WEEK_RAW = 195_000_000;   // 週間制限: 195M raw tokens
+
+  const pct5h = Math.round((usage.limits.last5Hours.weightedTokens / LIMIT_5H_WEIGHTED) * 100);
+  const pctWeek = Math.round((usage.limits.lastWeek.totalTokens / LIMIT_WEEK_RAW) * 100);
+
+  // ローリングウィンドウ（Claude Code制限と同じ形式）
+  console.log('=== Usage Limits ===');
+  console.log(`5h Session:  ${usage.limits.last5Hours.weightedTokens.toLocaleString()} weighted / ${LIMIT_5H_WEIGHTED.toLocaleString()} (${pct5h}%)`);
+  console.log(`Weekly:      ${usage.limits.lastWeek.totalTokens.toLocaleString()} raw / ${LIMIT_WEEK_RAW.toLocaleString()} (${pctWeek}%)`);
+
+  console.log('\n=== Last 5 Hours Breakdown ===');
+  console.log(`  Input:         ${usage.limits.last5Hours.inputTokens.toLocaleString()} × 1.0`);
+  console.log(`  Output:        ${usage.limits.last5Hours.outputTokens.toLocaleString()} × 1.0`);
+  console.log(`  Cache Create:  ${usage.limits.last5Hours.cacheCreationTokens.toLocaleString()} × 1.25`);
+  console.log(`  Cache Read:    ${usage.limits.last5Hours.cacheReadTokens.toLocaleString()} × 0.1`);
+
+  console.log('\n=== All Time Total ===');
+  console.log(`Total Tokens:  ${usage.summary.totalTokens.toLocaleString()}`);
+  console.log(`  Input:       ${usage.summary.totalInputTokens.toLocaleString()}`);
+  console.log(`  Output:      ${usage.summary.totalOutputTokens.toLocaleString()}`);
+  console.log(`  Cache (in):  ${usage.summary.cacheReadInputTokens.toLocaleString()}`);
+  console.log(`Messages:      ${usage.summary.messageCount.toLocaleString()}`);
+  console.log(`Files:         ${usage.fileCount}`);
+
+  if (Object.keys(usage.byModel).length > 0) {
+    console.log('\nBy Model:');
+    for (const [model, data] of Object.entries(usage.byModel)) {
+      const total = data.inputTokens + data.outputTokens + data.cacheCreationTokens + data.cacheReadTokens;
+      console.log(`  ${model}: ${total.toLocaleString()} tokens`);
+    }
+  }
+
+  console.log('\n💡 Run with --send to sync to dashboard');
+}
+
+main().catch(console.error);

package/lib/calculations.js

@@ -0,0 +1,131 @@
+// 期間内の使用量を計算
+export function calculateUsageForPeriod(entries, hoursAgo, now = new Date()) {
+  const cutoff = new Date(now.getTime() - hoursAgo * 60 * 60 * 1000);
+
+  let inputTokens = 0;
+  let outputTokens = 0;
+  let cacheCreationTokens = 0;
+  let cacheReadTokens = 0;
+
+  for (const entry of entries) {
+    const timestamp = entry.timestamp || entry.message?.timestamp;
+    if (!timestamp) continue;
+
+    const entryTime = new Date(timestamp);
+    if (entryTime < cutoff) continue;
+
+    const usage = entry.message?.usage || entry.usage;
+    if (!usage) continue;
+
+    inputTokens += usage.input_tokens || 0;
+    outputTokens += usage.output_tokens || 0;
+    cacheCreationTokens += usage.cache_creation_input_tokens || 0;
+    cacheReadTokens += usage.cache_read_input_tokens || 0;
+  }
+
+  // 重み付けトークン計算（Claude API料金ベース）
+  const weightedTokens = Math.round(
+    inputTokens * 1.0 +
+    outputTokens * 1.0 +
+    cacheCreationTokens * 1.25 +
+    cacheReadTokens * 0.1
+  );
+
+  return {
+    inputTokens,
+    outputTokens,
+    cacheCreationTokens,
+    cacheReadTokens,
+    totalTokens: inputTokens + outputTokens + cacheCreationTokens + cacheReadTokens,
+    weightedTokens,
+  };
+}
+
+// 使用量を集計
+export function aggregateUsage(entries, now = new Date()) {
+  let totalInputTokens = 0;
+  let totalOutputTokens = 0;
+  let totalCacheCreationInputTokens = 0;
+  let totalCacheReadInputTokens = 0;
+  let messageCount = 0;
+
+  const byModel = {};
+  const byDate = {};
+
+  for (const entry of entries) {
+    const usage = entry.message?.usage || entry.usage;
+    if (!usage) continue;
+
+    const inputTokens = usage.input_tokens || 0;
+    const outputTokens = usage.output_tokens || 0;
+    const cacheCreation = usage.cache_creation_input_tokens || 0;
+    const cacheRead = usage.cache_read_input_tokens || 0;
+
+    totalInputTokens += inputTokens;
+    totalOutputTokens += outputTokens;
+    totalCacheCreationInputTokens += cacheCreation;
+    totalCacheReadInputTokens += cacheRead;
+    messageCount++;
+
+    // モデル別集計
+    const model = entry.message?.model || entry.model || 'unknown';
+    if (!byModel[model]) {
+      byModel[model] = { inputTokens: 0, outputTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0, count: 0 };
+    }
+    byModel[model].inputTokens += inputTokens;
+    byModel[model].outputTokens += outputTokens;
+    byModel[model].cacheCreationTokens += cacheCreation;
+    byModel[model].cacheReadTokens += cacheRead;
+    byModel[model].count++;
+
+    // 日別集計
+    const timestamp = entry.timestamp || entry.message?.timestamp;
+    if (timestamp) {
+      const date = new Date(timestamp).toISOString().split('T')[0];
+      if (!byDate[date]) {
+        byDate[date] = { inputTokens: 0, outputTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0, count: 0 };
+      }
+      byDate[date].inputTokens += inputTokens;
+      byDate[date].outputTokens += outputTokens;
+      byDate[date].cacheCreationTokens += cacheCreation;
+      byDate[date].cacheReadTokens += cacheRead;
+      byDate[date].count++;
+    }
+  }
+
+  // ローリングウィンドウの使用量を計算
+  const last5Hours = calculateUsageForPeriod(entries, 5, now);
+  const last24Hours = calculateUsageForPeriod(entries, 24, now);
+  const lastWeek = calculateUsageForPeriod(entries, 24 * 7, now);
+
+  return {
+    summary: {
+      totalInputTokens,
+      totalOutputTokens,
+      totalTokens: totalInputTokens + totalOutputTokens,
+      cacheCreationInputTokens: totalCacheCreationInputTokens,
+      cacheReadInputTokens: totalCacheReadInputTokens,
+      messageCount,
+    },
+    limits: {
+      last5Hours,
+      last24Hours,
+      lastWeek,
+    },
+    byModel,
+    byDate,
+  };
+}
+
+// パーセント計算
+export function percent(used, limit) {
+  if (limit <= 0) return 0;
+  return Math.min(100, Math.max(0, Math.round((used / limit) * 100)));
+}
+
+// トークン数フォーマット
+export function formatTokens(n) {
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+  if (n >= 1_000) return `${(n / 1_000).toFixed(0)}K`;
+  return n.toString();
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "token-usage-sync",
+  "version": "1.0.0",
+  "description": "Sync Claude Code token usage to your self-hosted dashboard",
+  "type": "module",
+  "bin": {
+    "token-usage-sync": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "lib/"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "usage",
+    "token",
+    "dashboard",
+    "monitoring"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-username/token-usage-dashboard"
+  },
+  "homepage": "https://github.com/your-username/token-usage-dashboard#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}