tokentracker-cli 0.5.65 → 0.5.66

package/dashboard/dist/assets/use-limits-display-prefs-B4BIb5sR.js

@@ -0,0 +1 @@
+import{r as a}from"./main-XWVaG1Bp.js";const d=["claude","codex","cursor","gemini","kiro","copilot","antigravity"],v={claude:"Claude",codex:"Codex",cursor:"Cursor",gemini:"Gemini",kiro:"Kiro",copilot:"GitHub Copilot",antigravity:"Antigravity"},k={claude:"/brand-logos/claude-code.svg",codex:"/brand-logos/codex.svg",cursor:"/brand-logos/cursor.svg",gemini:"/brand-logos/gemini.svg",kiro:"/brand-logos/kiro.svg",copilot:"/brand-logos/copilot.svg",antigravity:"/brand-logos/antigravity.svg"},l="tt.limits.providerOrder",g="tt.limits.providerVisibility";function y(){if(typeof window>"u")return[...d];try{const r=window.localStorage.getItem(l);if(!r)return[...d];const s=JSON.parse(r);if(!Array.isArray(s))return[...d];const n=s.filter(c=>d.includes(c));for(const c of d)n.includes(c)||n.push(c);return n}catch{return[...d]}}function m(){const r=Object.fromEntries(d.map(s=>[s,!0]));if(typeof window>"u")return r;try{const s=window.localStorage.getItem(g);if(!s)return r;const n=JSON.parse(s);if(!n||typeof n!="object")return r;const c={...r};for(const u of d)typeof n[u]=="boolean"&&(c[u]=n[u]);return c}catch{return r}}function C(){const[r,s]=a.useState(y),[n,c]=a.useState(m);a.useEffect(()=>{if(!(typeof window>"u"))try{window.localStorage.setItem(l,JSON.stringify(r))}catch{}},[r]),a.useEffect(()=>{if(!(typeof window>"u"))try{window.localStorage.setItem(g,JSON.stringify(n))}catch{}},[n]),a.useEffect(()=>{if(typeof window>"u")return;const o=t=>{t.key===l&&s(y()),t.key===g&&c(m())};return window.addEventListener("storage",o),()=>window.removeEventListener("storage",o)},[]);const u=a.useCallback(o=>{c(t=>({...t,[o]:!t[o]}))},[]),b=a.useCallback(o=>{s(t=>{const e=t.indexOf(o);if(e<=0)return t;const i=[...t];return[i[e-1],i[e]]=[i[e],i[e-1]],i})},[]),p=a.useCallback(o=>{s(t=>{const e=t.indexOf(o);if(e<0||e>=t.length-1)return t;const i=[...t];return[i[e],i[e+1]]=[i[e+1],i[e]],i})},[]),O=a.useCallback((o,t)=>{o!==t&&s(e=>{const i=e.indexOf(o),w=e.indexOf(t);if(i<0||w<0)return e;const f=[...e],[E]=f.splice(i,1);return f.splice(w,0,E),f})},[]),x=a.useCallback(()=>{s([...d]),c(Object.fromEntries(d.map(o=>[o,!0])))},[]),I=a.useMemo(()=>r.filter(o=>n[o]!==!1),[r,n]);return{order:r,visibility:n,visibleOrdered:I,toggle:u,moveUp:b,moveDown:p,moveToward:O,reset:x}}export{k as L,v as a,C as u};

package/dashboard/dist/assets/{use-usage-limits-BLkA4tpF.js → use-usage-limits-DOtf83Kb.js}

