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

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,117 @@
+# @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-login` | Authenticate with Plexor |
+| `/plexor-status` | View usage stats and savings |
+| `/plexor-mode` | Set optimization mode (eco/balanced/quality/passthrough) |
+| `/plexor-provider` | Force specific provider (auto/claude/deepseek/mistral/gemini) |
+| `/plexor-config` | Quick config (enable/disable/cache/reset) |
+| `/plexor-settings` | Advanced settings (API URL, mode, provider) |
+| `/plexor-enabled` | Enable/disable the proxy |
+| `/plexor-logout` | Sign out and clear credentials |
+
+## 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-config.md

@@ -0,0 +1,43 @@
+---
+description: Configure Plexor settings
+---
+
+# Plexor Config
+
+Configure Plexor optimization settings.
+
+## Arguments
+
+$ARGUMENTS - Configuration command and value
+
+## Supported Commands
+
+- `plexor-config show` - Show current configuration
+- `plexor-config enable` - Enable Plexor optimization
+- `plexor-config disable` - Disable Plexor optimization
+- `plexor-config cache on|off` - Enable/disable local cache
+- `plexor-config provider <name>` - Set preferred provider (anthropic, deepseek, auto)
+- `plexor-config reset` - Reset to default configuration
+
+## Instructions
+
+1. Parse the arguments to determine the command
+2. Read current config from ~/.plexor/config.json
+3. Apply the requested change
+4. Save updated config
+5. Display confirmation
+
+## Output
+
+```
+Plexor Configuration Updated
+============================
+
+Local cache: Enabled → Disabled
+
+Current settings:
+├── Optimization: Enabled
+├── Local cache: Disabled
+├── Preferred provider: Auto
+└── Telemetry: Enabled
+```

package/commands/plexor-enabled.md

@@ -0,0 +1,36 @@
+---
+description: Enable or disable Plexor proxy (routes all traffic through Plexor API)
+---
+
+Toggle Plexor proxy mode on or off.
+
+**IMPORTANT**: Use the `AskUserQuestion` tool to present the user with these options:
+
+Question: "Enable Plexor proxy? (routes all prompts through Plexor for optimization)"
+Header: "Proxy"
+Options:
+1. **Enable** - Route all traffic through Plexor API (60-90% cost savings)
+2. **Disable** - Direct to Anthropic (no optimization)
+
+After the user selects an option:
+
+### If Enable:
+1. Update ~/.plexor/config.json: `{"enabled": true}`
+2. Inform user to set environment variable:
+   ```
+   export ANTHROPIC_BASE_URL="http://localhost:8000/gateway/anthropic"
+   ```
+3. Tell user to restart Claude Code: `claude --continue`
+4. Explain benefits:
+   - 60-90% cost reduction via Mistral/DeepSeek/Gemini/OpenAI routing
+   - Automatic provider selection based on mode
+   - Session tracking and savings analytics
+
+### If Disable:
+1. Update ~/.plexor/config.json: `{"enabled": false}`
+2. Inform user to unset environment variable:
+   ```
+   unset ANTHROPIC_BASE_URL
+   ```
+3. Tell user to restart Claude Code: `claude --continue`
+4. Note: Prompts will go directly to Anthropic at full price

package/commands/plexor-login.md

