@lemantorus/opencode-analytics 1.0.0

package/README.md

@@ -0,0 +1,211 @@
+# OpenCode Analytics
+
+> ⚠️ **Unofficial** - This is a community-built dashboard, not affiliated with or endorsed by [Anomaly](https://anoma.ly) (the creators of OpenCode).
+
+A beautiful, real-time analytics dashboard for OpenCode that visualizes your AI coding usage, token consumption, costs, and model performance.
+
+![Dashboard Preview](https://via.placeholder.com/800x400/0a0a0a/00ff88?text=OpenCode+Analytics+Dashboard)
+
+## Features
+
+### 📊 Usage Overview
+- Total messages count
+- Input/Output token breakdown
+- Cache read/write statistics
+- Estimated cost calculation
+
+### 📈 Daily Usage Trend
+- Interactive line chart showing token usage over time
+- Toggle between Tokens view and Cost view
+- Supports custom date ranges
+
+### 🤖 Model Breakdown
+- Comprehensive table of all models used
+- Per-model statistics: messages, input/output tokens, cache, cost
+- Visual bar chart comparison
+- Cost distribution doughnut chart
+
+### ⚡ Models Usage (TPS)
+- Real tokens-per-second calculation using actual response times
+- Select which models to compare (multi-select dropdown)
+- Shows average TPS per day over the last 30 days
+- Tooltip shows tree format with TPS + input/output tokens:
+  ```
+  Model Name
+    ├─ TPS: 45.23 tok/s
+    └─ In: 12.5K | Out: 8.2K
+  ```
+
+**How TPS is calculated:**
+```
+Output TPS = outputTokens / ((time.completed - time.created) / 1000)
+```
+This uses the actual response start and completion timestamps from each message, providing true generation speed metrics.
+
+### 🕐 Hourly Activity
+- See your most productive hours
+- Toggle between Messages count and TPS view
+- Visual indication of peak hours (business hours highlighted)
+
+### 💰 Cost Management
+- Automatic pricing from models.dev API
+- Manual price overrides per model
+- Total estimated cost tracking
+
+### 🎨 Design
+- Dark theme optimized for developers
+- JetBrains Mono font
+- Smooth animations
+- Responsive layout
+
+## Installation
+
+### From npm (recommended)
+
+```bash
+npm install -g @lemantorus/opencode-analytics
+```
+
+### From source
+
+```bash
+git clone https://github.com/lemantorus/opencode_analytics.git
+cd opencode_analytics
+npm install
+```
+
+## Usage
+
+### Quick Start
+
+Simply run from anywhere:
+
+```bash
+opencode-analytics
+```
+
+This will:
+1. Auto-detect your OpenCode database location based on your OS
+2. Start the server on http://localhost:3456
+3. Open the dashboard in your default browser
+
+### Command Line Options
+
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--port` | `-p` | Port to run server on | 3456 |
+| `--db` | - | Path to OpenCode database | Auto-detected |
+| `--no-open` | - | Don't open browser automatically | false |
+| `--help` | `-h` | Show help message | - |
+
+### Examples
+
+```bash
+# Run on custom port
+opencode-analytics --port 4000
+
+# Use custom database path
+opencode-analytics --db /path/to/opencode.db
+
+# Don't open browser
+opencode-analytics --no-open
+
+# Combine options
+opencode-analytics -p 3000 --db ~/custom/opencode.db --no-open
+```
+
+### Environment Variables
+
+```bash
+# Override database path
+OPENCODE_DB_PATH=/custom/path/opencode.db opencode-analytics
+
+# Override port
+PORT=4000 opencode-analytics
+```
+
+## Database Locations
+
+OpenCode stores its SQLite database in platform-specific locations:
+
+| OS | Path |
+|----|------|
+| Linux | `~/.local/share/opencode/opencode.db` |
+| macOS | `~/.local/share/opencode/opencode.db` |
+| Windows | `%USERPROFILE%\.local\share\opencode\opencode.db` |
+
+The application automatically detects your OS and finds the database. You can override this with the `--db` flag or `OPENCODE_DB_PATH` environment variable.
+
+## Custom Pricing
+
+The dashboard fetches live pricing from [models.dev](https://models.dev), but you can override prices for any model:
+
+1. Click "Edit Pricing" button
+2. Modify prices per 1M tokens
+3. Click "Save" for each model
+
+Your custom prices are stored locally and will persist across sessions.
+
+## Development
+
+### Running from source
+
+```bash
+# Clone the repository
+git clone https://github.com/lemantorus/opencode_analytics.git
+cd opencode_analytics
+
+# Install dependencies
+npm install
+
+# Start the server
+npm start
+```
+
+### Project Structure
+
+```
+opencode-analytics/
+├── bin/
+│   └── opencode-analytics.js    # CLI entry point
+├── server/
+│   ├── index.js                # Express server
+│   ├── db.js                   # Database queries
+│   ├── pricing.json            # Cached pricing data
+│   └── user-prices.json        # User overrides
+├── public/
+│   ├── index.html              # Dashboard HTML
+│   ├── app.js                  # Frontend JavaScript
+│   └── styles.css              # Dashboard styles
+├── package.json
+└── README.md
+```
+
+## Tech Stack
+
+- **Backend**: Node.js, Express
+- **Database**: SQLite (OpenCode's native DB)
+- **Frontend**: Vanilla JavaScript, Chart.js
+- **Build**: No build step required
+
+## License
+
+MIT License - feel free to use, modify, and distribute.
+
+## Author
+
+Built by [Lemantorus](https://github.com/lemantorus) - Not affiliated with [Anomaly](https://anoma.ly) or the official OpenCode project.
+
+## Credits
+
+- [OpenCode](https://opencode.ai) - The amazing AI coding agent
+- [models.dev](https://models.dev) - For real-time model pricing
+- [Chart.js](https://www.chartjs.org) - Beautiful charts
+
+## Support
+
+If you encounter any issues or have suggestions:
+
+1. Check the [issues](https://github.com/lemantorus/opencode_analytics/issues)
+2. Open a new issue if needed
+3. Contributions are welcome!

package/bin/opencode-analytics.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+const path = require('path');
+const fs = require('fs');
+const { spawn } = require('child_process');
+const { parseArgs } = require('util');
+
+const HELP_TEXT = `
+OpenCode Analytics
+===================
+
+Usage: opencode-analytics [options]
+
+Options:
+  --port, -p <port>    Port to run server on (default: 3456)
+  --db <path>          Path to OpenCode database (auto-detected by OS)
+  --no-open            Don't open browser automatically
+  --help, -h          Show this help message
+
+Examples:
+  opencode-analytics
+  opencode-analytics --port 4000
+  opencode-analytics --db /custom/path/opencode.db
+  opencode-analytics --port 3000 --no-open
+
+Database locations by OS:
+  Linux/macOS:  ~/.local/share/opencode/opencode.db
+  Windows:       %USERPROFILE%\\.local\\share\\opencode\\opencode.db
+
+Override with: OPENCODE_DB_PATH environment variable
+`;
+
+function detectDbPath() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  
+  if (!home) {
+    console.error('Could not detect home directory');
+    process.exit(1);
+  }
+  
+  const dataDir = path.join(home, '.local', 'share', 'opencode');
+  const dbPath = path.join(dataDir, 'opencode.db');
+  
+  return dbPath;
+}
+
+function findDbPath() {
+  if (process.env.OPENCODE_DB_PATH) {
+    return process.env.OPENCODE_DB_PATH;
+  }
+  return detectDbPath();
+}
+
+async function openBrowser(url) {
+  const open = (await import('open')).default;
+  open(url);
+}
+
+async function main() {
+  const options = {
+    port: {
+      type: 'string',
+      short: 'p',
+      default: '3456'
+    },
+    db: {
+      type: 'string'
+    },
+    'no-open': {
+      type: 'boolean',
+      default: false
+    },
+    help: {
+      type: 'boolean',
+      short: 'h',
+      default: false
+    }
+  };
+  
+  let args;
+  try {
+    args = parseArgs({ options, allowPositionals: false });
+  } catch (e) {
+    console.error('Invalid arguments:', e.message);
+    console.log(HELP_TEXT);
+    process.exit(1);
+  }
+  
+  if (args.values.help) {
+    console.log(HELP_TEXT);
+    process.exit(0);
+  }
+  
+  const port = parseInt(args.values.port) || 3456;
+  const dbPath = args.values.db || findDbPath();
+  const shouldOpen = !args.values['no-open'];
+  
+  console.log(`OpenCode Analytics v1.0.0`);
+  console.log(`Database: ${dbPath}`);
+  
+  if (!fs.existsSync(dbPath)) {
+    console.error(`\nError: Database not found at: ${dbPath}`);
+    console.error(`\nPlease ensure OpenCode has been used at least once on this machine.`);
+    console.error(`Or specify a custom DB path with: --db /path/to/opencode.db`);
+    process.exit(1);
+  }
+  
+  const serverPath = path.join(__dirname, '..', 'server', 'index.js');
+  
+  if (!fs.existsSync(serverPath)) {
+    console.error(`Error: Server not found at: ${serverPath}`);
+    process.exit(1);
+  }
+  
+  process.env.OPENCODE_DB_PATH = dbPath;
+  process.env.PORT = port;
+  
+  const serverProcess = spawn(process.execPath, [serverPath], {
+    env: { ...process.env, OPENCODE_DB_PATH: dbPath, PORT: port.toString() },
+    stdio: 'inherit'
+  });
+  
+  serverProcess.on('error', (err) => {
+    console.error('Server error:', err);
+    process.exit(1);
+  });
+  
+  serverProcess.on('close', (code) => {
+    process.exit(code);
+  });
+  
+  setTimeout(async () => {
+    const url = `http://localhost:${port}`;
+    console.log(`\nServer running at: ${url}`);
+    
+    if (shouldOpen) {
+      console.log('Opening browser...');
+      await openBrowser(url);
+    }
+  }, 1000);
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@lemantorus/opencode-analytics",
+  "version": "1.0.0",
+  "description": "Analytics dashboard for OpenCode - visualize your AI coding usage (unofficial)",
+  "main": "server/index.js",
+  "bin": {
+    "opencode-analytics": "./bin/opencode-analytics.js"
+  },
+  "files": [
+    "bin",
+    "server",
+    "public"
+  ],
+  "scripts": {
+    "start": "node bin/opencode-analytics.js"
+  },
+  "keywords": [
+    "opencode",
+    "analytics",
+    "ai",
+    "llm",
+    "usage",
+    "dashboard"
+  ],
+  "license": "MIT",
+  "author": "Lemantorus <andrew@example.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lemantorus/opencode_analytics"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "express": "^4.22.1",
+    "open": "^10.1.0"
+  }
+}