cursor-usage 0.1.3 → 0.1.4

package/README.md

@@ -1,15 +1,18 @@
 # Cursor Usage Analyzer
 
+![Cursor Usage Banner](banner.png)
+
 A CLI tool for analyzing Cursor API usage and membership information, inspired by [ccusage](https://github.com/ryoppippi/ccusage).
 
 ## Features
 
-- Extract Cursor credentials from local database
-- Fetch usage data from Cursor API
-- Display membership and plan usage information
-- Show usage breakdown (included vs bonus)
-- Track percentage of included usage consumed
-- Colorful terminal output
+- 📊 Extract Cursor credentials from local database
+- 🔄 Fetch usage data from Cursor API
+- 📋 Display membership and plan usage information
+- 📈 Daily, weekly, and monthly usage reports
+- 💰 Token count and cost tracking
+- 🎨 Beautiful Unicode tables with colored output (inspired by [ccusage](https://github.com/ryoppippi/ccusage))
+- 📦 JSON output for programmatic use
 
 ## Installation
 
@@ -99,84 +102,77 @@ npm run build           # Compile TypeScript
 ### Summary View
 
 ```
-ACCOUNT INFORMATION:
-  Membership: pro
-  Billing Cycle: <your-billing-cycle>
+╭────────────────────────────────────────╮
+│         Cursor Usage Summary           │
+╰────────────────────────────────────────╯
+
+📋 ACCOUNT INFORMATION
+  Membership:     pro
+  Billing Cycle:  Dec 29, 2025 to Jan 29, 2026
 
-PLAN USAGE:
-  Used: 150 / 2000 (7.50%)
+📊 PLAN USAGE
+  Used:      150 / 2000 (7.50%)
   Remaining: 1850
+  Breakdown:
+    - Included: 150
+    - Bonus:    0
+    - Total:    150
 ```
 
 ### Daily Report View
 
 ```
-✓ Found 3 usage events
-
-====================================================================================================
-DAILY USAGE REPORT (Last 7 days)
-====================================================================================================
-
-+------------+--------+--------------+-------+--------+-------+----------------------------------+
-| Date       | Events | Total Tokens | Input | Output | Cost  | Models                           |
-+------------+--------+--------------+-------+--------+-------+----------------------------------+
-| 2026-01-11 | 3      | 539,301      | 381   | 7,081  | $0.82 | claude-4.5-opus-high-thinking(3) |
-+------------+--------+--------------+-------+--------+-------+----------------------------------+
-
-====================================================================================================
-SUMMARY
-====================================================================================================
-Total Events: 3
-Total Tokens: 539,301
-Total Cost: $0.82
-====================================================================================================
+╭──────────────────────────────────────────────╮
+│  Cursor Usage Report - Daily (Last 7 days)   │
+╰──────────────────────────────────────────────╯
+
+┌────────────┬────────┬──────────────┬───────┬────────┬───────┬──────────────────────────────────┐
+│ Date       │ Events │ Total Tokens │ Input │ Output │  Cost │ Models                           │
+├────────────┼────────┼──────────────┼───────┼────────┼───────┼──────────────────────────────────┤
+│ 2026-01-11 │      3 │      539,301 │   381 │  7,081 │ $0.82 │ claude-4.5-opus-high-thinking(3) │
+├────────────┼────────┼──────────────┼───────┼────────┼───────┼──────────────────────────────────┤
+│ Total      │      3 │      539,301 │   381 │  7,081 │ $0.82 │                                  │
+└────────────┴────────┴──────────────┴───────┴────────┴───────┴──────────────────────────────────┘
 ```
 
 ### Monthly Report View
 
 ```
-====================================================================================================
-MONTHLY USAGE REPORT (Last 3 months)
-====================================================================================================
-
-+----------+--------+---------------+-------+-------+-------+------------------------------+
-| Month    | Events | Total Tokens  | Input | Output| Cost  | Models                       |
-+----------+--------+---------------+-------+-------+-------+------------------------------+
-| Month 1  | 50     | 5,000,000     | 50000 | 30000 | $4.50 | claude-sonnet(50)            |
-| Month 2  | 75     | 8,500,000     | 75000 | 45000 | $6.80 | claude-opus(75)              |
-| Month 3  | 25     | 2,500,000     | 20000 | 10000 | $2.00 | claude-haiku(25)             |
-+----------+--------+---------------+-------+-------+-------+------------------------------+
-
-====================================================================================================
-SUMMARY
-====================================================================================================
-Total Events: 150
-Total Tokens: 16,000,000
-Total Cost: $13.30
-Average per month: 5,333,333 tokens, $4.43
-====================================================================================================
+╭────────────────────────────────────────────────────╮
+│  Cursor Usage Report - Monthly (Last 3 months)     │
+╰────────────────────────────────────────────────────╯
+
+┌──────────┬────────┬───────────────┬─────────┬─────────┬────────┬─────────────────────┐
+│ Month    │ Events │ Total Tokens  │   Input │  Output │   Cost │ Models              │
+├──────────┼────────┼───────────────┼─────────┼─────────┼────────┼─────────────────────┤
+│ 2026-01  │     50 │     5,000,000 │  50,000 │  30,000 │  $4.50 │ claude-sonnet(50)   │
+├──────────┼────────┼───────────────┼─────────┼─────────┼────────┼─────────────────────┤
+│ 2025-12  │     75 │     8,500,000 │  75,000 │  45,000 │  $6.80 │ claude-opus(75)     │
+├──────────┼────────┼───────────────┼─────────┼─────────┼────────┼─────────────────────┤
+│ 2025-11  │     25 │     2,500,000 │  20,000 │  10,000 │  $2.00 │ claude-haiku(25)    │
+├──────────┼────────┼───────────────┼─────────┼─────────┼────────┼─────────────────────┤
+│ Total    │    150 │    16,000,000 │ 145,000 │  85,000 │ $13.30 │                     │
+└──────────┴────────┴───────────────┴─────────┴─────────┴────────┴─────────────────────┘
 ```
 
 ### Detailed Event View
 
 ```
-========================================================================================================================
-USAGE EVENTS FOR Today
-========================================================================================================================
-
-+----------+---------------+-------+--------------+---------------+--------------+---------+
-| Time     | Model         | Type  | Input Tokens | Output Tokens | Total Tokens | Cost    |
-+----------+---------------+-------+--------------+---------------+--------------+---------+
-| 2:15 pm  | claude-opus   | usage | 500          | 1,200         | 1,700        | $0.0850 |
-| 1:45 pm  | claude-sonnet | usage | 300          | 800           | 1,100        | $0.0440 |
-| 1:20 pm  | claude-haiku  | usage | 100          | 250           | 350          | $0.0070 |
-+----------+---------------+-------+--------------+---------------+--------------+---------+
-
-========================================================================================================================
-Total Events: 3
-Total Tokens: 3,150
-Total Cost: $0.14
-==================================================================================================================
+╭─────────────────────────────────────────╮
+│  Cursor Usage Report - Sun Jan 11 2026  │
+╰─────────────────────────────────────────╯
+
+┌──────────┬───────────────┬───────┬──────────────┬───────────────┬──────────────┬─────────┐
+│ Time     │ Model         │ Type  │ Input Tokens │ Output Tokens │ Total Tokens │    Cost │
+├──────────┼───────────────┼───────┼──────────────┼───────────────┼──────────────┼─────────┤
+│ 2:15 pm  │ claude-opus   │ usage │          500 │         1,200 │        1,700 │ $0.0850 │
+├──────────┼───────────────┼───────┼──────────────┼───────────────┼──────────────┼─────────┤
+│ 1:45 pm  │ claude-sonnet │ usage │          300 │           800 │        1,100 │ $0.0440 │
+├──────────┼───────────────┼───────┼──────────────┼───────────────┼──────────────┼─────────┤
+│ 1:20 pm  │ claude-haiku  │ usage │          100 │           250 │          350 │ $0.0070 │
+├──────────┼───────────────┼───────┼──────────────┼───────────────┼──────────────┼─────────┤
+│ Total    │               │       │          900 │         2,250 │        3,150 │  $0.14  │
+└──────────┴───────────────┴───────┴──────────────┴───────────────┴──────────────┴─────────┘
 ```
 
 ### Model Breakdown View (`--breakdown`)
@@ -184,17 +180,19 @@ Total Cost: $0.14
 When using `--breakdown`, reports include a detailed per-model breakdown:
 
 ```
-==================================================================================================================
-PER-MODEL BREAKDOWN
-==================================================================================================================
-
-+---------------+--------+--------------+-------+-------+-------+---------+------------+------------+
-| Model         | Events | Total Tokens | Input | Output| Cost  | Token % | Cost %     |
-+---------------+--------+--------------+-------+-------+-------+---------+------------+
-| claude-opus   | 15     | 2,500,000    | 20000 | 15000 | $2.00 | 50.00%  | 40.00%    |
-| claude-sonnet | 10     | 2,000,000    | 15000 | 12000 | $1.60 | 40.00%  | 32.00%    |
-| claude-haiku  | 5      | 500,000      | 5000  | 3000  | $0.40 | 10.00%  | 8.00%     |
-+---------------+--------+--------------+-------+-------+-------+---------+------------+
+╭────────────────────────────────────────╮
+│          PER-MODEL BREAKDOWN           │
+╰────────────────────────────────────────╯
+
+┌───────────────┬────────┬──────────────┬─────────┬─────────┬───────┬─────────┬────────┐
+│ Model         │ Events │ Total Tokens │   Input │  Output │  Cost │ Token % │ Cost % │
+├───────────────┼────────┼──────────────┼─────────┼─────────┼───────┼─────────┼────────┤
+│ claude-opus   │     15 │    2,500,000 │  20,000 │  15,000 │ $2.00 │  50.00% │ 40.00% │
+├───────────────┼────────┼──────────────┼─────────┼─────────┼───────┼─────────┼────────┤
+│ claude-sonnet │     10 │    2,000,000 │  15,000 │  12,000 │ $1.60 │  40.00% │ 32.00% │
+├───────────────┼────────┼──────────────┼─────────┼─────────┼───────┼─────────┼────────┤
+│ claude-haiku  │      5 │      500,000 │   5,000 │   3,000 │ $0.40 │  10.00% │  8.00% │
+└───────────────┴────────┴──────────────┴─────────┴─────────┴───────┴─────────┴────────┘
 ```
 
 ### JSON Output (`--json`)
@@ -239,27 +237,22 @@ JSON output provides clean, structured data for programmatic use (no table forma
 }
 ```
 
-### Compact Table Format (`--compact`)
-
-The `--compact` flag provides a more condensed table layout:
+### Weekly Report View
 
 ```
-==================================================================================================================
-DAILY USAGE REPORT (Last 7 days)
-==================================================================================================================
-
-Date        Events  Tokens      Cost   Models
-2026-01-11  3       539,301     $0.82  claude-4.5-opus-high-thinking(3)
-2026-01-10  5       1,200,450   $1.45  claude-sonnet(4), claude-opus(1)
-2026-01-09  2       89,320      $0.12  claude-haiku(2)
-
-==================================================================================================================
-SUMMARY
-==================================================================================================================
-Total Events: 10
-Total Tokens: 1,829,071
-Total Cost: $2.39
-==================================================================================================================
+╭─────────────────────────────────────────────────╮
+│  Cursor Usage Report - Weekly (Last 4 weeks)    │
+╰─────────────────────────────────────────────────╯
+
+┌─────────────────────────┬────────┬──────────────┬─────────┬─────────┬────────┬─────────────────────┐
+│ Week                    │ Events │ Total Tokens │   Input │  Output │   Cost │ Models              │
+├─────────────────────────┼────────┼──────────────┼─────────┼─────────┼────────┼─────────────────────┤
+│ 2026-01-06 - 2026-01-12 │     25 │    3,500,000 │  35,000 │  21,000 │  $3.50 │ claude-opus(25)     │
+├─────────────────────────┼────────┼──────────────┼─────────┼─────────┼────────┼─────────────────────┤
+│ 2025-12-30 - 2026-01-05 │     40 │    5,200,000 │  52,000 │  31,200 │  $5.20 │ claude-sonnet(40)   │
+├─────────────────────────┼────────┼──────────────┼─────────┼─────────┼────────┼─────────────────────┤
+│ Total                   │     65 │    8,700,000 │  87,000 │  52,200 │  $8.70 │                     │
+└─────────────────────────┴────────┴──────────────┴─────────┴─────────┴────────┴─────────────────────┘
 ```
 
 ## Environment Variables
@@ -280,20 +273,17 @@ src/
 
 ## Features Implemented
 
-- ✅ Daily usage reports with table formatting
+- ✅ Daily, weekly, and monthly usage reports
 - ✅ Detailed event breakdown by time
 - ✅ Token count tracking (input, output, cache)
 - ✅ Cost calculation and display
-- ✅ Model usage breakdown
-- ✅ Flexible date range querying
-- ✅ Colorized CLI output
+- ✅ Model usage breakdown with `--breakdown` flag
+- ✅ Flexible date range querying with `--since` and `--until`
+- ✅ Beautiful Unicode tables with box-drawing characters
+- ✅ Colorized CLI output (cyan headers, yellow totals)
+- ✅ JSON output for programmatic use
 
 
 ## License
 
 MIT
-
-## Related Projects
-
-- [ccusage](https://github.com/ryoppippi/ccusage) - Claude Code usage analyzer
-- [@ccusage/amp](https://www.npmjs.com/package/@ccusage/amp) - Amp usage analyzer

package/dist/cli.js

@@ -5,6 +5,7 @@ import { getCursorCredentials, fetchUsageData } from './data-loader.js';
 import { showDailyReport, showMonthlyReport, showWeeklyReport, showDateReport, } from './commands.js';
 import { logger } from './logger.js';
 import { parseArgs, getNumberFlag, getDateFlag, getBoolFlag, } from './args-parser.js';
+import { createTitleBox, colors } from './table-formatter.js';
 export async function runCLI(argv) {
     const parsed = parseArgs(argv);
     const { command, params, flags } = parsed;
@@ -70,45 +71,49 @@ export async function runCLI(argv) {
     }
 }
 function displayResults(data) {
-    logger.log('='.repeat(70));
-    logger.log('CURSOR USAGE SUMMARY');
-    logger.log('='.repeat(70));
+    logger.log(createTitleBox('Cursor Usage Summary'));
     // Membership and plan info
-    logger.log('\n📋 ACCOUNT INFORMATION:');
-    logger.log(`  Membership: ${data.membershipType || 'N/A'}`);
-    logger.log(`  Billing Cycle: ${formatDate(data.billingCycleStart)} to ${formatDate(data.billingCycleEnd)}`);
+    logger.log(colors.cyan('📋 ACCOUNT INFORMATION'));
+    logger.log(`  ${colors.dim('Membership:')}     ${colors.yellow(data.membershipType || 'N/A')}`);
+    logger.log(`  ${colors.dim('Billing Cycle:')} ${colors.yellow(formatDate(data.billingCycleStart))} to ${colors.yellow(formatDate(data.billingCycleEnd))}`);
     // Plan usage
     const plan = data.individualUsage?.plan;
     if (plan) {
-        logger.log('\n📊 PLAN USAGE:');
-        logger.log(`  Used: ${plan.used} / ${plan.limit} (${plan.limit > 0 ? ((plan.used / plan.limit) * 100).toFixed(2) : '0.00'}%)`);
-        logger.log(`  Remaining: ${plan.limit - plan.used}`);
-        logger.log(`  Breakdown:`);
-        logger.log(`    - Included: ${plan.breakdown?.included || 0}`);
-        logger.log(`    - Bonus: ${plan.breakdown?.bonus || 0}`);
-        logger.log(`    - Total: ${plan.breakdown?.total || 0}`);
+        logger.log('');
+        logger.log(colors.cyan('📊 PLAN USAGE'));
+        const percentage = plan.limit > 0 ? ((plan.used / plan.limit) * 100).toFixed(2) : '0.00';
+        logger.log(`  ${colors.dim('Used:')}      ${colors.yellow(`${plan.used} / ${plan.limit}`)} (${colors.green(percentage + '%')})`);
+        logger.log(`  ${colors.dim('Remaining:')} ${colors.yellow(String(plan.limit - plan.used))}`);
+        logger.log(`  ${colors.dim('Breakdown:')}`);
+        logger.log(`    ${colors.dim('- Included:')} ${colors.yellow(String(plan.breakdown?.included || 0))}`);
+        logger.log(`    ${colors.dim('- Bonus:')}    ${colors.yellow(String(plan.breakdown?.bonus || 0))}`);
+        logger.log(`    ${colors.dim('- Total:')}    ${colors.yellow(String(plan.breakdown?.total || 0))}`);
     }
     // On-demand usage
     const onDemand = data.individualUsage?.onDemand;
     if (onDemand && onDemand.enabled) {
-        logger.log('\n💰 ON-DEMAND USAGE:');
-        logger.log(`  Used: ${onDemand.used}`);
+        logger.log('');
+        logger.log(colors.cyan('💰 ON-DEMAND USAGE'));
+        logger.log(`  ${colors.dim('Used:')}   ${colors.yellow(String(onDemand.used))}`);
         if (onDemand.limit !== null) {
-            logger.log(`  Limit: ${onDemand.limit}`);
-            logger.log(`  Remaining: ${onDemand.remaining !== null ? onDemand.remaining : (onDemand.limit - onDemand.used)}`);
+            logger.log(`  ${colors.dim('Limit:')}  ${colors.yellow(String(onDemand.limit))}`);
+            const remaining = onDemand.remaining !== null ? onDemand.remaining : (onDemand.limit - onDemand.used);
+            logger.log(`  ${colors.dim('Remaining:')} ${colors.yellow(String(remaining))}`);
         }
-        logger.log(`  Status: Enabled`);
+        logger.log(`  ${colors.dim('Status:')} ${colors.green('Enabled')}`);
     }
     // Display messages
     if (data.autoModelSelectedDisplayMessage) {
-        logger.log('\n📢 AUTO MODEL MESSAGE:');
-        logger.log(`  ${data.autoModelSelectedDisplayMessage}`);
+        logger.log('');
+        logger.log(colors.cyan('📢 AUTO MODEL MESSAGE'));
+        logger.log(`  ${colors.dim(data.autoModelSelectedDisplayMessage)}`);
     }
     if (data.namedModelSelectedDisplayMessage) {
-        logger.log('\n💬 NAMED MODEL MESSAGE:');
-        logger.log(`  ${data.namedModelSelectedDisplayMessage}`);
+        logger.log('');
+        logger.log(colors.cyan('💬 NAMED MODEL MESSAGE'));
+        logger.log(`  ${colors.dim(data.namedModelSelectedDisplayMessage)}`);
     }
-    logger.log('\n' + '='.repeat(70) + '\n');
+    logger.log('');
 }
 function formatDate(dateString) {
     try {

package/dist/commands.js

@@ -2,7 +2,7 @@
  * CLI command handlers
  */
 import { fetchUsageEvents, groupByDay, calculateDailyStats, groupByMonth, calculateMonthlyStats, formatMonthlyStatsTable, groupByWeek, calculateWeeklyStats, formatWeeklyStatsTable, calculateModelBreakdown, formatModelBreakdownTable, } from './event-loader.js';
-import { createTable } from './table-formatter.js';
+import { createTable, createTitleBox, formatNumber, formatCurrency, formatTotalsRow, } from './table-formatter.js';
 import { logger } from './logger.js';
 /**
  * Convert stats to JSON
@@ -45,11 +45,9 @@ function displayBreakdown(events, title = 'MODEL BREAKDOWN') {
     const breakdown = calculateModelBreakdown(events);
     const totalTokens = events.reduce((sum, e) => sum + e.tokens, 0);
     const totalCost = events.reduce((sum, e) => sum + (e.cost || 0), 0);
-    logger.log('\n' + '='.repeat(100));
-    logger.log(title);
-    logger.log('='.repeat(100) + '\n');
+    logger.log(createTitleBox(title));
     const tableData = formatModelBreakdownTable(breakdown, totalTokens, totalCost);
-    const table = createTable(['Model', 'Events', 'Total Tokens', 'Cost', 'Token %', 'Cost %'], tableData);
+    const table = createTable(['Model', 'Events', 'Total Tokens', 'Cost', 'Token %', 'Cost %'], tableData, ['left', 'right', 'right', 'right', 'right', 'right']);
     logger.log(table + '\n');
 }
 /**
@@ -80,12 +78,8 @@ export async function showDailyReport(credentials, days = 7, options = {}, outpu
         console.log(jsonOutput);
     }
     else {
-        // Display table and summary
-        logger.log('');
-        // Display table
-        logger.log('\n' + '='.repeat(100));
-        logger.log(`DAILY USAGE REPORT (Last ${days} days)`);
-        logger.log('='.repeat(100) + '\n');
+        // Display title box
+        logger.log(createTitleBox(`Cursor Usage Report - Daily (Last ${days} days)`));
         const tableData = stats.map((day) => {
             const modelList = Array.from(day.models.entries())
                 .map(([model, count]) => `${model}(${count})`)
@@ -93,26 +87,31 @@ export async function showDailyReport(credentials, days = 7, options = {}, outpu
             return [
                 day.date,
                 day.eventCount.toString(),
-                day.totalTokens.toLocaleString(),
-                day.inputTokens.toLocaleString(),
-                day.outputTokens.toLocaleString(),
-                `$${day.totalCost.toFixed(2)}`,
+                formatNumber(day.totalTokens),
+                formatNumber(day.inputTokens),
+                formatNumber(day.outputTokens),
+                formatCurrency(day.totalCost),
                 modelList || 'N/A',
             ];
         });
-        const table = createTable(['Date', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData);
-        logger.log(table);
-        // Summary
+        // Calculate totals
         const totalEvents = stats.reduce((sum, day) => sum + day.eventCount, 0);
         const totalTokens = stats.reduce((sum, day) => sum + day.totalTokens, 0);
+        const totalInputTokens = stats.reduce((sum, day) => sum + day.inputTokens, 0);
+        const totalOutputTokens = stats.reduce((sum, day) => sum + day.outputTokens, 0);
         const totalCost = stats.reduce((sum, day) => sum + day.totalCost, 0);
-        logger.log('\n' + '='.repeat(100));
-        logger.log('SUMMARY');
-        logger.log('='.repeat(100));
-        logger.log(`Total Events: ${totalEvents}`);
-        logger.log(`Total Tokens: ${totalTokens.toLocaleString()}`);
-        logger.log(`Total Cost: $${totalCost.toFixed(2)}`);
-        logger.log('='.repeat(100) + '\n');
+        // Add totals row
+        tableData.push(formatTotalsRow([
+            'Total',
+            totalEvents.toString(),
+            formatNumber(totalTokens),
+            formatNumber(totalInputTokens),
+            formatNumber(totalOutputTokens),
+            formatCurrency(totalCost),
+            '',
+        ]));
+        const table = createTable(['Date', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData, ['left', 'right', 'right', 'right', 'right', 'right', 'left']);
+        logger.log(table + '\n');
         // Show breakdown if requested
         if (options.breakdown) {
             displayBreakdown(events, 'PER-MODEL BREAKDOWN');
@@ -148,27 +147,27 @@ export async function showMonthlyReport(credentials, months = 3, options = {}, o
         console.log(jsonOutput);
     }
     else {
-        // Display table and summary
-        logger.log('');
-        // Display table
-        logger.log('\n' + '='.repeat(100));
-        logger.log(`MONTHLY USAGE REPORT (Last ${months} months)`);
-        logger.log('='.repeat(100) + '\n');
+        // Display title box
+        logger.log(createTitleBox(`Cursor Usage Report - Monthly (Last ${months} months)`));
         const tableData = formatMonthlyStatsTable(stats);
-        const table = createTable(['Month', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData);
-        logger.log(table);
-        // Summary
+        // Calculate totals
         const totalEvents = stats.reduce((sum, month) => sum + month.eventCount, 0);
         const totalTokens = stats.reduce((sum, month) => sum + month.totalTokens, 0);
+        const totalInputTokens = stats.reduce((sum, month) => sum + month.inputTokens, 0);
+        const totalOutputTokens = stats.reduce((sum, month) => sum + month.outputTokens, 0);
         const totalCost = stats.reduce((sum, month) => sum + month.totalCost, 0);
-        logger.log('\n' + '='.repeat(100));
-        logger.log('SUMMARY');
-        logger.log('='.repeat(100));
-        logger.log(`Total Events: ${totalEvents}`);
-        logger.log(`Total Tokens: ${totalTokens.toLocaleString()}`);
-        logger.log(`Total Cost: $${totalCost.toFixed(2)}`);
-        logger.log(`Average per month: ${(totalTokens / Math.max(1, stats.length)).toLocaleString()} tokens, $${(totalCost / Math.max(1, stats.length)).toFixed(2)}`);
-        logger.log('='.repeat(100) + '\n');
+        // Add totals row
+        tableData.push(formatTotalsRow([
+            'Total',
+            totalEvents.toString(),
+            formatNumber(totalTokens),
+            formatNumber(totalInputTokens),
+            formatNumber(totalOutputTokens),
+            formatCurrency(totalCost),
+            '',
+        ]));
+        const table = createTable(['Month', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData, ['left', 'right', 'right', 'right', 'right', 'right', 'left']);
+        logger.log(table + '\n');
         // Show breakdown if requested
         if (options.breakdown) {
             displayBreakdown(events, 'PER-MODEL BREAKDOWN');
@@ -203,27 +202,27 @@ export async function showWeeklyReport(credentials, weeks = 4, options = {}, out
         console.log(jsonOutput);
     }
     else {
-        // Display table and summary
-        logger.log('');
-        // Display table
-        logger.log('\n' + '='.repeat(120));
-        logger.log(`WEEKLY USAGE REPORT (Last ${weeks} weeks)`);
-        logger.log('='.repeat(120) + '\n');
+        // Display title box
+        logger.log(createTitleBox(`Cursor Usage Report - Weekly (Last ${weeks} weeks)`));
         const tableData = formatWeeklyStatsTable(stats);
-        const table = createTable(['Week', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData);
-        logger.log(table);
-        // Summary
+        // Calculate totals
         const totalEvents = stats.reduce((sum, week) => sum + week.eventCount, 0);
         const totalTokens = stats.reduce((sum, week) => sum + week.totalTokens, 0);
+        const totalInputTokens = stats.reduce((sum, week) => sum + week.inputTokens, 0);
+        const totalOutputTokens = stats.reduce((sum, week) => sum + week.outputTokens, 0);
         const totalCost = stats.reduce((sum, week) => sum + week.totalCost, 0);
-        logger.log('\n' + '='.repeat(120));
-        logger.log('SUMMARY');
-        logger.log('='.repeat(120));
-        logger.log(`Total Events: ${totalEvents}`);
-        logger.log(`Total Tokens: ${totalTokens.toLocaleString()}`);
-        logger.log(`Total Cost: $${totalCost.toFixed(2)}`);
-        logger.log(`Average per week: ${(totalTokens / Math.max(1, stats.length)).toLocaleString()} tokens, $${(totalCost / Math.max(1, stats.length)).toFixed(2)}`);
-        logger.log('='.repeat(120) + '\n');
+        // Add totals row
+        tableData.push(formatTotalsRow([
+            'Total',
+            totalEvents.toString(),
+            formatNumber(totalTokens),
+            formatNumber(totalInputTokens),
+            formatNumber(totalOutputTokens),
+            formatCurrency(totalCost),
+            '',
+        ]));
+        const table = createTable(['Week', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData, ['left', 'right', 'right', 'right', 'right', 'right', 'left']);
+        logger.log(table + '\n');
         // Show breakdown if requested
         if (options.breakdown) {
             displayBreakdown(events, 'PER-MODEL BREAKDOWN');
@@ -249,34 +248,37 @@ export async function showDateReport(credentials, date, options = {}, outputJson
         console.log(jsonOutput);
     }
     else {
-        // Display table and summary
-        logger.log('');
-        // Display detailed events
-        logger.log('\n' + '='.repeat(120));
-        logger.log(`USAGE EVENTS FOR ${date.toDateString()}`);
-        logger.log('='.repeat(120) + '\n');
+        // Display title box
+        logger.log(createTitleBox(`Cursor Usage Report - ${date.toDateString()}`));
         const tableData = events.map((event) => {
             const timestamp = new Date(event.timestamp).toLocaleTimeString();
             return [
                 timestamp,
                 event.model,
                 event.type,
-                event.inputTokens.toLocaleString(),
-                event.outputTokens.toLocaleString(),
-                event.tokens.toLocaleString(),
-                `$${event.cost?.toFixed(4) || '0.0000'}`,
+                formatNumber(event.inputTokens),
+                formatNumber(event.outputTokens),
+                formatNumber(event.tokens),
+                formatCurrency(event.cost || 0),
             ];
         });
-        const table = createTable(['Time', 'Model', 'Type', 'Input Tokens', 'Output Tokens', 'Total Tokens', 'Cost'], tableData);
-        logger.log(table);
-        // Summary
+        // Calculate totals
+        const totalInputTokens = events.reduce((sum, e) => sum + e.inputTokens, 0);
+        const totalOutputTokens = events.reduce((sum, e) => sum + e.outputTokens, 0);
         const totalTokens = events.reduce((sum, e) => sum + e.tokens, 0);
         const totalCost = events.reduce((sum, e) => sum + (e.cost || 0), 0);
-        logger.log('\n' + '='.repeat(120));
-        logger.log(`Total Events: ${events.length}`);
-        logger.log(`Total Tokens: ${totalTokens.toLocaleString()}`);
-        logger.log(`Total Cost: $${totalCost.toFixed(2)}`);
-        logger.log('='.repeat(120) + '\n');
+        // Add totals row
+        tableData.push(formatTotalsRow([
+            'Total',
+            '',
+            '',
+            formatNumber(totalInputTokens),
+            formatNumber(totalOutputTokens),
+            formatNumber(totalTokens),
+            formatCurrency(totalCost),
+        ]));
+        const table = createTable(['Time', 'Model', 'Type', 'Input Tokens', 'Output Tokens', 'Total Tokens', 'Cost'], tableData, ['left', 'left', 'left', 'right', 'right', 'right', 'right']);
+        logger.log(table + '\n');
         // Show breakdown if requested
         if (options.breakdown) {
             displayBreakdown(events, 'PER-MODEL BREAKDOWN');

package/dist/table-formatter.d.ts

@@ -1,16 +1,74 @@
 /**
- * Simple table formatting utilities
+ * Table formatting utilities with polished Unicode styling
+ * Inspired by ccusage (https://github.com/ryoppippi/ccusage)
  */
+export type TableCellAlign = 'left' | 'right' | 'center';
 export interface TableOptions {
     headers: string[];
-    rows: string[][];
-    maxWidth?: number;
+    rows: (string | number)[][];
+    colAligns?: TableCellAlign[];
+    headerStyle?: 'cyan' | 'yellow' | 'green' | 'magenta' | 'white';
 }
 /**
- * Format data as a simple ASCII table
+ * Format data as a styled Unicode table
  */
 export declare function formatTable(options: TableOptions): string;
 /**
- * Create a simple data table with borders
+ * Create a simple data table with Unicode borders
  */
-export declare function createTable(headers: string[], rows: string[][]): string;
+export declare function createTable(headers: string[], rows: (string | number)[][], colAligns?: TableCellAlign[]): string;
+/**
+ * Format a number with locale-specific thousand separators
+ */
+export declare function formatNumber(num: number): string;
+/**
+ * Format a number as USD currency
+ */
+export declare function formatCurrency(amount: number): string;
+/**
+ * Create a styled title box for report headers
+ */
+export declare function createTitleBox(title: string): string;
+/**
+ * Style text with color
+ */
+export declare const colors: {
+    cyan: (text: string) => string;
+    yellow: (text: string) => string;
+    green: (text: string) => string;
+    red: (text: string) => string;
+    gray: (text: string) => string;
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+};
+/**
+ * Format a row with yellow highlighting (for totals)
+ */
+export declare function formatTotalsRow(cells: (string | number)[]): string[];
+/**
+ * Create a usage report table with consistent styling
+ */
+export interface UsageReportOptions {
+    title: string;
+    headers: string[];
+    rows: (string | number)[][];
+    totals?: (string | number)[];
+    colAligns?: TableCellAlign[];
+}
+export declare function createUsageReportTable(options: UsageReportOptions): string;
+/**
+ * Create a summary section with styled output
+ */
+export declare function createSummary(items: {
+    label: string;
+    value: string | number;
+}[]): string;
+/**
+ * Shorten model names for display
+ * e.g., "claude-sonnet-4-20250514" -> "sonnet-4"
+ */
+export declare function formatModelName(modelName: string): string;
+/**
+ * Format an array of model names for display
+ */
+export declare function formatModelsDisplay(models: string[]): string;

package/dist/table-formatter.js

@@ -1,40 +1,135 @@
 /**
- * Simple table formatting utilities
+ * Table formatting utilities with polished Unicode styling
+ * Inspired by ccusage (https://github.com/ryoppippi/ccusage)
  */
+import Table from 'cli-table3';
+import pc from 'picocolors';
 /**
- * Format data as a simple ASCII table
+ * Format data as a styled Unicode table
  */
 export function formatTable(options) {
-    const { headers, rows } = options;
+    const { headers, rows, colAligns, headerStyle = 'cyan' } = options;
     if (rows.length === 0) {
         return 'No data to display';
     }
-    // Calculate column widths
-    const colWidths = headers.map((h, i) => {
-        const headerWidth = h.length;
-        const maxRowWidth = Math.max(...rows.map((row) => (row[i] ? row[i].length : 0)));
-        return Math.max(headerWidth, maxRowWidth);
+    // Create table with styled headers
+    const table = new Table({
+        head: headers,
+        style: { head: [headerStyle] },
+        colAligns: colAligns || headers.map(() => 'left'),
+        wordWrap: true,
     });
-    // Build separator line
-    const separator = '+' + colWidths.map((w) => '-'.repeat(w + 2)).join('+') + '+';
-    // Build header line
-    const headerLine = '| ' +
-        headers
-            .map((h, i) => h.padEnd(colWidths[i]))
-            .join(' | ') +
-        ' |';
-    // Build data lines
-    const dataLines = rows.map((row) => '| ' +
-        row
-            .map((cell, i) => (cell || '').padEnd(colWidths[i]))
-            .join(' | ') +
-        ' |');
-    // Combine all parts
-    return [separator, headerLine, separator, ...dataLines, separator].join('\n');
-}
-/**
- * Create a simple data table with borders
- */
-export function createTable(headers, rows) {
-    return formatTable({ headers, rows });
+    // Add rows
+    for (const row of rows) {
+        table.push(row.map((cell) => String(cell)));
+    }
+    return table.toString();
+}
+/**
+ * Create a simple data table with Unicode borders
+ */
+export function createTable(headers, rows, colAligns) {
+    return formatTable({ headers, rows, colAligns });
+}
+/**
+ * Format a number with locale-specific thousand separators
+ */
+export function formatNumber(num) {
+    return num.toLocaleString('en-US');
+}
+/**
+ * Format a number as USD currency
+ */
+export function formatCurrency(amount) {
+    return `$${amount.toFixed(2)}`;
+}
+/**
+ * Create a styled title box for report headers
+ */
+export function createTitleBox(title) {
+    const innerWidth = Math.max(title.length + 4, 40);
+    const padding = Math.floor((innerWidth - title.length) / 2);
+    const extraPadding = (innerWidth - title.length) % 2;
+    const top = '╭' + '─'.repeat(innerWidth) + '╮';
+    const middle = '│' + ' '.repeat(padding) + title + ' '.repeat(padding + extraPadding) + '│';
+    const bottom = '╰' + '─'.repeat(innerWidth) + '╯';
+    return '\n' + top + '\n' + middle + '\n' + bottom + '\n';
+}
+/**
+ * Style text with color
+ */
+export const colors = {
+    cyan: (text) => pc.cyan(text),
+    yellow: (text) => pc.yellow(text),
+    green: (text) => pc.green(text),
+    red: (text) => pc.red(text),
+    gray: (text) => pc.gray(text),
+    bold: (text) => pc.bold(text),
+    dim: (text) => pc.dim(text),
+};
+/**
+ * Format a row with yellow highlighting (for totals)
+ */
+export function formatTotalsRow(cells) {
+    return cells.map((cell) => pc.yellow(String(cell)));
+}
+export function createUsageReportTable(options) {
+    const { title, headers, rows, totals, colAligns } = options;
+    const output = [];
+    // Title box
+    output.push(createTitleBox(title));
+    // Create table
+    const table = new Table({
+        head: headers,
+        style: { head: ['cyan'] },
+        colAligns: colAligns || headers.map((_, i) => (i === 0 ? 'left' : 'right')),
+        wordWrap: true,
+    });
+    // Add data rows
+    for (const row of rows) {
+        table.push(row.map((cell) => String(cell)));
+    }
+    // Add totals row with yellow highlighting
+    if (totals) {
+        const formattedTotals = totals.map((cell, i) => i === 0 ? pc.yellow(String(cell)) : pc.yellow(String(cell)));
+        table.push(formattedTotals);
+    }
+    output.push(table.toString());
+    return output.join('\n');
+}
+/**
+ * Create a summary section with styled output
+ */
+export function createSummary(items) {
+    const maxLabelWidth = Math.max(...items.map((item) => item.label.length));
+    const lines = items.map((item) => {
+        const label = pc.cyan(item.label.padEnd(maxLabelWidth));
+        const value = pc.yellow(String(item.value));
+        return `  ${label}  ${value}`;
+    });
+    return lines.join('\n');
+}
+/**
+ * Shorten model names for display
+ * e.g., "claude-sonnet-4-20250514" -> "sonnet-4"
+ */
+export function formatModelName(modelName) {
+    // Match claude-{type}-{version}-{date} pattern
+    const match = modelName.match(/^claude-(\w+)-([\d-]+)-(\d{8})$/);
+    if (match) {
+        return `${match[1]}-${match[2]}`;
+    }
+    // Match claude-{type}-{version} without date
+    const noDateMatch = modelName.match(/^claude-(\w+)-([\d-]+)$/);
+    if (noDateMatch) {
+        return `${noDateMatch[1]}-${noDateMatch[2]}`;
+    }
+    return modelName;
+}
+/**
+ * Format an array of model names for display
+ */
+export function formatModelsDisplay(models) {
+    const uniqueModels = [...new Set(models.map(formatModelName))];
+    return uniqueModels.sort().join(', ');
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cursor-usage",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "CLI tool for analyzing Cursor usage and token consumption",
   "author": "yifen <anthonyeef@gmail.com>",
   "license": "MIT",
@@ -40,12 +40,14 @@
     "format": "prettier --write src/"
   },
   "dependencies": {
+    "cli-table3": "^0.6.5",
+    "picocolors": "^1.1.1",
     "sql.js": "^1.8.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.6",
-    "typescript": "^5.3.3",
-    "tsx": "^4.7.0"
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
   },
   "engines": {
     "node": ">=18.0.0"