@@ -0,0 +1,87 @@
+---
+description: Authenticate with Plexor to enable optimization
+---
+
+# Plexor Login
+
+Authenticate with your Plexor account to enable LLM cost optimization.
+
+## Instructions
+
+1. Check if already authenticated by reading ~/.plexor/config.json
+2. If already authenticated and valid, show current account info and status
+3. If not authenticated, initiate device flow:
+   a. Call POST https://api.plexor.dev/v1/auth/device-code to get device_code and user_code
+   b. Display the user code and verification URL to the user
+   c. Open https://plexor.dev/auth/device in the user's browser
+   d. Poll POST https://api.plexor.dev/v1/auth/device-token every 5 seconds
+   e. On success, save API key to ~/.plexor/config.json
+   f. Verify the key works by calling GET https://api.plexor.dev/v1/user
+
+4. After successful authentication, configure the gateway:
+   a. Set ANTHROPIC_BASE_URL to route traffic through Plexor gateway
+   b. Inform user they need to restart Claude Code
+
+## Config File
+
+Location: ~/.plexor/config.json
+
+```json
+{
+  "version": 1,
+  "auth": {
+    "api_key": "plx_...",
+    "email": "user@example.com",
+    "tier": "beta",
+    "authenticated_at": "2025-12-16T20:00:00Z"
+  },
+  "settings": {
+    "enabled": true,
+    "preferred_provider": "auto",
+    "mode": "balanced"
+  }
+}
+```
+
+## Output (New User)
+
+```
+Plexor Login
+============
+
+1. Open this URL in your browser:
+   https://plexor.dev/auth/device
+
+2. Enter this code:
+   ABCD-1234
+
+Waiting for authentication... ✓
+
+✓ Authenticated as user@example.com
+✓ Plan: Beta ($1/month)
+✓ Plexor gateway configured
+
+To activate, run this in your terminal:
+
+  export ANTHROPIC_BASE_URL="https://api.plexor.dev/v1/gateway/anthropic"
+
+Then restart Claude Code. All prompts will be optimized automatically.
+
+Run /plexor-status to see your savings.
+```
+
+## Output (Already Authenticated)
+
+```
+Plexor Login
+============
+
+Already authenticated as user@example.com
+Plan: Beta ($1/month)
+Status: Active
+
+Gateway URL: https://api.plexor.dev/v1/gateway/anthropic
+
+Run /plexor-status to see your savings.
+Run /plexor-logout to sign out.
+```

package/commands/plexor-logout.md

@@ -0,0 +1,50 @@
+---
+description: Log out from Plexor and clear credentials
+---
+
+# Plexor Logout
+
+Log out from your Plexor account and clear stored credentials.
+
+## Instructions
+
+1. Read the current configuration from ~/.plexor/config.json
+2. If not authenticated, inform the user they are not logged in
+3. If authenticated:
+   a. Clear the API key from the configuration
+   b. Preserve non-sensitive settings (mode, provider preferences)
+   c. Save the updated configuration
+4. Remind user to restore original Anthropic URL
+5. Display confirmation message
+
+## Output
+
+```
+Plexor Logout
+=============
+
+✓ Successfully logged out
+✓ API key cleared from ~/.plexor/config.json
+
+To restore direct Anthropic access, run:
+
+  unset ANTHROPIC_BASE_URL
+
+Then restart Claude Code.
+
+Note: Your Plexor subscription is still active.
+To manage billing: https://plexor.dev/billing
+
+To use Plexor again, run /plexor-login
+```
+
+## Output (Not Logged In)
+
+```
+Plexor Logout
+=============
+
+You are not currently logged in.
+
+Run /plexor-login to authenticate.
+```

package/commands/plexor-mode.md

@@ -0,0 +1,25 @@
+---
+description: Set Plexor optimization mode (eco/balanced/quality/passthrough)
+---
+
+Set the Plexor optimization mode.
+
+**IMPORTANT**: Use the `AskUserQuestion` tool to present the user with these options:
+
+Question: "Which optimization mode would you like to use?"
+Header: "Mode"
+Options:
+1. **eco** - Maximum cost savings (Ministral 3B $0.04/$0.04 - cheapest)
+2. **balanced** - Cost-first with fallbacks (DeepSeek → Gemini Flash → Mistral → GPT-5-nano → Claude Haiku)
+3. **quality** - Premium models (Claude Opus 4.5 → Gemini Pro → Mistral Large → GPT-5.1)
+4. **passthrough** - No optimization, direct passthrough to requested model
+
+After the user selects an option:
+1. Update ~/.plexor/config.json with the selected mode
+2. Set the X-Plexor-Mode header for future requests
+3. Confirm the change and explain the cost/quality trade-offs
+
+Cost comparison (per 1M tokens input/output):
+- eco: Mistral Ministral 3B $0.04/$0.04 (cheapest)
+- balanced: DeepSeek $0.14/$0.28, Gemini 2.5 Flash $0.15/$0.60, Mistral Small $0.1/$0.3
+- quality: Claude Opus 4.5 $5/$25, Gemini 2.5 Pro $1.25/$10, Mistral Large $2/$6

