@vibescore/tracker 0.2.5 → 0.2.7

package/README.md

@@ -9,7 +9,7 @@ _Real-time AI Analytics for Codex CLI_
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Support](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
-[![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
+[![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Linux-lightgrey.svg)](https://www.kernel.org/)
 
 [**English**](README.md) • [**中文说明**](README.zh-CN.md)
 
@@ -25,7 +25,7 @@ _Real-time AI Analytics for Codex CLI_
 
 ## 🌌 Overview
 
-**VibeScore** is an intelligent token usage tracking system designed specifically for macOS developers. Through the all-new **Matrix-A Design System**, it provides a high-fidelity cyberpunk-style dashboard that transforms your **AI Output** into quantifiable metrics, supported by the **Neural Divergence Map** for real-time monitoring of multi-model compute distribution.
+**VibeScore** is an intelligent token usage tracking system designed for macOS-first workflows, with CLI support on mainstream Linux (Ubuntu/Fedora/Arch). Through the all-new **Matrix-A Design System**, it provides a high-fidelity cyberpunk-style dashboard that transforms your **AI Output** into quantifiable metrics, supported by the **Neural Divergence Map** for real-time monitoring of multi-model compute distribution.
 
 > [!TIP] > **Core Index**: Our signature metric that reflects your flow state by analyzing token consumption rates and patterns.
 
@@ -67,6 +67,7 @@ Note: `init` shows a consent prompt in interactive shells. Use `--yes` to skip p
 Optional: `--dry-run` previews planned changes without writing files.
 Note: If `~/.code/config.toml` exists (or `CODE_HOME`), `init` also configures Every Code `notify` automatically. No further user intervention is required for data sync.
 Note: If Gemini CLI home exists, `init` installs a `SessionEnd` hook in `~/.gemini/settings.json` and sets `tools.enableHooks = true` so hooks execute. This enables all Gemini hooks; disable by setting `tools.enableHooks = false` (or disabling the `vibescore-tracker` hook).
+Note: Linux support is CLI-only and officially covers Codex CLI + Claude Code sources.
 
 ### Sync & Status
 
@@ -84,6 +85,7 @@ npx --yes @vibescore/tracker status
 ### Sources
 
 - Codex CLI logs: `~/.codex/sessions/**/rollout-*.jsonl` (override with `CODEX_HOME`)
+- Claude Code logs: `~/.claude/projects/**/*.jsonl` (override with `CLAUDE_HOME`)
 - Every Code logs: `~/.code/sessions/**/rollout-*.jsonl` (override with `CODE_HOME`)
 - Gemini CLI logs: `~/.gemini/tmp/**/chats/session-*.json` (override with `GEMINI_HOME`)
 
@@ -91,6 +93,7 @@ npx --yes @vibescore/tracker status
 
 - `VIBESCORE_HTTP_TIMEOUT_MS`: CLI HTTP timeout in ms (default `20000`, `0` disables, clamped to `1000..120000`).
 - `VITE_VIBESCORE_HTTP_TIMEOUT_MS`: Dashboard request timeout in ms (default `15000`, `0` disables, clamped to `1000..30000`).
+- `CLAUDE_HOME`: Override Claude Code home (defaults to `~/.claude`).
 - `GEMINI_HOME`: Override Gemini CLI home (defaults to `~/.gemini`).
 
 ## 🧰 Troubleshooting

package/README.zh-CN.md

@@ -9,7 +9,7 @@ _Codex CLI 实时 AI 分析工具_
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Support](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
-[![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
+[![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Linux-lightgrey.svg)](https://www.kernel.org/)
 
 [**English**](README.md) • [**中文说明**](README.zh-CN.md)
 
@@ -25,7 +25,7 @@ _Codex CLI 实时 AI 分析工具_
 
 ## 🌌 项目概述
 
-**VibeScore** 是一个专为 macOS 开发者设计的智能令牌（Token）使用追踪系统。它通过全新的 **Matrix-A Design System**，提供高度可视化的赛博朋克风格仪表盘，将你的 **AI 产出 (AI Output)** 转化为可量化的指标，并支持通过 **Neural Divergence Map** 实时监控多模型的算力分布。
+**VibeScore** 是一个 macOS 优先的智能令牌（Token）使用追踪系统，CLI 支持主流 Linux 发行版（Ubuntu/Fedora/Arch）。它通过全新的 **Matrix-A Design System**，提供高度可视化的赛博朋克风格仪表盘，将你的 **AI 产出 (AI Output)** 转化为可量化的指标，并支持通过 **Neural Divergence Map** 实时监控多模型的算力分布。
 
 > [!TIP] > **Core Index (核心指数)**: 我们的标志性指标，通过分析 Token 消耗速率与模式，反映你的开发心流状态。
 
@@ -67,6 +67,7 @@ npx --yes @vibescore/tracker init
 可选：`--dry-run` 仅预览将发生的变更，不写入任何文件。
 说明：若存在 `~/.code/config.toml`（或 `CODE_HOME`），`init` 会自动配置 Every Code 的 `notify`。配置完成后，数据同步完全自动化，无需后续人工干预。
 说明：若检测到 Gemini CLI home，`init` 会在 `~/.gemini/settings.json` 安装 `SessionEnd` hook，并将 `tools.enableHooks = true` 以确保 hook 生效。这会启用所有 Gemini hooks；如需关闭，可将 `tools.enableHooks = false`（或禁用 `vibescore-tracker` hook）。
+说明：Linux 仅支持 CLI，官方支持的数据源范围为 Codex CLI + Claude Code。
 
 ### 同步与状态查看
 
@@ -84,6 +85,7 @@ npx --yes @vibescore/tracker status
 ### 日志来源
 
 - Codex CLI 日志：`~/.codex/sessions/**/rollout-*.jsonl`（可用 `CODEX_HOME` 覆盖）
+- Claude Code 日志：`~/.claude/projects/**/*.jsonl`（可用 `CLAUDE_HOME` 覆盖）
 - Every Code 日志：`~/.code/sessions/**/rollout-*.jsonl`（可用 `CODE_HOME` 覆盖）
 - Gemini CLI 日志：`~/.gemini/tmp/**/chats/session-*.json`（可用 `GEMINI_HOME` 覆盖）
 
@@ -91,6 +93,7 @@ npx --yes @vibescore/tracker status
 
 - `VIBESCORE_HTTP_TIMEOUT_MS`：CLI 请求超时（毫秒，默认 `20000`，`0` 表示关闭，范围 `1000..120000`）。
 - `VITE_VIBESCORE_HTTP_TIMEOUT_MS`：Dashboard 请求超时（毫秒，默认 `15000`，`0` 表示关闭，范围 `1000..30000`）。
+- `CLAUDE_HOME`：覆盖 Claude Code 的 home（默认 `~/.claude`）。
 - `GEMINI_HOME`：覆盖 Gemini CLI 的 home（默认 `~/.gemini`）。
 
 ## 🧰 常见问题

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescore/tracker",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Codex CLI token usage tracker (macOS-first, notify-driven).",
   "license": "MIT",
   "publishConfig": {

package/src/cli.js

@@ -54,7 +54,8 @@ function printHelp() {
       '  - Every Code notify installs when ~/.code/config.toml exists.',
       '  - auto sync waits for a device token.',
       '  - optional: VIBESCORE_DASHBOARD_URL or --dashboard-url for hosted landing.',
-      '  - sync parses ~/.codex/sessions/**/rollout-*.jsonl and ~/.code/sessions/**/rollout-*.jsonl, then uploads token deltas.',
+      '  - sync parses Codex (~/.codex/sessions/**/rollout-*.jsonl), Claude (~/.claude/projects/**/*.jsonl), and other supported sources.',
+      '  - Linux support: Codex + Claude only (set CLAUDE_HOME to override Claude paths).',
       '  - --debug shows original backend errors.',
       ''
     ].join('\n')

package/src/commands/init.js

@@ -13,7 +13,13 @@ const {
   readCodexNotify,
   readEveryCodeNotify
 } = require('../lib/codex-config');
-const { upsertClaudeHook, buildClaudeHookCommand, isClaudeHookConfigured } = require('../lib/claude-config');
+const {
+  upsertClaudeHook,
+  buildClaudeHookCommand,
+  isClaudeHookConfigured,
+  resolveClaudeHome,
+  resolveClaudeSettingsPath
+} = require('../lib/claude-config');
 const {
   resolveGeminiConfigDir,
   resolveGeminiSettingsPath,
@@ -34,14 +40,11 @@ const {
   CYAN,
   RESET,
   color,
-  underline,
-  renderBox,
   isInteractive,
   promptMenu,
-  promptEnter,
-  createSpinner,
-  formatSummaryLine
+  createSpinner
 } = require('../lib/cli-ui');
+const { renderLocalReport, renderAuthTransition, renderSuccessBox } = require('../lib/init-flow');
 
 const ASCII_LOGO = [
   '██╗   ██╗██╗██████╗ ███████╗███████╗ ██████╗  ██████╗ ██████╗ ███████╗',
@@ -80,11 +83,12 @@ async function cmdInit(argv) {
 
   if (isInteractive() && !opts.yes && !opts.dryRun) {
     const choice = await promptMenu({
-      message: '? How would you like to proceed?',
-      options: ['Start Setup (Recommended)', 'Exit'],
+      message: '? Proceed with installation?',
+      options: ['Yes, configure my environment', 'No, exit'],
       defaultIndex: 0
     });
-    if (choice.toLowerCase().startsWith('exit')) {
+    const normalizedChoice = String(choice || '').trim().toLowerCase();
+    if (normalizedChoice.startsWith('no') || normalizedChoice.includes('exit')) {
       process.stdout.write('Setup cancelled.\n');
       return;
     }
@@ -98,7 +102,7 @@ async function cmdInit(argv) {
       configPath,
       notifyPath
     });
-    renderTransparencyReport({ summary: preview.summary, isDryRun: true });
+    renderLocalReport({ summary: preview.summary, isDryRun: true });
     if (preview.pendingBrowserAuth) {
       process.stdout.write('Account linking would be required for full setup.\n');
     } else if (!preview.deviceToken) {
@@ -130,11 +134,7 @@ async function cmdInit(argv) {
   }
   spinner.stop();
 
-  renderTransparencyReport({
-    summary: setup.summary,
-    isDryRun: false,
-    includeDivider: setup.pendingBrowserAuth
-  });
+  renderLocalReport({ summary: setup.summary, isDryRun: false });
 
   let deviceToken = setup.deviceToken;
   let deviceId = setup.deviceId;
@@ -144,10 +144,7 @@ async function cmdInit(argv) {
     if (!dashboardUrl) dashboardUrl = await detectLocalDashboardUrl();
     const flow = await beginBrowserAuth({ baseUrl, dashboardUrl, timeoutMs: 10 * 60_000, open: false });
     const canAutoOpen = !opts.noOpen;
-    renderFinalStep({ authUrl: flow.authUrl, canAutoOpen });
-    if (canAutoOpen && isInteractive()) {
-      await promptEnter('');
-    }
+    renderAuthTransition({ authUrl: flow.authUrl, canAutoOpen });
     if (canAutoOpen) {
       if (isInteractive()) await sleep(250);
       openInBrowser(flow.authUrl);
@@ -158,9 +155,12 @@ async function cmdInit(argv) {
     deviceId = issued.deviceId;
     await writeJson(configPath, { baseUrl, deviceToken, deviceId, installedAt: setup.installedAt });
     await chmod600IfPossible(configPath);
-    renderSuccessBox({ deviceId, configPath });
+    const resolvedDashboardUrl = dashboardUrl || null;
+    renderSuccessBox({ configPath, dashboardUrl: resolvedDashboardUrl });
   } else if (deviceToken) {
-    renderSuccessBox({ deviceId, configPath });
+    if (!dashboardUrl) dashboardUrl = await detectLocalDashboardUrl();
+    const resolvedDashboardUrl = dashboardUrl || null;
+    renderSuccessBox({ configPath, dashboardUrl: resolvedDashboardUrl });
   } else {
     renderAccountNotLinked();
   }
@@ -194,39 +194,6 @@ function renderWelcome() {
   );
 }
 
-function renderTransparencyReport({ summary, isDryRun, includeDivider = false }) {
-  const header = isDryRun ? 'Dry run complete. Preview only; no changes were applied.' : 'Local setup complete.';
-  const lines = [header, '', "We've integrated VibeScore with:"];
-  for (const item of summary) lines.push(formatSummaryLine(item));
-  if (includeDivider) lines.push('', DIVIDER, '');
-  process.stdout.write(`${lines.join('\n')}\n`);
-}
-
-function renderFinalStep({ authUrl, canAutoOpen }) {
-  const lines = [
-    'Final Step: Link your account',
-    '',
-    canAutoOpen ? 'Press [Enter] to open your browser and sign in.' : 'Open the link below to sign in.'
-  ];
-  if (authUrl) lines.push(`(Or visit: ${underline(authUrl)})`);
-  lines.push('');
-  process.stdout.write(lines.join('\n'));
-}
-
-function renderSuccessBox({ deviceId, configPath }) {
-  const identityLine = deviceId ? `Device ID: ${deviceId}` : 'Account linked.';
-  const lines = [
-    'You are all set!',
-    '',
-    identityLine,
-    `Token saved to: ${configPath}`,
-    '',
-    'VibeScore is now running in the background.',
-    'You can close this terminal window.'
-  ];
-  process.stdout.write(`${renderBox(lines)}\n`);
-}
-
 function renderAccountNotLinked({ context } = {}) {
   if (context === 'dry-run') {
     process.stdout.write(['', 'Account not linked (dry run).', 'Run init without --dry-run to link your account.', ''].join('\n'));
@@ -363,8 +330,8 @@ function buildIntegrationTargets({ home, trackerDir, notifyPath }) {
   const codeNotifyOriginalPath = path.join(trackerDir, 'code_notify_original.json');
   const notifyCmd = ['/usr/bin/env', 'node', notifyPath];
   const codeNotifyCmd = ['/usr/bin/env', 'node', notifyPath, '--source=every-code'];
-  const claudeDir = path.join(home, '.claude');
-  const claudeSettingsPath = path.join(claudeDir, 'settings.json');
+  const claudeDir = resolveClaudeHome({ home, env: process.env });
+  const claudeSettingsPath = resolveClaudeSettingsPath({ claudeHome: claudeDir });
   const claudeHookCommand = buildClaudeHookCommand(notifyPath);
   const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
   const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });

package/src/commands/status.js

@@ -4,7 +4,12 @@ const fs = require('node:fs/promises');
 
 const { readJson } = require('../lib/fs');
 const { readCodexNotify, readEveryCodeNotify } = require('../lib/codex-config');
-const { isClaudeHookConfigured, buildClaudeHookCommand } = require('../lib/claude-config');
+const {
+  isClaudeHookConfigured,
+  buildClaudeHookCommand,
+  resolveClaudeHome,
+  resolveClaudeSettingsPath
+} = require('../lib/claude-config');
 const {
   resolveGeminiConfigDir,
   resolveGeminiSettingsPath,
@@ -37,7 +42,8 @@ async function cmdStatus(argv = []) {
   const codexConfigPath = path.join(codexHome, 'config.toml');
   const codeHome = process.env.CODE_HOME || path.join(home, '.code');
   const codeConfigPath = path.join(codeHome, 'config.toml');
-  const claudeSettingsPath = path.join(home, '.claude', 'settings.json');
+  const claudeHome = resolveClaudeHome({ home, env: process.env });
+  const claudeSettingsPath = resolveClaudeSettingsPath({ claudeHome });
   const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
   const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
   const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });

package/src/commands/sync.js

@@ -14,6 +14,7 @@ const {
   parseGeminiIncremental,
   parseOpencodeIncremental
 } = require('../lib/rollout');
+const { resolveClaudeHome, resolveClaudeProjectsDir } = require('../lib/claude-config');
 const { drainQueueToCloud } = require('../lib/uploader');
 const { createProgress, renderBar, formatNumber, formatBytes } = require('../lib/progress');
 const { syncHeartbeat } = require('../lib/vibescore-api');
@@ -53,7 +54,8 @@ async function cmdSync(argv) {
 
     const codexHome = process.env.CODEX_HOME || path.join(home, '.codex');
     const codeHome = process.env.CODE_HOME || path.join(home, '.code');
-    const claudeProjectsDir = path.join(home, '.claude', 'projects');
+    const claudeHome = resolveClaudeHome({ home, env: process.env });
+    const claudeProjectsDir = resolveClaudeProjectsDir({ claudeHome });
     const geminiHome = process.env.GEMINI_HOME || path.join(home, '.gemini');
     const geminiTmpDir = path.join(geminiHome, 'tmp');
     const xdgDataHome = process.env.XDG_DATA_HOME || path.join(home, '.local', 'share');

package/src/commands/uninstall.js

@@ -3,7 +3,12 @@ const path = require('node:path');
 const fs = require('node:fs/promises');
 
 const { restoreCodexNotify, restoreEveryCodeNotify } = require('../lib/codex-config');
-const { removeClaudeHook, buildClaudeHookCommand } = require('../lib/claude-config');
+const {
+  removeClaudeHook,
+  buildClaudeHookCommand,
+  resolveClaudeHome,
+  resolveClaudeSettingsPath
+} = require('../lib/claude-config');
 const {
   resolveGeminiConfigDir,
   resolveGeminiSettingsPath,
@@ -21,7 +26,8 @@ async function cmdUninstall(argv) {
   const codexConfigPath = path.join(codexHome, 'config.toml');
   const codeHome = process.env.CODE_HOME || path.join(home, '.code');
   const codeConfigPath = path.join(codeHome, 'config.toml');
-  const claudeSettingsPath = path.join(home, '.claude', 'settings.json');
+  const claudeHome = resolveClaudeHome({ home, env: process.env });
+  const claudeSettingsPath = resolveClaudeSettingsPath({ claudeHome });
   const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
   const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
   const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });

package/src/lib/claude-config.js

@@ -1,10 +1,25 @@
 const fs = require('node:fs/promises');
+const os = require('node:os');
 const path = require('node:path');
 
 const { ensureDir, readJson, writeJson } = require('./fs');
 
 const DEFAULT_EVENT = 'SessionEnd';
 
+function resolveClaudeHome({ home = os.homedir(), env = process.env } = {}) {
+  const explicit = typeof env.CLAUDE_HOME === 'string' ? env.CLAUDE_HOME.trim() : '';
+  if (explicit) return path.resolve(explicit);
+  return path.join(home, '.claude');
+}
+
+function resolveClaudeSettingsPath({ claudeHome }) {
+  return path.join(claudeHome, 'settings.json');
+}
+
+function resolveClaudeProjectsDir({ claudeHome }) {
+  return path.join(claudeHome, 'projects');
+}
+
 async function upsertClaudeHook({ settingsPath, hookCommand, event = DEFAULT_EVENT }) {
   const existing = await readJson(settingsPath);
   const settings = normalizeSettings(existing);
@@ -183,6 +198,9 @@ async function writeClaudeSettings({ settingsPath, settings }) {
 }
 
 module.exports = {
+  resolveClaudeHome,
+  resolveClaudeSettingsPath,
+  resolveClaudeProjectsDir,
   upsertClaudeHook,
   removeClaudeHook,
   isClaudeHookConfigured,

package/src/lib/diagnostics.js

@@ -4,7 +4,12 @@ const fs = require('node:fs/promises');
 
 const { readJson } = require('./fs');
 const { readCodexNotify, readEveryCodeNotify } = require('./codex-config');
-const { isClaudeHookConfigured, buildClaudeHookCommand } = require('./claude-config');
+const {
+  isClaudeHookConfigured,
+  buildClaudeHookCommand,
+  resolveClaudeHome,
+  resolveClaudeSettingsPath
+} = require('./claude-config');
 const {
   resolveGeminiConfigDir,
   resolveGeminiSettingsPath,
@@ -30,7 +35,8 @@ async function collectTrackerDiagnostics({
   const autoRetryPath = path.join(trackerDir, 'auto.retry.json');
   const codexConfigPath = path.join(codexHome, 'config.toml');
   const codeConfigPath = path.join(codeHome, 'config.toml');
-  const claudeConfigPath = path.join(home, '.claude', 'settings.json');
+  const claudeHome = resolveClaudeHome({ home, env: process.env });
+  const claudeConfigPath = resolveClaudeSettingsPath({ claudeHome });
   const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
   const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
   const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });

package/src/lib/init-flow.js

@@ -0,0 +1,48 @@
+'use strict';
+
+const { formatSummaryLine, renderBox, underline } = require('./cli-ui');
+
+const DIVIDER = '----------------------------------------------';
+
+function renderLocalReport({ summary, isDryRun }) {
+  const header = isDryRun
+    ? 'Dry run complete. Preview only; no changes were applied.'
+    : 'Local configuration complete.';
+  const lines = [header, '', 'Integration Status:'];
+  for (const item of summary || []) lines.push(formatSummaryLine(item));
+  process.stdout.write(`${lines.join('\n')}\n`);
+}
+
+function renderAuthTransition({ authUrl, canAutoOpen }) {
+  const lines = ['', DIVIDER, '', 'Next: Registering device...'];
+  if (canAutoOpen) {
+    lines.push('Opening your browser to link account...');
+    if (authUrl) lines.push(`If it does not open, visit: ${underline(authUrl)}`);
+  } else {
+    lines.push('Open the link below to sign in.');
+    if (authUrl) lines.push(`Visit: ${underline(authUrl)}`);
+  }
+  lines.push('');
+  process.stdout.write(`${lines.join('\n')}\n`);
+}
+
+function renderSuccessBox({ configPath, dashboardUrl }) {
+  const identityLine = 'Account linked.';
+  const lines = [
+    'You are all set!',
+    '',
+    identityLine,
+    `Token saved to: ${configPath}`,
+    ''
+  ];
+  if (dashboardUrl) lines.push(`View your stats at: ${dashboardUrl}`);
+  lines.push('You can close this terminal window.');
+  process.stdout.write(`${renderBox(lines)}\n`);
+}
+
+module.exports = {
+  DIVIDER,
+  renderLocalReport,
+  renderAuthTransition,
+  renderSuccessBox
+};