tokenphage 2026.7.2-BETA → 2026.11.1

package/README.md

@@ -5,22 +5,22 @@
 
 > 먹어치운 토큰, 이젠 README에 기록하세요!
 
-Claude Code와 Codex의 토큰 사용량을 모아 GitHub README에 붙일 수 있는 배지로 만들어 줍니다.
+Claude Code, Codex, opencode의 토큰 사용량을 모아 GitHub README에 붙일 수 있는 배지로 만들어 줍니다.
 
 ---
 
 ## 📋 요구 사항
 
-- **Node.js 20.17 이상**
+- **Node.js 22.14 이상**
 - macOS 또는 Windows (자동 동기화 사용 시)
 - GitHub 계정
 
 ## 🖼️ 이런 배지가 만들어져요
 
-GitHub README(이미지를 붙일 수 있는 곳이면 어디든)에 아래 한 줄만 넣으면 됩니다. `kobenlys`를 본인 GitHub 아이디로 바꾸세요.
+GitHub README(이미지를 붙일 수 있는 곳이면 어디든)에 아래 한 줄만 넣으면 됩니다. `<your-github-name>`을 본인 GitHub 아이디로 바꾸세요.
 
 ```markdown
-[![TokenPhage](https://api.tokenphage.com/badge/kobenlys)](https://github.com/TOKENPHAGE/tokenphage-api)
+[![Tokenphage](https://api.tokenphage.com/badge/<your-github-name>)](https://github.com/TOKENPHAGE)
 ```
 
 **결과 ↓**
@@ -32,17 +32,35 @@ GitHub README(이미지를 붙일 수 있는 곳이면 어디든)에 아래 한
   </tr>
   <tr>
     <td align="center">