package/commands/plexor-provider.md

@@ -0,0 +1,25 @@
+---
+description: Force a specific LLM provider (claude/openai/deepseek/mistral/gemini/auto)
+---
+
+Force Plexor to use a specific LLM provider or enable automatic routing.
+
+**IMPORTANT**: Use the `AskUserQuestion` tool to present the user with these options:
+
+Question: "Which provider would you like to use?"
+Header: "Provider"
+Options:
+1. **auto** - Automatic routing (cheapest first: Mistral → DeepSeek → Gemini → OpenAI → Claude)
+2. **mistral** - Force Mistral (Ministral 3B $0.04/$0.04, Small $0.1/$0.3, Large $2/$6)
+3. **deepseek** - Force DeepSeek ($0.14/$0.28 per MTok)
+4. **gemini** - Force Gemini (2.0 Flash $0.10/$0.40, 2.5 Flash $0.15/$0.60, 2.5 Pro $1.25/$10)
+5. **openai** - Force OpenAI (GPT-5-nano $0.05/$0.40, GPT-5.1 $1.25/$10)
+6. **claude** - Force Anthropic (Haiku 4.5 $1/$5, Sonnet 4.5 $3/$15, Opus 4.5 $5/$25)
+
+After the user selects an option:
+1. Update ~/.plexor/config.json with the selected provider
+2. Set the X-Plexor-Force-Provider header for future requests
+3. Confirm the change and explain:
+   - The cost implications of the selected provider
+   - Model that will be used (based on current mode)
+   - When automatic routing might be more beneficial

package/commands/plexor-settings.md

@@ -0,0 +1,93 @@
+---
+description: Configure Plexor settings (API URL, mode, provider preferences)
+---
+
+# Plexor Settings
+
+View and configure Plexor settings. Manages the connection to the Plexor API gateway.
+
+## Usage
+
+- `/plexor-settings` - Show current settings
+- `/plexor-settings api-url <url>` - Set the Plexor API URL
+- `/plexor-settings mode <eco|balanced|quality|passthrough>` - Set optimization mode
+- `/plexor-settings provider <auto|claude|openai|deepseek>` - Set provider preference
+
+## Instructions
+
+1. Read ~/.plexor/config.json
+2. If no arguments, display current settings
+3. If setting a value, update the config file
+4. For api-url changes, remind user to set ANTHROPIC_BASE_URL
+
+## Config File Location
+
+~/.plexor/config.json
+
+## Config Schema
+
+```json
+{
+  "enabled": true,
+  "apiUrl": "http://localhost:8000",
+  "apiKey": "plx_...",
+  "mode": "balanced",
+  "preferredProvider": "auto",
+  "localCacheEnabled": true,
+  "timeout": 5000
+}
+```
+
+## API URL Values
+
+- **Development**: `http://localhost:8000`
+- **Production**: `https://api.plexor.dev` (default)
+
+## Output Examples
+
+### Show settings:
+```
+┌─────────────────────────────────────────────┐
+│  Plexor Settings                            │
+├─────────────────────────────────────────────┤
+│  API URL: http://localhost:8000             │
+│  Mode: balanced                             │
+│  Provider: auto                             │
+│  Local Cache: enabled                       │
+│  Timeout: 5000ms                            │
+├─────────────────────────────────────────────┤
+│  Proxy Status: NOT ACTIVE                   │
+│                                             │
+│  To activate proxy, run:                    │
+│  export ANTHROPIC_BASE_URL="http://localhost:8000/gateway/anthropic"
+│  claude --continue                          │
+└─────────────────────────────────────────────┘
+```
+
+### Set API URL:
+```
+/plexor-settings api-url http://localhost:8000
+```
+
+Output:
+```
+✓ API URL set to: http://localhost:8000
+
+To route all traffic through Plexor, run:
+  export ANTHROPIC_BASE_URL="http://localhost:8000/gateway/anthropic"
+  claude --continue
+```
+
+### Set API URL (production):
+```
+/plexor-settings api-url https://api.plexor.dev
+```
+
+Output:
+```
+✓ API URL set to: https://api.plexor.dev
+
+To route all traffic through Plexor, run:
+  export ANTHROPIC_BASE_URL="https://api.plexor.dev/v1/gateway/anthropic"
+  claude --continue
+```

