@plexor-dev/claude-code-plugin 0.1.0-beta.21 → 0.1.0-beta.23

package/commands/plexor-config.md

@@ -4,41 +4,25 @@ description: Configure Plexor settings (user)
 
 # Plexor Config
 
-View and modify Plexor configuration. This is an alias for /plexor-settings.
+Run this command to view configuration details:
 
-## Steps
-
-**Step 1: Read current configuration**
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-config.js
+```
 
-Use the Read tool to read `~/.plexor/config.json`.
+Options:
 
-If the file doesn't exist, show:
-```
-Plexor Config
-=============
-No configuration found. Run /plexor-login to set up Plexor.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-config.js --raw    # Show raw JSON
+node ~/.claude/plugins/plexor/commands/plexor-config.js --paths  # Show file paths
 ```
 
-**Step 2: Display current configuration**
+Use the Bash tool to execute this command.
 
-```
-Plexor Config
-=============
-Enabled: [enabled]
-API URL: [apiUrl]
-API Key: [show "configured" if apiKey exists, otherwise "not configured"]
-Mode: [mode]
-Provider: [preferredProvider]
-Local Cache: [localCacheEnabled]
-Timeout: [timeout]ms
-
-Configuration file: ~/.plexor/config.json
-
-Other commands:
-- /plexor-settings - View/edit all settings
-- /plexor-mode - Change optimization mode
-- /plexor-provider - Change provider
-- /plexor-enabled - Enable/disable proxy
-```
+**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
 
-**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/commands/plexor-enabled.md

@@ -4,53 +4,25 @@ description: Enable or disable Plexor proxy (routes all traffic through Plexor A
 
 # Plexor Enabled
 
-Toggle Plexor proxy mode on or off.
+Run this command to view or toggle the Plexor proxy:
 
-## Steps
-
-**Step 1: Read current configuration**
-
-Use the Read tool to read `~/.plexor/config.json` and check the current `enabled` status.
-
-**Step 2: Ask user what they want to do**
-
-Use the `AskUserQuestion` tool to present options:
-
-Question: "Enable or disable Plexor proxy?"
-Header: "Proxy"
-Options:
-1. **Enable** - Route traffic through Plexor for optimization (60-90% cost savings)
-2. **Disable** - Direct to Anthropic (no optimization, full price)
-
-**Step 3: Update the configuration**
-
-Use the Read tool to get the current config, then use the Write tool to update `~/.plexor/config.json`:
-- If **Enable**: Set `"enabled": true`
-- If **Disable**: Set `"enabled": false`
-
-Keep all other settings unchanged.
-
-**Step 4: Show confirmation**
-
-If **Enabled**:
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-enabled.js
 ```
-Plexor Proxy: ENABLED
 
-Benefits:
-- 60-90% cost reduction via intelligent provider routing
-- Automatic selection of Mistral/DeepSeek/Gemini based on task
-- Usage tracking and savings analytics
+To enable or disable, pass an argument:
 
-Your prompts will now be routed through Plexor for optimization.
-Run /plexor-status to see your savings.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-enabled.js true
+node ~/.claude/plugins/plexor/commands/plexor-enabled.js false
 ```
 
-If **Disabled**:
-```
-Plexor Proxy: DISABLED
+Use the Bash tool to execute this command.
 
