@plexor-dev/claude-code-plugin 0.1.0-beta.2 → 0.1.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,43 +1,42 @@
1
1
  ---
2
- description: Configure Plexor settings
2
+ description: Configure Plexor settings (user)
3
3
  ---
4
4
 
5
5
  # Plexor Config
6
6
 
7
- Configure Plexor optimization settings.
7
+ View and modify Plexor configuration. This is an alias for /plexor-settings.
8
8
 
9
- ## Arguments
9
+ ## Steps
10
10
 
11
- $ARGUMENTS - Configuration command and value
11
+ **Step 1: Read current configuration**
12
12
 
13
- ## Supported Commands
14
-
15
- - `plexor-config show` - Show current configuration
16
- - `plexor-config enable` - Enable Plexor optimization
17
- - `plexor-config disable` - Disable Plexor optimization
18
- - `plexor-config cache on|off` - Enable/disable local cache
19
- - `plexor-config provider <name>` - Set preferred provider (anthropic, deepseek, auto)
20
- - `plexor-config reset` - Reset to default configuration
21
-
22
- ## Instructions
23
-
24
- 1. Parse the arguments to determine the command
25
- 2. Read current config from ~/.plexor/config.json
26
- 3. Apply the requested change
27
- 4. Save updated config
28
- 5. Display confirmation
29
-
30
- ## Output
13
+ Use the Read tool to read `~/.plexor/config.json`.
31
14
 
15
+ If the file doesn't exist, show:
16
+ ```
17
+ Plexor Config
18
+ =============
19
+ No configuration found. Run /plexor-login to set up Plexor.
32
20
  ```
33
- Plexor Configuration Updated
34
- ============================
35
21
 
36
- Local cache: Enabled Disabled
22
+ **Step 2: Display current configuration**
37
23
 
38
- Current settings:
39
- ├── Optimization: Enabled
40
- ├── Local cache: Disabled
41
- ├── Preferred provider: Auto
42
- └── Telemetry: Enabled
24
+ ```
25
+ Plexor Config
26
+ =============
27
+ Enabled: [enabled]
28
+ API URL: [apiUrl]
29
+ API Key: [show "configured" if apiKey exists, otherwise "not configured"]
30
+ Mode: [mode]
31
+ Provider: [preferredProvider]
32
+ Local Cache: [localCacheEnabled]
33
+ Timeout: [timeout]ms
34
+
35
+ Configuration file: ~/.plexor/config.json
36
+
37
+ Other commands:
38
+ - /plexor-settings - View/edit all settings
39
+ - /plexor-mode - Change optimization mode
40
+ - /plexor-provider - Change provider
41
+ - /plexor-enabled - Enable/disable proxy
43
42
  ```
@@ -1,36 +1,54 @@
1
1
  ---
2
- description: Enable or disable Plexor proxy (routes all traffic through Plexor API)
2
+ description: Enable or disable Plexor proxy (routes all traffic through Plexor API) (user)
3
3
  ---
4
4
 
5
+ # Plexor Enabled
6
+
5
7
  Toggle Plexor proxy mode on or off.
6
8
 
7
- **IMPORTANT**: Use the `AskUserQuestion` tool to present the user with these options:
9
+ ## Steps
10
+
11
+ **Step 1: Read current configuration**
12
+
13
+ Use the Read tool to read `~/.plexor/config.json` and check the current `enabled` status.
14
+
15
+ **Step 2: Ask user what they want to do**
8
16
 
9
- Question: "Enable Plexor proxy? (routes all prompts through Plexor for optimization)"
17
+ Use the `AskUserQuestion` tool to present options:
18
+
19
+ Question: "Enable or disable Plexor proxy?"
10
20
  Header: "Proxy"
11
21
  Options:
