claude-usage-rzp 0.1.0

package/README.md

@@ -0,0 +1,239 @@
+# Claude Usage CLI
+
+> View your Claude Code API usage directly in your terminal 📊
+
+A beautiful command-line tool to visualize Claude Code token usage, costs, and activity across all your projects.
+
+## Features
+
+✨ **Interactive Mode** - Beautiful menu-driven interface with Claude branding
+📊 **Token Breakdown** - Input, Output, Cache Write, and Cache Read tokens by model
+📁 **Project Analytics** - View usage breakdown by project
+💬 **Session Details** - Drill down to individual session messages
+🎨 **Beautiful Output** - Colorful tables with proper formatting and emojis
+⚡ **Fast & Lightweight** - No external services, reads local Claude data
+
+## Quick Start
+
+### Using npx (Recommended)
+
+Run instantly without installation:
+
+```bash
+npx claude-usage-rzp
+```
+
+### Installation
+
+Install globally to use anywhere:
+
+```bash
+npm install -g claude-usage-rzp
+```
+
+Then simply run:
+
+```bash
+claude-usage
+```
+
+## Usage
+
+### Interactive Mode (Default)
+
+Running `claude-usage` launches an interactive menu where you can explore your usage data:
+
+```bash
+claude-usage
+```
+
+The interactive mode features:
+- 📊 Summary with total sessions, messages, tokens, and costs
+- 📅 Last 7 Days Activity
+- 💎 Token Usage by Model
+- 📁 All Projects view
+- 🔄 Refresh Data
+- Beautiful Claude ASCII art header in orange
+
+### Commands
+
+#### Overview
+Shows total usage statistics, token breakdown by model, and recent activity:
+
+```bash
+claude-usage overview
+```
+
+#### List Projects
+View all projects with session counts and total costs:
+
+```bash
+claude-usage projects
+```
+
+#### View Project
+See all sessions within a specific project:
+
+```bash
+claude-usage project /path/to/project
+```
+
+#### View Session
+Get detailed message-level breakdown for a session:
+
+```bash
+claude-usage session <session-id>
+
+# Or specify project
+claude-usage session <session-id> --project /path/to/project
+```
+
+#### Configuration
+Check current settings and data directory:
+
+```bash
+claude-usage config
+```
+
+### Options
+
+#### Custom Data Directory
+
+By default, the tool reads from `~/.claude`. To use a different location:
+
+```bash
+claude-usage --data-dir /custom/path/to/claude/data
+```
+
+Or set the `CLAUDE_DATA_DIR` environment variable:
+
+```bash
+export CLAUDE_DATA_DIR=/custom/path/to/claude/data
+claude-usage
+```
+
+## Example Output
+
+### Interactive Mode
+
+```
+   ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
+  ██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
+  ██║     ██║     ███████║██║   ██║██║  ██║█████╗
+  ██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝
+  ╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
+   ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
+
+           Usage Visualizer  ・  Track your AI costs
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Summary:
+  💬 Total Sessions:      32
+  📨 Total Messages:      5,393
+  🔢 Total Tokens Used:   141,115,796
+  ⬆️  Total Input Tokens:  54,341,054
+  ⬇️  Total Output Tokens: 12,326
+  💰 Estimated Cost:      $1063.1512
+
+? What would you like to see? (Use arrow keys)
+❯ 📅 Last 7 Days Activity
+  💎 Token Usage by Model
+  📁 All Projects
+  ──────────────
+  🔄 Refresh Data
+  ❌ Exit
+```
+
+### Token Usage by Model
+
+```
+💎 Token Usage by Model:
+
+┌───────────────────────┬────────────┬────────┬─────────────┬────────────┬───────────┐
+│ Model                 │      Input │ Output │ Cache Write │ Cache Read │      Cost │
+├───────────────────────┼────────────┼────────┼─────────────┼────────────┼───────────┤
+│ opus-4-6              │ 54,272,618 │  4,678 │     428,133 │  1,735,051 │ $825.0702 │
+│ sonnet-4-5 (20250929) │     17,478 │    568 │   1,852,448 │ 21,403,174 │  $13.4286 │
+└───────────────────────┴────────────┴────────┴─────────────┴────────────┴───────────┘
+```
+
+## How It Works
+
+Claude Usage CLI reads your local Claude Code data files:
+- `stats-cache.json` - Aggregated statistics
+- `history.jsonl` - Session metadata and names
+- `projects/` - Individual session message logs
+
+All data stays local. No external API calls or data transmission.
+
+## Development
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://github.com/hamid-miran/claude-usage-cli.git
+cd claude-usage-cli
+
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Run locally
+node dist/index.js
+
+# Or use tsx for development
+npm run dev
+```
+
+### Project Structure
+
+```
+src/
+├── index.ts          # Main CLI entry point
+├── types.ts          # TypeScript type definitions
+├── config.ts         # Configuration and data directory
+├── loader.ts         # Data loading from Claude files
+├── pricing.ts        # Token pricing and cost calculation
+└── commands/         # CLI command implementations
+    ├── interactive.ts # Interactive menu mode
+    ├── overview.ts
+    ├── projects.ts
+    ├── project.ts
+    ├── session.ts
+    └── config.ts
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Claude Code data directory (usually `~/.claude`)
+
+## Publishing to npm
+
+To make this available via `npx` for everyone:
+
+1. Create an npm account at [npmjs.com](https://www.npmjs.com)
+2. Login locally: `npm login`
+3. Update package name to be unique (if needed)
+4. Publish: `npm publish`
+
+Then users can run:
+```bash
+npx claude-usage-rzp
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+---
+
+Created by Hamid 👋

package/dist/commands/config.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configCommand = configCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../config");
+function configCommand() {
+    console.log(chalk_1.default.cyan.bold('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.cyan.bold('  Configuration'));
+    console.log(chalk_1.default.cyan.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    console.log(`  Data Directory:       ${chalk_1.default.green((0, config_1.getDataDir)())}`);
+    console.log(`  Has stats-cache.json: ${(0, config_1.hasStatsCache)() ? chalk_1.default.green('✓') : chalk_1.default.red('✗')}`);
+    console.log(`  Has projects/:        ${(0, config_1.hasProjects)() ? chalk_1.default.green('✓') : chalk_1.default.red('✗')}`);
+    console.log(chalk_1.default.dim('\n💡 Set CLAUDE_DATA_DIR environment variable or use --data-dir option\n'));
+}

package/dist/commands/interactive.js

@@ -0,0 +1,217 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.interactiveCommand = interactiveCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const loader_1 = require("../loader");
+const pricing_1 = require("../pricing");
+const config_1 = require("../config");
+async function showSummary() {
+    const stats = (0, loader_1.loadStatsCache)();
+    if (!stats)
+        return false;
+    // Calculate total cost
+    const totalCost = Object.entries(stats.modelStats).reduce((sum, [modelId, model]) => {
+        return (sum +
+            (0, pricing_1.estimateCost)(modelId, model.inputTokens, model.outputTokens, model.cacheCreationInputTokens, model.cacheReadInputTokens));
+    }, 0);
+    // Calculate total cache tokens across all models
+    let totalCacheWrite = 0;
+    let totalCacheRead = 0;
+    for (const model of Object.values(stats.modelStats)) {
+        totalCacheWrite += model.cacheCreationInputTokens;
+        totalCacheRead += model.cacheReadInputTokens;
+    }
+    const totalTokens = stats.totalInputTokens + stats.totalOutputTokens + totalCacheWrite + totalCacheRead;
+    console.log(chalk_1.default.bold('\n📊 Summary:'));
+    console.log(`  💬 Total Sessions:      ${chalk_1.default.green(stats.totalSessions.toLocaleString('en-US'))}`);
+    console.log(`  📨 Total Messages:      ${chalk_1.default.green(stats.totalMessages.toLocaleString('en-US'))}`);
+    console.log(`  🔢 Total Tokens Used:   ${chalk_1.default.green.bold((0, pricing_1.formatTokens)(totalTokens))}`);
+    console.log(`  ⬆️  Total Input Tokens:  ${chalk_1.default.cyan((0, pricing_1.formatTokens)(stats.totalInputTokens))}`);
+    console.log(`  ⬇️  Total Output Tokens: ${chalk_1.default.green((0, pricing_1.formatTokens)(stats.totalOutputTokens))}`);
+    console.log(`  💰 Estimated Cost:      ${chalk_1.default.hex('#FF6B35').bold((0, pricing_1.formatCost)(totalCost))}`);
+    return true;
+}
+async function showLast7Days() {
+    const stats = (0, loader_1.loadStatsCache)();
+    if (!stats)
+        return;
+    const recent = stats.dailyActivity.slice(-7);
+    console.log(chalk_1.default.bold('\n📅 Recent Activity (Last 7 Days):'));
+    const activityTable = new cli_table3_1.default({
+        head: [
+            chalk_1.default.cyan('Date'),
+            chalk_1.default.white('Sessions'),
+            chalk_1.default.white('Messages'),
+            chalk_1.default.white('Tool Calls'),
+        ],
+        colAligns: ['left', 'right', 'right', 'right'],
+    });
+    for (const day of recent) {
+        activityTable.push([
+            day.date,
+            day.sessionCount.toString(),
+            day.messageCount.toString(),
+            day.toolCallCount.toString(),
+        ]);
+    }
+    console.log(activityTable.toString());
+}
+async function showTokensByModel() {
+    const stats = (0, loader_1.loadStatsCache)();
+    if (!stats)
+        return;
+    console.log(chalk_1.default.bold('\n💎 Token Usage by Model:'));
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.cyan('Model'),
+            chalk_1.default.blue('Input'),
+            chalk_1.default.green('Output'),
+            chalk_1.default.yellow('Cache Write'),
+            chalk_1.default.magenta('Cache Read'),
+            chalk_1.default.green.bold('Cost'),
+        ],
+        colAligns: ['left', 'right', 'right', 'right', 'right', 'right'],
+    });
+    for (const [modelId, model] of Object.entries(stats.modelStats)) {
+        const cost = (0, pricing_1.estimateCost)(modelId, model.inputTokens, model.outputTokens, model.cacheCreationInputTokens, model.cacheReadInputTokens);
+        let displayName = modelId.replace('claude-', '').replace(/-20\d{6}/, (match) => ` (${match.substring(1)})`);
+        table.push([
+            displayName,
+            (0, pricing_1.formatTokens)(model.inputTokens),
+            (0, pricing_1.formatTokens)(model.outputTokens),
+            (0, pricing_1.formatTokens)(model.cacheCreationInputTokens),
+            (0, pricing_1.formatTokens)(model.cacheReadInputTokens),
+            (0, pricing_1.formatCost)(cost),
+        ]);
+    }
+    console.log(table.toString());
+}
+async function showProjects() {
+    const projectSummaries = (0, loader_1.buildProjectSummaries)();
+    if (Object.keys(projectSummaries).length === 0) {
+        console.log(chalk_1.default.yellow('\nNo projects found'));
+        return;
+    }
+    const projectData = [];
+    for (const [encodedPath, sessions] of Object.entries(projectSummaries)) {
+        const displayPath = decodeURIComponent(encodedPath);
+        const sessionCount = sessions.length;
+        const totalInput = sessions.reduce((sum, s) => sum + s.totalInputTokens, 0);
+        const totalOutput = sessions.reduce((sum, s) => sum + s.totalOutputTokens, 0);
+        const totalCost = sessions.reduce((sum, s) => sum + s.totalCostUsd, 0);
+        projectData.push({
+            path: displayPath,
+            encoded: encodedPath,
+            sessions: sessionCount,
+            input: totalInput,
+            output: totalOutput,
+            cost: totalCost,
+        });
+    }
+    projectData.sort((a, b) => b.cost - a.cost);
+    console.log(chalk_1.default.bold(`\n📁 Projects (${projectData.length} total):`));
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.cyan('Project Path'),
+            chalk_1.default.white('Sessions'),
+            chalk_1.default.blue('Input Tokens'),
+            chalk_1.default.green('Output Tokens'),
+            chalk_1.default.green.bold('Total Cost'),
+        ],
+        colAligns: ['left', 'right', 'right', 'right', 'right'],
+        colWidths: [40, 10, 15, 15, 12],
+        wordWrap: true,
+    });
+    for (const proj of projectData) {
+        table.push([
+            proj.path,
+            proj.sessions.toString(),
+            (0, pricing_1.formatTokens)(proj.input),
+            (0, pricing_1.formatTokens)(proj.output),
+            (0, pricing_1.formatCost)(proj.cost),
+        ]);
+    }
+    console.log(table.toString());
+}
+async function interactiveCommand() {
+    if (!(0, config_1.hasStatsCache)()) {
+        console.log(chalk_1.default.red(`\n✗ No stats-cache.json found in ${(0, config_1.getDataDir)()}`));
+        console.log(chalk_1.default.dim('Make sure CLAUDE_DATA_DIR is set correctly or use --data-dir option.\n'));
+        process.exit(1);
+    }
+    // Clear screen and show header
+    console.clear();
+    // ASCII Art Header - Claude orange color
+    console.log(chalk_1.default.hex('#FF6B35').bold(`
+   ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
+  ██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
+  ██║     ██║     ███████║██║   ██║██║  ██║█████╗
+  ██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝
+  ╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
+   ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
+  `));
+    console.log(chalk_1.default.hex('#FF6B35')('           Usage Visualizer') + chalk_1.default.dim('  ・  Track your AI costs\n'));
+    console.log(chalk_1.default.dim('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    // Show summary first
+    const hasData = await showSummary();
+    if (!hasData) {
+        console.log(chalk_1.default.red('\n✗ Failed to load stats cache\n'));
+        process.exit(1);
+    }
+    // Interactive menu loop
+    let running = true;
+    while (running) {
+        console.log(); // spacing
+        const { action } = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to see?',
+                choices: [
+                    { name: '📅 Last 7 Days Activity', value: 'last7days' },
+                    { name: '💎 Token Usage by Model', value: 'tokens' },
+                    { name: '📁 All Projects', value: 'projects' },
+                    new inquirer_1.default.Separator(),
+                    { name: '🔄 Refresh Data', value: 'refresh' },
+                    { name: '❌ Exit', value: 'exit' },
+                ],
+            },
+        ]);
+        console.log(); // spacing
+        switch (action) {
+            case 'last7days':
+                await showLast7Days();
+                break;
+            case 'tokens':
+                await showTokensByModel();
+                break;
+            case 'projects':
+                await showProjects();
+                break;
+            case 'refresh':
+                console.clear();
+                // ASCII Art Header - Claude orange color
+                console.log(chalk_1.default.hex('#FF6B35').bold(`
+   ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
+  ██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
+  ██║     ██║     ███████║██║   ██║██║  ██║█████╗
+  ██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝
+  ╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
+   ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
+  `));
+                console.log(chalk_1.default.hex('#FF6B35')('           Usage Visualizer') + chalk_1.default.dim('  ・  Track your AI costs\n'));
+                console.log(chalk_1.default.dim('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+                await showSummary();
+                break;
+            case 'exit':
+                console.log(chalk_1.default.dim('\nHamid said Goodbye! 👋\n'));
+                running = false;
+                break;
+        }
+    }
+}

package/dist/commands/overview.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overviewCommand = overviewCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const loader_1 = require("../loader");
+const pricing_1 = require("../pricing");
+const config_1 = require("../config");
+function overviewCommand() {
+    if (!(0, config_1.hasStatsCache)()) {
+        console.log(chalk_1.default.red(`✗ No stats-cache.json found in ${(0, config_1.getDataDir)()}`));
+        console.log(chalk_1.default.dim('\nMake sure CLAUDE_DATA_DIR is set correctly or use --data-dir option.'));
+        process.exit(1);
+    }
+    const stats = (0, loader_1.loadStatsCache)();
+    if (!stats) {
+        console.log(chalk_1.default.red('✗ Failed to load stats cache'));
+        process.exit(1);
+    }
+    // Header
+    console.log(chalk_1.default.cyan.bold('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.cyan.bold('  Claude Code Usage Overview'));
+    console.log(chalk_1.default.cyan.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    // Calculate total cost
+    const totalCost = Object.entries(stats.modelStats).reduce((sum, [modelId, model]) => {
+        return (sum +
+            (0, pricing_1.estimateCost)(modelId, model.inputTokens, model.outputTokens, model.cacheCreationInputTokens, model.cacheReadInputTokens));
+    }, 0);
+    // Summary stats
+    console.log(chalk_1.default.bold('Summary:'));
+    console.log(`  Total Sessions:      ${chalk_1.default.green(stats.totalSessions.toLocaleString('en-US'))}`);
+    console.log(`  Total Messages:      ${chalk_1.default.green(stats.totalMessages.toLocaleString('en-US'))}`);
+    console.log(`  Total Input Tokens:  ${chalk_1.default.blue((0, pricing_1.formatTokens)(stats.totalInputTokens))}`);
+    console.log(`  Total Output Tokens: ${chalk_1.default.green((0, pricing_1.formatTokens)(stats.totalOutputTokens))}`);
+    console.log(`  Estimated Cost:      ${chalk_1.default.green.bold((0, pricing_1.formatCost)(totalCost))}`);
+    if (stats.firstSessionDate) {
+        console.log(`  First Session:       ${chalk_1.default.dim(stats.firstSessionDate)}`);
+    }
+    if (stats.lastComputedDate) {
+        console.log(`  Last Computed:       ${chalk_1.default.dim(stats.lastComputedDate)}`);
+    }
+    // Token breakdown by model
+    if (Object.keys(stats.modelStats).length > 0) {
+        console.log(chalk_1.default.bold('\nToken Usage by Model:'));
+        const table = new cli_table3_1.default({
+            head: [
+                chalk_1.default.cyan('Model'),
+                chalk_1.default.blue('Input'),
+                chalk_1.default.green('Output'),
+                chalk_1.default.yellow('Cache Write'),
+                chalk_1.default.magenta('Cache Read'),
+                chalk_1.default.green.bold('Cost'),
+            ],
+            colAligns: ['left', 'right', 'right', 'right', 'right', 'right'],
+        });
+        for (const [modelId, model] of Object.entries(stats.modelStats)) {
+            const cost = (0, pricing_1.estimateCost)(modelId, model.inputTokens, model.outputTokens, model.cacheCreationInputTokens, model.cacheReadInputTokens);
+            // Simplify model name
+            let displayName = modelId.replace('claude-', '').replace(/-20\d{6}/, (match) => ` (${match.substring(1)})`);
+            table.push([
+                displayName,
+                (0, pricing_1.formatTokens)(model.inputTokens),
+                (0, pricing_1.formatTokens)(model.outputTokens),
+                (0, pricing_1.formatTokens)(model.cacheCreationInputTokens),
+                (0, pricing_1.formatTokens)(model.cacheReadInputTokens),
+                (0, pricing_1.formatCost)(cost),
+            ]);
+        }
+        console.log(table.toString());
+    }
+    // Recent activity
+    if (stats.dailyActivity.length > 0) {
+        const recent = stats.dailyActivity.slice(-7); // Last 7 days
+        console.log(chalk_1.default.bold('\nRecent Activity (Last 7 Days):'));
+        const activityTable = new cli_table3_1.default({
+            head: [
+                chalk_1.default.cyan('Date'),
+                chalk_1.default.white('Sessions'),
+                chalk_1.default.white('Messages'),
+                chalk_1.default.white('Tool Calls'),
+            ],
+            colAligns: ['left', 'right', 'right', 'right'],
+        });
+        for (const day of recent) {
+            activityTable.push([
+                day.date,
+                day.sessionCount.toString(),
+                day.messageCount.toString(),
+                day.toolCallCount.toString(),
+            ]);
+        }
+        console.log(activityTable.toString());
+    }
+    console.log(chalk_1.default.dim('\n💡 Tip: Use "claude-usage projects" to see all projects\n'));
+}

package/dist/commands/project.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectCommand = projectCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const loader_1 = require("../loader");
+const pricing_1 = require("../pricing");
+function projectCommand(projectPath) {
+    const projectSummaries = (0, loader_1.buildProjectSummaries)();
+    // Try to find the project (handle both encoded and unencoded paths)
+    const encodedPath = encodeURIComponent(projectPath);
+    let sessions;
+    let foundPath = '';
+    if (encodedPath in projectSummaries) {
+        sessions = projectSummaries[encodedPath];
+        foundPath = encodedPath;
+    }
+    else {
+        // Try to find by partial match
+        for (const [path, sess] of Object.entries(projectSummaries)) {
+            if (projectPath.includes(decodeURIComponent(path)) || decodeURIComponent(path).includes(projectPath)) {
+                sessions = sess;
+                foundPath = path;
+                break;
+            }
+        }
+    }
+    if (!sessions) {
+        console.log(chalk_1.default.red(`✗ Project not found: ${projectPath}`));
+        console.log(chalk_1.default.dim('\nAvailable projects:'));
+        for (const path of Object.keys(projectSummaries)) {
+            console.log(`  - ${decodeURIComponent(path)}`);
+        }
+        process.exit(1);
+    }
+    // Sort sessions by timestamp descending
+    sessions = sessions.slice().sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    console.log(chalk_1.default.cyan.bold('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.cyan.bold(`  Project: ${decodeURIComponent(foundPath)}`));
+    console.log(chalk_1.default.dim(`  ${sessions.length} sessions`));
+    console.log(chalk_1.default.cyan.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.cyan('Session'),
+            chalk_1.default.dim('Timestamp'),
+            chalk_1.default.white('Messages'),
+            chalk_1.default.blue('Input'),
+            chalk_1.default.green('Output'),
+            chalk_1.default.green.bold('Cost'),
+            chalk_1.default.yellow('Models'),
+        ],
+        colAligns: ['left', 'left', 'right', 'right', 'right', 'right', 'left'],
+        colWidths: [30, 20, 10, 12, 12, 10, 20],
+        wordWrap: true,
+    });
+    for (const session of sessions) {
+        // Truncate slug if too long
+        const slugDisplay = session.slug.length > 60 ? session.slug.substring(0, 57) + '...' : session.slug;
+        // Format timestamp
+        const timestamp = session.timestamp ? new Date(session.timestamp).toLocaleString('en-US') : 'N/A';
+        table.push([
+            slugDisplay,
+            timestamp,
+            session.messageCount.toString(),
+            (0, pricing_1.formatTokens)(session.totalInputTokens),
+            (0, pricing_1.formatTokens)(session.totalOutputTokens),
+            (0, pricing_1.formatCost)(session.totalCostUsd),
+            Array.from(session.modelsUsed)
+                .map(m => m.replace('claude-', ''))
+                .join(', '),
+        ]);
+    }
+    console.log(table.toString());
+    console.log(chalk_1.default.dim('\n💡 Tip: Use "claude-usage session <session-id>" to see message details\n'));
+}