-Your prompts will go directly to Anthropic at full price.
-Run /plexor-enabled to re-enable optimization.
-```
+**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
 
-**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/commands/plexor-login.md

@@ -4,83 +4,24 @@ description: Authenticate with Plexor to enable optimization (user)
 
 # Plexor Login
 
-Authenticate with your Plexor account to enable LLM cost optimization.
+Run this command to authenticate with Plexor:
 
-## Steps
-
-**Step 1: Check existing authentication**
-
-Use the Read tool to read `~/.plexor/config.json`.
-
-If the file exists and has `auth.api_key` that starts with "plx_", the user is already authenticated. Show them:
-```
-Plexor Login
-============
-Already authenticated!
-API Key: plx_****[last 4 chars]
-API URL: [apiUrl from config]
-Status: [Enabled/Disabled]
-
-Run /plexor-status to see your usage statistics.
-Run /plexor-logout to sign out.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-login.js
 ```
 
-**Step 2: If not authenticated, ask for API key**
+To login with an API key:
 
-Ask the user to provide their Plexor API key. They can get one from:
-- https://plexor.dev/dashboard (if they have an account)
-- https://plexor.dev/signup (to create an account)
-
-Tell them: "Please provide your Plexor API key (starts with 'plx_'):"
-
-**Step 3: Save the configuration**
-
-Once the user provides an API key (or it was passed as an argument), use the Write tool to create/update `~/.plexor/config.json`:
-
-```json
-{
-  "version": 1,
-  "auth": {
-    "api_key": "[user's API key]",
-    "authenticated_at": "[current ISO timestamp]"
-  },
-  "settings": {
-    "enabled": true,
-    "apiUrl": "https://api.plexor.dev",
-    "preferred_provider": "auto",
-    "mode": "balanced",
-    "localCacheEnabled": true,
-    "timeout": 5000
-  }
-}
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-login.js plx_your_api_key_here
 ```
 
-**IMPORTANT**: If the user provided the API key as an argument (e.g., `/plexor-login plx_abc123`), use that key directly instead of asking for it.
-
-**Step 4: Verify the key works**
-
-Make a test request to verify authentication:
-```
-GET https://api.plexor.dev/api/users/me
-Authorization: Bearer [apiKey]
-```
-
-If successful, show:
-```
-Plexor Login
-============
-Authentication successful!
-
-Your API key has been saved to ~/.plexor/config.json
-
-Next steps:
-1. Run /plexor-status to see your usage
-2. Run /plexor-enabled true to enable the proxy
-3. Start saving on LLM costs!
-
-Dashboard: https://plexor.dev/dashboard
-```
+Use the Bash tool to execute this command.
 
-If the API call fails, tell the user the key may be invalid and ask them to check it.
+**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
 
-**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/commands/plexor-logout.md

@@ -4,41 +4,24 @@ description: Log out from Plexor and clear credentials (user)
 
 # Plexor Logout
 
-Log out from your Plexor account and clear stored credentials.
+Run this command to log out and clear credentials:
 
-## Steps
-
-**Step 1: Read current configuration**
-
-Use the Read tool to read `~/.plexor/config.json`.
-
-If the file doesn't exist or has no `apiKey`, show:
-```
-Plexor Logout
-=============
-You are not currently logged in.
-Run /plexor-login to authenticate.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-logout.js
 ```
 
-**Step 2: Clear the API key**
-
-If authenticated, use the Write tool to update `~/.plexor/config.json`:
-- Remove or clear the `apiKey` field (set to empty string "")
-- Keep all other settings (mode, preferredProvider, etc.)
-
-**Step 3: Show confirmation**
+To also clear the cache:
 
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-logout.js --clear-cache
 ```
-Plexor Logout
-=============
-Successfully logged out!
 
-- API key cleared from ~/.plexor/config.json
-- Settings preserved (mode, provider preferences)
+Use the Bash tool to execute this command.
 
-To use Plexor again, run /plexor-login
-
-Dashboard: https://plexor.dev/dashboard
-```
+**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
 
-**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/commands/plexor-mode.md

@@ -4,46 +4,24 @@ description: Set Plexor optimization mode (eco/balanced/quality/passthrough) (us
 
 # Plexor Mode
 
-Set the Plexor optimization mode to control cost vs quality trade-offs.
+Run this command to view or set the optimization mode:
 
-## Steps
-
-**Step 1: Read current configuration**
-
-Use the Read tool to read `~/.plexor/config.json` and check the current `mode` setting.
-
-**Step 2: Ask user which mode they want**
-
-Use the `AskUserQuestion` tool:
-
-Question: "Which optimization mode would you like to use?"
-Header: "Mode"
-Options:
-1. **eco** - Maximum savings (~$0.04/1M tokens) - Uses Ministral 3B
-2. **balanced** - Good balance (~$0.15/1M) - DeepSeek, Gemini Flash, Mistral Small
-3. **quality** - Premium models (~$5/1M) - Claude Opus, Gemini Pro, Mistral Large
-4. **passthrough** - No optimization - Direct to requested model
-
-**Step 3: Update the configuration**
-
-Use the Read tool to get the current config, then use the Write tool to update `~/.plexor/config.json`:
-- Set the `mode` field to the selected value: "eco", "balanced", "quality", or "passthrough"
-
-Keep all other settings unchanged.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-mode.js
+```
 
-**Step 4: Show confirmation**
+To set a specific mode, pass it as an argument:
 
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-mode.js balanced
 ```
-Plexor Mode: [SELECTED MODE]
 
-Mode Details:
-- eco: Maximum cost savings using Ministral 3B ($0.04/$0.04 per 1M tokens)
-- balanced: Cost-first with quality fallbacks (DeepSeek → Gemini Flash → Mistral)
-- quality: Premium models for complex tasks (Claude Opus, Gemini Pro)
-- passthrough: No optimization, direct to Anthropic
+Use the Bash tool to execute this command.
 
-Current mode: [mode]
-Run /plexor-status to see your savings.
-```
+**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
 
-**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/commands/plexor-provider.md