12
- 1. **Enable** - Route all traffic through Plexor API (60-90% cost savings)
13
- 2. **Disable** - Direct to Anthropic (no optimization)
14
-
15
- After the user selects an option:
16
-
17
- ### If Enable:
18
- 1. Update ~/.plexor/config.json: `{"enabled": true}`
19
- 2. Inform user to set environment variable:
20
- ```
21
- export ANTHROPIC_BASE_URL="http://localhost:8000/gateway/anthropic"
22
- ```
23
- 3. Tell user to restart Claude Code: `claude --continue`
24
- 4. Explain benefits:
25
- - 60-90% cost reduction via Mistral/DeepSeek/Gemini/OpenAI routing
26
- - Automatic provider selection based on mode
27
- - Session tracking and savings analytics
28
-
29
- ### If Disable:
30
- 1. Update ~/.plexor/config.json: `{"enabled": false}`
31
- 2. Inform user to unset environment variable:
32
- ```
33
- unset ANTHROPIC_BASE_URL
34
- ```
35
- 3. Tell user to restart Claude Code: `claude --continue`
36
- 4. Note: Prompts will go directly to Anthropic at full price
22
+ 1. **Enable** - Route traffic through Plexor for optimization (60-90% cost savings)
23
+ 2. **Disable** - Direct to Anthropic (no optimization, full price)
24
+
25
+ **Step 3: Update the configuration**
26
+
27
+ Use the Read tool to get the current config, then use the Write tool to update `~/.plexor/config.json`:
28
+ - If **Enable**: Set `"enabled": true`
29
+ - If **Disable**: Set `"enabled": false`
30
+
31
+ Keep all other settings unchanged.
32
+
33
+ **Step 4: Show confirmation**
34
+
35
+ If **Enabled**:
36
+ ```
37
+ Plexor Proxy: ENABLED
38
+
39
+ Benefits:
40
+ - 60-90% cost reduction via intelligent provider routing
41
+ - Automatic selection of Mistral/DeepSeek/Gemini based on task
42
+ - Usage tracking and savings analytics
43
+
44
+ Your prompts will now be routed through Plexor for optimization.
45
+ Run /plexor-status to see your savings.
46
+ ```
47
+
48
+ If **Disabled**:
49
+ ```
50
+ Plexor Proxy: DISABLED
51
+
52
+ Your prompts will go directly to Anthropic at full price.
53
+ Run /plexor-enabled to re-enable optimization.
54
+ ```
@@ -1,87 +1,76 @@
1
1
  ---
2
- description: Authenticate with Plexor to enable optimization
2
+ description: Authenticate with Plexor to enable optimization (user)
3
3
  ---
4
4
 
5
5
  # Plexor Login
6
6
 
7
7
  Authenticate with your Plexor account to enable LLM cost optimization.
8
8
 
9
- ## Instructions
9
+ ## Steps
10
10
 
11
- 1. Check if already authenticated by reading ~/.plexor/config.json
12
- 2. If already authenticated and valid, show current account info and status
13
- 3. If not authenticated, initiate device flow:
14
- a. Call POST https://api.plexor.dev/v1/auth/device-code to get device_code and user_code
15
- b. Display the user code and verification URL to the user
16
- c. Open https://plexor.dev/auth/device in the user's browser
17
- d. Poll POST https://api.plexor.dev/v1/auth/device-token every 5 seconds
18
- e. On success, save API key to ~/.plexor/config.json
19
- f. Verify the key works by calling GET https://api.plexor.dev/v1/user
11
+ **Step 1: Check existing authentication**
20
12
 
21
- 4. After successful authentication, configure the gateway:
22
- a. Set ANTHROPIC_BASE_URL to route traffic through Plexor gateway
23
- b. Inform user they need to restart Claude Code
24
-
25
- ## Config File
26
-
27
- Location: ~/.plexor/config.json
28
-
29
- ```json
30
- {
31
- "version": 1,
32
- "auth": {
33
- "api_key": "plx_...",
34
- "email": "user@example.com",
35
- "tier": "beta",
36
- "authenticated_at": "2025-12-16T20:00:00Z"
37
- },
38
- "settings": {
39
- "enabled": true,
40
- "preferred_provider": "auto",
41
- "mode": "balanced"
42
- }
43
- }
44
- ```
45
-
46
- ## Output (New User)
13
+ Use the Read tool to read `~/.plexor/config.json`.
47
14
 
15
+ If the file exists and has an `apiKey` field that starts with "plx_", the user is already authenticated. Show them:
48
16
  ```
49
17
  Plexor Login
50
18
  ============
19
+ Already authenticated!
20
+ API Key: plx_****[last 4 chars]
21
+ API URL: [apiUrl from config]
22
+ Status: [Enabled/Disabled]
51
23
 
52
- 1. Open this URL in your browser:
53
- https://plexor.dev/auth/device
54
-
55
- 2. Enter this code:
56
- ABCD-1234
24
+ Run /plexor-status to see your usage statistics.
25
+ Run /plexor-logout to sign out.
26
+ ```
57
27
 
