@plexor-dev/claude-code-plugin 0.1.0-beta.2 → 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/commands/plexor-status.js

@@ -0,0 +1,213 @@
+#!/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 SESSION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+
+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}`)}
+` : '';
+
+  console.log(`  ┌─────────────────────────────────────────────┐
+${line('Plexor Status')}
+  ├─────────────────────────────────────────────┤
+${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

@@ -1,46 +1,21 @@
 ---
-description: Show Plexor optimization statistics and savings
+description: Show Plexor optimization statistics and savings (user)
 ---
 
 # Plexor Status
 
-Display current Plexor status, configuration, and usage statistics.
+Run this command to display Plexor statistics:
 
-## Instructions
-
-1. Read the Plexor configuration from ~/.plexor/config.json
-2. If not authenticated, show a message to run /plexor-login
-3. If authenticated, call the Plexor API to get usage stats
-4. Display a formatted summary including:
-   - Account status (Free/Pro/Team)
-   - This session: requests optimized, tokens saved, estimated savings
-   - This week: total requests, total tokens saved, total savings
-   - Current settings: optimization enabled, local cache status
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-status.js
+```
 
-## Output Format
+Use the Bash tool to execute this single command.
 
-```
-┌─────────────────────────────────────────────┐
-│  Plexor Status                              │
-├─────────────────────────────────────────────┤
-│  Account: Pro ($19/mo)                      │
-│  Status: ● Active                           │
-├─────────────────────────────────────────────┤
-│  This Session                               │
-│  ├── Requests: 47                           │
-│  ├── Tokens saved: 12,847 (31%)             │
-│  └── Est. savings: $0.42                    │
-├─────────────────────────────────────────────┤
-│  This Week                                  │
-│  ├── Requests: 1,247                        │
-│  ├── Tokens saved: 482,938 (34%)            │
-│  └── Est. savings: $14.23                   │
-├─────────────────────────────────────────────┤
-│  Settings                                   │
-│  ├── Optimization: Enabled                  │
-│  ├── Local cache: Enabled                   │
-│  └── Provider routing: DeepSeek preferred   │
-└─────────────────────────────────────────────┘
+**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.