@@ -4,46 +4,24 @@ description: Force a specific LLM provider (claude/openai/deepseek/mistral/gemin
 
 # Plexor Provider
 
-Set your preferred LLM provider for Plexor routing.
+Run this command to view or set the preferred provider:
 
-## Steps
-
-**Step 1: Read current configuration**
-
-Use the Read tool to read `~/.plexor/config.json` and check the current `preferredProvider` setting.
-
-**Step 2: Ask user which provider they prefer**
-
-Use the `AskUserQuestion` tool:
-
-Question: "Which LLM provider would you prefer?"
-Header: "Provider"
-Options:
-1. **auto** - Let Plexor choose the best provider based on task (Recommended)
-2. **deepseek** - Use DeepSeek models (cheapest, good for code)
-3. **mistral** - Use Mistral models (fast, good balance)
-4. **gemini** - Use Google Gemini models (good for analysis)
-
-**Step 3: Update the configuration**
-
-Use the Read tool to get the current config, then use the Write tool to update `~/.plexor/config.json`:
-- Set `preferredProvider` to: "auto", "deepseek", "mistral", or "gemini"
-
-Keep all other settings unchanged.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-provider.js
+```
 
-**Step 4: Show confirmation**
+To set a specific provider:
 
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-provider.js deepseek
 ```
-Plexor Provider: [SELECTED PROVIDER]
 
-Provider options:
-- auto: Plexor automatically selects the best provider for each task
-- deepseek: DeepSeek models ($0.14/$0.28 per 1M tokens) - Great for code
-- mistral: Mistral models ($0.10/$0.30 per 1M tokens) - Fast and versatile
-- gemini: Google Gemini ($0.075/$0.30 per 1M tokens) - Good for analysis
+Use the Bash tool to execute this command.
 
-Current provider: [preferredProvider]
-Run /plexor-status to see your usage.
-```
+**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
 
-**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/commands/plexor-settings.md

@@ -4,57 +4,25 @@ description: Configure Plexor settings (API URL, mode, provider preferences) (us
 
 # Plexor Settings
 
-View and configure all Plexor settings.
+Run this command to view or update settings:
 
-## Steps
-
-**Step 1: Read current configuration**
-
-Use the Read tool to read `~/.plexor/config.json`.
-
-If the file doesn't exist, show:
-```
-Plexor Settings
-===============
-No configuration found. Run /plexor-login to set up Plexor.
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-settings.js
 ```
 
-**Step 2: Display current settings**
+To update a setting:
 
-Show the current configuration:
-
-```
-Plexor Settings
-===============
-Enabled: [enabled - true/false]
-API URL: [apiUrl]
-API Key: plx_****[last 4 chars] (configured/not configured)
-Mode: [mode]
-Provider: [preferredProvider]
-Local Cache: [localCacheEnabled - enabled/disabled]
-Timeout: [timeout]ms
-
-Quick Commands:
-- /plexor-enabled - Toggle proxy on/off
-- /plexor-mode - Change optimization mode
-- /plexor-provider - Change provider preference
-- /plexor-status - View usage statistics
-
-Dashboard: https://plexor.dev/dashboard
+```bash
+node ~/.claude/plugins/plexor/commands/plexor-settings.js cache true
+node ~/.claude/plugins/plexor/commands/plexor-settings.js timeout 10000
 ```
 
-**Step 3: If user wants to change a setting**
-
-If the user specifies they want to change something, use the `AskUserQuestion` tool:
-
-Question: "Which setting would you like to change?"
-Header: "Setting"
-Options:
-1. **API URL** - Change the Plexor API endpoint
-2. **Mode** - Change optimization mode (eco/balanced/quality)
-3. **Provider** - Change preferred provider
-4. **Timeout** - Change request timeout
+Use the Bash tool to execute this command.
 
-Then update `~/.plexor/config.json` with the new value using the Write tool.
+**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
 
-**IMPORTANT**: After completing the task, STOP. Do not run additional commands or explore the codebase.
+The command output is the complete response. Simply show the output and wait for the user's next input.

package/lib/plexor-client.js

@@ -31,7 +31,7 @@ class PlexorClient {
           'Content-Type': 'application/json',
           'X-API-Key': this.apiKey,
           'X-Plexor-Key': this.apiKey,
-          'User-Agent': 'plexor-claude-code-plugin/0.1.0-beta.21'
+          'User-Agent': 'plexor-claude-code-plugin/0.1.0-beta.22'
         },
         timeout: this.timeout
       };

package/package.json

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

package/scripts/postinstall.js

@@ -35,6 +35,22 @@ const COMMANDS_SOURCE = path.join(__dirname, '..', 'commands');
 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');