58
- Waiting for authentication...
28
+ **Step 2: If not authenticated, ask for API key**
59
29
 
60
- Authenticated as user@example.com
61
- Plan: Beta ($1/month)
62
- Plexor gateway configured
30
+ Ask the user to provide their Plexor API key. They can get one from:
31
+ - https://plexor.dev/dashboard (if they have an account)
32
+ - https://plexor.dev/signup (to create an account)
63
33
 
64
- To activate, run this in your terminal:
34
+ Tell them: "Please provide your Plexor API key (starts with 'plx_'):"
65
35
 
66
- export ANTHROPIC_BASE_URL="https://api.plexor.dev/v1/gateway/anthropic"
36
+ **Step 3: Save the configuration**
67
37
 
68
- Then restart Claude Code. All prompts will be optimized automatically.
38
+ Once the user provides an API key, use the Write tool to create/update `~/.plexor/config.json`:
69
39
 
70
- Run /plexor-status to see your savings.
40
+ ```json
41
+ {
42
+ "enabled": true,
43
+ "apiUrl": "https://api.plexor.dev",
44
+ "apiKey": "[user's API key]",
45
+ "mode": "balanced",
46
+ "preferredProvider": "auto",
47
+ "localCacheEnabled": true,
48
+ "timeout": 5000
49
+ }
71
50
  ```
72
51
 
73
- ## Output (Already Authenticated)
52
+ **Step 4: Verify the key works**
74
53
 
54
+ Make a test request to verify authentication:
55
+ ```
56
+ GET https://api.plexor.dev/api/users/me
57
+ Authorization: Bearer [apiKey]
58
+ ```
59
+
60
+ If successful, show:
75
61
  ```
76
62
  Plexor Login
77
63
  ============
64
+ Authentication successful!
78
65
 
79
- Already authenticated as user@example.com
80
- Plan: Beta ($1/month)
81
- Status: Active
66
+ Your API key has been saved to ~/.plexor/config.json
82
67
 
83
- Gateway URL: https://api.plexor.dev/v1/gateway/anthropic
68
+ Next steps:
69
+ 1. Run /plexor-status to see your usage
70
+ 2. Run /plexor-enabled true to enable the proxy
71
+ 3. Start saving on LLM costs!
84
72
 
85
- Run /plexor-status to see your savings.
86
- Run /plexor-logout to sign out.
73
+ Dashboard: https://plexor.dev/dashboard
87
74
  ```
75
+
76
+ If the API call fails, tell the user the key may be invalid and ask them to check it.
@@ -1,50 +1,42 @@
1
1
  ---
2
- description: Log out from Plexor and clear credentials
2
+ description: Log out from Plexor and clear credentials (user)
3
3
  ---
4
4
 
5
5
  # Plexor Logout
6
6
 
7
7
  Log out from your Plexor account and clear stored credentials.
8
8
 
9
- ## Instructions
9
+ ## Steps
10
10
 
11
- 1. Read the current configuration from ~/.plexor/config.json
12
- 2. If not authenticated, inform the user they are not logged in
13
- 3. If authenticated:
14
- a. Clear the API key from the configuration
15
- b. Preserve non-sensitive settings (mode, provider preferences)
16
- c. Save the updated configuration
17
- 4. Remind user to restore original Anthropic URL
18
- 5. Display confirmation message
11
+ **Step 1: Read current configuration**
19
12
 
20
- ## Output
13
+ Use the Read tool to read `~/.plexor/config.json`.
21
14
 
15
+ If the file doesn't exist or has no `apiKey`, show:
22
16
  ```
23
17
  Plexor Logout
24
18
  =============
19
+ You are not currently logged in.
20
+ Run /plexor-login to authenticate.
21
+ ```
25
22
 
26
- Successfully logged out
27
- ✓ API key cleared from ~/.plexor/config.json
28
-
29
- To restore direct Anthropic access, run:
30
-
31
- unset ANTHROPIC_BASE_URL
23
+ **Step 2: Clear the API key**
32
24
 
33
- Then restart Claude Code.
25
+ If authenticated, use the Write tool to update `~/.plexor/config.json`:
26
+ - Remove or clear the `apiKey` field (set to empty string "")
27
+ - Keep all other settings (mode, preferredProvider, etc.)
34
28
 
