@plexor-dev/claude-code-plugin 0.1.0-beta.19 → 0.1.0-beta.20

package/commands/plexor-setup.md

@@ -0,0 +1,134 @@
+---
+description: First-time setup wizard for Plexor with Claude Code (user)
+---
+
+# Plexor Setup Wizard
+
+Guide users through first-time Plexor setup, handling both Claude MAX subscribers and API key users.
+
+## Steps
+
+**Step 1: Check if already configured**
+
+Use the Read tool to check if `~/.plexor/config.json` exists and has valid configuration.
+
+If configured, show:
+```
+Plexor Setup
+============
+Already configured!
+
+API URL: [apiUrl from config]
+Mode: [mode from config]
+Status: [Enabled/Disabled]
+
+Run /plexor-status to see your usage.
+Run /plexor-settings to modify configuration.
+```
+
+**Step 2: Ask about Claude MAX subscription**
+
+Use the AskUserQuestion tool:
+
+Question: "Do you have a Claude MAX subscription (Pro/Team/Enterprise)?"
+Header: "Subscription"
+Options:
+1. **Yes, I have Claude MAX** - I'm already logged into Claude Code with OAuth
+2. **No, I'll use a Plexor API key** - I want to use Plexor's provider routing
+
+**Step 3A: Claude MAX User Setup**
+
+If user selected "Yes, I have Claude MAX":
+
+1. Use the Write tool to create `~/.plexor/config.json`:
+```json
+{
+  "version": 1,
+  "auth": {
+    "mode": "oauth_passthrough",
+    "authenticated_at": "[current ISO timestamp]"
+  },
+  "settings": {
+    "enabled": true,
+    "apiUrl": "https://api.plexor.dev",
+    "mode": "balanced",
+    "localCacheEnabled": true
+  }
+}
+```
+
+2. Show the user:
+```
+Plexor Setup - Claude MAX User
+==============================
+Your Claude MAX subscription will be used with Plexor optimization.
+
+Add this to your shell profile (~/.bashrc or ~/.zshrc):
+
+  export ANTHROPIC_BASE_URL="https://api.plexor.dev/gateway/anthropic"
+
+Then restart your terminal or run: source ~/.bashrc
+
+How it works:
+- Claude Code sends your OAuth token through Plexor
+- Plexor optimizes prompts and tracks usage
+- You keep your MAX benefits ($0 cost, 20x rate limits)
+
+Run /plexor-status to verify setup.
+```
+
+**Step 3B: API Key User Setup**
+
+If user selected "No, I'll use a Plexor API key":
+
+1. Ask for their Plexor API key:
+   "Please provide your Plexor API key (starts with 'plx_')."
+   "Get one at: https://plexor.dev/dashboard"
+
+2. Once they provide the key, use the Write tool to create `~/.plexor/config.json`:
+```json
+{
+  "version": 1,
+  "auth": {
+    "api_key": "[user's API key]",
+    "mode": "api_key",
+    "authenticated_at": "[current ISO timestamp]"
+  },
+  "settings": {
+    "enabled": true,
+    "apiUrl": "https://api.plexor.dev",
+    "preferred_provider": "auto",
+    "mode": "balanced",
+    "localCacheEnabled": true
+  }
+}
+```
+
+3. Show the user:
+```
+Plexor Setup - API Key User
+===========================
+Your Plexor API key has been configured.
+
+Add these lines to your shell profile (~/.bashrc or ~/.zshrc):
+
+  export ANTHROPIC_BASE_URL="https://api.plexor.dev/gateway/anthropic"
+  export ANTHROPIC_API_KEY="[their plexor key]"
+
+Then restart your terminal or run: source ~/.bashrc
+
+How it works:
+- Requests route through Plexor gateway
+- Plexor picks the best provider (can save up to 90%)
+- Your Plexor key goes in ANTHROPIC_API_KEY (this is correct!)
+
+Run /plexor-status to verify setup.
+```
+
+**Step 4: Offer to auto-configure shell (optional)**
+
+Ask: "Would you like me to add this to your shell profile automatically?"
+
+If yes, use the Edit tool to append the export lines to `~/.bashrc` (or `~/.zshrc` if it exists).
+
+**IMPORTANT**: After completing setup, STOP. Do not run additional commands.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plexor-dev/claude-code-plugin",
-  "version": "0.1.0-beta.19",
+  "version": "0.1.0-beta.20",
   "description": "LLM cost optimization plugin for Claude Code - Save up to 90% on AI costs",
   "main": "lib/constants.js",
   "scripts": {

package/scripts/postinstall.js

@@ -121,9 +121,11 @@ function main() {
     console.log('');
     console.log('  Next steps:');
     console.log('    1. Open Claude Code');
-    console.log('    2. Run /plexor-login to authenticate');
+    console.log('    2. Run /plexor-setup to configure (handles MAX + API key users)');
     console.log('    3. Start saving on LLM costs!');
     console.log('');
+    console.log('  Have Claude MAX? Just set: export ANTHROPIC_BASE_URL="https://api.plexor.dev/gateway/anthropic"');
+    console.log('');
     console.log('  Documentation: https://plexor.dev/docs');
     console.log('');