@vibe-cafe/vibe-usage 0.7.3 → 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)

package/package.json

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

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/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() {