35
- Note: Your Plexor subscription is still active.
36
- To manage billing: https://plexor.dev/billing
37
-
38
- To use Plexor again, run /plexor-login
39
- ```
40
-
41
- ## Output (Not Logged In)
29
+ **Step 3: Show confirmation**
42
30
 
43
31
  ```
44
32
  Plexor Logout
45
33
  =============
34
+ Successfully logged out!
46
35
 
47
- You are not currently logged in.
36
+ - API key cleared from ~/.plexor/config.json
37
+ - Settings preserved (mode, provider preferences)
48
38
 
49
- Run /plexor-login to authenticate.
39
+ To use Plexor again, run /plexor-login
40
+
41
+ Dashboard: https://plexor.dev/dashboard
50
42
  ```
@@ -1,25 +1,47 @@
1
1
  ---
2
- description: Set Plexor optimization mode (eco/balanced/quality/passthrough)
2
+ description: Set Plexor optimization mode (eco/balanced/quality/passthrough) (user)
3
3
  ---
4
4
 
5
- Set the Plexor optimization mode.
5
+ # Plexor Mode
6
6
 
7
- **IMPORTANT**: Use the `AskUserQuestion` tool to present the user with these options:
7
+ Set the Plexor optimization mode to control cost vs quality trade-offs.
8
+
9
+ ## Steps
10
+
11
+ **Step 1: Read current configuration**
12
+
13
+ Use the Read tool to read `~/.plexor/config.json` and check the current `mode` setting.
14
+
15
+ **Step 2: Ask user which mode they want**
16
+
17
+ Use the `AskUserQuestion` tool:
8
18
 
9
19
  Question: "Which optimization mode would you like to use?"
10
20
  Header: "Mode"
11
21
  Options:
12
- 1. **eco** - Maximum cost savings (Ministral 3B $0.04/$0.04 - cheapest)
13
- 2. **balanced** - Cost-first with fallbacks (DeepSeek Gemini Flash Mistral → GPT-5-nano → Claude Haiku)
14
- 3. **quality** - Premium models (Claude Opus 4.5 → Gemini Pro Mistral Large → GPT-5.1)
15
- 4. **passthrough** - No optimization, direct passthrough to requested model
16
-
17
- After the user selects an option:
18
- 1. Update ~/.plexor/config.json with the selected mode
19
- 2. Set the X-Plexor-Mode header for future requests
20
- 3. Confirm the change and explain the cost/quality trade-offs
21
-
22
- Cost comparison (per 1M tokens input/output):
23
- - eco: Mistral Ministral 3B $0.04/$0.04 (cheapest)
24
- - balanced: DeepSeek $0.14/$0.28, Gemini 2.5 Flash $0.15/$0.60, Mistral Small $0.1/$0.3
25
- - quality: Claude Opus 4.5 $5/$25, Gemini 2.5 Pro $1.25/$10, Mistral Large $2/$6
22
+ 1. **eco** - Maximum savings (~$0.04/1M tokens) - Uses Ministral 3B
23
+ 2. **balanced** - Good balance (~$0.15/1M) - DeepSeek, Gemini Flash, Mistral Small
24
+ 3. **quality** - Premium models (~$5/1M) - Claude Opus, Gemini Pro, Mistral Large
25
+ 4. **passthrough** - No optimization - Direct to requested model
26
+
27
+ **Step 3: Update the configuration**
28
+
29
+ Use the Read tool to get the current config, then use the Write tool to update `~/.plexor/config.json`:
30
+ - Set the `mode` field to the selected value: "eco", "balanced", "quality", or "passthrough"
31
+
32
+ Keep all other settings unchanged.
33
+
34
+ **Step 4: Show confirmation**
35
+
36
+ ```
37
+ Plexor Mode: [SELECTED MODE]
38
+
39
+ Mode Details:
40
+ - eco: Maximum cost savings using Ministral 3B ($0.04/$0.04 per 1M tokens)
41
+ - balanced: Cost-first with quality fallbacks (DeepSeek → Gemini Flash → Mistral)
42
+ - quality: Premium models for complex tasks (Claude Opus, Gemini Pro)
43
+ - passthrough: No optimization, direct to Anthropic
44
+
45
+ Current mode: [mode]
46
+ Run /plexor-status to see your savings.
47
+ ```
@@ -1,25 +1,47 @@
1
1
  ---
2
- description: Force a specific LLM provider (claude/openai/deepseek/mistral/gemini/auto)
2
+ description: Force a specific LLM provider (claude/openai/deepseek/mistral/gemini/auto) (user)
3
3
  ---
4
4
 
5
- Force Plexor to use a specific LLM provider or enable automatic routing.
5
+ # Plexor Provider
6
6
 
7
- **IMPORTANT**: Use the `AskUserQuestion` tool to present the user with these options:
7
+ Set your preferred LLM provider for Plexor routing.
8
8
 
9
- Question: "Which provider would you like to use?"
9
+ ## Steps
10
+
11
+ **Step 1: Read current configuration**
12
+
13
+ Use the Read tool to read `~/.plexor/config.json` and check the current `preferredProvider` setting.
14
+
15
+ **Step 2: Ask user which provider they prefer**
16
+
17
+ Use the `AskUserQuestion` tool:
18
+
19
+ Question: "Which LLM provider would you prefer?"
10
20
  Header: "Provider"
11
21
  Options:
12
- 1. **auto** - Automatic routing (cheapest first: Mistral DeepSeek Gemini → OpenAI → Claude)
13
- 2. **mistral** - Force Mistral (Ministral 3B $0.04/$0.04, Small $0.1/$0.3, Large $2/$6)
14
- 3. **deepseek** - Force DeepSeek ($0.14/$0.28 per MTok)
15
- 4. **gemini** - Force Gemini (2.0 Flash $0.10/$0.40, 2.5 Flash $0.15/$0.60, 2.5 Pro $1.25/$10)
16
- 5. **openai** - Force OpenAI (GPT-5-nano $0.05/$0.40, GPT-5.1 $1.25/$10)
17
- 6. **claude** - Force Anthropic (Haiku 4.5 $1/$5, Sonnet 4.5 $3/$15, Opus 4.5 $5/$25)
18
-
19
- After the user selects an option:
20
- 1. Update ~/.plexor/config.json with the selected provider
21
- 2. Set the X-Plexor-Force-Provider header for future requests
22
- 3. Confirm the change and explain:
23
- - The cost implications of the selected provider
24
- - Model that will be used (based on current mode)
25
- - When automatic routing might be more beneficial
22
+ 1. **auto** - Let Plexor choose the best provider based on task (Recommended)
23
+ 2. **deepseek** - Use DeepSeek models (cheapest, good for code)
24
+ 3. **mistral** - Use Mistral models (fast, good balance)
25
+ 4. **gemini** - Use Google Gemini models (good for analysis)
26
+
27
+ **Step 3: Update the configuration**
28
+
29
+ Use the Read tool to get the current config, then use the Write tool to update `~/.plexor/config.json`:
30
+ - Set `preferredProvider` to: "auto", "deepseek", "mistral", or "gemini"
31
+
32
+ Keep all other settings unchanged.
33
+
34
+ **Step 4: Show confirmation**
35
+
36
+ ```
37
+ Plexor Provider: [SELECTED PROVIDER]
38
+
39
+ Provider options:
40
+ - auto: Plexor automatically selects the best provider for each task
41
+ - deepseek: DeepSeek models ($0.14/$0.28 per 1M tokens) - Great for code
42
+ - mistral: Mistral models ($0.10/$0.30 per 1M tokens) - Fast and versatile
43
+ - gemini: Google Gemini ($0.075/$0.30 per 1M tokens) - Good for analysis
44
+
45
+ Current provider: [preferredProvider]
46
+ Run /plexor-status to see your usage.
47
+ ```
@@ -1,93 +1,58 @@
1
1
  ---
2
- description: Configure Plexor settings (API URL, mode, provider preferences)
2
+ description: Configure Plexor settings (API URL, mode, provider preferences) (user)
3
3
  ---
4
4
 
5
5
  # Plexor Settings
6
6
 
7
- View and configure Plexor settings. Manages the connection to the Plexor API gateway.
7
+ View and configure all Plexor settings.
8
8
 
9
- ## Usage
9
+ ## Steps
10
10
 
11
- - `/plexor-settings` - Show current settings
12
- - `/plexor-settings api-url <url>` - Set the Plexor API URL
13
- - `/plexor-settings mode <eco|balanced|quality|passthrough>` - Set optimization mode
14
- - `/plexor-settings provider <auto|claude|openai|deepseek>` - Set provider preference
11
+ **Step 1: Read current configuration**
15
12
 
16
- ## Instructions
13
+ Use the Read tool to read `~/.plexor/config.json`.
17
14
 
18
- 1. Read ~/.plexor/config.json
19
- 2. If no arguments, display current settings
20
- 3. If setting a value, update the config file
21
- 4. For api-url changes, remind user to set ANTHROPIC_BASE_URL
22
-
23
- ## Config File Location
24
-
25
- ~/.plexor/config.json
26
-
27
- ## Config Schema
28
-
29
- ```json
30
- {
31
- "enabled": true,
32
- "apiUrl": "http://localhost:8000",
33
- "apiKey": "plx_...",
34
- "mode": "balanced",
35
- "preferredProvider": "auto",
36
- "localCacheEnabled": true,
37
- "timeout": 5000
38
- }
15
+ If the file doesn't exist, show:
16
+ ```
17
+ Plexor Settings
18
+ ===============
19
+ No configuration found. Run /plexor-login to set up Plexor.
39
20
  ```
