@plexor-dev/claude-code-plugin-localhost 0.1.0-beta.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Plexor AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @plexor-dev/claude-code-plugin
+
+LLM cost optimization plugin for Claude Code. Save up to 90% on AI costs through intelligent prompt optimization and multi-provider routing.
+
+## Installation
+
+```bash
+npm install -g @plexor-dev/claude-code-plugin
+```
+
+This installs slash commands to `~/.claude/commands/`.
+
+## Quick Start
+
+1. **Install the plugin** (see above)
+
+2. **Open Claude Code** and run:
+   ```
+   /plexor-login
+   ```
+
+3. **Follow the prompts** to authenticate via browser
+
+4. **Set the gateway URL** in your terminal:
+   ```bash
+   export ANTHROPIC_BASE_URL="https://api.plexor.dev/v1/gateway/anthropic"
+   ```
+
+5. **Restart Claude Code** - all prompts are now optimized!
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/plexor-setup` | First-time setup wizard |
+| `/plexor-login` | Authenticate with Plexor API key |
+| `/plexor-logout` | Sign out and clear credentials |
+| `/plexor-status` | View usage stats and savings |
+| `/plexor-enabled` | Enable/disable Plexor routing |
+
+## How It Works
+
+Plexor acts as an intelligent gateway between Claude Code and LLM providers:
+
+```
+Claude Code → Plexor Gateway → Best Provider (Anthropic/DeepSeek/Mistral/Gemini/OpenAI)
+```
+
+The gateway:
+- **Optimizes prompts** to reduce token usage
+- **Routes requests** to the most cost-effective provider
+- **Maintains quality** based on your selected mode
+- **Tracks savings** so you can see your ROI
+
+## Optimization Modes
+
+| Mode | Savings | Best For |
+|------|---------|----------|
+| **eco** | 60-90% | Development, testing, iteration |
+| **balanced** | 40-60% | Most production workloads |
+| **quality** | 20-40% | Critical responses, customer-facing |
+| **passthrough** | 0% | Debugging, comparison |
+
+## Pricing
+
+- **Beta**: $1/month (unlimited requests)
+- Savings typically 10-100x the subscription cost
+
+## Configuration
+
+Settings are stored in `~/.plexor/config.json`:
+
+```json
+{
+  "version": 1,
+  "auth": {
+    "api_key": "plx_...",
+    "email": "user@example.com"
+  },
+  "settings": {
+    "enabled": true,
+    "mode": "balanced",
+    "preferred_provider": "auto"
+  }
+}
+```
+
+## Uninstall
+
+```bash
+npm uninstall -g @plexor-dev/claude-code-plugin
+```
+
+To fully remove:
+```bash
+unset ANTHROPIC_BASE_URL
+rm -rf ~/.plexor
+```
+
+## Requirements
+
+- Node.js 16+
+- Claude Code CLI
+- macOS, Linux, or Windows (WSL)
+
+## Support
+
+- **Documentation**: https://plexor.dev/docs
+- **Issues**: https://github.com/plexor-ai/claude-code-plugin/issues
+- **Email**: hello@plexor.dev
+
+## License
+
+MIT

package/commands/plexor-enabled.js

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+
+/**
+ * Plexor Enabled Command
+ * Enable or disable Plexor optimization proxy
+ *
+ * KEY FEATURE: When toggling on/off, automatically updates ~/.claude/settings.json
+ * to route or un-route ALL Claude Code sessions through Plexor gateway.
+ *
+ * THE DREAM: User just runs "/plexor-enabled off" to disable, "/plexor-enabled on" to enable.
+ * No manual environment variables or config updates required!
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Import centralized constants with HOME directory validation
+const { PLEXOR_DIR, CONFIG_PATH } = require('../lib/constants');
+
+// Import settings manager with error handling for missing lib
+let settingsManager, PLEXOR_STAGING_URL, PLEXOR_PROD_URL;
+try {
+  const lib = require('../lib/settings-manager');
+  settingsManager = lib.settingsManager;
+  PLEXOR_STAGING_URL = lib.PLEXOR_STAGING_URL;
+  PLEXOR_PROD_URL = lib.PLEXOR_PROD_URL;
+} catch (err) {
+  if (err.code === 'MODULE_NOT_FOUND') {
+    console.error('Error: Plexor plugin files are missing or corrupted.');
+    console.error('       Please reinstall: npm install @plexor-dev/claude-code-plugin-localhost');
+    process.exit(1);
+  }
+  throw err;
+}
+
+function loadConfig() {
+  try {
+    if (!fs.existsSync(CONFIG_PATH)) {
+      return { version: 1, auth: {}, settings: {} };
+    }
+    const data = fs.readFileSync(CONFIG_PATH, 'utf8');
+    if (!data || data.trim() === '') {
+      return { version: 1, auth: {}, settings: {} };
+    }
+    const config = JSON.parse(data);
+    if (typeof config !== 'object' || config === null) {
+      console.warn('Warning: Config file has invalid format, using defaults');
+      return { version: 1, auth: {}, settings: {} };
+    }
+    return config;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      console.warn('Warning: Config file is corrupted, using defaults');
+      // Backup corrupted file
+      try {
+        fs.copyFileSync(CONFIG_PATH, CONFIG_PATH + '.corrupted');
+      } catch { /* ignore */ }
+    }
+    return { version: 1, auth: {}, settings: {} };
+  }
+}
+
+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;
+  }
+}
+
+/**
+ * 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;
+}
+
+/**
+ * Check for state mismatch between config.json enabled flag and settings.json routing
+ * @param {boolean} configEnabled - enabled flag from config.json
+ * @param {boolean} routingActive - whether settings.json has Plexor routing configured
+ * @returns {Object|null} mismatch details or null if states are consistent
+ */
+function checkStateMismatch(configEnabled, routingActive) {
+  if (configEnabled && !routingActive) {
+    return {
+      type: 'config-enabled-routing-inactive',
+      message: 'Config shows enabled but Claude routing is not configured',
+      suggestion: 'Run /plexor-enabled true to sync and configure routing'
+    };
+  }
+  if (!configEnabled && routingActive) {
+    return {
+      type: 'config-disabled-routing-active',
+      message: 'Config shows disabled but Claude routing is active',
+      suggestion: 'Run /plexor-enabled false to sync and disable routing'
+    };
+  }
+  return null;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const config = loadConfig();
+  const currentEnabled = config.settings?.enabled ?? false;
+  const apiKey = config.auth?.api_key;
+
+  // Get current Claude settings.json routing status
+  const routingStatus = settingsManager.getRoutingStatus();
+
+  // No args - show current status
+  if (args.length === 0) {
+    const status = currentEnabled ? '● Enabled' : '○ Disabled';
+    const routingStr = routingStatus.enabled ? '● Active' : '○ Inactive';
+
+    // Check for state mismatch between config enabled flag and routing status
+    const stateMismatch = checkStateMismatch(currentEnabled, routingStatus.enabled);
+
+    console.log(`┌─────────────────────────────────────────────┐`);
+    console.log(`│  Plexor Proxy Status                        │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Plugin Config: ${status.padEnd(27)}│`);
+    console.log(`│  Claude Routing: ${routingStr.padEnd(26)}│`);
+    if (routingStatus.enabled) {
+    console.log(`│  Endpoint: ${(routingStatus.isStaging ? 'Staging' : 'Production').padEnd(32)}│`);
+    }
+    if (stateMismatch) {
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  ⚠ State mismatch detected:                 │`);
+    console.log(`│  ${stateMismatch.message.padEnd(42)}│`);
+    console.log(`│  ${stateMismatch.suggestion.padEnd(42)}│`);
+    }
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Usage:                                     │`);
+    console.log(`│    /plexor-enabled true   - Enable proxy    │`);
+    console.log(`│    /plexor-enabled false  - Disable proxy   │`);
+    console.log(`│    /plexor-enabled on     - Enable proxy    │`);
+    console.log(`│    /plexor-enabled off    - Disable proxy   │`);
+    console.log(`└─────────────────────────────────────────────┘`);
+    return;
+  }
+
+  const arg = args[0].toLowerCase();
+  let newEnabled;
+
+  if (['true', 'on', 'yes', '1', 'enable'].includes(arg)) {
+    newEnabled = true;
+  } else if (['false', 'off', 'no', '0', 'disable'].includes(arg)) {
+    newEnabled = false;
+  } else {
+    console.error(`Error: Invalid value "${args[0]}"`);
+    console.error(`Use: true/false, on/off, yes/no, enable/disable`);
+    process.exit(1);
+  }
+
+  // THE KEY FEATURE: Update Claude Code settings.json routing
+  let routingUpdated = false;
+  let missingApiKey = false;
+  let invalidApiKey = false;
+
+  if (newEnabled) {
+    // Enable routing - need valid API key from config
+    if (!apiKey) {
+      missingApiKey = true;
+    } else if (!isValidApiKeyFormat(apiKey)) {
+      invalidApiKey = true;
+    } else {
+      // Update Plexor plugin config first
+      config.settings = config.settings || {};
+      config.settings.enabled = newEnabled;
+      if (!saveConfig(config)) {
+        process.exit(1);
+      }
+
+      // LOCALHOST PACKAGE - uses tunnel URL
+      const apiUrl = config.settings?.apiUrl || 'LOCALHOST_TUNNEL_URL';
+      const useStaging = apiUrl.includes('staging');
+      routingUpdated = settingsManager.enablePlexorRouting(apiKey, { useStaging });
+
+      // Check if settings.json update failed
+      if (!routingUpdated) {
+        console.log(`┌─────────────────────────────────────────────┐`);
+        console.log(`│  ✗ Failed to Enable Plexor Routing          │`);
+        console.log(`├─────────────────────────────────────────────┤`);
+        console.log(`│  Could not update ~/.claude/settings.json   │`);
+        console.log(`│  Config.json was updated but routing failed.│`);
+        console.log(`├─────────────────────────────────────────────┤`);
+        console.log(`│  Check file permissions and try again.      │`);
+        console.log(`└─────────────────────────────────────────────┘`);
+        process.exit(1);
+      }
+    }
+  } else {
+    // Update Plexor plugin config
+    config.settings = config.settings || {};
+    config.settings.enabled = newEnabled;
+    if (!saveConfig(config)) {
+      process.exit(1);
+    }
+
+    // Disable routing - remove env vars from settings.json
+    routingUpdated = settingsManager.disablePlexorRouting();
+
+    // Check if settings.json update failed
+    if (!routingUpdated) {
+      console.log(`┌─────────────────────────────────────────────┐`);
+      console.log(`│  ✗ Failed to Disable Plexor Routing         │`);
+      console.log(`├─────────────────────────────────────────────┤`);
+      console.log(`│  Could not update ~/.claude/settings.json   │`);
+      console.log(`│  Config.json was updated but routing failed.│`);
+      console.log(`├─────────────────────────────────────────────┤`);
+      console.log(`│  Check file permissions and try again.      │`);
+      console.log(`└─────────────────────────────────────────────┘`);
+      process.exit(1);
+    }
+  }
+
+  // Show error if no API key when enabling
+  if (missingApiKey) {
+    console.log(`┌─────────────────────────────────────────────┐`);
+    console.log(`│  ✗ Cannot Enable Plexor                     │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  No API key configured.                     │`);
+    console.log(`│  Run /plexor-login <api-key> first.         │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Get your API key at:                       │`);
+    console.log(`│  https://plexor.dev/dashboard/api-keys      │`);
+    console.log(`└─────────────────────────────────────────────┘`);
+    process.exit(1);
+  }
+
+  // Show error if API key format is invalid
+  if (invalidApiKey) {
+    console.log(`┌─────────────────────────────────────────────┐`);
+    console.log(`│  ✗ Cannot Enable Plexor                     │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Invalid API key format in config.          │`);
+    console.log(`│  Keys must start with "plx_" (20+ chars).   │`);
+    console.log(`├─────────────────────────────────────────────┤`);
+    console.log(`│  Run /plexor-login <api-key> to fix.        │`);
+    console.log(`└─────────────────────────────────────────────┘`);
+    process.exit(1);
+  }
+
+  const newStatus = newEnabled ? '● Enabled' : '○ Disabled';
+  const prevStatus = currentEnabled ? 'Enabled' : 'Disabled';
+  const routingMsg = routingUpdated
+    ? (newEnabled ? 'Claude Code now routes through Plexor' : 'Claude Code now connects directly')
+    : 'Manual routing update may be needed';
+
+  console.log(`┌─────────────────────────────────────────────┐`);
+  console.log(`│  ✓ Plexor Proxy Updated                     │`);
+  console.log(`├─────────────────────────────────────────────┤`);
+  console.log(`│  Previous: ${prevStatus.padEnd(32)}│`);
+  console.log(`│  New: ${newStatus.padEnd(37)}│`);
+  console.log(`├─────────────────────────────────────────────┤`);
+  console.log(`│  ${routingMsg.padEnd(42)}│`);
+  console.log(`│  Changes take effect immediately.           │`);
+  console.log(`└─────────────────────────────────────────────┘`);
+}
+
+main();