+const PLEXOR_CONFIG_FILE = path.join(PLEXOR_CONFIG_DIR, 'config.json');
+
+// Default configuration for new installs
+const DEFAULT_CONFIG = {
+  version: 1,
+  auth: {
+    mode: "pending",
+    authenticated_at: null
+  },
+  settings: {
+    enabled: true,
+    apiUrl: "https://api.plexor.dev",
+    mode: "balanced",
+    localCacheEnabled: true
+  }
+};
 
 function main() {
   try {
@@ -47,6 +63,17 @@ function main() {
     // Create ~/.plexor/ with secure permissions (owner only)
     fs.mkdirSync(PLEXOR_CONFIG_DIR, { recursive: true, mode: 0o700 });
 
+    // Create default config.json if it doesn't exist
+    let configCreated = false;
+    if (!fs.existsSync(PLEXOR_CONFIG_FILE)) {
+      fs.writeFileSync(
+        PLEXOR_CONFIG_FILE,
+        JSON.stringify(DEFAULT_CONFIG, null, 2),
+        { mode: 0o600 }
+      );
+      configCreated = true;
+    }
+
     // Get list of command files (.md for Claude, .js for executors)
     const mdFiles = fs.readdirSync(COMMANDS_SOURCE)
       .filter(f => f.endsWith('.md'));
@@ -93,42 +120,64 @@ function main() {
       jsInstalled.push(file);
     }
 
-    // Print success message
+    // Detect shell type
+    const shell = process.env.SHELL || '';
+    const isZsh = shell.includes('zsh');
+    const shellRc = isZsh ? '~/.zshrc' : '~/.bashrc';
+
+    // Print success message with clear onboarding steps
     console.log('');
-    console.log('  ╔═══════════════════════════════════════════════════════════╗');
-    console.log('  ║                                                           ║');
-    console.log('  ║   Plexor Claude Code Plugin installed successfully!       ║');
-    console.log('  ║                                                           ║');
-    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}`));
+    if (configCreated) {
+      console.log('  ✓ Created ~/.plexor/config.json');
     }
-
+    console.log(`  ✓ Installed ${installed.length} slash commands to ~/.claude/commands/`);
     if (jsInstalled.length > 0) {
-      console.log('');
-      console.log('  Executors installed to ~/.claude/plugins/plexor/commands/:');
-      jsInstalled.forEach(f => console.log(`    ${f}`));
+      console.log(`  ✓ Installed ${jsInstalled.length} executors to ~/.claude/plugins/plexor/`);
     }
+    console.log('');
 
+    // CRITICAL: Make the required step VERY obvious
+    console.log('  ┌─────────────────────────────────────────────────────────────────┐');
+    console.log('  │  REQUIRED: Run this command to enable Plexor routing:          │');
+    console.log('  └─────────────────────────────────────────────────────────────────┘');
     console.log('');
-    console.log('  Next steps:');
-    console.log('    1. Open Claude Code');
-    console.log('    2. Run /plexor-setup to configure (handles MAX + API key users)');
-    console.log('    3. Start saving on LLM costs!');
+    console.log('  For Claude MAX users (OAuth):');
     console.log('');
-    console.log('  Have Claude MAX? Just set: export ANTHROPIC_BASE_URL="https://api.plexor.dev/gateway/anthropic"');
+    console.log(`    echo 'export ANTHROPIC_BASE_URL="https://api.plexor.dev/gateway/anthropic"' >> ${shellRc}`);
+    console.log(`    source ${shellRc}`);
+    console.log('');
+    console.log('  For API key users (get key at https://plexor.dev/dashboard):');
+    console.log('');
+    console.log(`    echo 'export ANTHROPIC_BASE_URL="https://api.plexor.dev/gateway/anthropic"' >> ${shellRc}`);
+    console.log(`    echo 'export ANTHROPIC_API_KEY="plx_your_key_here"' >> ${shellRc}`);
+    console.log(`    source ${shellRc}`);
+    console.log('');
+    console.log('  ┌─────────────────────────────────────────────────────────────────┐');
+    console.log('  │  Then start Claude Code and run: /plexor-status                │');
+    console.log('  └─────────────────────────────────────────────────────────────────┘');
+    console.log('');
+    console.log('  Available commands:');
+    console.log('    /plexor-status   - Check connection and see savings');
+    console.log('    /plexor-mode     - Switch modes (eco/balanced/quality)');
+    console.log('    /plexor-login    - Authenticate with API key');
+    console.log('    /plexor-settings - View/modify settings');
     console.log('');
     console.log('  Documentation: https://plexor.dev/docs');
     console.log('');
 
+    if (backed_up.length > 0) {
+      console.log('  Note: Existing files backed up (.backup):');
+      backed_up.forEach(f => console.log(`    ${f}`));
+      console.log('');
+    }
+
   } catch (error) {
     console.error('');
     console.error('  Plexor plugin installation failed');