40
21
 
41
- ## API URL Values
42
-
43
- - **Development**: `http://localhost:8000`
44
- - **Production**: `https://api.plexor.dev` (default)
22
+ **Step 2: Display current settings**
45
23
 
46
- ## Output Examples
24
+ Show the current configuration:
47
25
 
48
- ### Show settings:
49
- ```
50
- ┌─────────────────────────────────────────────┐
51
- │ Plexor Settings │
52
- ├─────────────────────────────────────────────┤
53
- │ API URL: http://localhost:8000 │
54
- │ Mode: balanced │
55
- │ Provider: auto │
56
- │ Local Cache: enabled │
57
- │ Timeout: 5000ms │
58
- ├─────────────────────────────────────────────┤
59
- │ Proxy Status: NOT ACTIVE │
60
- │ │
61
- │ To activate proxy, run: │
62
- │ export ANTHROPIC_BASE_URL="http://localhost:8000/gateway/anthropic"
63
- │ claude --continue │
64
- └─────────────────────────────────────────────┘
65
26
  ```
27
+ Plexor Settings
28
+ ===============
29
+ Enabled: [enabled - true/false]
30
+ API URL: [apiUrl]
31
+ API Key: plx_****[last 4 chars] (configured/not configured)
32
+ Mode: [mode]
33
+ Provider: [preferredProvider]
34
+ Local Cache: [localCacheEnabled - enabled/disabled]
35
+ Timeout: [timeout]ms
66
36
 
