tokely 0.5.1 → 0.5.2

package/README.md

@@ -24,17 +24,19 @@ tokely
 ## Usage
 
 ```bash
-tokely [--all] [--claude] [--codex] [--cursor] [--gemini] [--opencode] [--pi] [--dark] [--format png|svg|json] [--output ./heatmap-last-year.png]
+tokely [--all] [--today] [--claude] [--codex] [--cursor] [--gemini] [--opencode] [--pi] [--dark] [--format png|svg|json] [--output ./heatmap-last-year.png]
 ```
 
 By default, the CLI:
 
 - scans all supported providers
+- renders the top 4 providers with available data (priority: Claude Code → Codex → Cursor → Open Code)
 - writes `./heatmap-last-year.png`
 - infers the date window as the rolling last year ending today
 
 ## Options
 
+- `--today`: show today's usage stats in terminal
 - `--claude`: include only Claude Code data
 - `--codex`: include only Codex data
 - `--cursor`: include only Cursor data
@@ -128,8 +130,9 @@ When Claude Code falls back to `history.jsonl`, those days are rendered as activ
 
 ## Exit behavior
 
-- If no provider flags are passed, `tokely` renders every provider with available data.
-- If `--all` is passed, `tokely` loads all providers and renders one combined graph with merged totals, streaks, and model rankings.
+- By default, renders the top 4 providers with available data.
+- Priority order: Claude Code → Codex → Cursor → Open Code → Amp → Gemini CLI → Pi Coding Agent.
+- Use `--all` to merge all providers, or specify providers explicitly.
 - Pi Coding Agent usage is derived from assistant messages in Pi session logs, grouped by the model that handled each turn.
 - If provider flags are passed and a requested provider has no data, the command exits with an error.
 - If no provider has data, the command exits with an error.

package/dist/cli.js

@@ -8307,10 +8307,11 @@ var HELP_TEXT = `tokely
 Generate rolling 1-year usage heatmap image(s) (today is the latest day).
 
 Usage:
-  tokely [--all] [--amp] [--claude] [--codex] [--cursor] [--gemini] [--opencode] [--pi] [--dark] [--format png|svg|json] [--output ./heatmap-last-year.png]
+  tokely [--all] [--today] [--amp] [--claude] [--codex] [--cursor] [--gemini] [--opencode] [--pi] [--dark] [--format png|svg|json] [--output ./heatmap-last-year.png]
 
 Options:
   --all                       Render one merged graph for all providers
+  --today                     Show today's usage stats in terminal
   --amp                       Render Amp graph
   --claude                    Render Claude Code graph
   --codex                     Render Codex graph
@@ -8335,6 +8336,7 @@ function validateArgs(values) {
       help: ow.boolean,
       dark: ow.boolean,
       all: ow.boolean,
+      today: ow.boolean,
       amp: ow.boolean,
       claude: ow.boolean,
       codex: ow.boolean,
@@ -8487,6 +8489,62 @@ function printRunSummary(outputPath, format, colorMode, startDate, endDate, rend
 `
   );
 }
+function formatTokens(value) {
+  const units = [
+    { size: 1e12, suffix: "T" },
+    { size: 1e9, suffix: "B" },
+    { size: 1e6, suffix: "M" },
+    { size: 1e3, suffix: "K" }
+  ];
+  for (const unit of units) {
+    if (value >= unit.size) {
+      const scaled = value / unit.size;
+      const precision = scaled >= 100 ? 0 : scaled >= 10 ? 1 : 2;
+      const compact = scaled.toFixed(precision).replace(/\.0+$/, "").replace(/(\.\d*[1-9])0+$/, "$1");
+      return `${compact}${unit.suffix}`;
+    }
+  }
+  return new Intl.NumberFormat("en-US").format(value);
+}
+function printTodayStats(rowsByProvider, providers) {
+  const today = formatLocalDate(/* @__PURE__ */ new Date());
+  const rows = [];
+  for (const provider of providers) {
+    const summary = rowsByProvider[provider];
+    if (!summary) {
+      continue;
+    }
+    const todayRow = summary.daily.find(
+      (row) => formatLocalDate(row.date) === today
+    );
+    if (!todayRow || todayRow.total <= 0 && (todayRow.displayValue ?? 0) <= 0) {
+      continue;
+    }
+    const topModel = todayRow.breakdown.length > 0 ? `${todayRow.breakdown[0].name} (${formatTokens(todayRow.breakdown[0].tokens.total)})` : "-";
+    rows.push({
+      provider: providerStatusLabel[provider],
+      input: formatTokens(todayRow.input),
+      output: formatTokens(todayRow.output),
+      total: formatTokens(todayRow.total),
+      topModel
+    });
+  }
+  if (rows.length === 0) {
+    process.stdout.write(`
+No usage data found for today (${today}).
+`);
+    return;
+  }
+  const header = "| Provider | Input | Output | Total | Top Model |\n| --- | --- | --- | --- | --- |";
+  const body = rows.map(
+    (row) => `| ${row.provider} | ${row.input} | ${row.output} | ${row.total} | ${row.topModel} |`
+  ).join("\n");
+  process.stdout.write(`
+${header}
+${body}
+
+`);
+}
 async function main() {
   let spinner;
   const parsed = parseArgs({
@@ -8496,6 +8554,7 @@ async function main() {
       help: { type: "boolean", short: "h", default: false },
       dark: { type: "boolean", default: false },
       all: { type: "boolean", default: false },
+      today: { type: "boolean", default: false },
       amp: { type: "boolean", default: false },
       claude: { type: "boolean", default: false },
       codex: { type: "boolean", default: false },
@@ -8533,7 +8592,13 @@ async function main() {
       process.stderr.write(`${warning}
 `);
     }
-    printProviderAvailability(availabilityByProvider, inspectedProviders);
+    if (!values.today) {
+      printProviderAvailability(availabilityByProvider, inspectedProviders);
+    }
+    if (values.today) {
+      printTodayStats(rowsByProvider, inspectedProviders);
+      return;
+    }
     const exportProviders = getOutputProviders(
       values,
       availabilityByProvider,