cloud-cost-cli 0.2.0 → 0.3.0-beta.2

package/README.md

@@ -7,6 +7,8 @@
 
 A command-line tool that analyzes your AWS and Azure resources to identify cost-saving opportunities — idle resources, oversized instances, unattached volumes, and more.
 
+**✨ NEW in v0.3.0-beta:** AI-powered explanations and natural language queries!
+
 ---
 
 ## The Problem
@@ -34,6 +36,11 @@ Cloud bills are growing faster than revenue. Engineering teams overprovision, fo
 - ✅ **Multi-cloud support** - AWS and Azure
 - ✅ **AWS analyzers** - EC2, EBS, RDS, S3, ELB, Elastic IP
 - ✅ **Azure analyzers** - VMs, Managed Disks, Storage, SQL, Public IPs
+- ✅ **🤖 AI-powered explanations** - Get human-readable explanations for why resources are costing money (beta)
+- ✅ **💬 Natural language queries** - Ask questions like "What's my biggest cost?" or "Show me idle VMs" (beta)
+- ✅ **🔒 Privacy-first AI** - Use local Ollama or cloud OpenAI
+- ✅ **💰 Cost tracking** - Track AI API costs (OpenAI only)
+- ✅ **⚙️ Configuration file** - Save your preferences
 - ✅ Connect via cloud credentials (read-only recommended)
 - ✅ Analyze last 7-30 days of usage
 - ✅ Output top savings opportunities with estimated monthly savings
@@ -44,7 +51,6 @@ Cloud bills are growing faster than revenue. Engineering teams overprovision, fo
 **Potential future additions:**
 - GCP support (Compute Engine, Cloud Storage, Cloud SQL)
 - Real-time pricing API integration
-- Configuration file support
 - Additional AWS services (Lambda, DynamoDB, CloudFront, etc.)
 - Additional Azure services (App Services, CosmosDB, etc.)
 - Multi-region analysis
@@ -61,19 +67,34 @@ No commitment on timeline - contributions welcome!
 
 **Requirements:**
 - Node.js >= 18
