opencode-token-tracker 1.3.0 → 1.3.1

package/README.md

@@ -183,6 +183,35 @@ Create a config file at `~/.config/opencode/token-tracker.json`:
 }
 ```
 
+### Pricing Fields Explained
+
+All prices are in **USD per 1 million tokens**:
+
+| Field | Description | Example |
+|-------|-------------|---------|
+| `input` | Cost for input/prompt tokens | `15` = $15 per 1M tokens |
+| `output` | Cost for output/completion tokens | `75` = $75 per 1M tokens |
+| `cacheRead` | Cost for cached input tokens (optional) | `1.5` = $1.5 per 1M tokens |
+| `cacheWrite` | Cost for cache write tokens (optional) | `18.75` = $18.75 per 1M tokens |
+
+**How to find pricing for your model:**
+
+1. Check the provider's official pricing page:
+   - [Anthropic Claude](https://www.anthropic.com/pricing)
+   - [OpenAI](https://openai.com/pricing)
+   - [DeepSeek](https://platform.deepseek.com/api-docs/pricing)
+   - [Google Gemini](https://ai.google.dev/pricing)
+
+2. Or run `opencode-tokens pricing` to see built-in prices
+
+**Common scenarios:**
+
+| Scenario | Config |
+|----------|--------|
+| Subscription service (GitHub Copilot, Cursor) | `{ "input": 0, "output": 0 }` |
+| Free/local model | `{ "input": 0, "output": 0 }` |
+| Custom API with known pricing | Look up provider's pricing page |
+
 ### Pricing Override
 
 Pricing is resolved in this order (first match wins):
@@ -207,7 +236,7 @@ If you're using GitHub Copilot or other subscription-based services, set their c
 
 #### Example: Custom model pricing
 
-Override or add pricing for specific models:
+Override or add pricing for specific models (prices in USD per 1M tokens):
 
 ```json
 {

package/dist/bin/opencode-tokens.js

@@ -407,19 +407,47 @@ function cmdConfig(action) {
         for (const model of unknownModels) {
             exampleConfig.models[model] = { input: 1, output: 4 };
         }
+        // Print explanation first
+        console.log(`
+  Pricing Configuration Guide
+  ══════════════════════════════════════════════════════════════════
+
+  All prices are in USD per 1 MILLION tokens.
+
+  Fields:
+    input      Cost for input/prompt tokens sent to the model
+    output     Cost for output/completion tokens from the model
+    cacheRead  Cost for cached input tokens (optional, usually cheaper)
+    cacheWrite Cost for cache write tokens (optional)
+
+  Examples:
+    { "input": 15, "output": 75 }     = $15 per 1M input, $75 per 1M output
+    { "input": 0, "output": 0 }       = Free (subscription or local model)
+
+  Common scenarios:
+    - GitHub Copilot, Cursor, etc.   → Set to 0 (subscription-based)
+    - Local/self-hosted models       → Set to 0
+    - Direct API usage               → Look up provider's pricing page
+
+  Where to find pricing:
+    - Anthropic: https://www.anthropic.com/pricing
+    - OpenAI:    https://openai.com/pricing
+    - DeepSeek:  https://platform.deepseek.com/api-docs/pricing
+    - Google:    https://ai.google.dev/pricing
+    - Or run:    opencode-tokens pricing
+
+  ────────────────────────────────────────────────────────────────
+  Example config based on your usage:
+`);
+        console.log(JSON.stringify(exampleConfig, null, 2));
         if (action === "generate") {
             const json = JSON.stringify(exampleConfig, null, 2);
             writeFileSync(CONFIG_FILE, json);
-            console.log(`\n  Config file generated: ${CONFIG_FILE}\n`);
-            console.log(json);
-            console.log();
-        }
-        else {
             console.log(`
-  Example config based on your usage:
-  ────────────────────────────────────────────────────────────────
+  Config file created: ${CONFIG_FILE}
 `);
-            console.log(JSON.stringify(exampleConfig, null, 2));
+        }
+        else {
             console.log(`
   To create this config file, run:
     opencode-tokens config generate
@@ -444,8 +472,8 @@ function cmdConfig(action) {
         console.log();
     }
     console.log(`  Commands:`);
-    console.log(`    opencode-tokens config init      Show example config based on your usage`);
-    console.log(`    opencode-tokens config generate  Create config file with example`);
+    console.log(`    opencode-tokens config init      Show example config with explanation`);
+    console.log(`    opencode-tokens config generate  Create config file`);
     console.log();
 }
 function cmdHelp() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-token-tracker",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Real-time token usage and cost tracking plugin for OpenCode with Toast notifications and CLI stats",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",