mycontext-cli 0.4.14 → 0.4.16

package/README.md

@@ -93,18 +93,29 @@ mycontext model test              # Test generation
 - **`.mycontext/04-component-list.json`** — Component architecture plan
 - **`components/`** — Generated React components with shadcn/ui
 
-## 🤖 Supported Models
+## 🤖 AI Provider Options
 
-MyContext supports multiple AI providers for maximum flexibility and cost optimization:
+MyContext supports multiple AI providers - you can use your own API keys or our managed service:
 
-### **Primary Providers**
+### **Bring Your Own Keys (BYOK)**
 
-| Provider               | Model                        | Best For                         | Setup Required             |
-| ---------------------- | ---------------------------- | -------------------------------- | -------------------------- |
-| **GitHub Models**      | `openai/gpt-5`               | Fast, high-quality generation    | `MYCONTEXT_GITHUB_TOKEN`   |
-| **Claude (Anthropic)** | `claude-3-5-sonnet-20241022` | Complex reasoning, detailed PRDs | `MYCONTEXT_CLAUDE_API_KEY` |
-| **OpenAI**             | `gpt-4`                      | Versatile generation, refinement | `MYCONTEXT_OPENAI_API_KEY` |
-| **X.AI (Grok)**        | `grok-2-latest`              | Creative tasks, quick iterations | `MYCONTEXT_GROK_TOKEN`     |
+Use your own API keys for full control and potentially lower costs:
+
+| Provider               | Environment Variable       | Best For                         | Cost           |
+| ---------------------- | -------------------------- | -------------------------------- | -------------- |
+| **GitHub Models**      | `MYCONTEXT_GITHUB_TOKEN`   | Fast, high-quality generation    | Your API costs |
+| **Claude (Anthropic)** | `MYCONTEXT_CLAUDE_API_KEY` | Complex reasoning, detailed PRDs | Your API costs |
+| **OpenAI**             | `MYCONTEXT_OPENAI_API_KEY` | Versatile generation, refinement | Your API costs |
+| **X.AI (Grok)**        | `MYCONTEXT_GROK_TOKEN`     | Creative tasks, quick iterations | Your API costs |
+
+### **MyContext Managed Service**
+
+If you don't set any API keys, MyContext uses our hosted AI service:
+
+- **Rate Limited**: 10 requests per hour for free tier
+- **Paid Credits**: Purchase credits for unlimited usage
+- **Tracked Usage**: All generations are logged for quality improvement
+- **Fallback Support**: Automatic fallback to multiple providers
 
 ### **Local AI (Free & Unlimited)**
 
@@ -113,30 +124,55 @@ MyContext supports multiple AI providers for maximum flexibility and cost optimi
 | **Ollama** | `mycontext-react` | Unlimited generation | `mycontext setup`            |
 | **Ollama** | `deepseek-coder`  | Code-focused tasks   | `ollama pull deepseek-coder` |
 
-### **Automatic Fallback Chain**
+### **Provider Priority Order**
 
-MyContext automatically tries providers in this priority order:
+MyContext automatically tries providers in this order:
 
-1. **GitHub Models** (fastest, most cost-effective)
-2. **Claude** (best reasoning for complex tasks)
-3. **OpenAI** (versatile fallback)
-4. **Ollama** (local, unlimited generation)
+1. **Your API Keys** (GitHub → Claude → OpenAI → X.AI)
+2. **MyContext Managed Service** (if no keys set)
+3. **Local Ollama** (if available)
+4. **Basic Templates** (fallback generation)
 
 ## Environment Setup
 
-### Optional: GitHub Models (Faster Generation)
+### Option 1: Bring Your Own API Keys (Recommended)
+
+Set up your preferred AI provider for best performance and cost control:
 
 ```bash
+# GitHub Models (Fastest, most cost-effective)
 echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
+
+# Or Claude (Best for complex reasoning)
+echo 'MYCONTEXT_CLAUDE_API_KEY=sk-ant-xxx' > .mycontext/.env
+
+# Or OpenAI (Most versatile)
+echo 'MYCONTEXT_OPENAI_API_KEY=sk-xxx' > .mycontext/.env
+
+# Or X.AI (Creative tasks)
+echo 'MYCONTEXT_GROK_TOKEN=xai-xxx' > .mycontext/.env
 ```
 
-### Local AI Setup (Unlimited Generation)
+### Option 2: Use MyContext Managed Service
+
+No setup required! Just start using MyContext:
+
+```bash
+mycontext generate context --description "My project"
+```
+
+**Note**: Without API keys, you'll use MyContext's hosted service with rate limits and usage tracking.
+
+### Option 3: Local AI Setup (Free & Unlimited)
 
 ```bash
 # Install Ollama (one-time setup)
 curl -fsSL https://ollama.ai/install.sh | sh
 ollama pull llama3.2:3b
 
+# Set up MyContext local AI
+mycontext setup
+
 # Verify setup
 mycontext model status
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mycontext-cli",
-  "version": "0.4.14",
+  "version": "0.4.16",
   "description": "mycontext CLI - AI-powered component generation with shadcn/ui and Next.js 15 integration",
   "main": "dist/cli.js",
   "bin": {