@vibescore/tracker 0.2.6 → 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.6",
+  "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,
@@ -324,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 });