@vibe-cafe/vibe-usage 0.7.2 → 0.7.4

package/README.md

@@ -47,12 +47,13 @@ npx @vibe-cafe/vibe-usage status       # Show config & detected tools
 | Kimi Code | `~/.kimi/sessions/` |
 | Amp | `~/.local/share/amp/threads/` |
 | Droid | `~/.factory/sessions/` |
+| Hermes | `~/.hermes/state.db` (SQLite) |
 
 ## How It Works
 
 - Parses local session logs from each AI coding tool
 - Aggregates token usage into 30-minute buckets
-- Extracts session metadata from all 10 parsers: active time (AI generation time, excluding queue/TTFT wait), total duration, message counts
+- Extracts session metadata from all parsers: active time (AI generation time, excluding queue/TTFT wait), total duration, message counts
 - Uploads buckets + sessions to your vibecafe.ai dashboard
 - Stateless: computes full totals from local logs each sync (idempotent, no state files)
 - For continuous syncing, use `npx @vibe-cafe/vibe-usage daemon` or the [Vibe Usage Mac app](https://github.com/vibe-cafe/vibe-usage-app)
@@ -90,7 +91,19 @@ VIBE_USAGE_DEV=1 npx @vibe-cafe/vibe-usage sync
 
 ## Config
 
-Config stored at `~/.vibe-usage/config.json` (dev: `config.dev.json`). Contains your API key and server URL.
+Config stored at `~/.vibe-usage/config.json` (dev: `config.dev.json`).
+
+| Key | Description |
+|-----|-------------|
+| `apiKey` | Your API key (starts with `vbu_`) |
+| `apiUrl` | Server URL (default: `https://vibecafe.ai`) |
+| `hostname` | Stable device name for usage tracking (set at init, reused across syncs) |
+
+The `hostname` is captured once during `init` and reused for all future syncs. This prevents macOS mDNS hostname changes (e.g., `MacBook-Pro` → `MacBook-Pro-2`) from creating duplicate device entries. To change it manually:
+
+```bash
+npx @vibe-cafe/vibe-usage config set hostname my-device-name
+```
 
 ## Daemon Mode
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-cafe/vibe-usage",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Track your AI coding tool token usage and sync to vibecafe.ai",
   "type": "module",
   "bin": {

package/src/index.js

@@ -34,7 +34,7 @@ async function showStatus() {
   console.log();
 }
 
-const VALID_CONFIG_KEYS = ['apiKey', 'apiUrl'];
+const VALID_CONFIG_KEYS = ['apiKey', 'apiUrl', 'hostname'];
 
 function handleConfig(args) {
   const sub = args[0];

package/src/init.js

@@ -1,6 +1,6 @@
 import { createInterface } from 'node:readline';
 import { execFile } from 'node:child_process';
-import { platform } from 'node:os';
+import { hostname as osHostname, platform } from 'node:os';
 import { loadConfig, saveConfig } from './config.js';
 import { ingest } from './api.js';
 import { runSync } from './sync.js';
@@ -61,6 +61,7 @@ export async function runInit() {
   const config = {
     apiKey,
     apiUrl,
+    hostname: existing?.hostname || osHostname().replace(/\.local$/, ''),
   };
   saveConfig(config);
 

package/src/parsers/hermes.js

@@ -0,0 +1,100 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { aggregateToBuckets, extractSessions } from './index.js';
+
+const HERMES_HOME = process.env.HERMES_HOME || join(homedir(), '.hermes');
+const DB_PATH = join(HERMES_HOME, 'state.db');
+
+/**
+ * Parse Hermes Agent usage data from its SQLite database (~/.hermes/state.db).
+ *
+ * Token buckets come from the sessions table (cumulative per-session totals).
+ * Session timing comes from the messages table (per-message role + timestamp).
+ */
+export async function parse() {
+  if (!existsSync(DB_PATH)) return { buckets: [], sessions: [] };
+
+  let sessionRows;
+  try {
+    sessionRows = queryDb(`SELECT
+      id,
+      model,
+      started_at as startedAt,
+      input_tokens as inputTokens,
+      output_tokens as outputTokens,
+      cache_read_tokens as cacheReadTokens,
+      reasoning_tokens as reasoningTokens
+      FROM sessions
+      WHERE input_tokens > 0 OR output_tokens > 0`);
+  } catch (err) {
+    if (err.message && err.message.includes('ENOENT')) {
+      throw new Error('sqlite3 CLI not found. Install sqlite3 to sync Hermes data.');
+    }
+    throw err;
+  }
+
+  const entries = [];
+  for (const row of sessionRows) {
+    // started_at is a Unix timestamp (float)
+    const timestamp = new Date(row.startedAt * 1000);
+    if (isNaN(timestamp.getTime())) continue;
+
+    // Hermes stores input_tokens exclusive of cache (Anthropic-style semantics)
+    entries.push({
+      source: 'hermes',
+      model: row.model || 'unknown',
+      project: 'unknown',
+      timestamp,
+      inputTokens: row.inputTokens || 0,
+      outputTokens: row.outputTokens || 0,
+      cachedInputTokens: row.cacheReadTokens || 0,
+      reasoningOutputTokens: row.reasoningTokens || 0,
+    });
+  }
+
+  // Session events from messages table for active time calculation
+  let messageRows;
+  try {
+    messageRows = queryDb(`SELECT
+      session_id as sessionId,
+      role,
+      timestamp
+      FROM messages
+      WHERE role IN ('user', 'assistant')
+      ORDER BY timestamp`);
+  } catch {
+    // Messages query failed — return buckets only
+    return { buckets: aggregateToBuckets(entries), sessions: [] };
+  }
+
+  const sessionEvents = [];
+  for (const row of messageRows) {
+    const timestamp = new Date(row.timestamp * 1000);
+    if (isNaN(timestamp.getTime())) continue;
+
+    sessionEvents.push({
+      sessionId: row.sessionId,
+      source: 'hermes',
+      project: 'unknown',
+      timestamp,
+      role: row.role === 'user' ? 'user' : 'assistant',
+    });
+  }
+
+  return { buckets: aggregateToBuckets(entries), sessions: extractSessions(sessionEvents) };
+}
+
+function queryDb(sql) {
+  const output = execFileSync('sqlite3', [
+    '-json',
+    DB_PATH,
+    sql,
+  ], { encoding: 'utf-8', maxBuffer: 100 * 1024 * 1024, timeout: 30000 });
+
+  const trimmed = output.trim();
+  if (!trimmed || trimmed === '[]') return [];
+
+  return JSON.parse(trimmed);
+}

package/src/parsers/index.js

@@ -10,6 +10,7 @@ import { parse as parseKimiCode } from './kimi-code.js';
 import { parse as parseAmp } from './amp.js';
 import { parse as parseDroid } from './droid.js';
 import { parse as parseAntigravity } from './antigravity.js';
+import { parse as parseHermes } from './hermes.js';
 import { parse as parsePiCodingAgent } from './pi-coding-agent.js';
 
 export const parsers = {
@@ -24,6 +25,7 @@ export const parsers = {
   'amp': parseAmp,
   'droid': parseDroid,
   'antigravity': parseAntigravity,
+  'hermes': parseHermes,
   'pi-coding-agent': parsePiCodingAgent,
 };
 

package/src/sync.js

@@ -59,7 +59,12 @@ export async function runSync({ throws = false, quiet = false } = {}) {
     }
   }
 
-  const host = osHostname().replace(/\.local$/, '');
+  let host = config.hostname;
+  if (!host) {
+    host = osHostname().replace(/\.local$/, '');
+    config.hostname = host;
+    saveConfig(config);
+  }
   for (const b of allBuckets) {
     b.hostname = host;
   }

package/src/tools.js

@@ -82,6 +82,11 @@ export const TOOLS = [
     id: 'droid',
     dataDir: join(homedir(), '.factory', 'sessions'),
   },
+  {
+    name: 'Hermes',
+    id: 'hermes',
+    dataDir: join(homedir(), '.hermes', 'state.db'),
+  },
 ];
 
 export function detectInstalledTools() {