-      <a href="https://github.com/TOKENPHAGE/tokenphage-api"><img src="https://api.tokenphage.com/badge/kobenlys?theme=gpu&amp;mode=dark" alt="TokenPhage gpu dark 배지"></a><br/>
-      <code>https://api.tokenphage.com/badge/kobenlys?theme=gpu&amp;mode=dark</code>
+      <a href="https://github.com/TOKENPHAGE"><img src="https://api.tokenphage.com/badge/kobenlys?theme=gpu&amp;mode=dark" alt="TokenPhage gpu dark 배지"></a><br/>
+      <code>[![Tokenphage](https://api.tokenphage.com/badge/&lt;your-github-name&gt;?theme=gpu&amp;mode=dark)](https://github.com/TOKENPHAGE)</code>
     </td>
     <td align="center">
-      <a href="https://github.com/TOKENPHAGE/tokenphage-api"><img src="https://api.tokenphage.com/badge/kobenlys?theme=claude&amp;mode=light" alt="TokenPhage claude light 배지"></a><br/>
-      <code>https://api.tokenphage.com/badge/kobenlys?theme=claude&amp;mode=light</code>
+      <a href="https://github.com/TOKENPHAGE"><img src="https://api.tokenphage.com/badge/kobenlys?theme=claude&amp;mode=light" alt="TokenPhage claude light 배지"></a><br/>
+      <code>[![Tokenphage](https://api.tokenphage.com/badge/&lt;your-github-name&gt;?theme=claude&amp;mode=light)](https://github.com/TOKENPHAGE)</code>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" colspan="2"><strong>grass-claude · light</strong></td>
+  </tr>
+  <tr>
+    <td align="center" colspan="2">
+      <a href="https://github.com/TOKENPHAGE"><img src="https://api.tokenphage.com/badge/kobenlys?theme=grass-claude" alt="TokenPhage grass-claude light 배지"></a><br/>
+      <code>[![Tokenphage](https://api.tokenphage.com/badge/&lt;your-github-name&gt;?theme=grass-claude)](https://github.com/TOKENPHAGE)</code>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" colspan="2"><strong>grass-claude · dark</strong></td>
+  </tr>
+  <tr>
+    <td align="center" colspan="2">
+      <a href="https://github.com/TOKENPHAGE"><img src="https://api.tokenphage.com/badge/kobenlys?theme=grass-claude&amp;mode=dark" alt="TokenPhage grass-claude dark 배지"></a><br/>
+      <code>[![Tokenphage](https://api.tokenphage.com/badge/&lt;your-github-name&gt;?theme=grass-claude&amp;mode=dark)](https://github.com/TOKENPHAGE)</code>
     </td>
   </tr>
 </table>
 
-> 🎨 URL 뒤에 옵션을 붙일 수 있어요 — 테마 `?theme=gpu`(기본) 또는 `?theme=claude`, 색상 `?mode=light`(기본) 또는 `?mode=dark`.
+> 🎨 URL 뒤에 옵션을 붙일 수 있어요 — 테마 `?theme=gpu`(기본) · `?theme=claude` · `?theme=grass-claude`, 색상 `?mode=light`(기본) 또는 `?mode=dark`.
 
 ## 📦 설치
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenphage",
-  "version": "2026.7.2-BETA",
+  "version": "2026.11.1",
   "description": "AI 토큰 사용량 GitHub README 뱃지",
   "author": "kobenlys <kobenlys@gmail.com>",
   "license": "MIT",
@@ -19,10 +19,12 @@
   "scripts": {
     "start": "node src/index.js",
     "dev": "cross-env TOKENPHAGE_API=http://localhost:8080 node src/index.js",
-    "test": "node --test test/*.test.js"
+    "test": "node --test test/*.test.js",
+    "test:coverage": "node --test --experimental-test-coverage --test-coverage-exclude='test/**' --test-coverage-exclude='src/index.js' --test-coverage-exclude='src/ui.js' --test-coverage-exclude='src/animated-select.js' --test-coverage-exclude='src/gradient.js' --test-coverage-exclude='src/auth.js' --test-coverage-exclude='src/scheduler.js' --test-coverage-exclude='src/parser.js' --test-coverage-lines=80 --test-coverage-functions=80 test/*.test.js"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.5.0",
+    "better-sqlite3": "^13.0.3",
     "chalk": "^5.6.2",
     "commander": "^12.1.0",
     "glob": "^11.0.0",
@@ -36,6 +38,6 @@
     "mute-stream": "^3.0.0"
   },
   "engines": {
-    "node": "^20.17.0 || ^22.13.0 || >=23.5.0"
+    "node": "^22.14.0 || >=23.6.0"
   }
 }

package/src/auth.js

@@ -4,6 +4,7 @@ import { join } from 'path';
 import { randomUUID } from 'crypto';
 import { normalizeConfig } from './lib/config-schema.js';
 import { localDateOf } from './lib/dates.js';
+import { apiFetch } from './sync.js';
 
 // 로컬 설정 파일 경로: ~/.tokenphage/config.json (JWT·deviceId·sync 상태 보관)
 const CONFIG_DIR = join(homedir(), '.tokenphage');
@@ -79,18 +80,10 @@ export function getCustomClaudePaths() {
   return Array.isArray(paths) ? paths : [];
 }
 
-/** 마지막 sync 완료 날짜(YYYY-MM-DD)를 반환한다. 없으면 null. */
-export function getLastSyncDate() { return loadConfig().lastSyncDate ?? null; }
-
-/** 마지막 sync 날짜를 저장한다. 다음 sync는 이 날짜 이후만 증분 파싱한다. */
-export function saveLastSyncDate(date) {
-  saveConfig({ ...loadConfig(), lastSyncDate: date });
-}
-
-/** lastSyncDate를 제거해 다음 sync가 전체 히스토리를 재파싱하도록 한다. token/deviceId는 보존. */
-export function clearLastSyncDate() {
-  const { lastSyncDate: _omit, ...rest } = loadConfig();
-  saveConfig(rest);
+/** reset용: lastSyncDate와 lastSyncVersion을 지워 다음 sync가 토큰·실행시간을 처음부터 보내게 한다. 나머지는 보존. */
+export function clearSyncState({ readConfig = loadConfig, writeConfig = saveConfig } = {}) {
+  const { lastSyncDate: _date, lastSyncVersion: _version, ...rest } = readConfig();
+  writeConfig(rest);
 }
 
 // Gist 소유권 검증용 파일명 — 사용자가 이 이름으로 Gist를 만들어야 한다.
@@ -113,8 +106,8 @@ export function parseGistId(input) {
 
 /** url에 JSON body를 POST하고 {ok, status, body}를 반환한다. 응답이 JSON이 아니면 {error: 원문}으로 감싼다. */
 async function postJson(url, body) {
-  // Node 18+ 전역 fetch 사용 (node-fetch 의존성 불필요).
-  const res = await fetch(url, {
+  // 이름표를 붙이고 지원 종료 헤더를 안내하는 공통 요청
+  const res = await apiFetch(url, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(body),

package/src/hook-reconcile.js

@@ -0,0 +1,53 @@
+/**
+ * auto-sync 등록 정합성 복구.
+ * 설정(config.json)은 켜짐인데 OS 스케줄러에서 예약이 사라진 경우를 감지해 다시 등록한다.
+ *
+ * index.js가 아니라 별 모듈인 이유: index.js는 최상단에서 program.parse()를 실행하므로
+ * 테스트가 import하는 순간 CLI가 시동된다. lib/가 아닌 이유는 ui.js에 의존해
+ * 순수 로직 계층 규약에 맞지 않기 때문이다.
+ */
+import { loadConfig, setHookInstalled } from './auth.js';
+import { installHook, probeHookRegistration } from './scheduler.js';
+import { showError, pauseForEnter } from './ui.js';
+
+const ISSUE_HINT =
+  'Log: ~/.tokenphage/logs/sync.log — please report it: https://github.com/TOKENPHAGE/tokenphage-cli/issues';
+
+/**
+ * 설정은 auto-sync 켜짐인데 OS 스케줄러에 등록이 없으면 재등록한다.
+ *
+ * 헤드리스에서는 절대 재등록하지 않는다 — installMac()이 첫 단계로
+ * launchctlBootout()을 호출하는데, 그 프로세스가 바로 해당 launchd job이라 자기 자신을 내려
+ * SIGTERM으로 죽고 plist 작성에 도달하지 못한다. 그래서 호출 위치에만 의존하지 않고
+ * 함수 안에서 isTTY를 직접 확인해 구조적으로 막는다.
+ *
+ * 의존성은 전부 기본값으로 실제 구현이 배선돼 있다 — 호출부는 인자 없이 부르고 테스트만 대체한다.
+ * @param {{interactive?: boolean, readConfig?: Function, probe?: Function, install?: Function,
+ *          persist?: Function, onError?: Function, onPause?: Function}} [deps]
+ * @returns {Promise<boolean>} 등록을 초록으로 단정할 수 없으면 true (확인 불가 또는 재등록 실패)
+ */
+export async function reconcileHookRegistration({
+  interactive = Boolean(process.stdin.isTTY),
+  readConfig = loadConfig,
+  probe = probeHookRegistration,
+  install = installHook,
+  persist = setHookInstalled,
+  onError = showError,
+  onPause = pauseForEnter,
+} = {}) {
+  if (!interactive) return false;                          // 헤드리스: 자기 예약을 건드리지 않는다
+  if (readConfig().hookInstalled !== true) return false;   // 꺼짐(사용자 의사): 조회조차 하지 않는다
+
+  const state = probe();
+  if (state === 'registered') return false;
+  if (state === 'unknown') return true;                    // 판정 불가에서 재등록하면 정상 예약을 깬다
+
+  try {
+    persist(true, await install());                        // installHook은 멱등이라 그대로 재사용한다
+    return false;
+  } catch (err) {
+    onError('Auto-sync re-registration failed', err.message, ISSUE_HINT);
+    await onPause();
+    return true;                                           // 실패했으므로 초록으로 단정하지 않는다
+  }
+}

package/src/index.js

@@ -5,13 +5,14 @@
  *       맨 끝 program.parse()가 argv를 해석해 실제 시동을 건다.
  */
 import { Command } from 'commander';
-import { parseAll } from './parser.js';
-import { loadToken, saveToken, getOrCreateDeviceId, gistLogin, setHookInstalled, getLastSyncDate, saveLastSyncDate, clearLastSyncDate } from './auth.js';
-import { syncRecords, resetData } from './sync.js';
+import { parseLogs } from './parser.js';
+import { loadConfig, loadToken, saveToken, getOrCreateDeviceId, gistLogin, setHookInstalled, clearSyncState } from './auth.js';
+import { resetData } from './sync.js';
+import { runSyncFlow } from './sync-flow.js';
 import { installHook, uninstallHook } from './scheduler.js';
+import { reconcileHookRegistration } from './hook-reconcile.js';
 import { promptFirstRun, promptDashboard, promptAdvanced, confirmReset, pauseForEnter, showError } from './ui.js';
 import { accent } from './gradient.js';
-import { localDateOf } from './lib/dates.js';
 import { claudeDirCandidates } from './parser.js';
 import { checkClaudeRetention, applyRetentionSetting, DEFAULT_CLEANUP_DAYS } from './lib/retention.js';
 import { checkLatestVersion, getUpdateInfo } from './lib/update-check.js';
@@ -125,30 +126,11 @@ async function promptRetentionSetup() {
   }
 }
 
-/** sync 명령 본체: 로컬 로그를 파싱(최초=전체 / 이후=증분)해 서버로 업로드하고, 마지막 sync 날짜를 갱신한다. */
+/** sync 명령 본체: 인증·기기 ID를 확인하고 sync 흐름(sync-flow.js)을 실행한다. */
 async function runSync() {
   const token = requireToken();
   const deviceId = getOrCreateDeviceId();
-  const today = localDateOf(new Date());
-
-  // 최초(lastSyncDate 없음)면 fromDate=null → 전체 히스토리 파싱.
-  // 이후엔 직전 sync일부터 오늘까지 증분만 파싱.
-  const lastSyncDate = getLastSyncDate();
-  const fromDate = lastSyncDate ?? null;
-
-  console.log(`Parsing local JSONL... (${fromDate ?? 'beginning'} ~ ${today})`);
-  const records = await parseAll(fromDate);
-  console.log(`${records.length} records aggregated (date×model)`);
-  if (records.length === 0) {
-    console.log('Nothing to sync.');
-    saveLastSyncDate(today);
-    return;
-  }
-
-  console.log('Uploading to server...');
-  await syncRecords(API_BASE, token, deviceId, records);
-  saveLastSyncDate(today);
-  console.log('Done! Badge will update shortly.');
+  await runSyncFlow({ apiBase: API_BASE, token, deviceId, parseLogs });
 }
 
 /**
@@ -182,8 +164,8 @@ async function runAdvanced(apiBase, cfg) {
     await pauseForEnter();
     return;
   }
-  // 2단계: 로컬 워터마크 제거 후 전체 재-sync. 재-sync가 실패해도 서버 삭제는 이미 완료됐음을 명확히 안내.
-  clearLastSyncDate();
+  // 2단계: 로컬 워터마크(lastSyncDate·lastSyncVersion) 제거 후 전체 재-sync. 재-sync가 실패해도 서버 삭제는 이미 완료됐음을 명확히 안내.
+  clearSyncState();
   console.log(accent('  [OK] Server data reset.') + ' Re-syncing from scratch...');
   try {
     await runSync();
@@ -239,14 +221,14 @@ program.action(async () => {
       }
     }
 
-    // 인증 이후 메뉴는 최신 설정이 필요하므로 여기서 동적 import (상단 정적 import과 별개)
-    const { loadConfig } = await import('./auth.js');
     // TUI 진입 시 npm 최신버전을 1회 조회(짧은 타임아웃). 세션 동안 재사용해 배너/메뉴에 반영한다.
     const latest = await checkLatestVersion();
+    // 대시보드 진입 전 1회: 설정만 켜져 있고 OS 스케줄러에서 사라졌으면 여기서 되살린다.
+    const hookUnverified = await reconcileHookRegistration();
     // 대시보드 루프: 액션 수행 후 메인으로 복귀, Exit/Esc 에서만 종료
     while (true) {
       const cfg = loadConfig();
-      const action = await promptDashboard(cfg, latest);
+      const action = await promptDashboard(cfg, latest, hookUnverified);
       if (action === 'exit') break;
       if (action === 'sync') await runSync();
       else if (action === 'install-hook') await runInstallHook();
@@ -293,9 +275,9 @@ program.command('login [username]')
     }
   });
 
-// sync: 로컬 Claude/Codex 로그를 파싱해 서버로 업로드한다(배지 갱신). 미인증이면 안내 후 종료.
+// sync: 로컬 Claude Code/Codex/opencode 로그를 파싱해 서버로 업로드한다(배지 갱신). 미인증이면 안내 후 종료.
 program.command('sync')
-  .description('Sync local Claude Code token usage to the server')
+  .description('Sync local token usage (Claude Code, Codex, opencode) to the server')
   .action(async () => {
     try { await runSync(); }
     catch (err) { showError('Sync failed', err.message); process.exitCode = 1; }

package/src/lib/config-schema.js

@@ -83,6 +83,7 @@ export function normalizeConfig(raw, today) {
   dropIf('token', isJwtShape);
   dropIf('deviceId', isUuid);                         // 없으면 getOrCreateDeviceId가 재발급
   dropIf('lastSyncDate', (v) => isYmdDate(v, today)); // 없으면 전체 재파싱
+  dropIf('lastSyncVersion', (v) => typeof v === 'string' && v !== ''); // 없으면 실행시간 전체 재전송
   dropIf('hookInstalledAt', isIsoDate);
   dropIf('hookInstalled', (v) => typeof v === 'boolean');
   dropIf('claudePaths', isStringArray);

package/src/lib/paths.js

@@ -1,7 +1,9 @@
 import { join, resolve } from 'path';
 
-// Claude 설정 디렉터리 후보를 우선순위 순으로 만든다.
-// 순서: 기본(~/.claude) → XDG($XDG_CONFIG_HOME/claude, 기본 ~/.config/claude) → 사용자 지정.
+// AI 도구별 로컬 디렉터리 후보를 우선순위 순으로 만든다.
+//  - Claude: 설정(config) 디렉터리. 기본(~/.claude) → XDG($XDG_CONFIG_HOME/claude) → 사용자 지정.
+//  - opencode: 데이터(data) 디렉터리. XDG($XDG_DATA_HOME, 기본 ~/.local/share)/opencode → 사용자 지정.
+//    (opencode는 세션을 <data>/opencode/storage/... 에 저장하므로 config가 아니라 data home 기준이다.)
 
 function expandTilde(p, home) {
   if (p === '~') return home;
@@ -9,8 +11,30 @@ function expandTilde(p, home) {
   return p;
 }
 
+// 후보 경로들을 절대경로로 normalize하고 순서를 유지한 채 중복을 제거한다.
+function normalizeUnique(candidates) {
+  const seen = new Set();
+  const dirs = [];
+  for (const candidate of candidates) {
+    const normalized = resolve(candidate);
+    if (seen.has(normalized)) continue;
+    seen.add(normalized);
+    dirs.push(normalized);
+  }
+  return dirs;
+}
+
+// 외부 입력(config.json 등)의 customPaths를 검증한다: 문자열 배열만 인정, 틸드는 home으로 확장.
+function cleanCustomPaths(customPaths, home) {
+  if (!Array.isArray(customPaths)) return [];
+  return customPaths
+    .filter((p) => typeof p === 'string' && p.trim())
+    .map((p) => expandTilde(p.trim(), home));
+}
+
 /**
  * Claude 설정 디렉터리 후보 목록을 우선순위 순으로 반환한다.
+ * 순서: 기본(~/.claude) → XDG($XDG_CONFIG_HOME/claude, 기본 ~/.config/claude) → 사용자 지정.
  * @param {{ home: string, xdgConfigHome?: string, customPaths?: string[] }} opts
  *   home: 사용자 홈, xdgConfigHome: $XDG_CONFIG_HOME, customPaths: config.json의 claudePaths
  * @returns {string[]} normalize·중복 제거된 절대 경로 목록
@@ -20,24 +44,28 @@ export function resolveClaudeDirs({ home, xdgConfigHome, customPaths } = {}) {
     ? xdgConfigHome
     : join(home, '.config');
 
-  // 외부 입력(config.json) 검증: 문자열 배열만 인정, 그 외는 통째로 무시
-  const custom = Array.isArray(customPaths)
-    ? customPaths.filter((p) => typeof p === 'string' && p.trim())
-    : [];
-
-  const candidates = [
+  return normalizeUnique([
     join(home, '.claude'),
     join(xdgBase, 'claude'),
-    ...custom.map((p) => expandTilde(p.trim(), home)),
-  ];
+    ...cleanCustomPaths(customPaths, home),
+  ]);
+}
 
-  const seen = new Set();
-  const dirs = [];
-  for (const candidate of candidates) {
-    const normalized = resolve(candidate);
-    if (seen.has(normalized)) continue;
-    seen.add(normalized);
-    dirs.push(normalized);
-  }
-  return dirs;
+/**
+ * opencode 데이터 디렉터리 후보 목록을 우선순위 순으로 반환한다.
+ * 순서: XDG($XDG_DATA_HOME/opencode, 기본 ~/.local/share/opencode) → 사용자 지정.
+ * Claude(config home 기준)와 달리 data home 기준임에 주의.
+ * @param {{ home: string, xdgDataHome?: string, customPaths?: string[] }} opts
+ *   home: 사용자 홈, xdgDataHome: $XDG_DATA_HOME, customPaths: 사용자 지정 opencode 디렉터리
+ * @returns {string[]} normalize·중복 제거된 절대 경로 목록
+ */
+export function resolveOpencodeDirs({ home, xdgDataHome, customPaths } = {}) {
+  const xdgBase = typeof xdgDataHome === 'string' && xdgDataHome.trim()
+    ? xdgDataHome
+    : join(home, '.local', 'share');
+
+  return normalizeUnique([
+    join(xdgBase, 'opencode'),
+    ...cleanCustomPaths(customPaths, home),
+  ]);
 }

package/src/lib/retention.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, writeFileSync, renameSync } from 'fs';
-import { join } from 'path';
+import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
 
 // Claude Code의 cleanupPeriodDays(트랜스크립트 보존 기간) 검사·설정.
 // 규칙은 하나: 99999 이상이면 통과, 아니면 동의를 받아 무조건 99999로 설정한다.
@@ -41,9 +41,9 @@ export function checkClaudeRetention(claudeDirs) {
 }
 
 /**
- * settings.json의 cleanupPeriodDays를 무조건 99999로 설정한다 (다른 필드 보존, 원자 쓰기).
+ * settings.json의 cleanupPeriodDays를 무조건 99999로 설정한다 (다른 필드 보존, 원자 쓰기, 상위 폴더가 없으면 0700으로 생성).
  * @param {string} settingsPath checkClaudeRetention()이 돌려준 settings.json 경로
- * @returns {boolean} 성공 여부 — 손상 JSON이면 수정하지 않고 false
+ * @returns {boolean} 성공 여부 — 손상 JSON이면 수정하지 않고 false, 쓰기(폴더 생성 포함)에 실패해도 false
  */
 export function applyRetentionSetting(settingsPath) {
   let config = {};
@@ -57,6 +57,7 @@ export function applyRetentionSetting(settingsPath) {
 
   try {
     const next = { ...config, cleanupPeriodDays: FOREVER_DAYS };
+    mkdirSync(dirname(settingsPath), { recursive: true, mode: 0o700 }); // Claude Code가 이 폴더에 대화 기록을 쌓는다
     const tmpPath = settingsPath + '.tmp';
     writeFileSync(tmpPath, JSON.stringify(next, null, 2) + '\n');
     renameSync(tmpPath, settingsPath); // 같은 디렉터리 내 rename = 원자적 교체

package/src/parser.js

@@ -1,9 +1,8 @@
 import { glob } from 'glob';
 import { homedir } from 'os';
-import { parseClaudeFiles } from './parsers/claude.js';
-import { parseCodexFiles } from './parsers/codex.js';
-import { resolveClaudeDirs } from './lib/paths.js';
+import { resolveClaudeDirs, resolveOpencodeDirs } from './lib/paths.js';
 import { getCustomClaudePaths } from './auth.js';
+import { readLogs } from './runtime/read-logs.js';
 
 /**
  * 소스별 파서가 돌려준 항목들을 "날짜|모델" 단위 레코드로 합산한다.
@@ -41,7 +40,16 @@ export function claudeDirCandidates() {
   });
 }
 
-export async function parseAll(fromDate = null) {
+/** opencode 데이터 디렉터리 후보(XDG data home 기준)를 우선순위 순으로 반환한다. */
+export function opencodeDirCandidates() {
+  return resolveOpencodeDirs({
+    home: homedir(),
+    xdgDataHome: process.env.XDG_DATA_HOME,
+  });
+}
+
+/** 세 도구의 로그 경로를 기존 탐색 순서대로 찾는다. */
+async function discoverLogPaths() {
   // 경로가 겹쳐도 파일 간 first-wins dedup이 흡수하므로 순서만 보장하면 된다.
   const claudeFiles = [];
   for (const dir of claudeDirCandidates()) {
@@ -55,9 +63,33 @@ export async function parseAll(fromDate = null) {
     ...(await globSorted(`${codexHome}/archived_sessions/**/*.jsonl`)),
   ];
 
-  const [claudeEntries, codexEntries] = await Promise.all([
-    parseClaudeFiles(claudeFiles),
-    parseCodexFiles(codexFiles),
-  ]);
-  return aggregateRecords([...claudeEntries, ...codexEntries], fromDate);
+  // 최신 opencode는 data home 바로 아래 opencode.db에 저장한다.
+  // DB가 있으면 그 파일만 직접 읽고(구버전에서 마이그레이션된 JSON과의 이중 집계 방지),
+  // DB가 없는 구버전만 storage/message·part JSON을 읽는다.
+  let opencodeDatabase = null;
+  const opencodeFiles = [];
+  for (const dir of opencodeDirCandidates()) {
+    const base = dir.replaceAll('\\', '/');
+    if (!opencodeDatabase) {
+      [opencodeDatabase = null] = await globSorted(`${base}/opencode.db`);
+    }
+    if (!opencodeDatabase) {
+      opencodeFiles.push(...await globSorted(`${base}/storage/message/**/*.json`));
+      opencodeFiles.push(...await globSorted(`${base}/storage/part/**/*.json`));
+    }
+  }
+
+  return { claudeFiles, codexFiles, opencodeDatabase, opencodeFiles };
+}
+
+/**
+ * 로그를 한 번 읽어 토큰 레코드와 실행시간을 함께 계산한다.
+ * @param {{ tokenFrom: string|null, runtimeFrom: string|null }} range YYYY-MM-DD(포함) 또는 null(전체 기간)
+ * @returns {Promise<{ records: Array<{date: string, model: string, inputTok: number, outputTok: number, cacheReadTok: number, cacheCreateTok: number}>,
+ *   runtimes: Array<{ date: string, source: 'claude'|'codex'|'opencode', model: string, runtimeMs: number }>,
+ *   allSourcesRead: boolean, failedSources: string[] }>}
+ */
+export async function parseLogs({ tokenFrom = null, runtimeFrom = null } = {}) {
+  const { entries, runtimes, allSourcesRead, failedSources } = await readLogs(await discoverLogPaths(), runtimeFrom);
+  return { records: aggregateRecords(entries, tokenFrom), runtimes, allSourcesRead, failedSources };
 }

package/src/parsers/claude.js

@@ -50,9 +50,10 @@ function mergedEntry(existing, usage, timestamp) {
 /**
  * Claude 트랜스크립트 파일들을 응답(dedup된 메시지) 단위 usage 목록으로 파싱한다.
  * @param {string[]} files JSONL 파일 경로 목록 (정렬된 순서 = 파일 간 first-wins 기준)
+ * @param {((record: object, file: string) => void)|null} [onRecord] 파싱한 줄마다 부르는 수집기(예외를 던지지 않아야 한다)
  * @returns {Promise<Array<{date: string, model: string, inputTok: number, outputTok: number, cacheReadTok: number, cacheCreateTok: number}>>}
  */
-export async function parseClaudeFiles(files) {
+export async function parseClaudeFiles(files, onRecord = null) {
   const deduped = new Map(); // key → { file, ts, ...entry }
   const noKey = [];          // dedup 키를 만들 수 없는 라인은 전부 집계
 
@@ -62,6 +63,7 @@ export async function parseClaudeFiles(files) {
       if (!line.trim()) continue;
       try {
         const obj = JSON.parse(line);
+        onRecord?.(obj, file);
         if (obj.type !== 'assistant') continue;
         const msg = obj.message;
         if (!msg?.usage) continue;

package/src/parsers/codex.js

@@ -130,9 +130,10 @@ function resolveIncrement(total, last, previous) {
 /**
  * Codex rollout 파일들을 턴 증분 단위 usage 목록으로 파싱한다.
  * @param {string[]} files JSONL 파일 경로 목록 (정렬된 순서 — sessions를 archived보다 먼저)
+ * @param {((record: object, file: string) => void)|null} [onRecord] 파싱한 줄마다 부르는 수집기(예외를 던지지 않아야 한다)
  * @returns {Promise<Array<{date: string, model: string, inputTok: number, outputTok: number, cacheReadTok: number, cacheCreateTok: number}>>}
  */
-export async function parseCodexFiles(files) {
+export async function parseCodexFiles(files, onRecord = null) {
   const entries = [];
   const seenKeys = new Set(); // 파일 간 replay/복제 dedup
 
@@ -158,6 +159,7 @@ export async function parseCodexFiles(files) {
       if (!line.trim()) continue;
       try {
         const obj = JSON.parse(line);
+        onRecord?.(obj, file);
         const payload = obj.payload;
         if (!payload) continue;