@plexor-dev/claude-code-plugin 0.1.0-beta.3 → 0.1.0-beta.31

package/commands/plexor-logout.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+/**
+ * Plexor Logout Command
+ * Clear Plexor credentials and disable proxy
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PLEXOR_DIR = path.join(process.env.HOME, '.plexor');
+const CONFIG_PATH = path.join(PLEXOR_DIR, 'config.json');
+const SESSION_PATH = path.join(PLEXOR_DIR, 'session.json');
+const CACHE_PATH = path.join(PLEXOR_DIR, 'cache.json');
+
+function loadConfig() {
+  try {
+    if (!fs.existsSync(CONFIG_PATH)) {
+      return null;
+    }
+    const data = fs.readFileSync(CONFIG_PATH, 'utf8');
+    if (!data || data.trim() === '') {
+      return null;
+    }
+    const config = JSON.parse(data);
+    if (typeof config !== 'object' || config === null) {
+      return null;
+    }
+    return config;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      console.warn('Warning: Config file is corrupted');
+    }
+    return null;
+  }
+}
+
+function saveConfig(config) {
+  try {
+    if (!fs.existsSync(PLEXOR_DIR)) {
+      fs.mkdirSync(PLEXOR_DIR, { recursive: true, mode: 0o700 });
+    }
+
+    // Atomic write: write to temp file, then rename
+    const crypto = require('crypto');
+    const tempId = crypto.randomBytes(8).toString('hex');
+    const tempPath = path.join(PLEXOR_DIR, `.config.${tempId}.tmp`);
+
+    fs.writeFileSync(tempPath, JSON.stringify(config, null, 2), { mode: 0o600 });
+    fs.renameSync(tempPath, CONFIG_PATH);
+    return true;
+  } catch (err) {
+    if (err.code === 'EACCES' || err.code === 'EPERM') {
+      console.error('Error: Cannot write to ~/.plexor/config.json');
+      console.error('       Check file permissions or run with appropriate access.');
+    } else {
+      console.error('Failed to save config:', err.message);
+    }
+    return false;
+  }
+}
+
+function deleteFile(filePath) {
+  try {
+    if (fs.existsSync(filePath)) {
+      fs.unlinkSync(filePath);
+      return true;
+    }
+  } catch {
+    // Ignore errors
+  }
+  return false;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const config = loadConfig();
+
+  if (!config || !config.auth?.api_key) {
+    console.log(`┌─────────────────────────────────────────────┐`);
+    console.log(`│  Not Logged In                              │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  No active Plexor session found.            │`);
+    console.log(`│  Run /plexor-login to authenticate.         │`);
+    console.log(`└─────────────────────────────────────────────┘`);
+    return;
+  }
+
+  const clearCache = args.includes('--clear-cache') || args.includes('-c');
+
+  // Clear credentials
+  delete config.auth.api_key;
+  config.settings = config.settings || {};
+  config.settings.enabled = false;
+  if (!saveConfig(config)) {
+    process.exit(1);
+  }
+
+  // Clear session
+  deleteFile(SESSION_PATH);
+
+  // Optionally clear cache
+  let cacheCleared = false;
+  if (clearCache) {
+    cacheCleared = deleteFile(CACHE_PATH);
+  }
+
+  console.log(`┌─────────────────────────────────────────────┐`);
+  console.log(`│  ✓ Logged Out                               │`);
+  console.log(`├─────────────────────────────────────────────┤`);
+  console.log(`│  ✓ API key removed                          │`);
+  console.log(`│  ✓ Plexor proxy disabled                    │`);
+  console.log(`│  ✓ Session cleared                          │`);
+  if (clearCache) {
+    console.log(`│  ${cacheCleared ? '✓' : '○'} Cache cleared                            │`);
+  }
+  console.log(`├─────────────────────────────────────────────┤`);
+  console.log(`│  Run /plexor-login to re-authenticate.      │`);
+  if (!clearCache) {
+    console.log(`│  Use --clear-cache to also clear cache.     │`);
+  }
+  console.log(`└─────────────────────────────────────────────┘`);
+}
+
+main();

package/commands/plexor-logout.md

@@ -4,39 +4,24 @@ description: Log out from Plexor and clear credentials (user)
 
 # Plexor Logout
 
-Log out from your Plexor account and clear stored credentials.
+Run this command to log out and clear credentials:
 
-## Steps
-
-**Step 1: Read current configuration**
-
-Use the Read tool to read `~/.plexor/config.json`.
-
-If the file doesn't exist or has no `apiKey`, show:
-```
-Plexor Logout
-=============
-You are not currently logged in.
-Run /plexor-login to authenticate.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-logout.js
 ```
 
-**Step 2: Clear the API key**
-
-If authenticated, use the Write tool to update `~/.plexor/config.json`:
-- Remove or clear the `apiKey` field (set to empty string "")
-- Keep all other settings (mode, preferredProvider, etc.)
-
-**Step 3: Show confirmation**
+To also clear the cache:
 
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-logout.js --clear-cache
 ```
-Plexor Logout
-=============
-Successfully logged out!
 
-- API key cleared from ~/.plexor/config.json
-- Settings preserved (mode, provider preferences)
+Use the Bash tool to execute this command.
 
-To use Plexor again, run /plexor-login
+**IMPORTANT**: After running this command and displaying the output, STOP. Do not:
+- Read any files
+- Explore the codebase
+- Run additional commands
+- Ask follow-up questions
 
-Dashboard: https://plexor.dev/dashboard
-```
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/commands/plexor-setup.md

@@ -0,0 +1,172 @@
+---
+description: First-time setup wizard for Plexor with Claude Code (user)
+---
+
+# Plexor Setup Wizard
+
+Guide users through first-time Plexor setup. **No manual environment variable configuration required!**
+
+The plugin automatically configures `~/.claude/settings.json` to route all Claude Code sessions through Plexor.
+
+## Steps
+
+**Step 1: Check if already configured**
+
+Use the Read tool to check if `~/.plexor/config.json` exists and has valid configuration.
+Also check `~/.claude/settings.json` for routing status.
+
+If configured, show:
+```
+Plexor Setup
+============
+Already configured!
+
+API URL: [apiUrl from config]
+Mode: [mode from config]
+Status: [Enabled/Disabled]
+Claude Routing: [Active/Inactive]
+
+Run /plexor-status to see your usage.
+Run /plexor-settings to modify configuration.
+Run /plexor-enabled off to disable routing.
+```
+
+**Step 2: Ask about Claude subscription**
+
+Use the AskUserQuestion tool:
+
+Question: "How do you pay for Claude usage?"
+Header: "Billing"
+Options:
+1. **Claude MAX subscription (Pro/Team/Enterprise)** - I have a subscription and want Plexor for optimization & tracking (you'll still need a Plexor API key)
+2. **Pay-per-use via Plexor** - I want Plexor to handle billing and route to the cheapest provider
+
+**Step 3A: Claude MAX User Setup**
+
+If user selected "Yes, I have Claude MAX":
+
+1. Ask for their Plexor API key:
+   "Please provide your Plexor API key (starts with 'plx_')."
+   "Get one at: https://plexor.dev/dashboard"
+   "Your MAX subscription will be used for Claude - the Plexor key is for tracking/optimization."
+
+2. Use the Write tool to create `~/.plexor/config.json`:
+```json
+{
+  "version": 1,
+  "auth": {
+    "api_key": "[user's Plexor key]",
+    "mode": "oauth_passthrough",
+    "authenticated_at": "[current ISO timestamp]"
+  },
+  "settings": {
+    "enabled": true,
+    "apiUrl": "https://api.plexor.dev",
+    "mode": "balanced",
+    "localCacheEnabled": true
+  }
+}
+```
+
+3. Use the Write tool to update `~/.claude/settings.json` env block:
+```json
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "https://api.plexor.dev/gateway/anthropic",
+    "ANTHROPIC_AUTH_TOKEN": "[user's Plexor key]"
+  }
+}
+```
+Note: Preserve any existing settings, just add/update the env block.
+
+4. Show the user:
+```
+Plexor Setup - Claude MAX User
+==============================
+Setup Complete! No manual configuration needed.
+
+What was configured:
+- ~/.plexor/config.json (Plexor plugin settings)
+- ~/.claude/settings.json (automatic Claude Code routing)
+
+How it works:
+- All Claude Code sessions now route through Plexor
+- Your MAX subscription OAuth token is passed through
+- You keep your MAX benefits ($0 cost, 20x rate limits)
+- Plexor optimizes prompts and tracks usage
+
+Commands:
+- /plexor-status    - See your usage stats
+- /plexor-enabled off - Temporarily disable Plexor
+- /plexor-enabled on  - Re-enable Plexor
+
+Changes take effect immediately in all Claude Code sessions!
+```
+
+**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. Use the Write tool to update `~/.claude/settings.json` env block:
+```json
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "https://api.plexor.dev/gateway/anthropic",
+    "ANTHROPIC_AUTH_TOKEN": "[user's Plexor key]"
+  }
+}
+```
+Note: Preserve any existing settings, just add/update the env block.
+
+4. Show the user:
+```
+Plexor Setup - API Key User
+===========================
+Setup Complete! No manual configuration needed.
+
+What was configured:
+- ~/.plexor/config.json (Plexor plugin settings)
+- ~/.claude/settings.json (automatic Claude Code routing)
+
+How it works:
+- All Claude Code sessions now route through Plexor
+- Plexor picks the best provider (can save up to 90%)
+- Your usage is tracked and optimized
+
+Commands:
+- /plexor-status    - See your usage and savings
+- /plexor-mode eco  - Maximize savings
+- /plexor-mode quality - Maximize quality
+- /plexor-enabled off - Temporarily disable Plexor
+
+Changes take effect immediately in all Claude Code sessions!
+```
+
+**IMPORTANT NOTES**:
+- The `~/.claude/settings.json` env block is the KEY mechanism that routes Claude Code through Plexor
+- ANTHROPIC_AUTH_TOKEN takes precedence over ANTHROPIC_API_KEY (use AUTH_TOKEN for the Plexor key)
+- Changes take effect immediately - no shell restart needed
+- After completing setup, STOP. Do not run additional commands.

package/commands/plexor-status.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+
+/**
+ * Plexor Status Command
+ * Displays formatted status with usage statistics
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+
+const CONFIG_PATH = path.join(process.env.HOME, '.plexor', 'config.json');
+const SESSION_PATH = path.join(process.env.HOME, '.plexor', 'session.json');
+const CLAUDE_SETTINGS_PATH = path.join(process.env.HOME, '.claude', 'settings.json');
+const SESSION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+
+/**
+ * Check if Claude Code is actually routing through Plexor
+ * by reading ~/.claude/settings.json
+ */
+function getRoutingStatus() {
+  try {
+    const data = fs.readFileSync(CLAUDE_SETTINGS_PATH, 'utf8');
+    const settings = JSON.parse(data);
+    const baseUrl = settings.env?.ANTHROPIC_BASE_URL || '';
+    const hasToken = !!settings.env?.ANTHROPIC_AUTH_TOKEN;
+    const isPlexorRouting = baseUrl.includes('plexor') || baseUrl.includes('staging.api');
+    return {
+      active: isPlexorRouting && hasToken,
+      baseUrl,
+      isStaging: baseUrl.includes('staging')
+    };
+  } catch {
+    return { active: false, baseUrl: null, isStaging: false };
+  }
+}
+
+function loadSessionStats() {
+  try {
+    const data = fs.readFileSync(SESSION_PATH, 'utf8');
+    const session = JSON.parse(data);
+    // Check if session has expired
+    if (Date.now() - session.last_activity > SESSION_TIMEOUT_MS) {
+      return null;
+    }
+    return session;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Validate API key format
+ * @param {string} key - API key to validate
+ * @returns {boolean} true if valid format
+ */
+function isValidApiKeyFormat(key) {
+  return key && typeof key === 'string' && key.startsWith('plx_') && key.length >= 20;
+}
+
+/**
+ * Load config file with integrity checking
+ * @returns {Object|null} config object or null if invalid
+ */
+function loadConfig() {
+  try {
+    if (!fs.existsSync(CONFIG_PATH)) {
+      return null;
+    }
+    const data = fs.readFileSync(CONFIG_PATH, 'utf8');
+    if (!data || data.trim() === '') {
+      return null;
+    }
+    const config = JSON.parse(data);
+    if (typeof config !== 'object' || config === null) {
+      return null;
+    }
+    return config;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      console.log('Config file is corrupted. Run /plexor-login to reconfigure.');
+    }
+    return null;
+  }
+}
+
+/**
+ * Check for environment mismatch between config and routing
+ */
+function checkEnvironmentMismatch(configApiUrl, routingBaseUrl) {
+  if (!configApiUrl || !routingBaseUrl) return null;
+
+  const configIsStaging = configApiUrl.includes('staging');
+  const routingIsStaging = routingBaseUrl.includes('staging');
+
+  if (configIsStaging !== routingIsStaging) {
+    return {
+      config: configIsStaging ? 'staging' : 'production',
+      routing: routingIsStaging ? 'staging' : 'production'
+    };
+  }
+  return null;
+}
+
+async function main() {
+  // Read config with integrity checking
+  const config = loadConfig();
+  if (!config) {
+    console.log('Not configured. Run /plexor-login first.');
+    process.exit(1);
+  }
+
+  const apiKey = config.auth?.api_key;
+  const enabled = config.settings?.enabled ?? false;
+  const mode = config.settings?.mode || 'balanced';
+  const provider = config.settings?.preferred_provider || 'auto';
+  const localCache = config.settings?.localCacheEnabled ?? false;
+  const apiUrl = config.settings?.apiUrl || 'https://api.plexor.dev';
+
+  if (!apiKey) {
+    console.log('Not authenticated. Run /plexor-login first.');
+    process.exit(1);
+  }
+
+  // Validate API key format
+  if (!isValidApiKeyFormat(apiKey)) {
+    console.log('Invalid API key format. Keys must start with "plx_" and be at least 20 characters.');
+    console.log('Run /plexor-login with a valid API key.');
+    process.exit(1);
+  }
+
+  // Fetch user info and stats
+  let user = { email: 'Unknown', tier: { name: 'Free', limits: {} } };
+  let stats = { period: {}, summary: {} };
+
+  try {
+    [user, stats] = await Promise.all([
+      fetchJson(apiUrl, '/v1/user', apiKey),
+      fetchJson(apiUrl, '/v1/stats', apiKey)
+    ]);
+  } catch (err) {
+    // Continue with defaults if API fails
+  }
+
+  // Load session stats
+  const session = loadSessionStats();
+
+  // Extract data
+  const email = user.email || 'Unknown';
+  const tierName = user.tier?.name || 'Free';
+  const monthlyOpts = user.tier?.limits?.monthly_optimizations || '∞';
+  const monthlyComps = user.tier?.limits?.monthly_completions || '∞';
+
+  const period = stats.period || {};
+  const summary = stats.summary || {};
+
+  const formatDate = (iso) => {
+    if (!iso) return '?';
+    const d = new Date(iso);
+    return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+  };
+  const weekRange = `${formatDate(period.start)} - ${formatDate(period.end)}`;
+
+  // Format numbers
+  const formatNum = (n) => (n || 0).toLocaleString();
+  const formatPct = (n) => (n || 0).toFixed(1);
+  const formatCost = (n) => (n || 0).toFixed(2);
+
+  const status = enabled ? '● Active' : '○ Inactive';
+  const optEnabled = enabled ? 'Enabled' : 'Disabled';
+  const cacheEnabled = localCache ? 'Enabled' : 'Disabled';
+  const cacheRate = formatPct((summary.cache_hit_rate || 0) * 100);
+
+  // Build dashboard URL from API URL
+  // API: https://api.plexor.dev or https://staging.api.plexor.dev
+  // Dashboard: https://plexor.dev/dashboard or https://staging.plexor.dev/dashboard
+  let dashboardUrl = 'https://plexor.dev/dashboard';
+  try {
+    const url = new URL(apiUrl);
+    // Remove 'api.' prefix from hostname if present
+    const host = url.hostname.replace(/^api\./, '').replace(/\.api\./, '.');
+    dashboardUrl = `${url.protocol}//${host}/dashboard`;
+  } catch {
+    // If URL parsing fails, use default
+  }
+
+  // Output formatted status - each line is exactly 43 chars inner width
+  const line = (content) => `  │  ${content.padEnd(43)}│`;
+
+  // Session stats formatting
+  const formatDuration = (startedAt) => {
+    if (!startedAt) return '0m';
+    const elapsed = Date.now() - new Date(startedAt).getTime();
+    const minutes = Math.floor(elapsed / 60000);
+    if (minutes < 60) return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    return `${hours}h ${minutes % 60}m`;
+  };
+
+  const sessionDuration = session ? formatDuration(session.started_at) : '0m';
+  const sessionRequests = session ? formatNum(session.requests) : '0';
+  const sessionOptimizations = session ? formatNum(session.optimizations) : '0';
+  const sessionCacheHits = session ? formatNum(session.cache_hits) : '0';
+  const sessionTokensSaved = session ? formatNum(session.tokens_saved) : '0';
+  const sessionTokensSavedPct = session && session.original_tokens > 0
+    ? formatPct((session.tokens_saved / session.original_tokens) * 100)
+    : '0.0';
+  const sessionCostSaved = session ? formatCost(session.cost_saved) : '0.00';
+
+  // Build session section (only show if session exists)
+  const sessionSection = session ? `  ├─────────────────────────────────────────────┤
+${line(`This Session (${sessionDuration})`)}
+${line(`├── Requests: ${sessionRequests}`)}
+${line(`├── Optimizations: ${sessionOptimizations}`)}
+${line(`├── Cache hits: ${sessionCacheHits}`)}
+${line(`├── Tokens saved: ${sessionTokensSaved} (${sessionTokensSavedPct}%)`)}
+${line(`└── Cost saved: $${sessionCostSaved}`)}
+` : '';
+
+  // Get routing status from Claude settings.json
+  const routing = getRoutingStatus();
+  const routingIndicator = routing.active ? '🟢 PLEXOR MODE: ON' : '🔴 PLEXOR MODE: OFF';
+  const envLabel = routing.isStaging ? '(staging)' : '(production)';
+
+  // Check for environment mismatch
+  const envMismatch = checkEnvironmentMismatch(apiUrl, routing.baseUrl);
+  const mismatchWarning = envMismatch
+    ? `  ⚠ Warning: Config uses ${envMismatch.config} but routing is ${envMismatch.routing}\n`
+    : '';
+
+  if (mismatchWarning) {
+    console.log(mismatchWarning);
+  }
+
+  console.log(`  ┌─────────────────────────────────────────────┐
+${line(routingIndicator + (routing.active ? ' ' + envLabel : ''))}
+  ├─────────────────────────────────────────────┤
+${line(`Account: ${tierName}`)}
+${line(`Email: ${email}`)}
+${line(`Status: ${status}`)}
+${sessionSection}  ├─────────────────────────────────────────────┤
+${line(`This Week (${weekRange})`)}
+${line(`├── Requests: ${formatNum(summary.total_requests)}`)}
+${line(`├── Original tokens: ${formatNum(summary.original_tokens)}`)}
+${line(`├── Optimized tokens: ${formatNum(summary.optimized_tokens)}`)}
+${line(`├── Tokens saved: ${formatNum(summary.tokens_saved)} (${formatPct(summary.tokens_saved_percent)}%)`)}
+${line(`├── Baseline cost: $${formatCost(summary.baseline_cost)}`)}
+${line(`├── Actual cost: $${formatCost(summary.total_cost)}`)}
+${line(`└── Cost saved: $${formatCost(summary.cost_saved)} (${formatPct(summary.cost_saved_percent)}%)`)}
+  ├─────────────────────────────────────────────┤
+${line('Performance')}
+${line(`└── Cache hit rate: ${cacheRate}%`)}
+  ├─────────────────────────────────────────────┤
+${line('Limits')}
+${line(`├── Monthly optimizations: ${formatNum(monthlyOpts)}`)}
+${line(`└── Monthly completions: ${formatNum(monthlyComps)}`)}
+  ├─────────────────────────────────────────────┤
+${line('Settings')}
+${line(`├── Optimization: ${optEnabled}`)}
+${line(`├── Local cache: ${cacheEnabled}`)}
+${line(`├── Mode: ${mode}`)}
+${line(`├── Provider routing: ${provider}`)}
+${line(`└── Endpoint: ${routing.baseUrl ? routing.baseUrl.replace('https://', '').substring(0, 30) : 'not configured'}`)}
+  └─────────────────────────────────────────────┘
+
+  Dashboard: ${dashboardUrl}
+`);
+}
+
+function fetchJson(apiUrl, endpoint, apiKey) {
+  return new Promise((resolve, reject) => {
+    let url;
+    try {
+      url = new URL(`${apiUrl}${endpoint}`);
+    } catch {
+      reject(new Error('Invalid API URL'));
+      return;
+    }
+
+    const options = {
+      hostname: url.hostname,
+      port: 443,
+      path: url.pathname,
+      method: 'GET',
+      headers: {
+        'X-Plexor-Key': apiKey
+      }
+    };
+
+    const req = https.request(options, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        // Check HTTP status code first
+        if (res.statusCode === 401) {
+          reject(new Error('Invalid API key'));
+          return;
+        }
+        if (res.statusCode === 403) {
+          reject(new Error('Access denied'));
+          return;
+        }
+        if (res.statusCode >= 500) {
+          reject(new Error('Server error'));
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`HTTP ${res.statusCode}`));
+          return;
+        }
+
+        // Check for empty response
+        if (!data || data.trim() === '') {
+          reject(new Error('Empty response'));
+          return;
+        }
+
+        // Parse JSON
+        try {
+          const parsed = JSON.parse(data);
+          if (parsed === null) {
+            reject(new Error('Null response'));
+            return;
+          }
+          resolve(parsed);
+        } catch {
+          reject(new Error('Invalid JSON response'));
+        }
+      });
+    });
+
+    req.on('error', (err) => reject(new Error(`Connection failed: ${err.message}`)));
+    req.setTimeout(5000, () => {
+      req.destroy();
+      reject(new Error('Request timeout'));
+    });
+    req.end();
+  });
+}
+
+main().catch(err => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});