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

package/commands/plexor-config.md

@@ -40,3 +40,5 @@ Other commands:
 - /plexor-provider - Change provider
 - /plexor-enabled - Enable/disable proxy
 ```
+
+**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.

package/commands/plexor-enabled.md

@@ -52,3 +52,5 @@ Plexor Proxy: DISABLED
 Your prompts will go directly to Anthropic at full price.
 Run /plexor-enabled to re-enable optimization.
 ```
+
+**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.

package/commands/plexor-login.md

@@ -82,3 +82,5 @@ Dashboard: https://plexor.dev/dashboard
 ```
 
 If the API call fails, tell the user the key may be invalid and ask them to check it.
+
+**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.

package/commands/plexor-logout.md

@@ -40,3 +40,5 @@ To use Plexor again, run /plexor-login
 
 Dashboard: https://plexor.dev/dashboard
 ```
+
+**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.

package/commands/plexor-mode.md

@@ -45,3 +45,5 @@ Mode Details:
 Current mode: [mode]
 Run /plexor-status to see your savings.
 ```
+
+**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.

package/commands/plexor-provider.md

@@ -45,3 +45,5 @@ Provider options:
 Current provider: [preferredProvider]
 Run /plexor-status to see your usage.
 ```
+
+**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.

package/commands/plexor-settings.md

@@ -56,3 +56,5 @@ Options:
 4. **Timeout** - Change request timeout
 
 Then update `~/.plexor/config.json` with the new value using the Write tool.
+
+**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.

package/commands/plexor-status.js