-- Cloud credentials:
-  - **AWS**: [AWS CLI configured](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) or environment variables
-  - **Azure**: [Azure CLI logged in](https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli) or environment variables
+- Cloud credentials (choose one per provider):
+  - **AWS**: 
+    - [AWS CLI configured](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) OR
+    - Environment variables (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`)
+  - **Azure**:
+    - [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli) (`az login`) OR
+    - Service Principal (env vars: `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_TENANT_ID`) OR
+    - Managed Identity (for Azure VMs)
+- **Optional for AI features**:
+  - OpenAI API key OR
+  - [Ollama](https://ollama.ai) installed locally (free, private, runs on your machine)
 
 **Install via npm:**
 ```bash
 npm install -g cloud-cost-cli
 ```
 
+**Try the beta with AI features:**
+```bash
+npm install -g cloud-cost-cli@beta
+```
+
 ---
 
 ## Usage
 
+### Basic Scan
+
 **AWS scan:**
 ```bash
 cloud-cost-cli scan --provider aws --profile default --region us-east-1
@@ -81,12 +102,92 @@ cloud-cost-cli scan --provider aws --profile default --region us-east-1
 
 **Azure scan:**
 ```bash
-# Set Azure subscription ID (or use --subscription-id flag)
+# Option 1: Azure CLI (easiest for local use)
+az login
 export AZURE_SUBSCRIPTION_ID="your-subscription-id"
+cloud-cost-cli scan --provider azure --location eastus
 
+# Option 2: Service Principal (recommended for CI/CD and automation)
+export AZURE_CLIENT_ID="your-app-id"
+export AZURE_CLIENT_SECRET="your-secret"
+export AZURE_TENANT_ID="your-tenant-id"
+export AZURE_SUBSCRIPTION_ID="your-subscription-id"
 cloud-cost-cli scan --provider azure --location eastus
 ```
 
+**How to create Azure Service Principal:**
+```bash
+# Create service principal with Reader role
+az ad sp create-for-rbac --name "cloud-cost-cli" --role Reader --scopes /subscriptions/YOUR_SUBSCRIPTION_ID
+
+# Output will show:
+# {
+#   "appId": "xxx",          # Use as AZURE_CLIENT_ID
+#   "password": "xxx",       # Use as AZURE_CLIENT_SECRET
+#   "tenant": "xxx"          # Use as AZURE_TENANT_ID
+# }
+```
+
+### 🤖 AI-Powered Features (Beta)
+
+**Get AI explanations for opportunities:**
+```bash
+# Using OpenAI (requires API key)
+export OPENAI_API_KEY="sk-..."
+cloud-cost-cli scan --provider aws --region us-east-1 --explain
+
+# Using local Ollama (free, private, no API key needed)
+cloud-cost-cli scan --provider aws --region us-east-1 --explain --ai-provider ollama
+```
+
+**Ask natural language questions:**
+```bash
+# First, run a scan to collect data
+cloud-cost-cli scan --provider aws --region us-east-1
+
+# Then ask questions about your costs
+cloud-cost-cli ask "What's my biggest cost opportunity?"
+cloud-cost-cli ask "Show me all idle EC2 instances"
+cloud-cost-cli ask "How much can I save on storage?"
+cloud-cost-cli ask "Which resources should I optimize first?"
+```
+
+**Configure AI settings (saves preferences):**
+```bash
+# Initialize config file
+cloud-cost-cli config init
+
+# Set AI provider (openai or ollama)
+cloud-cost-cli config set ai.provider ollama
+
+# Set OpenAI API key (if using OpenAI)
+cloud-cost-cli config set ai.apiKey "sk-..."
+
+# Set AI model
+cloud-cost-cli config set ai.model "llama3.1:8b"  # For Ollama
+cloud-cost-cli config set ai.model "gpt-4o-mini"  # For OpenAI
+
+# Set max explanations (how many to explain)
+cloud-cost-cli config set ai.maxExplanations 5
+
+# View your config
+cloud-cost-cli config show
+```
+
+**Track AI costs (OpenAI only):**
+```bash
+# View AI API costs
+cloud-cost-cli costs
+
+# View last 7 days
+cloud-cost-cli costs --days 7
+
+# Clear cost tracking
+cloud-cost-cli costs --clear
+```
+
+### Advanced Options
+
 **Show more opportunities:**
 ```bash
 cloud-cost-cli scan --provider aws --top 20  # Show top 20 instead of default 5
@@ -102,7 +203,7 @@ cloud-cost-cli scan --provider azure --min-savings 50  # Only show opportunities
 cloud-cost-cli scan --provider aws --output json > report.json
 ```
 
-**Example output:**
+**Example output (with AI explanations):**
 ```
 Cloud Cost Optimization Report
 Provider: AWS | Region: us-east-1 | Account: N/A
@@ -118,18 +219,114 @@ Top 5 Savings Opportunities (est. $1,245/month):
 │ 2 │ EBS      │ vol-0xyz789abc                         │ Delete unattached volume (500 GB)                        │ $40.00      │
 ├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
 │ 3 │ RDS      │ mydb-production                        │ Downsize from db.r5.xlarge to db.t3.large (CPU: 15%)    │ $180.00     │
-├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
-│ 4 │ ELB      │ my-old-alb                             │ Delete unused load balancer                              │ $22.00      │
-├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
-│ 5 │ S3       │ logs-bucket-2023                       │ Add lifecycle policy to transition to Glacier            │ $938.00     │
 └───┴──────────┴────────────────────────────────────────┴──────────────────────────────────────────────────────────┴─────────────┘
 
+🤖 AI Explanations:
+
+💡 Opportunity #1: Stop idle instance (CPU: 2%)
+   This EC2 instance is consuming only 2% CPU, indicating it's severely underutilized. 
+   Consider stopping it during off-hours or right-sizing to a smaller instance type.
+   Quick win: Stop it immediately if it's a dev/test server not actively used.
+   Risk: Low - monitor for 24h first to confirm usage patterns.
+
+💡 Opportunity #2: Delete unattached volume (500 GB)
+   This EBS volume isn't attached to any instance but you're still paying for storage.
+   Either delete it if data isn't needed, or create a snapshot first for backup.
+   Quick win: Take a snapshot ($0.05/GB/mo vs $0.08/GB/mo), then delete the volume.
+   Risk: Medium - verify no one needs this data before deleting.
+
+💡 Opportunity #3: Downsize RDS instance
+   Your database is only using 15% CPU on a db.r5.xlarge. You're paying for 4 vCPUs 
+   but only need 1-2. Downsize to db.t3.large (2 vCPUs) and save $180/month.
+   Quick win: Schedule a downsize during your next maintenance window.
+   Risk: Low-Medium - test query performance after resize.
+
 Total potential savings: $1,245/month ($14,940/year)
 
-Summary: 47 resources analyzed | 12 idle | 8 oversized | 5 unused
+ℹ AI explanations powered by OpenAI GPT-4o-mini (cost: $0.02)
+```
+
+---
+
+## AI Features Setup
+
+### Option 1: OpenAI (Cloud, Paid)
+
+**Pros:** Fast, accurate, works anywhere  
+**Cons:** Costs ~$0.01-0.05 per scan, data sent to OpenAI
+
+```bash
+# Get API key from https://platform.openai.com/api-keys
+export OPENAI_API_KEY="sk-..."
+
+# Or save to config
+cloud-cost-cli config set ai.apiKey "sk-..."
+cloud-cost-cli config set ai.provider openai
+```
+
+### Option 2: Ollama (Local, Free)
 
-💡 Note: Cost estimates based on us-east-1 pricing and may vary by region.
-   For more accurate estimates, actual costs depend on your usage and region.
+**Pros:** Free, private (runs on your machine), no API costs  
+**Cons:** Requires ~4GB RAM, slower than OpenAI
+
+```bash
+# Install Ollama
+curl -fsSL https://ollama.ai/install.sh | sh
+
+# Pull a model (one-time, ~4GB download)
+ollama pull llama3.1:8b
+
+# Configure cloud-cost-cli
+cloud-cost-cli config set ai.provider ollama
+cloud-cost-cli config set ai.model "llama3.1:8b"
+
+# Use it
+cloud-cost-cli scan --provider aws --region us-east-1 --explain
+```
+
+**Recommended Ollama models:**
+- `llama3.1:8b` - Best balance (4GB RAM, good quality)
+- `llama3.2:3b` - Faster, less RAM (2GB, slightly lower quality)
+- `mistral:7b` - Alternative, similar to llama3.1
+
+---
+
+## Configuration File
+
+**Location:** `~/.cloud-cost-cli.json`
+
+**Example config:**
+```json
+{
+  "ai": {
+    "provider": "ollama",
+    "model": "llama3.1:8b",
+    "maxExplanations": 5,
+    "cache": {
+      "enabled": true,
+      "ttlDays": 7
+    }
+  },
+  "scan": {
+    "defaultProvider": "aws",
+    "defaultRegion": "us-east-1",
+    "defaultTop": 5,
+    "minSavings": 10
+  },
+  "aws": {
+    "profile": "default",
+    "region": "us-east-1"
+  }
+}
+```
+
+**Manage config:**
+```bash
+cloud-cost-cli config init        # Create config file
+cloud-cost-cli config show        # View current config
+cloud-cost-cli config get ai.provider    # Get specific value
+cloud-cost-cli config set ai.provider ollama  # Set value
+cloud-cost-cli config path        # Show config file location
 ```
 
 ---
@@ -208,6 +405,8 @@ MIT License - see [LICENSE](LICENSE)
 - [Commander.js](https://github.com/tj/commander.js) - CLI framework
 - [cli-table3](https://github.com/cli-table/cli-table3) - Terminal tables
 - [Chalk](https://github.com/chalk/chalk) - Terminal styling
+- [OpenAI API](https://platform.openai.com/) - AI explanations
+- [Ollama](https://ollama.ai) - Local AI models
 
 ---
 
@@ -224,9 +423,20 @@ A: Read-only permissions for each cloud provider:
 **Q: How accurate are the savings estimates?**  
 A: Estimates are based on current pricing and usage patterns. Actual savings may vary by region and your specific pricing agreements (Reserved Instances, Savings Plans, etc.).
 
+**Q: Is my data sent to OpenAI?**  
+A: Only if you use `--ai-provider openai` (the default). Resource metadata and recommendations are sent to OpenAI's API to generate explanations. If you want complete privacy, use `--ai-provider ollama` which runs 100% locally on your machine.
+
+**Q: How much do AI features cost?**  
+A: 
+- **Ollama**: Free! Runs locally, no API costs
+- **OpenAI**: ~$0.01-0.05 per scan (GPT-4o-mini). Use `cloud-cost-cli costs` to track spending.
+
 **Q: Can I run this in CI/CD?**  
 A: Yes. Use `--output json` and parse the results to fail builds if savings exceed a threshold.
 
+**Q: Do I need AI features to use the tool?**  
+A: No! AI features are completely optional. The core cost scanning works without any AI setup.
+
 ---
 
 **Star this repo if it saves you money!** ⭐

package/dist/bin/cloud-cost-cli.js

@@ -3,11 +3,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const scan_js_1 = require("../src/commands/scan.js");
+const ask_js_1 = require("../src/commands/ask.js");
+const config_js_1 = require("../src/commands/config.js");
+const costs_js_1 = require("../src/commands/costs.js");
 const program = new commander_1.Command();
 program
     .name('cloud-cost-cli')
     .description('Optimize your cloud spend in seconds')
-    .version('0.1.0');
+    .version('0.3.0-beta.1');
 program
     .command('scan')
     .description('Scan cloud account for cost savings')
@@ -21,6 +24,25 @@ program
     .option('--days <N>', 'Analysis period in days', '30')
     .option('--min-savings <amount>', 'Filter by minimum savings ($/month)')
     .option('--accurate', 'Use real-time pricing from AWS (slower but more accurate)')
+    .option('--explain', 'AI-powered explanations for top opportunities')
+    .option('--ai-provider <openai|ollama>', 'AI provider (reads from config if not specified)')
+    .option('--ai-model <model>', 'AI model (gpt-4o-mini for OpenAI, llama3.2:3b for Ollama)')
     .option('--verbose', 'Verbose logging')
     .action(scan_js_1.scanCommand);
+program
+    .command('ask <query>')
+    .description('Ask natural language questions about your cloud costs')
+    .option('--ai-provider <openai|ollama>', 'AI provider (reads from config if not specified)')
+    .option('--ai-model <model>', 'AI model to use')
+    .action(ask_js_1.askCommand);
+program
+    .command('config <action> [key] [value]')
+    .description('Manage configuration (actions: init, show, get, set, path)')
+    .action(config_js_1.configCommand);
+program
+    .command('costs')
+    .description('Show AI usage costs')
+    .option('--days <N>', 'Number of days to include', '30')
+    .option('--clear', 'Clear cost tracking data')
+    .action(costs_js_1.costsCommand);
 program.parse();

package/dist/src/commands/ask.d.ts

@@ -0,0 +1,11 @@
+interface AskCommandOptions {
+    provider?: string;
+    aiProvider?: string;
+    aiModel?: string;
+    region?: string;
+    location?: string;
+    subscriptionId?: string;
+}
+export declare function askCommand(query: string, options: AskCommandOptions): Promise<void>;
+export declare function saveScanCache(provider: string, region: string | undefined, report: any): void;
+export {};

package/dist/src/commands/ask.js

@@ -0,0 +1,164 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askCommand = askCommand;
+exports.saveScanCache = saveScanCache;
+const ai_1 = require("../services/ai");
+const logger_1 = require("../utils/logger");
+const config_1 = require("../utils/config");
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+async function askCommand(query, options) {
+    (0, logger_1.info)(`Analyzing: "${query}"`);
+    // Load most recent scan results
+    const scanData = loadRecentScan();
+    if (!scanData) {
+        (0, logger_1.error)('No recent scan found. Please run a scan first:');
+        (0, logger_1.info)('  cloud-cost-cli scan --provider aws --region us-east-1');
+        process.exit(1);
+    }
+    const ageMinutes = Math.floor((Date.now() - scanData.timestamp) / 60000);
+    (0, logger_1.info)(`Using scan from ${ageMinutes} minutes ago (${scanData.provider}${scanData.region ? ', ' + scanData.region : ''})`);
+    // Initialize AI service
+    // Load config file to get defaults
+    const fileConfig = config_1.ConfigLoader.load();
+    // CLI flags override config file
+    const provider = options.aiProvider || fileConfig.ai?.provider || 'openai';
+    const model = options.aiModel || fileConfig.ai?.model;
+    if (provider === 'openai' && !process.env.OPENAI_API_KEY && !fileConfig.ai?.apiKey) {
+        (0, logger_1.error)('Natural language queries require OPENAI_API_KEY or --ai-provider ollama');
+        (0, logger_1.info)('Set it with: export OPENAI_API_KEY="sk-..."');
+        (0, logger_1.info)('Or run: cloud-cost-cli config set ai.provider ollama');
+        process.exit(1);
+    }
+    try {
+        const aiService = new ai_1.AIService({
+            provider,
+            apiKey: provider === 'openai' ? (process.env.OPENAI_API_KEY || fileConfig.ai?.apiKey) : undefined,
+            model,
+        });
+        console.log(chalk_1.default.cyan('\n🤔 Thinking...\n'));
+        const answer = await aiService.answerQuery(query, scanData.report);
+        console.log(chalk_1.default.bold('💡 Answer:\n'));
+        console.log(chalk_1.default.white(answer.response));
+        if (answer.suggestions && answer.suggestions.length > 0) {
+            console.log(chalk_1.default.bold('\n📋 Suggestions:\n'));
+            answer.suggestions.forEach((suggestion, i) => {
+                console.log(chalk_1.default.green(`  ${i + 1}. ${suggestion}`));
+            });
+        }
+        if (answer.relatedOpportunities && answer.relatedOpportunities.length > 0) {
+            console.log(chalk_1.default.bold('\n🎯 Related Opportunities:\n'));
+            answer.relatedOpportunities.forEach((opp, i) => {
+                console.log(chalk_1.default.yellow(`  ${i + 1}. ${opp.resourceId}: ${opp.recommendation} (Save $${opp.estimatedSavings.toFixed(2)}/mo)`));
+            });
+        }
+        console.log();
+    }
+    catch (err) {
+        (0, logger_1.error)(`Query failed: ${err.message}`);
+        process.exit(1);
+    }
+}
+function loadRecentScan() {
+    const cacheDir = path.join(process.env.HOME || '/tmp', '.cloud-cost-cli', 'scans');
+    if (!fs.existsSync(cacheDir)) {
+        return null;
+    }
+    try {
+        const files = fs.readdirSync(cacheDir)
+            .filter(f => f.endsWith('.json'))
+            .map(f => ({
+            path: path.join(cacheDir, f),
+            stat: fs.statSync(path.join(cacheDir, f)),
+        }))
+            .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs);
+        if (files.length === 0) {
+            return null;
+        }
+        // Get most recent scan (max 24 hours old)
+        const mostRecent = files[0];
+        const ageMs = Date.now() - mostRecent.stat.mtimeMs;
+        if (ageMs > 24 * 60 * 60 * 1000) {
+            return null; // Too old
+        }
+        const data = fs.readFileSync(mostRecent.path, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch (err) {
+        return null;
+    }
+}
+function saveScanCache(provider, region, report) {
+    const cacheDir = path.join(process.env.HOME || '/tmp', '.cloud-cost-cli', 'scans');
+    if (!fs.existsSync(cacheDir)) {
+        fs.mkdirSync(cacheDir, { recursive: true });
+    }
+    const cache = {
+        timestamp: Date.now(),
+        provider,
+        region,
+        report,
+    };
+    const filename = `scan-${provider}-${Date.now()}.json`;
+    const filepath = path.join(cacheDir, filename);
+    try {
+        fs.writeFileSync(filepath, JSON.stringify(cache, null, 2), 'utf-8');
+        // Clean up old scans (keep only last 10)
+        const files = fs.readdirSync(cacheDir)
+            .filter(f => f.endsWith('.json'))
+            .map(f => ({
+            path: path.join(cacheDir, f),
+            stat: fs.statSync(path.join(cacheDir, f)),
+        }))
+            .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs);
+        // Delete all but the 10 most recent
+        files.slice(10).forEach(f => {
+            try {
+                fs.unlinkSync(f.path);
+            }
+            catch (err) {
+                // Ignore deletion errors
+            }
+        });
+    }
+    catch (err) {
+        // Failed to save cache, not critical
+    }
+}

package/dist/src/commands/config.d.ts

@@ -0,0 +1 @@
+export declare function configCommand(action: string, key?: string, value?: string): Promise<void>;

package/dist/src/commands/config.js

@@ -0,0 +1,120 @@
+"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 config_1 = require("../utils/config");
+const logger_1 = require("../utils/logger");
+const chalk_1 = __importDefault(require("chalk"));
+async function configCommand(action, key, value) {
+    switch (action) {
+        case 'init':
+            initConfig();
+            break;
+        case 'show':
+            showConfig();
+            break;
+        case 'get':
+            if (!key) {
+                (0, logger_1.error)('Key required for get action');
+                process.exit(1);
+            }
+            getConfigValue(key);
+            break;
+        case 'set':
+            if (!key || !value) {
+                (0, logger_1.error)('Key and value required for set action');
+                process.exit(1);
+            }
+            setConfigValue(key, value);
+            break;
+        case 'path':
+            showConfigPath();
+            break;
+        default:
+            (0, logger_1.error)(`Unknown config action: ${action}`);
+            (0, logger_1.info)('Available actions: init, show, get, set, path');
+            process.exit(1);
+    }
+}
+function initConfig() {
+    const configPath = config_1.ConfigLoader.getConfigPath();
+    const example = config_1.ConfigLoader.generateExample();
+    (0, logger_1.info)('Creating example configuration...');
+    console.log(chalk_1.default.dim('─'.repeat(80)));
+    console.log(example);
+    console.log(chalk_1.default.dim('─'.repeat(80)));
+    config_1.ConfigLoader.save(JSON.parse(example));
+    (0, logger_1.success)(`Configuration saved to: ${configPath}`);
+    (0, logger_1.info)('Edit this file to customize your settings');
+}
+function showConfig() {
+    const config = config_1.ConfigLoader.load();
+    const configPath = config_1.ConfigLoader.getConfigPath();
+    console.log(chalk_1.default.bold(`\nConfiguration (from ${configPath}):\n`));
+    console.log(JSON.stringify(config, null, 2));
+    console.log();
+    const errors = config_1.ConfigLoader.validate(config);
+    if (errors.length > 0) {
+        console.log(chalk_1.default.yellow('⚠️  Validation warnings:'));
+        errors.forEach(err => console.log(chalk_1.default.yellow(`  - ${err}`)));
+        console.log();
+    }
+}
+function getConfigValue(key) {
+    const config = config_1.ConfigLoader.load();
+    const value = getNestedValue(config, key);
+    if (value === undefined) {
+        (0, logger_1.error)(`Key not found: ${key}`);
+        process.exit(1);
+    }
+    console.log(JSON.stringify(value, null, 2));
+}
+function setConfigValue(key, value) {
+    const config = config_1.ConfigLoader.load();
+    // Parse value (try JSON first, fall back to string)
+    let parsedValue = value;
+    try {
+        parsedValue = JSON.parse(value);
+    }
+    catch (e) {
+        // Not JSON, use as string
+    }
+    setNestedValue(config, key, parsedValue);
+    const errors = config_1.ConfigLoader.validate(config);
+    if (errors.length > 0) {
+        (0, logger_1.error)('Configuration validation failed:');
+        errors.forEach(err => console.log(chalk_1.default.red(`  - ${err}`)));
+        process.exit(1);
+    }
+    config_1.ConfigLoader.save(config);
+    (0, logger_1.success)(`Set ${key} = ${JSON.stringify(parsedValue)}`);
+}
+function showConfigPath() {
+    const configPath = config_1.ConfigLoader.getConfigPath();
+    console.log(configPath);
+}
+function getNestedValue(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === undefined || current === null) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+function setNestedValue(obj, path, value) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (current[key] === undefined || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+}

package/dist/src/commands/costs.d.ts

@@ -0,0 +1,6 @@
+interface CostsCommandOptions {
+    days?: string;
+    clear?: boolean;
+}
+export declare function costsCommand(options: CostsCommandOptions): Promise<void>;
+export {};