package/commands/plexor-enabled.md

@@ -0,0 +1,48 @@
+---
+description: Enable or disable Plexor proxy (routes all traffic through Plexor API) (user)
+---
+
+# Plexor Enabled
+
+Toggle Plexor proxy on or off.
+
+## If argument provided (on/off/true/false)
+
+Run the command directly with the argument:
+
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-enabled.js <argument>
+```
+
+Then display the output and STOP.
+
+## If NO argument provided
+
+**Step 1**: First get current status by running:
+
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-enabled.js
+```
+
+**Step 2**: Based on the output, use AskUserQuestion to present options:
+
+If currently ENABLED (shows "● Enabled" or "● Active"):
+- Question: "Plexor is currently ON. What would you like to do?"
+- Header: "Plexor"
+- Options:
+  1. **Turn OFF** - Disable Plexor routing (connect directly to Anthropic)
+  2. **Keep ON** - No change
+
+If currently DISABLED (shows "○ Disabled" or "○ Inactive"):
+- Question: "Plexor is currently OFF. What would you like to do?"
+- Header: "Plexor"
+- Options:
+  1. **Turn ON** - Enable Plexor routing
+  2. **Keep OFF** - No change
+
+**Step 3**: Based on user selection:
+- If "Turn OFF" selected: Run `node ~/.claude/plugins/plexor/commands/plexor-enabled.js false`
+- If "Turn ON" selected: Run `node ~/.claude/plugins/plexor/commands/plexor-enabled.js true`
+- If "Keep" selected: Do nothing, just confirm current state
+
+**IMPORTANT**: After completing, STOP. Do not read files, explore codebase, or run additional commands.