letmecode 0.1.21 → 0.1.23

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Devforth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,32 +1,51 @@
-# letmecode - Discover your detailed agent ussage Codex | Claude
+# LetMeCode
 
-Ussage:
+Terminal AI real-money value usage dashboard for Codex, Claude, Copilot, and Antigravity.
+
+See your real $ usage data, inspect limits, see daily activity, and model-level token totals in a terminal UI.
+
+## Quick start
 
 ```bash
 npx -y letmecode@latest
 ```
 
+## Privacy and anonymous reporting
 
-Preview:
-
-<img width="2301" height="1397" alt="image" src="https://github.com/user-attachments/assets/c37d6847-9926-4977-8592-5cab8346a86f" />
+By default, `letmecode` sends an anonymous usage summary which powers [aggregated real-world plans comparison](https://devforth.io/agents-for-code/).
 
+The report includes aggregated limit-window percentages, token counts, plan/window metadata, the `letmecode` version, and a hashed user identifier when a provider exposes one. It does not send prompt content, usernames, email addresses, company names, or other directly identifiable personal information.
 
+To disable anonymous usage reporting:
 
+```bash
+npx -y letmecode@latest -- --no-usage
+```
 
-## Advanced ussage
+## Options
 
+```bash
+npx -y letmecode@latest -- --help
+npx -y letmecode@latest -- --log-to ./letmecode.log
 ```
-npx -y letmecode -- -h
-npx -y letmecode -- --log-to log.txt
-```
 
-`--log-to` now records Claude binary discovery, session-root selection, parsed transcript file summaries, entrypoint matching, raw `/usage` output, and live-window event matching so zero-token windows are diagnosable.
+`--log-to` records provider discovery details and raw usage parsing diagnostics so empty or unexpected windows are easier to debug.
+
+## Providers
+
+- Codex
+- Claude
+- Copilot
+- Antigravity
+
+## Preview
 
+<img width="2301" height="1397" alt="letmecode preview" src="https://github.com/user-attachments/assets/c37d6847-9926-4977-8592-5cab8346a86f" />
 
 ## Local development
 
 ```bash
 pnpm install
+pnpm test
 pnpm start
 ```

package/ink-app/dist/cli-options.js

@@ -4,6 +4,7 @@ export function parseCliOptions(argv) {
     let showHelp = false;
     let verbose = false;
     let logToPath;
+    let enableAnonymousUsageReporting = true;
     for (let index = 0; index < argv.length; index += 1) {
         const argument = argv[index] ?? "";
         if (argument === "-h" || argument === "--help") {
@@ -29,9 +30,13 @@ export function parseCliOptions(argv) {
                 throw new Error("Expected a file path after --log-to=.");
             }
             logToPath = value;
+            continue;
+        }
+        if (argument === "--no-usage") {
+            enableAnonymousUsageReporting = false;
         }
     }
-    return { showHelp, verbose, logToPath };
+    return { showHelp, verbose, logToPath, enableAnonymousUsageReporting };
 }
 export function buildProviderStatsOptions(options) {
     return {
@@ -41,7 +46,7 @@ export function buildProviderStatsOptions(options) {
 }
 export function buildHelpText() {
     return [
-        "letmecode - provider-based terminal usage dashboard",
+        "letmecode - terminal AI usage dashboard",
         "",
         "Usage:",
         "  letmecode [options]",
@@ -50,6 +55,7 @@ export function buildHelpText() {
         "  -h, --help         Show this help and exit",
         "  -v, --verbose      Show extra provider warnings",
         "  --log-to PATH      Write trace logs to PATH",
+        "  --no-usage         Disable anonymous usage reporting",
         "",
         "Controls:",
         "  [ ] / Tab          Switch providers",
@@ -64,7 +70,11 @@ export function buildHelpText() {
         "  --log-to PATH writes Claude detection details,",
         "  session root selection, parsed session file summaries, aggregated usage selection,",
         "  every candidate binary path check, the final found/not-found result,",
-        "  and the raw /usage command output plus live window matching details."
+        "  and the raw /usage command output plus live window matching details.",
+        "",
+        "Anonymous reporting:",
+        "  Enabled by default. Use --no-usage to disable the best-effort",
+        "  anonymous usage summary upload."
     ].join("\n");
 }
 export function createFileTraceLogger(logPath) {

package/ink-app/dist/index.js

@@ -96,7 +96,9 @@ function App(props) {
         setSelectedProviderId(topProvider.provider.id);
     }, [hasUserSelectedProvider, providerStates, sortedProviderStates]);
     useEffect(() => {
-        if (hasReportedAnonymousUsageRef.current || providerStates.some((state) => state.status === "loading")) {
+        if (!props.usageReportingEnabled ||
+            hasReportedAnonymousUsageRef.current ||
+            providerStates.some((state) => state.status === "loading")) {
             return;
         }
         hasReportedAnonymousUsageRef.current = true;
@@ -106,7 +108,7 @@ function App(props) {
         void reportAnonymousUsage(readyStats).catch(() => {
             // Anonymous usage reporting is best-effort and must never disturb the TUI.
         });
-    }, [providerStates]);
+    }, [props.usageReportingEnabled, providerStates]);
     useMouseClick((click) => {
         const regionId = resolveClick(click);
         if (!regionId) {
@@ -1002,7 +1004,7 @@ export function main(argv = process.argv.slice(2)) {
         restoreFullscreen();
     };
     process.once("exit", exitHandler);
-    const instance = render(_jsx(App, { statsOptions: statsOptions }), {
+    const instance = render(_jsx(App, { statsOptions: statsOptions, usageReportingEnabled: cliOptions.enableAnonymousUsageReporting }), {
         stdout: process.stdout,
         stdin: process.stdin,
         stderr: process.stderr

package/ink-app/dist/providers/claude.js

@@ -10,12 +10,26 @@ import { applyRateLimits, asRecord, buildWindowLists, createLimitWindowAggregate
 import { addDailyUsage, buildDailyUsageRows, createDailyUsageAggregates } from "./daily.js";
 import { resolveUsageRate } from "./pricing.js";
 const RATE_CARD = {
+    "claude-fable-5": { input: 10, cacheRead: 1, cacheWrite: 12.5, cacheWrite5m: 12.5, cacheWrite1h: 20, output: 50 },
     "claude-opus-4-8": { input: 5, cacheRead: 0.5, cacheWrite: 6.25, cacheWrite5m: 6.25, cacheWrite1h: 10, output: 25 },
     "claude-opus-4-7": { input: 5, cacheRead: 0.5, cacheWrite: 6.25, cacheWrite5m: 6.25, cacheWrite1h: 10, output: 25 },
     "claude-opus-4-6": { input: 5, cacheRead: 0.5, cacheWrite: 6.25, cacheWrite5m: 6.25, cacheWrite1h: 10, output: 25 },
     "claude-opus-4-5": { input: 5, cacheRead: 0.5, cacheWrite: 6.25, cacheWrite5m: 6.25, cacheWrite1h: 10, output: 25 },
     "claude-opus-4-1": { input: 15, cacheRead: 1.5, cacheWrite: 18.75, cacheWrite5m: 18.75, cacheWrite1h: 30, output: 75 },
     "claude-opus-4": { input: 15, cacheRead: 1.5, cacheWrite: 18.75, cacheWrite5m: 18.75, cacheWrite1h: 30, output: 75 },
+    "claude-sonnet-5": {
+        input: 3,
+        cacheRead: 0.3,
+        cacheWrite: 3.75,
+        cacheWrite5m: 3.75,
+        cacheWrite1h: 6,
+        output: 15,
+        // Intro pricing (~0.66x) through 2026-08-31; reverts to the standard rate above on 2026-09-01.
+        introOffer: {
+            effectiveUntilMs: Date.UTC(2026, 8, 1),
+            rate: { input: 2, cacheRead: 0.2, cacheWrite: 2.5, cacheWrite5m: 2.5, cacheWrite1h: 4, output: 10 }
+        }
+    },
     "claude-sonnet-4-6": { input: 3, cacheRead: 0.3, cacheWrite: 3.75, cacheWrite5m: 3.75, cacheWrite1h: 6, output: 15 },
     "claude-sonnet-4-5": { input: 3, cacheRead: 0.3, cacheWrite: 3.75, cacheWrite5m: 3.75, cacheWrite1h: 6, output: 15 },
     "claude-sonnet-4": { input: 3, cacheRead: 0.3, cacheWrite: 3.75, cacheWrite5m: 3.75, cacheWrite1h: 6, output: 15 },
@@ -46,12 +60,14 @@ const parsedClaudeSessionFilesCache = new Map();
 const claudeBinaryPathCache = new Map();
 const claudeUsageOutputCache = new Map();
 const claudeAuthStatusOutputCache = new Map();
+const claudeOauthCredentialsOutputCache = new Map();
 export class ClaudeUsageProvider extends UsageProviderBase {
     constructor(options = {}) {
         super(options.id ?? "claude", options.label ?? "Claude");
         this.root = path.resolve(options.root ?? os.homedir());
         this.readUsageCommandOutput = options.readUsageCommandOutput;
         this.readAuthStatusOutput = options.readAuthStatusOutput;
+        this.readOauthCredentials = options.readOauthCredentials;
         this.now = options.now ?? (() => new Date());
     }
     async getStats(options = {}) {
@@ -147,7 +163,7 @@ export class ClaudeUsageProvider extends UsageProviderBase {
         const liveLimitWindows = await buildLiveLimitWindows({
             root: this.root,
             readUsageCommandOutput: this.readUsageCommandOutput,
-            readAuthStatusOutput: this.readAuthStatusOutput,
+            readOauthCredentials: this.readOauthCredentials,
             traceLogger: options.traceLogger,
             now: this.now(),
             selectedEvents
@@ -212,14 +228,14 @@ function normalizeUsage(value) {
         inferenceGeo: String(usage.inference_geo ?? "")
     };
 }
-function resolveRate(modelId) {
-    return resolveUsageRate(RATE_CARD, modelId, 0, { prefixMatch: true });
+function resolveRate(modelId, timestampMs) {
+    return resolveUsageRate(RATE_CARD, modelId, 0, { prefixMatch: true, timestampMs });
 }
 function isInternalClaudeModel(modelId) {
     return modelId === "<synthetic>";
 }
-function creditsFor(modelId, usage) {
-    const rate = resolveRate(modelId);
+function creditsFor(modelId, usage, timestampMs) {
+    const rate = resolveRate(modelId, timestampMs);
     if (!rate) {
         return 0;
     }
@@ -233,7 +249,7 @@ function creditsFor(modelId, usage) {
         inferenceMultiplier *
         USD_TO_CREDITS);
 }
-function usageToTotals(modelId, usage) {
+function usageToTotals(modelId, usage, timestampMs) {
     const cacheWriteBreakdown = resolveClaudeCacheWriteBreakdown(usage);
     const cacheWriteInputTokens = cacheWriteBreakdown.cacheWrite5mInputTokens +
         cacheWriteBreakdown.cacheWrite1hInputTokens;
@@ -249,7 +265,7 @@ function usageToTotals(modelId, usage) {
             usage.cacheReadInputTokens +
             cacheWriteInputTokens +
             usage.outputTokens,
-        estimatedCredits: creditsFor(modelId, usage),
+        estimatedCredits: creditsFor(modelId, usage, timestampMs),
         eventCount: 1
     };
 }
@@ -437,7 +453,7 @@ async function parseSessionFile(filePath) {
             timestampMs: eventTimeMs,
             modelId,
             usage: normalizedUsage,
-            totals: usageToTotals(modelId, normalizedUsage),
+            totals: usageToTotals(modelId, normalizedUsage, eventTimeMs),
             rateLimits
         });
     }
@@ -546,7 +562,7 @@ function mergeParsedUsageEvents(previous, next) {
         timestampMs: Math.max(normalizeTimestamp(previous.timestampMs), normalizeTimestamp(next.timestampMs)),
         modelId,
         usage,
-        totals: usageToTotals(modelId, usage),
+        totals: usageToTotals(modelId, usage, primaryEvent.timestampMs),
         rateLimits: latestEvent.rateLimits ?? previous.rateLimits ?? next.rateLimits
     };
 }
@@ -648,16 +664,16 @@ function buildClaudeCommandEnvironment() {
     };
 }
 async function buildLiveLimitWindows(options) {
-    const [usageOutput, subscriptionType] = await Promise.all([
+    const [usageOutput, credentials] = await Promise.all([
         readClaudeUsageCommandOutput(options.root, options.readUsageCommandOutput, options.traceLogger),
-        readClaudeSubscriptionType(options.root, options.readAuthStatusOutput, options.traceLogger)
+        readClaudeOauthCredentials(options.root, options.readOauthCredentials, options.traceLogger)
     ]);
     const snapshots = parseLiveUsageWindowSnapshots(usageOutput, options.now);
     traceClaude(options.traceLogger, `Parsed ${snapshots.length} live usage snapshot(s) from /usage output.`);
     if (snapshots.length === 0) {
         traceClaude(options.traceLogger, "No live usage snapshots matched the expected /usage format.");
     }
-    const resolvedPlanType = resolveClaudeLivePlanType(subscriptionType, snapshots);
+    const resolvedPlanType = resolveClaudeLivePlanType(credentials);
     traceClaude(options.traceLogger, `Resolved live plan type ${resolvedPlanType}.`);
     const primaryLimitWindows = snapshots
         .filter((snapshot) => snapshot.scope === "primary")
@@ -690,20 +706,82 @@ async function buildLiveLimitWindows(options) {
         secondaryLimitWindows
     };
 }
-function resolveClaudeLivePlanType(subscriptionType, snapshots) {
-    if (snapshots.some((snapshot) => snapshot.modelScope === "sonnet-only")) {
-        return "team_premium";
+// Reported as-is: the claude.ai OAuth `rateLimitTier` is not mapped to a friendly tier name
+// anymore, it is combined with `subscriptionType` verbatim (e.g. "team|default_claude_max_5x").
+function resolveClaudeLivePlanType(credentials) {
+    const subscriptionType = credentials?.subscriptionType;
+    if (!subscriptionType) {
+        return "live";
+    }
+    return credentials?.rateLimitTier ? `${subscriptionType}|${credentials.rateLimitTier}` : subscriptionType;
+}
+async function readClaudeOauthCredentials(root, override, traceLogger) {
+    const output = await readClaudeOauthCredentialsOutput(root, override, traceLogger);
+    const credentials = parseClaudeOauthCredentials(output);
+    if (output && !credentials) {
+        traceClaude(traceLogger, "Could not parse claude.ai OAuth credentials from credentials file.");
+    }
+    traceClaude(traceLogger, `OAuth credentials result: subscriptionType=${credentials?.subscriptionType ?? "<none>"} rateLimitTier=${credentials?.rateLimitTier ?? "<none>"}.`);
+    return credentials;
+}
+async function readClaudeOauthCredentialsOutput(root, override, traceLogger) {
+    if (override) {
+        try {
+            const output = await override();
+            traceClaude(traceLogger, "Using injected OAuth credentials override.");
+            return output;
+        }
+        catch {
+            traceClaude(traceLogger, "Injected OAuth credentials override failed.");
+            return null;
+        }
+    }
+    const credentialsPath = path.join(path.resolve(root), ".claude", ".credentials.json");
+    const cacheKey = credentialsPath;
+    const cached = claudeOauthCredentialsOutputCache.get(cacheKey);
+    if (cached) {
+        traceClaude(traceLogger, "OAuth credentials cache hit.");
+        return cached;
     }
-    return subscriptionType || "live";
+    const pending = (async () => {
+        try {
+            const output = await fs.promises.readFile(credentialsPath, { encoding: "utf8" });
+            traceClaude(traceLogger, `Read OAuth credentials from ${credentialsPath}.`);
+            return output;
+        }
+        catch {
+            traceClaude(traceLogger, `No readable OAuth credentials at ${credentialsPath}.`);
+            return null;
+        }
+    })();
+    claudeOauthCredentialsOutputCache.set(cacheKey, pending);
+    return pending;
 }
-async function readClaudeSubscriptionType(root, override, traceLogger) {
-    const output = await readClaudeAuthStatusOutput(root, override, traceLogger);
-    const subscriptionType = parseClaudeSubscriptionType(output);
-    if (output && !subscriptionType) {
-        traceClaude(traceLogger, "Could not parse subscription type from auth status output.");
-    }
-    traceClaude(traceLogger, `Subscription type result: ${subscriptionType ?? "<none>"}.`);
-    return subscriptionType;
+function parseClaudeOauthCredentials(output) {
+    if (!output) {
+        return null;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(output);
+    }
+    catch {
+        return null;
+    }
+    const oauth = asRecord(asRecord(payload)?.claudeAiOauth);
+    if (!oauth) {
+        return null;
+    }
+    const subscriptionType = typeof oauth.subscriptionType === "string" && oauth.subscriptionType.trim()
+        ? oauth.subscriptionType.trim()
+        : null;
+    const rateLimitTier = typeof oauth.rateLimitTier === "string" && oauth.rateLimitTier.trim()
+        ? oauth.rateLimitTier.trim()
+        : null;
+    if (!subscriptionType && !rateLimitTier) {
+        return null;
+    }
+    return { subscriptionType, rateLimitTier };
 }
 async function readClaudeAuthStatusOutput(root, override, traceLogger) {
     if (override) {
@@ -751,10 +829,6 @@ async function readClaudeAuthStatusOutput(root, override, traceLogger) {
     claudeAuthStatusOutputCache.set(cacheKey, pending);
     return pending;
 }
-function parseClaudeSubscriptionType(output) {
-    const snapshot = parseClaudeAuthStatusSnapshot(output);
-    return snapshot?.subscriptionType ?? null;
-}
 function parseClaudeAuthStatusSnapshot(output) {
     if (!output) {
         return null;
@@ -977,9 +1051,6 @@ function parseLiveUsageWindowSnapshots(usageOutput, now) {
             resetString: match[4]?.trim() || null
         });
     }
-    // Per-scope reset times printed by Claude. Lines like "Current week (Sonnet
-    // only)" omit the reset because it is identical to the "all models" week, so
-    // a missing reset inherits the resolved reset of the same scope.
     const resetMsByLabel = new Map();
     for (const parsed of parsedLines) {
         if (!parsed.resetString || resetMsByLabel.has(parsed.label)) {
@@ -996,14 +1067,17 @@ function parseLiveUsageWindowSnapshots(usageOutput, now) {
         if (!resetsAtMs) {
             continue;
         }
-        const isSonnetOnlyWeek = parsed.label === "week" && parsed.windowQualifier === "sonnet only";
-        const limitId = isSonnetOnlyWeek ? "current-week-sonnet-only" : `current-${parsed.label}`;
+        const isModelScopedWeek = parsed.label === "week" && parsed.windowQualifier !== "" && parsed.windowQualifier !== "all models";
+        const modelFamily = isModelScopedWeek ? parsed.windowQualifier.replace(/\s+only$/, "") : null;
+        const limitId = modelFamily
+            ? `current-week-${modelFamily.replace(/\s+/g, "-")}-only`
+            : `current-${parsed.label}`;
         snapshots.set(limitId, {
             scope: parsed.label === "session" ? "primary" : "secondary",
             label: parsed.label,
             limitId,
-            modelScope: isSonnetOnlyWeek ? "sonnet-only" : "all-models",
-            modelType: isSonnetOnlyWeek ? "sonnet only" : undefined,
+            modelFamily,
+            modelType: modelFamily ? parsed.windowQualifier : undefined,
             usedPercent: parsed.usedPercent,
             resetsAtMs,
             windowMinutes: parsed.windowMinutes
@@ -1087,10 +1161,10 @@ function buildLiveLimitWindowRow(snapshot, planType, selectedEvents, now) {
     };
 }
 function matchesClaudeLiveSnapshotModelScope(snapshot, modelId) {
-    if (snapshot.modelScope !== "sonnet-only") {
+    if (!snapshot.modelFamily) {
         return true;
     }
-    return modelId.toLowerCase().includes("sonnet");
+    return modelId.toLowerCase().includes(snapshot.modelFamily);
 }
 function buildModelUsageRowsForEvents(events) {
     const byModel = new Map();

package/ink-app/dist/providers/pricing.js

@@ -14,5 +14,10 @@ export function resolveUsageRate(rateCard, modelId, inputTokens = 0, options = {
     if (rate.longContext && inputTokens > rate.longContext.thresholdTokens) {
         return rate.longContext.rate;
     }
+    if (rate.introOffer &&
+        Number.isFinite(options.timestampMs) &&
+        options.timestampMs < rate.introOffer.effectiveUntilMs) {
+        return rate.introOffer.rate;
+    }
     return rate;
 }

package/ink-app/dist/reporting.js

@@ -64,7 +64,11 @@ function resolveReportModelType(stats, window) {
     return truncateSchemaString(stats.providerId, 128);
 }
 function resolveClaudeReportModelType(window) {
-    return window.modelType?.toLowerCase().includes("sonnet") ? "sonnet-only" : "all";
+    const modelFamily = window.modelType?.toLowerCase().replace(/\s+only$/, "").trim();
+    if (!modelFamily) {
+        return "all";
+    }
+    return truncateSchemaString(`${modelFamily.replace(/\s+/g, "-")}-only`, 128);
 }
 function resolveAntigravityReportModelType(stats, window) {
     const limitId = window.limitId.toLowerCase();

package/package.json

@@ -1,14 +1,23 @@
 {
   "name": "letmecode",
-  "version": "0.1.21",
-  "description": "Provider-based terminal usage dashboard for LetMeCode.",
-  "author": "devforth.io",
+  "version": "0.1.23",
+  "description": "Terminal AI usage dashboard for Codex, Claude, Copilot, and Antigravity.",
+  "author": "Devforth (https://devforth.io)",
   "license": "MIT",
   "packageManager": "pnpm@10.28.2",
   "type": "commonjs",
+  "main": "./dist/index.js",
   "bin": {
     "letmecode": "./bin/letmecode.js"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devforth/letmecode.git"
+  },
+  "homepage": "https://github.com/devforth/letmecode#readme",
+  "bugs": {
+    "url": "https://github.com/devforth/letmecode/issues"
+  },
   "files": [
     "bin",
     "dist",
@@ -32,9 +41,18 @@
     "test": "node --test ink-app/test/*.test.mjs"
   },
   "keywords": [
+    "ai",
+    "agents",
     "cli",
-    "ink",
+    "dashboard",
+    "usage",
+    "terminal",
+    "codex",
+    "claude",
+    "copilot",
+    "antigravity",
     "npx",
+    "ink",
     "typescript"
   ],
   "dependencies": {