ccusage-collector 0.1.0

package/.env.example

@@ -0,0 +1,9 @@
+# Example usage:
+# npx ccusage-collector --api-key=your-key --endpoint=https://example.com/api/usage-sync
+# npx ccusage-collector --api-key=your-key --endpoint=https://example.com/api/usage-sync --schedule="0 */4 * * *"
+
+# API endpoint for syncing usage data
+API_ENDPOINT=https://example.com/api/usage-sync
+
+# API key for authentication
+API_KEY=your-api-key-here

package/.turbo/turbo-lint.log

@@ -0,0 +1,7 @@
+
+
+> ccusage-collector@0.1.0 lint /Users/didi/Documents/Code/MyCCusage/packages/ccusage-collector
+> eslint . --max-warnings 0
+
+sh: eslint: command not found
+ ELIFECYCLE  Command failed.

package/LICENSE

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

package/README.md

@@ -0,0 +1,242 @@
+# ccusage-collector
+
+A command-line tool for collecting Claude Code usage statistics and syncing them to your self-hosted My Claude Code Usage Dashboard.
+
+## Overview
+
+This package automatically collects your local Claude Code usage data and syncs it to your dashboard, giving you insights into your AI-assisted development workflow.
+
+## Installation
+
+```bash
+npm install -g ccusage-collector
+npm install -g pm2
+```
+
+## Prerequisites
+
+- Node.js ≥20
+- PM2 process manager (for reliable background execution)
+- Claude Code CLI installed and configured
+- Access to a deployed My Claude Code Usage Dashboard
+
+## Quick Start
+
+### 1. Basic sync (run once)
+
+```bash
+ccusage-collector --api-key=your-api-key --endpoint=https://example.com/api/usage-sync
+```
+
+### 2. Scheduled sync (recommended - runs in background)
+
+```bash
+pm2 start ccusage-collector -- --api-key=your-api-key --endpoint=https://example.com/api/usage-sync --schedule="0 */4 * * *"
+```
+
+### 3. Test data collection (dry run)
+
+```bash
+ccusage-collector --api-key=test --endpoint=https://example.com/api/usage-sync --dry-run
+```
+
+## CLI Options
+
+| Option | Description | Required | Default |
+|--------|-------------|----------|---------|
+| `-k, --api-key <key>` | API key for authentication | Yes | - |
+| `-e, --endpoint <url>` | API endpoint URL | Yes | - |
+| `-s, --schedule <cron>` | Cron schedule for periodic sync | No | - |
+| `-r, --max-retries <number>` | Maximum retry attempts | No | 3 |
+| `-d, --retry-delay <ms>` | Delay between retries (ms) | No | 1000 |
+| `--dry-run` | Collect data but don't sync | No | false |
+| `-h, --help` | Show help | No | - |
+| `-V, --version` | Show version | No | - |
+
+## Usage Examples
+
+### One-time sync
+```bash
+ccusage-collector --api-key=sk-1234567890abcdef --endpoint=https://myccusage.example.com/api/usage-sync
+```
+
+### Scheduled sync (every 6 hours) - Background execution
+```bash
+pm2 start ccusage-collector -- \
+  --api-key=sk-1234567890abcdef \
+  --endpoint=https://myccusage.example.com/api/usage-sync \
+  --schedule="0 */6 * * *"
+```
+
+### Test without syncing
+```bash
+ccusage-collector \
+  --api-key=test \
+  --endpoint=https://myccusage.example.com/api/usage-sync \
+  --dry-run
+```
+
+## Cron Schedule Examples
+
+| Schedule | Description |
+|----------|-------------|
+| `"0 */4 * * *"` | Every 4 hours |
+| `"*/10 * * * *"` | Every 10 minutes |
+| `"0 0 * * *"` | Daily at midnight |
+| `"0 */1 * * *"` | Every hour |
+| `"0 9,17 * * 1-5"` | 9 AM and 5 PM on weekdays |
+
+## Setup Guide
+
+### 1. Deploy the Dashboard
+First, deploy your own instance of My Claude Code Usage Dashboard:
+- Clone the repository
+- Set up PostgreSQL database
+- Configure environment variables
+- Deploy to your preferred platform
+
+### 2. Get API Key
+Set the `API_KEY` environment variable in your dashboard deployment:
+```env
+API_KEY=your-secret-api-key-here
+```
+
+### 3. Install and Run Collector
+```bash
+npm install -g ccusage-collector
+npm install -g pm2
+
+# Start background sync
+pm2 start ccusage-collector -- --api-key=your-secret-api-key-here --endpoint=https://your-domain.com/api/usage-sync --schedule="0 */4 * * *"
+```
+
+## Data Collection
+
+The collector:
+- Uses `npx ccusage daily --json` to gather usage statistics
+- Collects historical data (not just recent usage)
+- Syncs complete usage records to your dashboard
+- Supports upsert operations (updates existing records)
+
+### Data Format
+The collector syncs:
+- Daily usage metrics (tokens, costs, models)
+- Token breakdowns (input, output, cache creation/read)
+- Model usage statistics
+- Raw usage data for detailed analysis
+
+## Error Handling
+
+- **Network failures**: Automatic retry with exponential backoff
+- **Authentication errors**: Immediate failure (no retry on 401/403)
+- **Individual record failures**: Continues processing other records
+- **Detailed logging**: Clear error messages and debugging info
+
+## Process Management with PM2
+
+For reliable background execution, use PM2 to manage the collector process:
+
+### Start Background Sync
+```bash
+pm2 start ccusage-collector -- --api-key=your-key --endpoint=https://your-domain.com/api/usage-sync --schedule="0 */4 * * *"
+```
+
+### Check Status
+```bash
+pm2 list                    # Show all processes
+pm2 show ccusage-collector  # Show detailed info
+pm2 logs ccusage-collector  # View logs
+pm2 monit                   # Real-time monitoring
+```
+
+### Control Process
+```bash
+pm2 stop ccusage-collector     # Stop process
+pm2 restart ccusage-collector  # Restart process
+pm2 delete ccusage-collector   # Remove process
+```
+
+### Auto-start on Boot
+```bash
+pm2 startup                    # Generate startup script
+pm2 save                       # Save current process list
+```
+
+### Benefits of PM2
+- **Automatic restart** if process crashes
+- **Background execution** - no need to keep terminal open
+- **Process monitoring** and logging
+- **Prevents duplicate instances** - safe to run multiple times
+- **Cross-platform** - works on Windows, Linux, and macOS
+
+## Troubleshooting
+
+### Common Issues
+
+**"ccusage command not found"**
+- Ensure Claude Code CLI is installed and in PATH
+- Run `npx ccusage --help` to verify installation
+
+**"Authentication failed"**
+- Verify API key matches your dashboard configuration
+- Check that API key is correctly set in dashboard environment
+
+**"Connection refused"**
+- Verify endpoint URL is correct and accessible
+- Check that your dashboard is running and deployed
+
+**"Invalid cron expression"**
+- Use online cron validators to test expressions
+- Ensure cron format is correct (5 fields: minute hour day month weekday)
+
+### Debug Mode
+```bash
+# Enable verbose logging
+DEBUG=ccusage-collector ccusage-collector --api-key=... --endpoint=...
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Development
+
+```bash
+# Clone the main repository
+git clone https://github.com/i-richardwang/MyCCusage.git
+cd MyCCusage/packages/ccusage-collector
+
+# Install dependencies
+pnpm install
+
+# Build the package
+pnpm build
+
+# Test CLI locally
+pnpm cli --help
+pnpm cli --dry-run --api-key=test --endpoint=http://localhost:3000
+
+# Run type checking
+pnpm typecheck
+
+# Run linting
+pnpm lint
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [My Claude Code Usage Dashboard](https://github.com/i-richardwang/MyCCusage) - The main dashboard application
+- [Claude Code](https://claude.ai/code) - The AI-powered coding assistant
+
+## Support
+
+- 🐛 [Report bugs](https://github.com/i-richardwang/MyCCusage/issues)
+- 💡 [Request features](https://github.com/i-richardwang/MyCCusage/issues)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import * as cron from 'node-cron';
+import { UsageCollector } from './collector.js';
+program
+    .name('ccusage-collector')
+    .description('Collect and sync Claude Code usage statistics')
+    .version('0.1.0');
+program
+    .option('-k, --api-key <key>', 'API key for authentication')
+    .option('-e, --endpoint <url>', 'API endpoint URL')
+    .option('-s, --schedule <cron>', `Cron schedule for periodic sync
+Examples:
+  "0 */4 * * *"    - Every 4 hours
+  "*/10 * * * *"   - Every 10 minutes`)
+    .option('-r, --max-retries <number>', 'Maximum number of retry attempts', '3')
+    .option('-d, --retry-delay <ms>', 'Delay between retry attempts in milliseconds', '1000')
+    .option('--dry-run', 'Collect data but don\'t sync to server')
+    .action(async (options) => {
+    // Validate required options
+    if (!options.apiKey) {
+        console.error('Error: API key is required (--api-key)');
+        process.exit(1);
+    }
+    if (!options.endpoint) {
+        console.error('Error: API endpoint is required (--endpoint)');
+        process.exit(1);
+    }
+    const config = {
+        apiKey: options.apiKey,
+        endpoint: options.endpoint,
+        maxRetries: parseInt(options.maxRetries),
+        retryDelay: parseInt(options.retryDelay)
+    };
+    const collector = new UsageCollector(config);
+    if (options.dryRun) {
+        console.log('Dry run mode: collecting data only');
+        try {
+            const data = await collector.collectUsageData();
+            console.log('Collected data:', JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            console.error('Failed to collect data:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+        return;
+    }
+    if (options.schedule) {
+        console.log(`Starting scheduled sync with cron: ${options.schedule}`);
+        // Validate cron expression
+        if (!cron.validate(options.schedule)) {
+            console.error('Error: Invalid cron expression');
+            process.exit(1);
+        }
+        // Run once immediately
+        console.log('Running initial sync...');
+        await collector.run();
+        // Schedule periodic runs
+        cron.schedule(options.schedule, async () => {
+            console.log(`\n[${new Date().toISOString()}] Running scheduled sync...`);
+            await collector.run();
+        });
+        console.log('Scheduled sync is running. Press Ctrl+C to stop.');
+        // Keep the process running
+        process.on('SIGINT', () => {
+            console.log('\nStopping scheduled sync...');
+            process.exit(0);
+        });
+    }
+    else {
+        // Run once
+        await collector.run();
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/collector.d.ts

@@ -0,0 +1,9 @@
+import type { UsageData, SyncResult, CollectorConfig } from './types.js';
+export declare class UsageCollector {
+    private config;
+    constructor(config: CollectorConfig);
+    collectUsageData(): Promise<UsageData>;
+    syncData(data: UsageData): Promise<SyncResult>;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAIxE,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,eAAe;IAQ7B,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC;IAqBtC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAqE9C,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3B"}

package/dist/collector.js

@@ -0,0 +1,102 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import axios from 'axios';
+const execAsync = promisify(exec);
+export class UsageCollector {
+    config;
+    constructor(config) {
+        this.config = {
+            maxRetries: 3,
+            retryDelay: 1000,
+            ...config
+        };
+    }
+    async collectUsageData() {
+        try {
+            console.log('Collecting usage data...');
+            const { stdout } = await execAsync('npx ccusage daily --json');
+            const data = JSON.parse(stdout);
+            if (!data.daily || !Array.isArray(data.daily)) {
+                throw new Error('Invalid usage data format');
+            }
+            console.log(`Collected ${data.daily.length} daily records`);
+            return data;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to collect usage data: ${error.message}`);
+            }
+            throw new Error('Failed to collect usage data: Unknown error');
+        }
+    }
+    async syncData(data) {
+        const { endpoint, apiKey, maxRetries = 3, retryDelay = 1000 } = this.config;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                console.log(`Syncing data (attempt ${attempt}/${maxRetries})...`);
+                const response = await axios.post(endpoint, data, {
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'x-api-key': apiKey
+                    },
+                    timeout: 30000
+                });
+                const result = response.data;
+                if (result.success) {
+                    console.log(`Successfully synced ${result.processed} records`);
+                    // Log any errors for individual records
+                    const errors = result.results.filter(r => r.status === 'error');
+                    if (errors.length > 0) {
+                        console.warn(`${errors.length} records had errors:`);
+                        errors.forEach(error => {
+                            console.warn(`  - ${error.date}: ${error.message}`);
+                        });
+                    }
+                    return result;
+                }
+                else {
+                    throw new Error('Sync failed: ' + JSON.stringify(result));
+                }
+            }
+            catch (error) {
+                const isLastAttempt = attempt === maxRetries;
+                if (axios.isAxiosError(error)) {
+                    const status = error.response?.status;
+                    const message = error.response?.data?.error || error.message;
+                    console.error(`Sync failed (attempt ${attempt}/${maxRetries}): ${status} - ${message}`);
+                    // Don't retry on authentication errors
+                    if (status === 401 || status === 403) {
+                        throw new Error(`Authentication failed: ${message}`);
+                    }
+                    if (isLastAttempt) {
+                        throw new Error(`Sync failed after ${maxRetries} attempts: ${message}`);
+                    }
+                }
+                else {
+                    console.error(`Sync failed (attempt ${attempt}/${maxRetries}):`, error);
+                    if (isLastAttempt) {
+                        throw error;
+                    }
+                }
+                // Wait before retrying
+                if (!isLastAttempt) {
+                    console.log(`Retrying in ${retryDelay}ms...`);
+                    await new Promise(resolve => setTimeout(resolve, retryDelay));
+                }
+            }
+        }
+        throw new Error('Sync failed after all retries');
+    }
+    async run() {
+        try {
+            const data = await this.collectUsageData();
+            await this.syncData(data);
+            console.log('Usage data sync completed successfully');
+        }
+        catch (error) {
+            console.error('Usage data sync failed:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=collector.js.map

package/dist/collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.js","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { UsageCollector } from './collector.js';
+export type { DailyUsageRecord, UsageData, SyncResult, CollectorConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,eAAe,EAChB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { UsageCollector } from './collector.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export interface DailyUsageRecord {
+    date: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    totalTokens: number;
+    totalCost: number;
+    modelsUsed: string[];
+    modelBreakdowns: Array<{
+        modelName: string;
+        inputTokens: number;
+        outputTokens: number;
+        cacheCreationTokens: number;
+        cacheReadTokens: number;
+        cost: number;
+    }>;
+}
+export interface UsageData {
+    daily: DailyUsageRecord[];
+    totals: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheCreationTokens: number;
+        cacheReadTokens: number;
+        totalCost: number;
+        totalTokens: number;
+    };
+}
+export interface SyncResult {
+    success: boolean;
+    processed: number;
+    results: Array<{
+        date: string;
+        status: 'success' | 'error';
+        message?: string;
+    }>;
+}
+export interface CollectorConfig {
+    endpoint: string;
+    apiKey: string;
+    schedule?: string;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,KAAK,CAAC;QACrB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,eAAe,EAAE,MAAM,CAAA;QACvB,IAAI,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;CACH;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,eAAe,EAAE,MAAM,CAAA;QACvB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAC,CAAA;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/eslint.config.js

@@ -0,0 +1,13 @@
+import baseConfig from '@workspace/eslint-config/base.js'
+
+export default [
+  ...baseConfig,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: true,
+        tsconfigRootDir: import.meta.dirname
+      }
+    }
+  }
+]

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "ccusage-collector",
+  "version": "0.1.0",
+  "description": "Local collector for Claude Code usage statistics",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "ccusage-collector": "dist/cli.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "usage",
+    "collector",
+    "statistics",
+    "cli",
+    "monitoring",
+    "dashboard"
+  ],
+  "author": "Richard Wang",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/i-richardwang/MyCCusage.git",
+    "directory": "packages/ccusage-collector"
+  },
+  "bugs": {
+    "url": "https://github.com/i-richardwang/MyCCusage/issues"
+  },
+  "homepage": "https://github.com/i-richardwang/MyCCusage#readme",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20",
+    "@types/node-cron": "^3.0.11",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "@workspace/typescript-config": "0.0.0",
+    "@workspace/eslint-config": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "axios": "^1.10.0",
+    "commander": "^14.0.0",
+    "dotenv": "^17.1.0",
+    "node-cron": "^4.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "cli": "tsx src/cli.ts",
+    "lint": "eslint . --max-warnings 0",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+import { program } from 'commander'
+import * as cron from 'node-cron'
+import { UsageCollector } from './collector.js'
+import type { CollectorConfig } from './types.js'
+
+program
+  .name('ccusage-collector')
+  .description('Collect and sync Claude Code usage statistics')
+  .version('0.1.0')
+
+program
+  .option('-k, --api-key <key>', 'API key for authentication')
+  .option('-e, --endpoint <url>', 'API endpoint URL')
+  .option('-s, --schedule <cron>', `Cron schedule for periodic sync
+Examples:
+  "0 */4 * * *"    - Every 4 hours
+  "*/10 * * * *"   - Every 10 minutes`)
+  .option('-r, --max-retries <number>', 'Maximum number of retry attempts', '3')
+  .option('-d, --retry-delay <ms>', 'Delay between retry attempts in milliseconds', '1000')
+  .option('--dry-run', 'Collect data but don\'t sync to server')
+  .action(async (options) => {
+    // Validate required options
+    if (!options.apiKey) {
+      console.error('Error: API key is required (--api-key)')
+      process.exit(1)
+    }
+    
+    if (!options.endpoint) {
+      console.error('Error: API endpoint is required (--endpoint)')
+      process.exit(1)
+    }
+
+    const config: CollectorConfig = {
+      apiKey: options.apiKey,
+      endpoint: options.endpoint,
+      maxRetries: parseInt(options.maxRetries),
+      retryDelay: parseInt(options.retryDelay)
+    }
+
+    const collector = new UsageCollector(config)
+
+    if (options.dryRun) {
+      console.log('Dry run mode: collecting data only')
+      try {
+        const data = await collector.collectUsageData()
+        console.log('Collected data:', JSON.stringify(data, null, 2))
+      } catch (error) {
+        console.error('Failed to collect data:', error instanceof Error ? error.message : error)
+        process.exit(1)
+      }
+      return
+    }
+
+    if (options.schedule) {
+      console.log(`Starting scheduled sync with cron: ${options.schedule}`)
+      
+      // Validate cron expression
+      if (!cron.validate(options.schedule)) {
+        console.error('Error: Invalid cron expression')
+        process.exit(1)
+      }
+      
+      // Run once immediately
+      console.log('Running initial sync...')
+      await collector.run()
+      
+      // Schedule periodic runs
+      cron.schedule(options.schedule, async () => {
+        console.log(`\n[${new Date().toISOString()}] Running scheduled sync...`)
+        await collector.run()
+      })
+      
+      console.log('Scheduled sync is running. Press Ctrl+C to stop.')
+      
+      // Keep the process running
+      process.on('SIGINT', () => {
+        console.log('\nStopping scheduled sync...')
+        process.exit(0)
+      })
+    } else {
+      // Run once
+      await collector.run()
+    }
+  })
+
+program.parse()

package/src/collector.ts

@@ -0,0 +1,119 @@
+import { exec } from 'child_process'
+import { promisify } from 'util'
+import axios from 'axios'
+import type { UsageData, SyncResult, CollectorConfig } from './types.js'
+
+const execAsync = promisify(exec)
+
+export class UsageCollector {
+  private config: CollectorConfig
+
+  constructor(config: CollectorConfig) {
+    this.config = {
+      maxRetries: 3,
+      retryDelay: 1000,
+      ...config
+    }
+  }
+
+  async collectUsageData(): Promise<UsageData> {
+    try {
+      console.log('Collecting usage data...')
+      const { stdout } = await execAsync('npx ccusage daily --json')
+      
+      const data: UsageData = JSON.parse(stdout)
+      
+      if (!data.daily || !Array.isArray(data.daily)) {
+        throw new Error('Invalid usage data format')
+      }
+      
+      console.log(`Collected ${data.daily.length} daily records`)
+      return data
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`Failed to collect usage data: ${error.message}`)
+      }
+      throw new Error('Failed to collect usage data: Unknown error')
+    }
+  }
+
+  async syncData(data: UsageData): Promise<SyncResult> {
+    const { endpoint, apiKey, maxRetries = 3, retryDelay = 1000 } = this.config
+    
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      try {
+        console.log(`Syncing data (attempt ${attempt}/${maxRetries})...`)
+        
+        const response = await axios.post(endpoint, data, {
+          headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': apiKey
+          },
+          timeout: 30000
+        })
+
+        const result: SyncResult = response.data
+        
+        if (result.success) {
+          console.log(`Successfully synced ${result.processed} records`)
+          
+          // Log any errors for individual records
+          const errors = result.results.filter(r => r.status === 'error')
+          if (errors.length > 0) {
+            console.warn(`${errors.length} records had errors:`)
+            errors.forEach(error => {
+              console.warn(`  - ${error.date}: ${error.message}`)
+            })
+          }
+          
+          return result
+        } else {
+          throw new Error('Sync failed: ' + JSON.stringify(result))
+        }
+      } catch (error) {
+        const isLastAttempt = attempt === maxRetries
+        
+        if (axios.isAxiosError(error)) {
+          const status = error.response?.status
+          const message = error.response?.data?.error || error.message
+          
+          console.error(`Sync failed (attempt ${attempt}/${maxRetries}): ${status} - ${message}`)
+          
+          // Don't retry on authentication errors
+          if (status === 401 || status === 403) {
+            throw new Error(`Authentication failed: ${message}`)
+          }
+          
+          if (isLastAttempt) {
+            throw new Error(`Sync failed after ${maxRetries} attempts: ${message}`)
+          }
+        } else {
+          console.error(`Sync failed (attempt ${attempt}/${maxRetries}):`, error)
+          
+          if (isLastAttempt) {
+            throw error
+          }
+        }
+        
+        // Wait before retrying
+        if (!isLastAttempt) {
+          console.log(`Retrying in ${retryDelay}ms...`)
+          await new Promise(resolve => setTimeout(resolve, retryDelay))
+        }
+      }
+    }
+    
+    throw new Error('Sync failed after all retries')
+  }
+
+  async run(): Promise<void> {
+    try {
+      const data = await this.collectUsageData()
+      await this.syncData(data)
+      console.log('Usage data sync completed successfully')
+    } catch (error) {
+      console.error('Usage data sync failed:', error instanceof Error ? error.message : error)
+      process.exit(1)
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+export { UsageCollector } from './collector.js'
+export type { 
+  DailyUsageRecord, 
+  UsageData, 
+  SyncResult, 
+  CollectorConfig 
+} from './types.js'

package/src/types.ts

@@ -0,0 +1,48 @@
+export interface DailyUsageRecord {
+  date: string
+  inputTokens: number
+  outputTokens: number
+  cacheCreationTokens: number
+  cacheReadTokens: number
+  totalTokens: number
+  totalCost: number
+  modelsUsed: string[]
+  modelBreakdowns: Array<{
+    modelName: string
+    inputTokens: number
+    outputTokens: number
+    cacheCreationTokens: number
+    cacheReadTokens: number
+    cost: number
+  }>
+}
+
+export interface UsageData {
+  daily: DailyUsageRecord[]
+  totals: {
+    inputTokens: number
+    outputTokens: number
+    cacheCreationTokens: number
+    cacheReadTokens: number
+    totalCost: number
+    totalTokens: number
+  }
+}
+
+export interface SyncResult {
+  success: boolean
+  processed: number
+  results: Array<{
+    date: string
+    status: 'success' | 'error'
+    message?: string
+  }>
+}
+
+export interface CollectorConfig {
+  endpoint: string
+  apiKey: string
+  schedule?: string
+  maxRetries?: number
+  retryDelay?: number
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "@workspace/typescript-config/base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}