@@ -1 +1 @@
-import{r,aM as l}from"./main-DDaoGWcU.js";function y(i){const[o,a]=r.useState(null),[u,s]=r.useState(null),[c,f]=r.useState(!0),n=!!i?.initialRefresh,g=r.useCallback(async()=>{try{const e=await l({refresh:!0});a(e&&typeof e=="object"?e:null),s(null)}catch(e){s(e?.message||String(e))}},[]);return r.useEffect(()=>{let e=!1;return(async()=>{try{const t=await l(n?{refresh:!0}:{});if(e)return;a(t&&typeof t=="object"?t:null),s(null)}catch(t){if(e)return;s(t?.message||String(t))}finally{e||f(!1)}})(),()=>{e=!0}},[n]),{data:o,error:u,isLoading:c,refresh:g}}export{y as u};
+import{r,aM as l}from"./main-XWVaG1Bp.js";function y(i){const[o,a]=r.useState(null),[u,s]=r.useState(null),[c,f]=r.useState(!0),n=!!i?.initialRefresh,g=r.useCallback(async()=>{try{const e=await l({refresh:!0});a(e&&typeof e=="object"?e:null),s(null)}catch(e){s(e?.message||String(e))}},[]);return r.useEffect(()=>{let e=!1;return(async()=>{try{const t=await l(n?{refresh:!0}:{});if(e)return;a(t&&typeof t=="object"?t:null),s(null)}catch(t){if(e)return;s(t?.message||String(t))}finally{e||f(!1)}})(),()=>{e=!0}},[n]),{data:o,error:u,isLoading:c,refresh:g}}export{y as u};

package/dashboard/dist/brand-logos/copilot.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>GithubCopilot</title><path d="M19.245 5.364c1.322 1.36 1.877 3.216 2.11 5.817.622 0 1.2.135 1.592.654l.73.964c.21.278.323.61.323.955v2.62c0 .339-.173.669-.453.868C20.239 19.602 16.157 21.5 12 21.5c-4.6 0-9.205-2.583-11.547-4.258-.28-.2-.452-.53-.453-.868v-2.62c0-.345.113-.679.321-.956l.73-.963c.392-.517.974-.654 1.593-.654l.029-.297c.25-2.446.81-4.213 2.082-5.52 2.461-2.54 5.71-2.851 7.146-2.864h.198c1.436.013 4.685.323 7.146 2.864zm-7.244 4.328c-.284 0-.613.016-.962.05-.123.447-.305.85-.57 1.108-1.05 1.023-2.316 1.18-2.994 1.18-.638 0-1.306-.13-1.851-.464-.516.165-1.012.403-1.044.996a65.882 65.882 0 00-.063 2.884l-.002.48c-.002.563-.005 1.126-.013 1.69.002.326.204.63.51.765 2.482 1.102 4.83 1.657 6.99 1.657 2.156 0 4.504-.555 6.985-1.657a.854.854 0 00.51-.766c.03-1.682.006-3.372-.076-5.053-.031-.596-.528-.83-1.046-.996-.546.333-1.212.464-1.85.464-.677 0-1.942-.157-2.993-1.18-.266-.258-.447-.661-.57-1.108-.32-.032-.64-.049-.96-.05zm-2.525 4.013c.539 0 .976.426.976.95v1.753c0 .525-.437.95-.976.95a.964.964 0 01-.976-.95v-1.752c0-.525.437-.951.976-.951zm5 0c.539 0 .976.426.976.95v1.753c0 .525-.437.95-.976.95a.964.964 0 01-.976-.95v-1.752c0-.525.437-.951.976-.951zM7.635 5.087c-1.05.102-1.935.438-2.385.906-.975 1.037-.765 3.668-.21 4.224.405.394 1.17.657 1.995.657h.09c.649-.013 1.785-.176 2.73-1.11.435-.41.705-1.433.675-2.47-.03-.834-.27-1.52-.63-1.813-.39-.336-1.275-.482-2.265-.394zm6.465.394c-.36.292-.6.98-.63 1.813-.03 1.037.24 2.06.675 2.47.968.957 2.136 1.104 2.776 1.11h.044c.825 0 1.59-.263 1.995-.657.555-.556.765-3.187-.21-4.224-.45-.468-1.335-.804-2.385-.906-.99-.088-1.875.058-2.265.394zM12 7.615c-.24 0-.525.015-.84.044.03.16.045.336.06.526l-.001.159a2.94 2.94 0 01-.014.25c.225-.022.425-.027.612-.028h.366c.187 0 .387.006.612.028-.015-.146-.015-.277-.015-.409.015-.19.03-.365.06-.526a9.29 9.29 0 00-.84-.044z"></path></svg>

package/dashboard/dist/index.html

@@ -135,8 +135,8 @@
         ]
       }
     </script>
