@plexor-dev/claude-code-plugin-staging 0.1.0-beta.1

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,240 @@
+#!/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;
+  }
+}
+
+async function main() {
+  // Read config
+  let config;
+  try {
+    const data = fs.readFileSync(CONFIG_PATH, 'utf8');
+    config = JSON.parse(data);
+  } catch (err) {
+    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);
+  }
+
+  // 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)';
+
+  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}`)}
+  └─────────────────────────────────────────────┘
+
+  Dashboard: ${dashboardUrl}
+`);
+}
+
+function fetchJson(apiUrl, endpoint, apiKey) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(`${apiUrl}${endpoint}`);
+
+    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', () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch {
+          reject(new Error('Invalid response'));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.setTimeout(5000, () => {
+      req.destroy();
+      reject(new Error('Timeout'));
+    });
+    req.end();
+  });
+}
+
+main().catch(err => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/commands/plexor-status.md

@@ -0,0 +1,21 @@
+---
+description: Show Plexor optimization statistics and savings (user)
+---
+
+# Plexor Status
+
+Run this command to display Plexor statistics:
+
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-status.js
+```
+
+Use the Bash tool to execute this single command.
+
+**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
+
+The command output is the complete response. Simply show the output and wait for the user's next input.