cost-katana-cli 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Abdul Sagheer
+
+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,343 @@
+# Cost Katana CLI 🥷
+
+**Chat with AI from your terminal. Track costs automatically.**
+
+```bash
+$ cost-katana chat
+
+You: Hello!
+AI: Hi! How can I help you today?
+💰 Cost: $0.0001
+
+You: Write me a Python function
+AI: Here's a Python function...
+💰 Session: $0.0023
+```
+
+Simple. Powerful. Cost-aware.
+
+## Installation
+
+```bash
+npm install -g cost-katana-cli
+```
+
+## Quick Start
+
+### 1. Setup (One-time)
+
+```bash
+cost-katana init
+```
+
+Answer 2 questions:
+1. Your API key (from [costkatana.com](https://costkatana.com))
+2. Your default AI model
+
+Done! ✅
+
+### 2. Start Chatting
+
+```bash
+cost-katana chat
+```
+
+That's it!
+
+## Essential Commands
+
+### Chat with AI
+
+```bash
+# Start interactive chat
+cost-katana chat
+
+# Use specific model
+cost-katana chat --model claude-3-sonnet
+
+# With system prompt
+cost-katana chat --system "You are a coding expert"
+```
+
+### Quick Question (No chat mode)
+
+```bash
+# Ask a single question
+cost-katana ask "What is the capital of France?"
+
+# Save answer to file
+cost-katana ask "Explain Python" --output answer.txt
+
+# Use different model
+cost-katana ask "Write a poem" --model gpt-4
+```
+
+### Analyze Costs
+
+```bash
+# See your spending
+cost-katana analyze
+
+# Last 7 days
+cost-katana analyze --days 7
+
+# Export to CSV
+cost-katana analyze --export costs.csv
+```
+
+### List Models
+
+```bash
+# See available models
+cost-katana models
+
+# Filter by provider
+cost-katana models --provider openai
+
+# Show with prices
+cost-katana models --prices
+```
+
+## Chat Session Commands
+
+While in a chat session, you can use:
+
+- `help` - Show commands
+- `cost` - Show session cost
+- `models` - Switch model
+- `clear` - Clear history
+- `save` - Save conversation
+- `quit` - Exit
+
+## Advanced Features
+
+### Cost Optimization
+
+```bash
+# Enable Cortex (70-95% savings)
+cost-katana chat --cortex
+
+# Enable caching
+cost-katana chat --cache
+```
+
+### Compare Models
+
+```bash
+# Compare costs across models
+cost-katana compare "Explain AI" --models gpt-4,claude-3-sonnet,gemini-pro
+```
+
+### Budget Tracking
+
+```bash
+# Set daily budget
+cost-katana budget set --daily 10
+
+# Check budget status
+cost-katana budget status
+
+# Get alerts
+cost-katana budget alerts
+```
+
+## Configuration
+
+### View Config
+
+```bash
+cost-katana config
+```
+
+### Update Settings
+
+```bash
+# Change default model
+cost-katana config set model gpt-4
+
+# Set temperature
+cost-katana config set temperature 0.7
+
+# Set daily limit
+cost-katana config set daily-limit 5
+```
+
+### Environment Variables
+
+```bash
+# Alternative to init command
+export COST_KATANA_KEY="dak_your_key"
+export COST_KATANA_MODEL="gpt-4"
+```
+
+## Real-World Examples
+
+### Code Assistant
+
+```bash
+$ cost-katana chat --system "You are a senior developer. Be concise."
+
+You: Review this code: [paste code]
+AI: Here are the issues...
+💰 Cost: $0.0045
+
+You: How do I fix issue #2?
+AI: Here's how to fix it...
+💰 Session: $0.0067
+```
+
+### Content Writer
+
+```bash
+$ cost-katana chat --model gpt-4 --cortex
+
+You: Write a blog post about AI
+AI: [Generates comprehensive post with 70% cost savings]
+💰 Cost: $0.0123 (saved $0.041 with Cortex!)
+```
+
+### Quick Answers
+
+```bash
+# Get quick answers without entering chat mode
+$ cost-katana ask "What's the weather API for Node.js?"
+> Use the 'axios' library to call weather APIs like OpenWeatherMap...
+💰 Cost: $0.0002
+
+$ cost-katana ask "Python sort list by date" --output answer.md
+✅ Saved to answer.md
+💰 Cost: $0.0003
+```
+
+## Tips
+
+### Save Money
+
+```bash
+# Use cheaper models for simple tasks
+cost-katana chat --model gpt-3.5-turbo    # 10x cheaper
+
+# Enable optimization for long content
+cost-katana chat --cortex                  # 70-95% savings
+
+# Cache repeated queries
+cost-katana chat --cache                   # Free repeated answers
+```
+
+### Productivity
+
+```bash
+# Save conversations
+cost-katana chat --output session.json
+
+# Load previous conversation
+cost-katana chat --file session.json
+
+# Pipe output
+cost-katana ask "List of AI models" | grep gpt
+```
+
+## Comparison
+
+### Traditional AI CLIs
+
+```bash
+# Complex setup
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+
+# Different commands for each provider
+openai chat
+anthropic messages create
+```
+
+### Cost Katana CLI
+
+```bash
+# Simple setup
+cost-katana init
+
+# One command for all providers
+cost-katana chat
+
+# Automatic cost tracking!
+```
+
+## Troubleshooting
+
+### "API key not found"
+
+```bash
+# Run init again
+cost-katana init
+
+# Or set environment variable
+export COST_KATANA_KEY="dak_your_key"
+```
+
+### "Model not available"
+
+```bash
+# See available models
+cost-katana models
+
+# Try a different model
+cost-katana chat --model gpt-3.5-turbo
+```
+
+### "Rate limit exceeded"
+
+```bash
+# CLI automatically retries
+# If persistent, try different model:
+cost-katana chat --model claude-3-haiku
+```
+
+## Dashboard Integration
+
+All your CLI usage is tracked at [costkatana.com/dashboard](https://costkatana.com/dashboard):
+
+- Real-time cost tracking
+- Usage by model
+- Daily/weekly/monthly stats
+- Budget alerts
+- Optimization tips
+
+```bash
+# Every command is tracked
+cost-katana chat
+cost-katana ask "Hello"
+
+# View at: https://costkatana.com/dashboard
+```
+
+## Why Cost Katana CLI?
+
+✅ **Simple**: 2-step setup, then just `cost-katana chat`  
+✅ **Universal**: Works with all AI providers  
+✅ **Cost-Aware**: See costs in real-time  
+✅ **Optimized**: Built-in 70-95% cost reduction  
+✅ **Tracked**: Everything logged to dashboard  
+✅ **Beautiful**: Clean, colorful terminal UI  
+
+## Support
+
+- **Documentation**: https://docs.costkatana.com/cli
+- **Dashboard**: https://costkatana.com
+- **GitHub**: https://github.com/Hypothesize-Tech/costkatana-cli
+- **Discord**: https://discord.gg/Wcwzw8wM
+- **Email**: support@costkatana.com
+
+## License
+
+MIT © Cost Katana
+
+---
+
+**Start chatting with AI in your terminal!**
+
+```bash
+npm install -g cost-katana-cli
+cost-katana init
+cost-katana chat
+```

package/bin/cost-katana.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+// This file is the entry point for the CLI tool
+// It will be compiled from TypeScript and placed in the bin directory
+
+try {
+  // Try to load the compiled JavaScript
+  require('../dist/index.js');
+} catch (error) {
+  // If compiled version doesn't exist, try to run TypeScript directly
+  try {
+    require('ts-node/register');
+    require('../src/index.ts');
+  } catch (tsError) {
+    console.error('Error: Could not start Cost Katana CLI');
+    console.error('Please run "npm run build" to compile the TypeScript code');
+    console.error('Or install ts-node: npm install -g ts-node');
+    process.exit(1);
+  }
+}

package/dist/commands/agent-inspect.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function agentInspectCommand(program: Command): void;
+//# sourceMappingURL=agent-inspect.d.ts.map

package/dist/commands/agent-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-inspect.d.ts","sourceRoot":"","sources":["../../src/commands/agent-inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA8FnD"}