67
- ### Set API URL:
68
- ```
69
- /plexor-settings api-url http://localhost:8000
70
- ```
37
+ Quick Commands:
38
+ - /plexor-enabled - Toggle proxy on/off
39
+ - /plexor-mode - Change optimization mode
40
+ - /plexor-provider - Change provider preference
41
+ - /plexor-status - View usage statistics
71
42
 
72
- Output:
43
+ Dashboard: https://plexor.dev/dashboard
73
44
  ```
74
- ✓ API URL set to: http://localhost:8000
75
45
 
76
- To route all traffic through Plexor, run:
77
- export ANTHROPIC_BASE_URL="http://localhost:8000/gateway/anthropic"
78
- claude --continue
79
- ```
46
+ **Step 3: If user wants to change a setting**
80
47
 
81
- ### Set API URL (production):
82
- ```
83
- /plexor-settings api-url https://api.plexor.dev
84
- ```
48
+ If the user specifies they want to change something, use the `AskUserQuestion` tool:
85
49
 
86
- Output:
87
- ```
88
- ✓ API URL set to: https://api.plexor.dev
50
+ Question: "Which setting would you like to change?"
51
+ Header: "Setting"
52
+ Options:
53
+ 1. **API URL** - Change the Plexor API endpoint
54
+ 2. **Mode** - Change optimization mode (eco/balanced/quality)
55
+ 3. **Provider** - Change preferred provider
56
+ 4. **Timeout** - Change request timeout
89
57
 
90
- To route all traffic through Plexor, run:
91
- export ANTHROPIC_BASE_URL="https://api.plexor.dev/v1/gateway/anthropic"
92
- claude --continue
93
- ```
58
+ Then update `~/.plexor/config.json` with the new value using the Write tool.
@@ -1,46 +1,61 @@
1
1
  ---
