cursor-usage 0.1.2 → 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
 
@@ -17,6 +20,26 @@ A CLI tool for analyzing Cursor API usage and membership information, inspired b
 npm install
 ```
 
+## Quick Test
+
+You can test the package without installing it locally using npx or bunx:
+
+```bash
+# Test with npx (Node.js)
+npx cursor-usage@latest
+
+# Test with bunx (Bun runtime)
+bunx cursor-usage@latest
+
+# Test specific commands
+npx cursor-usage@latest daily
+npx cursor-usage@latest monthly
+
+# Test with flags
+npx cursor-usage@latest daily --breakdown
+npx cursor-usage@latest weekly --json
+```
+
 ## Usage
 
 ### Commands
@@ -44,8 +67,28 @@ npm run dev -- today
 
 # Show help
 npm run dev -- help
+
+# Show usage with date range
+npm run dev -- daily --since 2026-01-01 --until 2026-01-15
+
+# Show usage with model breakdown
+npm run dev -- daily --breakdown
+
+# Show compact table format
+npm run dev -- monthly --compact
+
+# Output as JSON (detailed reports only)
+npm run dev -- daily --json
 ```
 
+### Flags
+
+- `--since DATE` - Start date (YYYY-MM-DD)
+- `--until DATE` - End date (YYYY-MM-DD)
+- `--breakdown` - Show per-model breakdown
+- `--json` - Output as JSON (machine-readable format)
+- `--compact` - Compact table format
+
 ### Development
 
 ```bash
@@ -59,98 +102,158 @@ npm run build           # Compile TypeScript
 ### Summary View
 
 ```
-📊 ACCOUNT INFORMATION:
-  Membership: pro
-  Billing Cycle: <your-billing-cycle>
+╭────────────────────────────────────────╮
+│         Cursor Usage Summary           │
+╰────────────────────────────────────────╯
 
-📊 PLAN USAGE:
-  Used: 150 / 2000 (7.50%)
+📋 ACCOUNT INFORMATION
+  Membership:     pro
+  Billing Cycle:  Dec 29, 2025 to Jan 29, 2026
+
+📊 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  │
+└──────────┴───────────────┴───────┴──────────────┴───────────────┴──────────────┴─────────┘
 ```
 
-## How It Works
+### Model Breakdown View (`--breakdown`)
 
-1. **Extracts credentials** from `~/Library/Application Support/Cursor/User/globalStorage/state.vscdb`
-   - User ID from `workbench.experiments.statsigBootstrap`
-   - Access Token from `cursorAuth/accessToken`
-   - Email and membership (optional)
+When using `--breakdown`, reports include a detailed per-model breakdown:
 
-2. **Authenticates** with Cursor API using `WorkosCursorSessionToken` cookie
+```
+╭────────────────────────────────────────╮
+│          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% │
+└───────────────┴────────┴──────────────┴─────────┴─────────┴───────┴─────────┴────────┘
+```
 
-3. **Fetches usage data** from `https://cursor.com/api/usage-summary`
+### JSON Output (`--json`)
+
+JSON output provides clean, structured data for programmatic use (no table formatting):
+
+```json
+{
+  "command": "daily",
+  "generatedAt": "2026-01-11T10:30:00.000Z",
+  "period": "last 7 days",
+  "summary": {
+    "totalEvents": 45,
+    "totalTokens": 539301,
+    "totalCost": 0.82
+  },
+  "data": [
+    {
+      "date": "2026-01-11",
+      "eventCount": 3,
+      "totalTokens": 539301,
+      "inputTokens": 381,
+      "outputTokens": 7081,
+      "totalCost": 0.82,
+      "models": {
+        "claude-4.5-opus-high-thinking": 3
+      }
+    }
+  ],
+  "breakdown": [
+    {
+      "model": "claude-opus",
+      "count": 15,
+      "totalTokens": 250000,
+      "inputTokens": 20000,
+      "outputTokens": 15000,
+      "totalCost": 2.0,
+      "tokenPercent": 50.0,
+      "costPercent": 40.0
+    }
+  ]
+}
+```
 
