@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.
- package/commands/plexor-config.md +29 -30
- package/commands/plexor-enabled.md +46 -28
- package/commands/plexor-login.md +46 -57
- package/commands/plexor-logout.md +19 -27
- package/commands/plexor-mode.md +39 -17
- package/commands/plexor-provider.md +40 -18
- package/commands/plexor-settings.md +37 -72
- package/commands/plexor-status.md +48 -33
- package/package.json +1 -1
|
@@ -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
|
-
|
|
7
|
+
View and modify Plexor configuration. This is an alias for /plexor-settings.
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## Steps
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
**Step 1: Read current configuration**
|
|
12
12
|
|
|
13
|
-
|
|
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
|
-
|
|
22
|
+
**Step 2: Display current configuration**
|
|
37
23
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
13
|
-
2. **Disable** - Direct to Anthropic (no optimization)
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
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
|
+
```
|
package/commands/plexor-login.md
CHANGED
|
@@ -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
|
-
##
|
|
9
|
+
## Steps
|
|
10
10
|
|
|
11
|
-
1
|
|
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
|
-
|
|
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
|
-
|
|
53
|
-
|
|
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
|
-
|
|
28
|
+
**Step 2: If not authenticated, ask for API key**
|
|
59
29
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
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
|
-
|
|
34
|
+
Tell them: "Please provide your Plexor API key (starts with 'plx_'):"
|
|
65
35
|
|
|
66
|
-
|
|
36
|
+
**Step 3: Save the configuration**
|
|
67
37
|
|
|
68
|
-
|
|
38
|
+
Once the user provides an API key, use the Write tool to create/update `~/.plexor/config.json`:
|
|
69
39
|
|
|
70
|
-
|
|
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
|
-
|
|
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
|
-
|
|
80
|
-
Plan: Beta ($1/month)
|
|
81
|
-
Status: Active
|
|
66
|
+
Your API key has been saved to ~/.plexor/config.json
|
|
82
67
|
|
|
83
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
9
|
+
## Steps
|
|
10
10
|
|
|
11
|
-
1
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
36
|
+
- API key cleared from ~/.plexor/config.json
|
|
37
|
+
- Settings preserved (mode, provider preferences)
|
|
48
38
|
|
|
49
|
-
|
|
39
|
+
To use Plexor again, run /plexor-login
|
|
40
|
+
|
|
41
|
+
Dashboard: https://plexor.dev/dashboard
|
|
50
42
|
```
|
package/commands/plexor-mode.md
CHANGED
|
@@ -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
|
-
|
|
5
|
+
# Plexor Mode
|
|
6
6
|
|
|
7
|
-
|
|
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
|
|
13
|
-
2. **balanced** -
|
|
14
|
-
3. **quality** - Premium models (Claude Opus
|
|
15
|
-
4. **passthrough** - No optimization
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
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
|
-
|
|
5
|
+
# Plexor Provider
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Set your preferred LLM provider for Plexor routing.
|
|
8
8
|
|
|
9
|
-
|
|
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** -
|
|
13
|
-
2. **
|
|
14
|
-
3. **
|
|
15
|
-
4. **gemini** -
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
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.
|
|
7
|
+
View and configure all Plexor settings.
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## Steps
|
|
10
10
|
|
|
11
|
-
|
|
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
|
-
|
|
13
|
+
Use the Read tool to read `~/.plexor/config.json`.
|
|
17
14
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
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
|
-
|
|
42
|
-
|
|
43
|
-
- **Development**: `http://localhost:8000`
|
|
44
|
-
- **Production**: `https://api.plexor.dev` (default)
|
|
22
|
+
**Step 2: Display current settings**
|
|
45
23
|
|
|
46
|
-
|
|
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
|
-
|
|
68
|
-
|
|
69
|
-
/plexor-
|
|
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
|
-
|
|
43
|
+
Dashboard: https://plexor.dev/dashboard
|
|
73
44
|
```
|
|
74
|
-
✓ API URL set to: http://localhost:8000
|
|
75
45
|
|
|
76
|
-
|
|
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
|
-
|
|
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
|
-
|
|
87
|
-
|
|
88
|
-
|
|
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
|
-
|
|
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
|
-
|
|
7
|
+
Show current Plexor proxy status, configuration, and usage statistics.
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## Steps
|
|
10
10
|
|
|
11
|
-
1
|
|
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
|
-
|
|
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
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
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