2
- description: Show Plexor optimization statistics and savings
2
+ description: Show Plexor optimization statistics and savings (user)
3
3
  ---
4
4
 
5
5
  # Plexor Status
6
6
 
7
- Display current Plexor status, configuration, and usage statistics.
7
+ Show current Plexor proxy status, configuration, and usage statistics.
8
8
 
9
- ## Instructions
9
+ ## Steps
10
10
 
11
- 1. Read the Plexor configuration from ~/.plexor/config.json
12
- 2. If not authenticated, show a message to run /plexor-login
13
- 3. If authenticated, call the Plexor API to get usage stats
14
- 4. Display a formatted summary including:
15
- - Account status (Free/Pro/Team)
16
- - This session: requests optimized, tokens saved, estimated savings
17
- - This week: total requests, total tokens saved, total savings
18
- - Current settings: optimization enabled, local cache status
11
+ **Step 1: Read the configuration file**
19
12
 
20
- ## Output Format
13
+ Use the Read tool to read the file `~/.plexor/config.json`. If the file doesn't exist, tell the user to run `/plexor-login` first.
21
14
 
15
+ **Step 2: Parse configuration and check authentication**
16
+
17
+ The config file contains:
18
+ - `enabled`: boolean - whether Plexor proxy is enabled
19
+ - `apiUrl`: string - the API URL (e.g., "https://api.plexor.dev")
20
+ - `apiKey`: string - the user's API key (starts with "plx_")
21
+ - `mode`: string - optimization mode ("eco", "balanced", "quality", "passthrough")
22
+ - `preferredProvider`: string - provider preference ("auto", "claude", "openai", etc.)
23
+ - `localCacheEnabled`: boolean - whether local caching is enabled
24
+
25
+ If `apiKey` is missing or empty, tell the user to run `/plexor-login` first.
26
+
27
+ **Step 3: Call the stats API**
28
+
29
+ Make a request to get usage statistics:
22
30
  ```
23
- ┌─────────────────────────────────────────────┐
24
- │ Plexor Status │
25
- ├─────────────────────────────────────────────┤
26
- │ Account: Pro ($19/mo) │
27
- │ Status: Active │
28
- ├─────────────────────────────────────────────┤
29
- │ This Session │
30
- │ ├── Requests: 47 │
31
- │ ├── Tokens saved: 12,847 (31%) │
32
- │ └── Est. savings: $0.42 │
33
- ├─────────────────────────────────────────────┤
34
- │ This Week │
35
- │ ├── Requests: 1,247 │
36
- │ ├── Tokens saved: 482,938 (34%) │
37
- │ └── Est. savings: $14.23 │
38
- ├─────────────────────────────────────────────┤
39
- │ Settings │
40
- ├── Optimization: Enabled │
41
- ├── Local cache: Enabled │
42
- └── Provider routing: DeepSeek preferred │
43
- └─────────────────────────────────────────────┘
31
+ GET {apiUrl}/api/users/me/usage
32
+ Authorization: Bearer {apiKey}
33
+ ```
34
+
35
+ Note: The apiKey IS the bearer token - use it directly in the Authorization header.
36
+
37
+ **Step 4: Display the status**
38
+
39
+ Show the user a formatted status display like this:
40
+
41
+ ```
42
+ Plexor Status
43
+ =============
44
+ Account: [tier from API response, e.g., "Pro" or "Free"]
45
+ Status: [Enabled/Disabled based on config.enabled]
46
+
47
+ This Session
48
+ Requests: [totalRequests from API]
49
+ Tokens saved: [tokensUsed from API]
50
+ Est. savings: $[costSavings from API]
51
+
52
+ Settings
53
+ Mode: [config.mode]
54
+ Provider: [config.preferredProvider]
55
+ Local cache: [Enabled/Disabled based on config.localCacheEnabled]
56
+ API URL: [config.apiUrl]
44
57
 
45
58
  Dashboard: https://plexor.dev/dashboard
46
59
  ```
60
+
61
+ If the API call fails, show the configuration status and mention the API is unavailable.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plexor-dev/claude-code-plugin",
3
- "version": "0.1.0-beta.2",
3
+ "version": "0.1.0-beta.3",
4
4
  "description": "LLM cost optimization plugin for Claude Code - Save up to 90% on AI costs",
5
5
  "main": "lib/constants.js",
6
6
  "scripts": {