-4. **Parses and displays** membership, plan usage, and billing information
+### Weekly Report View
+
+```
+╭─────────────────────────────────────────────────╮
+│  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
 
@@ -168,42 +271,19 @@ src/
 └── _consts.ts        # Constants & configuration
 ```
 
-## API Response Structure
-
-The tool fetches data from Cursor's `/api/usage-summary` endpoint which returns:
-- Billing cycle information
-- Membership type (pro, hobby, etc.)
-- Plan usage (used/limit/remaining)
-- On-demand usage status
-- Display messages about usage percentage
-
 ## 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
-
-## Future Enhancements
-
-- [ ] JSON output format (`--json`)
-- [ ] Date range queries (`--from 2026-01-01 --to 2026-01-31`)
-- [ ] Weekly/monthly aggregations
-- [ ] Historical data caching
-- [ ] Cost projections
-- [ ] Team usage analysis
-- [ ] Export to CSV/JSON
-- [ ] Web dashboard
-- [ ] Webhook notifications
+- ✅ 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');
 }
 /**
@@ -71,50 +69,54 @@ export async function showDailyReport(credentials, days = 7, options = {}, outpu
         logger.warn('No usage events found for this period');
         return;
     }
-    logger.log('');
     // Group and calculate stats
     const grouped = groupByDay(events);
     const stats = calculateDailyStats(grouped);
-    // Display table
-    logger.log('\n' + '='.repeat(100));
-    logger.log(`DAILY USAGE REPORT (Last ${days} days)`);
-    logger.log('='.repeat(100) + '\n');
-    const tableData = stats.map((day) => {
-        const modelList = Array.from(day.models.entries())
-            .map(([model, count]) => `${model}(${count})`)
-            .join(', ');
-        return [
-            day.date,
-            day.eventCount.toString(),
-            day.totalTokens.toLocaleString(),
-            day.inputTokens.toLocaleString(),
-            day.outputTokens.toLocaleString(),
-            `$${day.totalCost.toFixed(2)}`,
-            modelList || 'N/A',
-        ];
-    });
-    const table = createTable(['Date', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData);
-    logger.log(table);
-    // Summary
-    const totalEvents = stats.reduce((sum, day) => sum + day.eventCount, 0);
-    const totalTokens = stats.reduce((sum, day) => sum + day.totalTokens, 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');
-    // Show breakdown if requested
-    if (options.breakdown) {
-        displayBreakdown(events, 'PER-MODEL BREAKDOWN');
-    }
-    // Output JSON if requested
     if (outputJson) {
+        // Output JSON only - no table display
         const jsonOutput = statsToJSON('daily', stats, events, { breakdown: options.breakdown, period: `last ${days} days` });
         console.log(jsonOutput);
     }
+    else {
+        // 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})`)
+                .join(', ');
+            return [
+                day.date,
+                day.eventCount.toString(),
+                formatNumber(day.totalTokens),
+                formatNumber(day.inputTokens),
+                formatNumber(day.outputTokens),
+                formatCurrency(day.totalCost),
+                modelList || 'N/A',
+            ];
+        });
+        // 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);
+        // 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');
+        }
+    }
 }
 /**
  * Show monthly usage report
@@ -136,38 +138,41 @@ export async function showMonthlyReport(credentials, months = 3, options = {}, o
         logger.warn('No usage events found for this period');
         return;
     }
-    logger.log('');
     // Group and calculate stats
     const grouped = groupByMonth(events);
     const stats = calculateMonthlyStats(grouped);
-    // Display table
-    logger.log('\n' + '='.repeat(100));
-    logger.log(`MONTHLY USAGE REPORT (Last ${months} months)`);
-    logger.log('='.repeat(100) + '\n');
-    const tableData = formatMonthlyStatsTable(stats);
-    const table = createTable(['Month', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData);
-    logger.log(table);
-    // Summary
-    const totalEvents = stats.reduce((sum, month) => sum + month.eventCount, 0);
-    const totalTokens = stats.reduce((sum, month) => sum + month.totalTokens, 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');
-    // Show breakdown if requested
-    if (options.breakdown) {
-        displayBreakdown(events, 'PER-MODEL BREAKDOWN');
-    }
-    // Output JSON if requested
     if (outputJson) {
+        // Output JSON only - no table display
         const jsonOutput = statsToJSON('monthly', stats, events, { breakdown: options.breakdown, period: `last ${months} months` });
         console.log(jsonOutput);
     }
+    else {
+        // Display title box
+        logger.log(createTitleBox(`Cursor Usage Report - Monthly (Last ${months} months)`));
+        const tableData = formatMonthlyStatsTable(stats);
+        // 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);
+        // 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');
+        }
+    }
 }
 /**
  * Show weekly usage report
@@ -188,38 +193,41 @@ export async function showWeeklyReport(credentials, weeks = 4, options = {}, out
         logger.warn('No usage events found for this period');
         return;
     }
-    logger.log('');
     // Group and calculate stats
     const grouped = groupByWeek(events);
     const stats = calculateWeeklyStats(grouped);
-    // Display table
-    logger.log('\n' + '='.repeat(120));
-    logger.log(`WEEKLY USAGE REPORT (Last ${weeks} weeks)`);
-    logger.log('='.repeat(120) + '\n');
-    const tableData = formatWeeklyStatsTable(stats);
-    const table = createTable(['Week', 'Events', 'Total Tokens', 'Input', 'Output', 'Cost', 'Models'], tableData);
-    logger.log(table);
-    // Summary
-    const totalEvents = stats.reduce((sum, week) => sum + week.eventCount, 0);
-    const totalTokens = stats.reduce((sum, week) => sum + week.totalTokens, 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');
-    // Show breakdown if requested
-    if (options.breakdown) {
-        displayBreakdown(events, 'PER-MODEL BREAKDOWN');
-    }
-    // Output JSON if requested
     if (outputJson) {
+        // Output JSON only - no table display
         const jsonOutput = statsToJSON('weekly', stats, events, { breakdown: options.breakdown, period: `last ${weeks} weeks` });
         console.log(jsonOutput);
     }
+    else {
+        // Display title box
+        logger.log(createTitleBox(`Cursor Usage Report - Weekly (Last ${weeks} weeks)`));
+        const tableData = formatWeeklyStatsTable(stats);
+        // 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);
+        // 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');
+        }
+    }
 }
 /**
  * Show usage for a specific date
@@ -234,40 +242,46 @@ export async function showDateReport(credentials, date, options = {}, outputJson
         logger.warn('No usage events found for this date');
         return;
     }
-    logger.log('');
-    // Display detailed events
-    logger.log('\n' + '='.repeat(120));
-    logger.log(`USAGE EVENTS FOR ${date.toDateString()}`);
-    logger.log('='.repeat(120) + '\n');
-    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'}`,
-        ];
-    });
-    const table = createTable(['Time', 'Model', 'Type', 'Input Tokens', 'Output Tokens', 'Total Tokens', 'Cost'], tableData);
-    logger.log(table);
-    // Summary
-    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');
-    // Show breakdown if requested
-    if (options.breakdown) {
-        displayBreakdown(events, 'PER-MODEL BREAKDOWN');
-    }
-    // Output JSON if requested
     if (outputJson) {
+        // Output JSON only - no table display
         const jsonOutput = statsToJSON('today', events.map((e, i) => ({ ...e, eventIndex: i })), events, { breakdown: options.breakdown, period: 'today' });
         console.log(jsonOutput);
     }
+    else {
+        // 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,
+                formatNumber(event.inputTokens),
+                formatNumber(event.outputTokens),
+                formatNumber(event.tokens),
+                formatCurrency(event.cost || 0),
+            ];
+        });
+        // 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);
+        // 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.2",
+  "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"