package/commands/plexor-status.md

@@ -0,0 +1,46 @@
+---
+description: Show Plexor optimization statistics and savings
+---
+
+# Plexor Status
+
+Display current Plexor status, configuration, and usage 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
+
+## Output Format
+
+```
+┌─────────────────────────────────────────────┐
+│  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   │
+└─────────────────────────────────────────────┘
+
+Dashboard: https://plexor.dev/dashboard
+```

package/lib/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Plexor Claude Code Plugin - Constants
+ */
+
+const path = require('path');
+const os = require('os');
+
+module.exports = {
+  // API endpoints
+  PLEXOR_API_URL: process.env.PLEXOR_API_URL || 'https://api.plexor.dev',
+  PLEXOR_GATEWAY_URL: process.env.PLEXOR_GATEWAY_URL || 'https://api.plexor.dev/v1',
+  PLEXOR_AUTH_URL: 'https://plexor.dev/auth/device',
+
+  // File paths
+  PLEXOR_CONFIG_DIR: process.env.PLEXOR_CONFIG_DIR || path.join(os.homedir(), '.plexor'),
+  PLEXOR_CONFIG_FILE: path.join(
+    process.env.PLEXOR_CONFIG_DIR || path.join(os.homedir(), '.plexor'),
+    'config.json'
+  ),
+  CLAUDE_COMMANDS_DIR: path.join(os.homedir(), '.claude', 'commands'),
+
+  // Config schema version
+  CONFIG_VERSION: 1,
+
+  // Default settings
+  DEFAULTS: {
+    enabled: true,
+    preferred_provider: 'auto',
+    telemetry: true,
+    local_cache: false
+  },
+
+  // API key prefix for identification
+  API_KEY_PREFIX: 'plx_',
+
+  // Timeouts (ms)
+  DEVICE_CODE_POLL_INTERVAL: 5000,
+  DEVICE_CODE_TIMEOUT: 900000, // 15 minutes
+  API_TIMEOUT: 30000
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@plexor-dev/claude-code-plugin",
+  "version": "0.1.0-beta.1",
+  "description": "LLM cost optimization plugin for Claude Code - Save up to 90% on AI costs",
+  "main": "lib/constants.js",
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/uninstall.js",
+    "test": "node --test"
+  },
+  "files": [
+    "commands/",
+    "scripts/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "llm",
+    "optimization",
+    "plexor",
+    "cost-savings",
+    "ai",
+    "anthropic"
+  ],
+  "author": "Plexor <hello@plexor.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/plexor-dev/claude-code-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/plexor-dev/claude-code-plugin/issues"
+  },
+  "homepage": "https://plexor.dev",
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+/**
+ * Plexor Claude Code Plugin - Postinstall Script
+ *
+ * Copies slash commands to ~/.claude/commands/ and creates
+ * the ~/.plexor/ configuration directory.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+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');
+
+function main() {
+  try {
+    // Create ~/.claude/commands/ if not exists
+    fs.mkdirSync(CLAUDE_COMMANDS_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)
+      .filter(f => f.endsWith('.md'));
+
+    if (files.length === 0) {
+      console.error('No command files found in package. Installation may be corrupt.');
+      process.exit(1);
+    }
+
+    const installed = [];
+    const backed_up = [];
+
+    for (const file of files) {
+      const src = path.join(COMMANDS_SOURCE, file);
+      const dest = path.join(CLAUDE_COMMANDS_DIR, file);
+
+      // Backup existing file if present and different
+      if (fs.existsSync(dest)) {
+        const existingContent = fs.readFileSync(dest, 'utf8');
+        const newContent = fs.readFileSync(src, 'utf8');
+
+        if (existingContent !== newContent) {
+          const backupPath = dest + '.backup';
+          fs.copyFileSync(dest, backupPath);
+          backed_up.push(file);
+        }
+      }
+
+      fs.copyFileSync(src, dest);
+      installed.push(file.replace('.md', ''));
+    }
+
+    // Print success message
+    console.log('');
+    console.log('  ╔═══════════════════════════════════════════════════════════╗');
+    console.log('  ║                                                           ║');
+    console.log('  ║   Plexor Claude Code Plugin installed successfully!       ║');
+    console.log('  ║                                                           ║');
+    console.log('  ╚═══════════════════════════════════════════════════════════╝');
+    console.log('');
+    console.log('  Commands installed to ~/.claude/commands/:');
+    installed.forEach(cmd => {
+      console.log(`    /${cmd}`);
+    });
+
+    if (backed_up.length > 0) {
+      console.log('');
+      console.log('  Existing files backed up (.backup):');
+      backed_up.forEach(f => console.log(`    ${f}`));
+    }
+
+    console.log('');
+    console.log('  Next steps:');
+    console.log('    1. Open Claude Code');
+    console.log('    2. Run /plexor-login to authenticate');
+    console.log('    3. Start saving on LLM costs!');
+    console.log('');
+    console.log('  Documentation: https://plexor.dev/docs');
+    console.log('');
+
+  } catch (error) {
+    console.error('');
+    console.error('  Plexor plugin installation failed');
+    console.error('');
+    console.error(`  Error: ${error.message}`);
+    console.error('');
+    console.error('  Troubleshooting:');
+    console.error('    - Ensure you have write access to ~/.claude/commands/');
+    console.error('    - Try running with sudo if permission denied');
+    console.error('');
+    console.error('  Report issues: https://github.com/plexor-ai/claude-code-plugin/issues');
+    console.error('');
+    process.exit(1);
+  }
+}
+
+main();

package/scripts/uninstall.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+/**
+ * Plexor Claude Code Plugin - Uninstall Script
+ *
+ * Removes slash commands from ~/.claude/commands/
+ * Optionally restores backups if they exist.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const COMMANDS_SOURCE = path.join(__dirname, '..', 'commands');
+const CLAUDE_COMMANDS_DIR = path.join(os.homedir(), '.claude', 'commands');
+
+function main() {
+  try {
+    // Get list of our command files
+    const files = fs.readdirSync(COMMANDS_SOURCE)
+      .filter(f => f.endsWith('.md'));
+
+    const removed = [];
+    const restored = [];
+
+    for (const file of files) {
+      const dest = path.join(CLAUDE_COMMANDS_DIR, file);
+      const backupPath = dest + '.backup';
+
+      if (fs.existsSync(dest)) {
+        fs.unlinkSync(dest);
+        removed.push(file.replace('.md', ''));
+
+        // Restore backup if it exists
+        if (fs.existsSync(backupPath)) {
+          fs.renameSync(backupPath, dest);
+          restored.push(file);
+        }
+      }
+    }
+
+    if (removed.length > 0) {
+      console.log('');
+      console.log('  Plexor plugin uninstalled');
+      console.log('');
+      console.log('  Removed commands:');
+      removed.forEach(cmd => console.log(`    /${cmd}`));
+
+      if (restored.length > 0) {
+        console.log('');
+        console.log('  Restored from backup:');
+        restored.forEach(f => console.log(`    ${f}`));
+      }
+
+      console.log('');
+      console.log('  Note: ~/.plexor/ config directory was preserved.');
+      console.log('  To remove it: rm -rf ~/.plexor');
+      console.log('');
+    }
+
+  } catch (error) {
+    // Don't fail uninstall on errors - just warn
+    console.warn(`  Warning: Could not fully uninstall: ${error.message}`);
+  }
+}
+
+main();