@@ -92,8 +92,18 @@ async function main() {
   const cacheEnabled = localCache ? 'Enabled' : 'Disabled';
   const cacheRate = formatPct((summary.cache_hit_rate || 0) * 100);
 
-  // Build dashboard URL
-  const dashboardUrl = apiUrl.replace('.api.', '.').replace('/api', '') + '/dashboard.html';
+  // 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)}│`;

package/commands/plexor-status.md

@@ -10,4 +10,12 @@ Run this command to display Plexor statistics:
 node ~/.claude/plugins/plexor/commands/plexor-status.js
 ```
 
-Use the Bash tool to execute this single command. Do not read files manually or format output yourself.
+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.

package/hooks/intercept.js

@@ -1,13 +1,22 @@
 #!/usr/bin/env node
 
 /**
- * Plexor Interception Hook
+ * Plexor Interception Hook - Phase 3 Hypervisor Architecture
  *
- * This script intercepts Claude Code prompts before they are sent to the LLM.
- * It optimizes the prompt and optionally routes to a cheaper provider.
+ * This script intercepts Claude Code requests before they reach the LLM.
+ *
+ * In HYPERVISOR MODE (ANTHROPIC_BASE_URL points to Plexor):
+ *   - All requests pass through unchanged
+ *   - Server handles all optimization, routing, and quality control
+ *   - Plugin just adds session tracking metadata
+ *   - This is the recommended setup for best user experience
+ *
+ * In PLUGIN MODE (direct to Anthropic):
+ *   - Plugin does local optimization (legacy behavior)
+ *   - Less reliable due to client-side state management
  *
  * Input: JSON object with messages, model, max_tokens, etc.
- * Output: Modified JSON object with optimized messages
+ * Output: Passthrough (hypervisor mode) or optimized messages (plugin mode)
  */
 
 const fs = require('fs');
@@ -170,14 +179,27 @@ async function main() {
     input = await readStdin();
     request = JSON.parse(input);
 
-    // Issue #687: Auto-disable hook when ANTHROPIC_BASE_URL points to Plexor
-    // If already using Plexor as proxy, don't run local hook (avoid double-processing)
+    // Phase 3 Hypervisor Mode Detection
+    // When ANTHROPIC_BASE_URL points to Plexor, all intelligence is server-side
+    // The plugin just passes through - server handles optimization, routing, quality
     const baseUrl = process.env.ANTHROPIC_BASE_URL || '';
-    if (baseUrl.includes('plexor')) {
-      logger.debug('Plexor proxy detected via ANTHROPIC_BASE_URL, passing through');
-      // Note: Don't add _plexor metadata here - the proxy will add its own
-      // This passthrough is transparent to avoid double-processing
-      return output(request);
+    const isHypervisorMode = baseUrl.includes('plexor') || baseUrl.includes('staging.api');
+
+    if (isHypervisorMode) {
+      // HYPERVISOR MODE: Server handles everything
+      // Just pass through with minimal metadata for session tracking
+      logger.debug('[Plexor] Hypervisor mode active - server handles all optimization');
+
+      // Add session tracking metadata (server will use this for analytics)
+      return output({
+        ...request,
+        _plexor_client: {
+          mode: 'hypervisor',
+          plugin_version: '0.1.0-beta.18',
+          cwd: process.cwd(),
+          timestamp: Date.now(),
+        }
+      });
     }
 
     // CRITICAL: Check for slash commands FIRST (before agentic check)

package/package.json

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

package/scripts/plexor-cli.sh

@@ -1,18 +1,31 @@
 #!/bin/bash
 # Plexor CLI - Claude Code with intelligent optimization
+# This wrapper auto-enables hypervisor mode for direct gateway routing
 
-# Only show Plexor branding if ANTHROPIC_BASE_URL points to Plexor
-if [[ "$ANTHROPIC_BASE_URL" == *"plexor"* ]]; then
-    # Colors
-    CYAN='\033[0;36m'
-    GREEN='\033[0;32m'
-    YELLOW='\033[0;33m'
-    DIM='\033[2m'
-    NC='\033[0m' # No Color
+# Colors
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+DIM='\033[2m'
+NC='\033[0m' # No Color
 
-    # Plexor ASCII art
-    echo -e "${CYAN}"
-    cat << 'EOF'
+CONFIG_FILE="$HOME/.plexor/config.json"
+
+# Auto-configure ANTHROPIC_BASE_URL if Plexor is enabled
+if [ -f "$CONFIG_FILE" ]; then
+    ENABLED=$(python3 -c "import json; c=json.load(open('$CONFIG_FILE')); print(c.get('settings',{}).get('enabled', False))" 2>/dev/null)
+    API_URL=$(python3 -c "import json; c=json.load(open('$CONFIG_FILE')); print(c.get('settings',{}).get('apiUrl', ''))" 2>/dev/null)
+    API_KEY=$(python3 -c "import json; c=json.load(open('$CONFIG_FILE')); print(c.get('auth',{}).get('api_key', ''))" 2>/dev/null)
+    MODE=$(python3 -c "import json; c=json.load(open('$CONFIG_FILE')); print(c.get('settings',{}).get('mode', 'balanced'))" 2>/dev/null)
+
+    if [ "$ENABLED" = "True" ] && [ -n "$API_URL" ] && [ -n "$API_KEY" ]; then
+        # Set ANTHROPIC_BASE_URL to Plexor gateway (hypervisor mode)
+        export ANTHROPIC_BASE_URL="${API_URL}/gateway/anthropic/v1"
+        export ANTHROPIC_API_KEY="$API_KEY"
+
+        # Show Plexor branding
+        echo -e "${CYAN}"
+        cat << 'EOF'
     ____  __
    / __ \/ /__  _  ______  _____
   / /_/ / / _ \| |/_/ __ \/ ___/
@@ -20,19 +33,13 @@ if [[ "$ANTHROPIC_BASE_URL" == *"plexor"* ]]; then
 /_/   /_/\___/_/|_|\____/_/
 
 EOF
-    echo -e "${NC}"
-
-    # Show status
-    CONFIG_FILE="$HOME/.plexor/config.json"
-    if [ -f "$CONFIG_FILE" ]; then
-        ENABLED=$(jq -r '.settings.enabled // false' "$CONFIG_FILE" 2>/dev/null)
-        MODE=$(jq -r '.settings.mode // "balanced"' "$CONFIG_FILE" 2>/dev/null)
-
-        if [ "$ENABLED" = "true" ]; then
-            echo -e "${GREEN}●${NC} Optimization: ${GREEN}Active${NC} (${MODE} mode)"
-        else
-            echo -e "${YELLOW}○${NC} Optimization: ${DIM}Disabled${NC}"
-        fi
+        echo -e "${NC}"
+        echo -e "${GREEN}●${NC} Hypervisor Mode: ${GREEN}Active${NC}"
+        echo -e "   Gateway: ${DIM}${ANTHROPIC_BASE_URL}${NC}"
+        echo -e "   Mode: ${MODE}"
+        echo ""
+    else
+        echo -e "${YELLOW}○${NC} Plexor: ${DIM}Disabled${NC} (run /plexor-login to enable)"
         echo ""
     fi
 fi

package/scripts/postinstall.js

@@ -11,23 +11,49 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+/**
+ * Get the correct home directory, accounting for sudo.
+ * When running with sudo, os.homedir() returns /root, but we want
+ * the actual user's home directory.
+ */
+function getHomeDir() {
+  // Check if running with sudo - SUDO_USER contains the original username
+  if (process.env.SUDO_USER) {
+    // On Linux/Mac, home directories are typically /home/<user> or /Users/<user>
+    const platform = os.platform();
+    if (platform === 'darwin') {
+      return path.join('/Users', process.env.SUDO_USER);
+    } else if (platform === 'linux') {
+      return path.join('/home', process.env.SUDO_USER);
+    }
+  }
+  return os.homedir();
+}
+
+const HOME_DIR = getHomeDir();
 const COMMANDS_SOURCE = path.join(__dirname, '..', 'commands');
-const CLAUDE_COMMANDS_DIR = path.join(os.homedir(), '.claude', 'commands');
-const PLEXOR_CONFIG_DIR = path.join(os.homedir(), '.plexor');
+const CLAUDE_COMMANDS_DIR = path.join(HOME_DIR, '.claude', 'commands');
+const PLEXOR_PLUGINS_DIR = path.join(HOME_DIR, '.claude', 'plugins', 'plexor', 'commands');
+const PLEXOR_CONFIG_DIR = path.join(HOME_DIR, '.plexor');
 
 function main() {
   try {
     // Create ~/.claude/commands/ if not exists
     fs.mkdirSync(CLAUDE_COMMANDS_DIR, { recursive: true });
 
+    // Create ~/.claude/plugins/plexor/commands/ for JS executors
+    fs.mkdirSync(PLEXOR_PLUGINS_DIR, { recursive: true });
+
     // Create ~/.plexor/ with secure permissions (owner only)
     fs.mkdirSync(PLEXOR_CONFIG_DIR, { recursive: true, mode: 0o700 });
 
-    // Get list of command files
-    const files = fs.readdirSync(COMMANDS_SOURCE)
+    // Get list of command files (.md for Claude, .js for executors)
+    const mdFiles = fs.readdirSync(COMMANDS_SOURCE)
       .filter(f => f.endsWith('.md'));
+    const jsFiles = fs.readdirSync(COMMANDS_SOURCE)
+      .filter(f => f.endsWith('.js'));
 
-    if (files.length === 0) {
+    if (mdFiles.length === 0) {
       console.error('No command files found in package. Installation may be corrupt.');
       process.exit(1);
     }
@@ -35,7 +61,8 @@ function main() {
     const installed = [];
     const backed_up = [];
 
-    for (const file of files) {
+    // Copy .md command files to ~/.claude/commands/
+    for (const file of mdFiles) {
       const src = path.join(COMMANDS_SOURCE, file);
       const dest = path.join(CLAUDE_COMMANDS_DIR, file);
 
@@ -55,6 +82,17 @@ function main() {
       installed.push(file.replace('.md', ''));
     }
 
+    // Copy .js executor files to ~/.claude/plugins/plexor/commands/
+    const jsInstalled = [];
+    for (const file of jsFiles) {
+      const src = path.join(COMMANDS_SOURCE, file);
+      const dest = path.join(PLEXOR_PLUGINS_DIR, file);
+      fs.copyFileSync(src, dest);
+      // Make executable
+      fs.chmodSync(dest, 0o755);
+      jsInstalled.push(file);
+    }
+
     // Print success message
     console.log('');
     console.log('  ╔═══════════════════════════════════════════════════════════╗');
@@ -74,6 +112,12 @@ function main() {
       backed_up.forEach(f => console.log(`    ${f}`));
     }
 
+    if (jsInstalled.length > 0) {
+      console.log('');
+      console.log('  Executors installed to ~/.claude/plugins/plexor/commands/:');
+      jsInstalled.forEach(f => console.log(`    ${f}`));
+    }
+
     console.log('');
     console.log('  Next steps:');
     console.log('    1. Open Claude Code');