-    <script type="module" crossorigin src="/assets/main-DDaoGWcU.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/main-DYCIFB2M.css">
+    <script type="module" crossorigin src="/assets/main-XWVaG1Bp.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/main-DHsb2wcd.css">
   </head>
   <body>
     <main class="aeo-seed-content" aria-label="Token Tracker AI-readable summary">

package/dashboard/dist/share.html

@@ -51,8 +51,8 @@
         "description": "Shareable Token Tracker dashboard snapshot."
       }
     </script>
-    <script type="module" crossorigin src="/assets/main-DDaoGWcU.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/main-DYCIFB2M.css">
+    <script type="module" crossorigin src="/assets/main-XWVaG1Bp.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/main-DHsb2wcd.css">
   </head>
   <body>
     <main class="aeo-seed-content" aria-label="Token Tracker share page summary">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokentracker-cli",
-  "version": "0.5.65",
+  "version": "0.5.66",
   "description": "Token usage tracker for AI agent CLIs (Claude Code, Codex, Cursor, Kiro, Gemini, OpenCode, OpenClaw, Hermes)",
   "main": "src/cli.js",
   "bin": {

package/src/commands/status.js

@@ -13,6 +13,7 @@ const {
 } = require("../lib/gemini-config");
 const { resolveOpencodeConfigDir, isOpencodePluginInstalled } = require("../lib/opencode-config");
 const { collectLocalSubscriptions } = require("../lib/subscriptions");
+const { describeCopilotOtelStatus, readCopilotOauthToken } = require("../lib/usage-limits");
 const { normalizeState: normalizeUploadState } = require("../lib/upload-throttle");
 const { collectTrackerDiagnostics } = require("../lib/diagnostics");
 const { probeOpenclawHookState } = require("../lib/openclaw-hook");
@@ -111,6 +112,10 @@ async function cmdStatus(argv = []) {
   const subscriptionLines =
     subscriptions.length > 0 ? subscriptions.map(formatSubscriptionLine) : [];
 
+  const copilotToken = readCopilotOauthToken({ home });
+  const copilotOtel = describeCopilotOtelStatus({ home, env: process.env });
+  const copilotLines = formatCopilotLines({ token: copilotToken, otel: copilotOtel });
+
   process.stdout.write(
     [
       "Status:",
@@ -133,6 +138,7 @@ async function cmdStatus(argv = []) {
       `- Opencode plugin: ${opencodePluginConfigured ? "set" : "unset"}`,
       `- OpenClaw session plugin: ${openclawSessionPluginState?.configured ? "set" : "unset"}`,
       `- OpenClaw hook (legacy): ${openclawHookState?.configured ? "set" : "unset"}`,
+      ...copilotLines,
       ...subscriptionLines,
       "",
     ]
@@ -141,6 +147,29 @@ async function cmdStatus(argv = []) {
   );
 }
 
+function formatCopilotLines({ token, otel }) {
+  if (!token && !otel.otel_has_files) return [];
+  const limitsState = token ? "set (via GitHub OAuth)" : "unset (no Copilot OAuth token found)";
+  const usageState = otel.otel_has_files
+    ? `set (${otel.otel_path || otel.otel_default_dir})`
+    : otel.otel_enabled
+      ? "enabled but no files yet"
+      : "unset (OTEL export not enabled)";
+  const lines = [
+    `- GitHub Copilot limits: ${limitsState}`,
+    `- GitHub Copilot usage (OTEL): ${usageState}`,
+  ];
+  if (!otel.otel_has_files) {
+    lines.push(
+      "    To track Copilot token usage, add to your shell profile:",
+      "      export COPILOT_OTEL_ENABLED=true",
+      "      export COPILOT_OTEL_EXPORTER_TYPE=file",
+      `      export COPILOT_OTEL_FILE_EXPORTER_PATH="${otel.otel_default_dir}/copilot-otel-$(date +%Y%m%d).jsonl"`,
+    );
+  }
+  return lines;
+}
+
 function formatSubscriptionLine(entry = {}) {
   const tool = String(entry.tool || "");
   const provider = String(entry.provider || "");

package/src/commands/sync.js

@@ -14,6 +14,7 @@ const {
   resolveKiroDbPath,
   resolveKiroJsonlPath,
   resolveHermesDbPath,
+  resolveCopilotOtelPaths,
   parseRolloutIncremental,
   parseClaudeIncremental,
   parseGeminiIncremental,
@@ -23,6 +24,7 @@ const {
   parseCursorApiIncremental,
   parseKiroIncremental,
   parseHermesIncremental,
+  parseCopilotIncremental,
 } = require("../lib/rollout");
 const { createProgress, renderBar, formatNumber, formatBytes } = require("../lib/progress");
 const {
@@ -39,6 +41,8 @@ const { purgeProjectUsage } = require("../lib/project-usage-purge");
 const { resolveTrackerPaths } = require("../lib/tracker-paths");
 const { resolveRuntimeConfig } = require("../lib/runtime-config");
 
+const CURSOR_UNKNOWN_MIGRATION_KEY = "cursorUnknownPurge_2026_04";
+
 async function cmdSync(argv) {
   const opts = parseArgs(argv);
   const home = os.homedir();
@@ -259,6 +263,13 @@ async function cmdSync(argv) {
     }
 
     // ── Cursor (API-based) ──
+    // One-time migration: earlier CLI versions mis-parsed the Cursor CSV after
+    // Cursor inserted new "Cloud Agent ID"/"Automation ID" columns, writing
+    // cursor records under model="unknown". Purge those local buckets, emit
+    // zero retractions so the cloud upserts overwrite them to zero, and reset
+    // the incremental cursor so the fixed parser re-fetches all affected rows.
+    await migrateCursorUnknownBuckets({ cursors, queuePath });
+
     let cursorResult = { recordsProcessed: 0, eventsAggregated: 0, bucketsQueued: 0 };
     if (isCursorInstalled({ home })) {
       const cursorAuth = extractCursorSessionToken({ home });
@@ -343,6 +354,28 @@ async function cmdSync(argv) {
       });
     }
 
+    // ── GitHub Copilot CLI (OTEL JSONL files) ──
+    let copilotResult = { recordsProcessed: 0, eventsAggregated: 0, bucketsQueued: 0 };
+    const copilotPaths = resolveCopilotOtelPaths(process.env);
+    if (copilotPaths.length > 0) {
+      if (progress?.enabled) {
+        progress.start(`Parsing Copilot ${renderBar(0)} | buckets 0`);
+      }
+      copilotResult = await parseCopilotIncremental({
+        otelPaths: copilotPaths,
+        cursors,
+        queuePath,
+        env: process.env,
+        onProgress: (p) => {
+          if (!progress?.enabled) return;
+          const pct = p.total > 0 ? p.index / p.total : 1;
+          progress.update(
+            `Parsing Copilot ${renderBar(pct)} ${formatNumber(p.index)}/${formatNumber(p.total)} files | buckets ${formatNumber(p.bucketsQueued)}`,
+          );
+        },
+      });
+    }
+
     if (cursors?.projectHourly?.projects && projectQueuePath && projectQueueStatePath) {
       for (const [projectKey, meta] of Object.entries(cursors.projectHourly.projects)) {
         if (!meta || typeof meta !== "object") continue;
@@ -419,7 +452,8 @@ async function cmdSync(argv) {
         opencodeResult.filesProcessed +
         cursorResult.recordsProcessed +
         kiroResult.recordsProcessed +
-        hermesResult.recordsProcessed;
+        hermesResult.recordsProcessed +
+        copilotResult.recordsProcessed;
       const totalBuckets =
         parseResult.bucketsQueued +
         openclawResult.bucketsQueued +
@@ -428,7 +462,8 @@ async function cmdSync(argv) {
         opencodeResult.bucketsQueued +
         cursorResult.bucketsQueued +
         kiroResult.bucketsQueued +
-        hermesResult.bucketsQueued;
+        hermesResult.bucketsQueued +
+        copilotResult.bucketsQueued;
       process.stdout.write(
         [
           "Sync finished:",
@@ -473,7 +508,7 @@ function parseArgs(argv) {
   return out;
 }
 
-module.exports = { cmdSync };
+module.exports = { cmdSync, migrateCursorUnknownBuckets, CURSOR_UNKNOWN_MIGRATION_KEY };
 
 function normalizeString(value) {
   if (typeof value !== "string") return null;
@@ -838,3 +873,46 @@ async function readQueueBatch(queuePath, startOffset, maxBuckets) {
   stream.close?.();
   return { buckets: Array.from(bucketMap.values()), nextOffset: offset };
 }
+
+async function migrateCursorUnknownBuckets({ cursors, queuePath }) {
+  if (!cursors || typeof cursors !== "object") return;
+  cursors.migrations = cursors.migrations || {};
+  if (cursors.migrations[CURSOR_UNKNOWN_MIGRATION_KEY]) return;
+
+  const buckets = cursors.hourly?.buckets;
+  if (!buckets || typeof buckets !== "object") {
+    cursors.migrations[CURSOR_UNKNOWN_MIGRATION_KEY] = new Date().toISOString();
+    return;
+  }
+
+  const retractions = [];
+  for (const key of Object.keys(buckets)) {
+    if (!key.startsWith("cursor|unknown|")) continue;
+    const hourStart = key.split("|").slice(2).join("|");
+    retractions.push(
+      JSON.stringify({
+        source: "cursor",
+        model: "unknown",
+        hour_start: hourStart,
+        input_tokens: 0,
+        cached_input_tokens: 0,
+        cache_creation_input_tokens: 0,
+        output_tokens: 0,
+        reasoning_output_tokens: 0,
+        total_tokens: 0,
+        conversation_count: 0,
+      }),
+    );
+    delete buckets[key];
+  }
+
+  if (retractions.length > 0) {
+    await ensureDir(path.dirname(queuePath));
+    await fs.appendFile(queuePath, retractions.join("\n") + "\n");
+    if (cursors.cursorApi) {
+      cursors.cursorApi.lastRecordTimestamp = null;
+    }
+  }
+
+  cursors.migrations[CURSOR_UNKNOWN_MIGRATION_KEY] = new Date().toISOString();
+}

package/src/lib/cursor-config.js

@@ -220,62 +220,61 @@ function fetchUrlRaw({ urlStr, cookie, timeoutMs }) {
 /**
  * Parse Cursor usage CSV into structured records.
  *
- * New format columns:
- *   Date, Kind, Model, Max Mode, Input (w/ Cache Write), Input (w/o Cache Write),
- *   Cache Read, Output Tokens, Total Tokens, Cost
+ * Column order has changed multiple times (e.g. new "Cloud Agent ID",
+ * "Automation ID" columns inserted before "Kind"). Resolve columns by
+ * header name instead of fixed index so the parser keeps working across
+ * future Cursor updates.
  *
- * Old format columns:
- *   Date, Model, Input (w/ Cache Write), Input (w/o Cache Write),
- *   Cache Read, Output Tokens, Total Tokens, Cost, Cost to you
+ * Known required columns: Date, Model, Input (w/ Cache Write),
+ * Input (w/o Cache Write), Cache Read, Output Tokens, Total Tokens, Cost.
+ * Optional: Kind, Max Mode.
  */
 function parseCursorCsv(csvText) {
   const lines = csvText.split("\n").filter((l) => l.trim().length > 0);
   if (lines.length < 2) return [];
 
-  const header = lines[0];
-  const isNewFormat = header.includes("Kind");
+  const headerFields = parseCsvLine(lines[0]).map((f) => stripQuotes(f));
+  const columnIndex = new Map();
+  for (let i = 0; i < headerFields.length; i++) {
+    columnIndex.set(headerFields[i], i);
+  }
+
+  const dateIdx = columnIndex.get("Date");
+  const modelIdx = columnIndex.get("Model");
+  const inputWithIdx = columnIndex.get("Input (w/ Cache Write)");
+  const inputWithoutIdx = columnIndex.get("Input (w/o Cache Write)");
+  const cacheReadIdx = columnIndex.get("Cache Read");
+  const outputIdx = columnIndex.get("Output Tokens");
+  const totalIdx = columnIndex.get("Total Tokens");
+  const costIdx = columnIndex.get("Cost");
+  const kindIdx = columnIndex.get("Kind");
+  const maxModeIdx = columnIndex.get("Max Mode");
+
+  const required = [dateIdx, modelIdx, inputWithIdx, inputWithoutIdx, cacheReadIdx, outputIdx, totalIdx, costIdx];
+  if (required.some((idx) => idx === undefined)) return [];
+
+  const minFields = Math.max(...required) + 1;
 
   const records = [];
   for (let i = 1; i < lines.length; i++) {
     const fields = parseCsvLine(lines[i]);
-    if (!fields || fields.length < 8) continue;
-
-    let record;
-    if (isNewFormat) {
-      // Date,Kind,Model,Max Mode,Input (w/ Cache Write),Input (w/o Cache Write),Cache Read,Output Tokens,Total Tokens,Cost
-      const inputWithCache = toNum(fields[4]);
-      const inputWithoutCache = toNum(fields[5]);
-      record = {
-        date: stripQuotes(fields[0]),
-        kind: stripQuotes(fields[1]),
-        model: stripQuotes(fields[2]),
-        maxMode: stripQuotes(fields[3]),
-        inputTokens: inputWithoutCache,
-        cacheWriteTokens: Math.max(0, inputWithCache - inputWithoutCache),
-        cacheReadTokens: toNum(fields[6]),
-        outputTokens: toNum(fields[7]),
-        totalTokens: toNum(fields[8]),
-        cost: toFloat(fields[9]),
-      };
-    } else {
-      // Date,Model,Input (w/ Cache Write),Input (w/o Cache Write),Cache Read,Output Tokens,Total Tokens,Cost,Cost to you
-      const inputWithCache = toNum(fields[2]);
-      const inputWithoutCache = toNum(fields[3]);
-      record = {
-        date: stripQuotes(fields[0]),
-        kind: "unknown",
-        model: stripQuotes(fields[1]),
-        maxMode: "No",
-        inputTokens: inputWithoutCache,
-        cacheWriteTokens: Math.max(0, inputWithCache - inputWithoutCache),
-        cacheReadTokens: toNum(fields[4]),
-        outputTokens: toNum(fields[5]),
-        totalTokens: toNum(fields[6]),
-        cost: toFloat(fields[7]),
-      };
-    }
+    if (!fields || fields.length < minFields) continue;
+
+    const inputWithCache = toNum(fields[inputWithIdx]);
+    const inputWithoutCache = toNum(fields[inputWithoutIdx]);
+    const record = {
+      date: stripQuotes(fields[dateIdx]),
+      kind: kindIdx !== undefined ? stripQuotes(fields[kindIdx]) : "unknown",
+      model: stripQuotes(fields[modelIdx]),
+      maxMode: maxModeIdx !== undefined ? stripQuotes(fields[maxModeIdx]) : "No",
+      inputTokens: inputWithoutCache,
+      cacheWriteTokens: Math.max(0, inputWithCache - inputWithoutCache),
+      cacheReadTokens: toNum(fields[cacheReadIdx]),
+      outputTokens: toNum(fields[outputIdx]),
+      totalTokens: toNum(fields[totalIdx]),
+      cost: toFloat(fields[costIdx]),
+    };
 
-    // Skip records with no tokens
     if (record.totalTokens <= 0 && record.inputTokens <= 0 && record.outputTokens <= 0) continue;
 
     records.push(record);

package/src/lib/rollout.js

@@ -2999,6 +2999,196 @@ async function parseHermesIncremental({ dbPath, cursors, queuePath, onProgress }
   return { recordsProcessed: rows.length, eventsAggregated, bucketsQueued };
 }
 
+// ─────────────────────────────────────────────────────────────────────────────
+// GitHub Copilot CLI — OpenTelemetry JSONL exporter
+// User must opt in by setting:
+//   COPILOT_OTEL_ENABLED=true
+//   COPILOT_OTEL_EXPORTER_TYPE=file
+//   COPILOT_OTEL_FILE_EXPORTER_PATH=$HOME/.copilot/otel/copilot-otel-...jsonl
+// We scan the default directory plus the env-overridden path.
+// ─────────────────────────────────────────────────────────────────────────────
+
+function resolveCopilotOtelPaths(env = process.env) {
+  const home = require("node:os").homedir();
+  const paths = new Set();
+  const defaultDir = path.join(home, ".copilot", "otel");
+  if (fssync.existsSync(defaultDir)) {
+    try {
+      for (const entry of fssync.readdirSync(defaultDir)) {
+        if (entry.endsWith(".jsonl")) paths.add(path.join(defaultDir, entry));
+      }
+    } catch (_e) {}
+  }
+  const explicit = env.COPILOT_OTEL_FILE_EXPORTER_PATH;
+  if (typeof explicit === "string" && explicit.trim() && fssync.existsSync(explicit)) {
+    paths.add(explicit);
+  }
+  return Array.from(paths).sort();
+}
+
+function isCopilotChatSpan(record) {
+  if (!record || record.type !== "span") return false;
+  const opName = record?.attributes?.["gen_ai.operation.name"];
+  if (opName === "chat") return true;
+  if (typeof record.name === "string" && record.name.startsWith("chat ")) return true;
+  return false;
+}
+
+function copilotOtelTimeToMs(value) {
+  if (!Array.isArray(value) || value.length < 2) return null;
+  const seconds = Number(value[0]);
+  const nanos = Number(value[1]);
+  if (!Number.isFinite(seconds)) return null;
+  const ns = Number.isFinite(nanos) ? nanos : 0;
+  return Math.round(seconds * 1000 + ns / 1_000_000);
+}
+
+function pickCopilotModel(attrs) {
+  const candidates = [attrs?.["gen_ai.response.model"], attrs?.["gen_ai.request.model"]];
+  for (const c of candidates) {
+    if (typeof c === "string" && c.trim()) return c.trim();
+  }
+  return null;
+}
+
+async function parseCopilotIncremental({ otelPaths, cursors, queuePath, onProgress, env } = {}) {
+  await ensureDir(path.dirname(queuePath));
+  const copilotState = cursors.copilot && typeof cursors.copilot === "object" ? cursors.copilot : {};
+  const seenIds = new Set(Array.isArray(copilotState.seenIds) ? copilotState.seenIds : []);
+  const fileOffsets =
+    copilotState.fileOffsets && typeof copilotState.fileOffsets === "object"
+      ? { ...copilotState.fileOffsets }
+      : {};
+
+  const files = Array.isArray(otelPaths) && otelPaths.length > 0
+    ? otelPaths
+    : resolveCopilotOtelPaths(env || process.env);
+  if (files.length === 0) {
+    cursors.copilot = { ...copilotState, seenIds: Array.from(seenIds), fileOffsets, updatedAt: new Date().toISOString() };
+    return { recordsProcessed: 0, eventsAggregated: 0, bucketsQueued: 0 };
+  }
+
+  const hourlyState = normalizeHourlyState(cursors?.hourly);
+  const touchedBuckets = new Set();
+  const cb = typeof onProgress === "function" ? onProgress : null;
+  let recordsProcessed = 0;
+  let eventsAggregated = 0;
+
+  for (let fileIdx = 0; fileIdx < files.length; fileIdx++) {
+    const filePath = files[fileIdx];
+    let stat;
+    try {
+      stat = fssync.statSync(filePath);
+    } catch (_e) {
+      continue;
+    }
+    const prevEntry = fileOffsets[filePath] || {};
+    const prevSize = Number(prevEntry.size) || 0;
+    const prevIno = prevEntry.ino;
+    // Re-read from start if (a) file shrunk (truncate/rewrite in place) or
+    // (b) inode changed (rotator deleted + recreated at same path). Without
+    // the inode check, a rotator producing a same-or-larger file would leave
+    // the old offset stuck and skip the new file's prefix forever.
+    const inodeChanged = typeof prevIno === "number" && prevIno !== stat.ino;
+    const startOffset = stat.size < prevSize || inodeChanged ? 0 : prevSize;
+    if (stat.size <= startOffset) continue;
+
+    let stream;
+    try {
+      stream = fssync.createReadStream(filePath, { encoding: "utf8", start: startOffset });
+    } catch (_e) {
+      continue;
+    }
+    const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+
+    for await (const line of rl) {
+      if (!line || !line.trim()) continue;
+      let record;
+      try {
+        record = JSON.parse(line);
+      } catch (_e) {
+        continue;
+      }
+      recordsProcessed++;
+      if (!isCopilotChatSpan(record)) continue;
+
+      const traceId = record?.traceId || "";
+      const spanId = record?.spanId || "";
+      const dedupKey = traceId && spanId ? `${traceId}:${spanId}` : null;
+      if (dedupKey && seenIds.has(dedupKey)) continue;
+
+      const attrs = record.attributes || {};
+      const inputRaw = toNonNegativeInt(attrs["gen_ai.usage.input_tokens"]);
+      const output = toNonNegativeInt(attrs["gen_ai.usage.output_tokens"]);
+      const cacheRead = toNonNegativeInt(attrs["gen_ai.usage.cache_read.input_tokens"]);
+      const cacheWrite = toNonNegativeInt(attrs["gen_ai.usage.cache_write.input_tokens"]);
+      const reasoning = toNonNegativeInt(attrs["gen_ai.usage.reasoning.output_tokens"]);
+      // OTEL input_tokens INCLUDES cache_read — subtract per project convention
+      const cacheReadClamped = Math.min(cacheRead, inputRaw);
+      const input = Math.max(0, inputRaw - cacheReadClamped);
+      const totalInteresting = input + output + cacheReadClamped + cacheWrite + reasoning;
+      // Drop empty rows unless cache-only
+      if (totalInteresting === 0) continue;
+
+      const tsMs = copilotOtelTimeToMs(record.endTime) || copilotOtelTimeToMs(record.startTime);
+      if (!tsMs) continue;
+      const tsIso = new Date(tsMs).toISOString();
+      const bucketStart = toUtcHalfHourStart(tsIso);
+      if (!bucketStart) continue;
+
+      const model = normalizeModelInput(pickCopilotModel(attrs)) || "github-copilot";
+
+      const delta = {
+        input_tokens: input,
+        cached_input_tokens: cacheReadClamped,
+        cache_creation_input_tokens: cacheWrite,
+        output_tokens: output,
+        reasoning_output_tokens: reasoning,
+        total_tokens: input + output + cacheReadClamped + cacheWrite + reasoning,
+        conversation_count: 1,
+      };
+
+      const bucket = getHourlyBucket(hourlyState, "copilot", model, bucketStart);
+      addTotals(bucket.totals, delta);
+      touchedBuckets.add(bucketKey("copilot", model, bucketStart));
+      eventsAggregated++;
+      if (dedupKey) seenIds.add(dedupKey);
+
+      if (cb) {
+        cb({
+          index: fileIdx + 1,
+          total: files.length,
+          recordsProcessed,
+          eventsAggregated,
+          bucketsQueued: touchedBuckets.size,
+        });
+      }
+    }
+
+    // Re-stat after readline drains: file may have been appended during the
+    // parse loop. Without this, those new lines would be replayed next run
+    // (dedup catches records with traceId+spanId, but spans missing either
+    // would be double-counted).
+    let postStat = stat;
+    try {
+      postStat = fssync.statSync(filePath);
+    } catch (_e) {}
+    fileOffsets[filePath] = { size: postStat.size, mtimeMs: postStat.mtimeMs, ino: postStat.ino };
+  }
+
+  // Cap dedup set to last 10k IDs to bound state size
+  const seenArr = Array.from(seenIds);
+  const cappedSeen = seenArr.length > 10_000 ? seenArr.slice(seenArr.length - 10_000) : seenArr;
+
+  const bucketsQueued = await enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets });
+  const updatedAt = new Date().toISOString();
+  hourlyState.updatedAt = updatedAt;
+  cursors.hourly = hourlyState;
+  cursors.copilot = { ...copilotState, seenIds: cappedSeen, fileOffsets, updatedAt };
+
+  return { recordsProcessed, eventsAggregated, bucketsQueued };
+}
+
 module.exports = {
   listRolloutFiles,
   listClaudeProjectFiles,
@@ -3008,6 +3198,7 @@ module.exports = {
   resolveKiroDbPath,
   resolveKiroJsonlPath,
   resolveHermesDbPath,
+  resolveCopilotOtelPaths,
   parseRolloutIncremental,
   parseClaudeIncremental,
   parseGeminiIncremental,
@@ -3017,4 +3208,5 @@ module.exports = {
   parseCursorApiIncremental,
   parseKiroIncremental,
   parseHermesIncremental,
+  parseCopilotIncremental,
 };