ccenv-cli 1.0.0 → 1.0.2

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.
Files changed (2) hide show
  1. package/README.md +29 -17
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # Claude Env (ccx)
1
+ # Claude Env (ccx or ccenv-cli)
2
2
 
3
3
  **Environment Orchestrator and Context Switcher for Claude Code CLI**
4
4
 
@@ -33,49 +33,56 @@ ccx create work --template openrouter --api-key sk-or-xxxxx
33
33
  ccx setup
34
34
  ```
35
35
 
36
- ### 2. Activate the profile
36
+ ### 2. Run Claude with your profile
37
37
 
38
+ **Easiest way (recommended):**
39
+ ```bash
40
+ ccx run work
41
+ ```
42
+
43
+ This launches Claude Code directly with the profile's environment - no shell tricks needed!
44
+
45
+ **Alternative: Activate in current shell**
38
46
  ```bash
39
47
  # Bash/Zsh
40
48
  eval "$(ccx use work)"
41
49
 
42
50
  # PowerShell
43
- Invoke-Expression (ccx use work --shell powershell)
51
+ iex (ccx use work --shell powershell)
44
52
 
45
53
  # Fish
46
54
  ccx use work --shell fish | source
47
- ```
48
-
49
- ### 3. Run Claude Code
50
55
 
51
- ```bash
56
+ # Then run claude normally
52
57
  claude
53
58
  ```
54
59
 
55
- That's it! Claude Code will now route through OpenRouter.
56
-
57
- ### 4. Switch back to official Anthropic
60
+ ### 3. Switch back to official Anthropic
58
61
 
59
62
  ```bash
60
- eval "$(ccx use official)"
61
- # or
62
- eval "$(ccx reset)"
63
+ # Run with default settings
64
+ ccx run
65
+
66
+ # Or reset your shell environment
67
+ eval "$(ccx reset)" # bash/zsh
68
+ iex (ccx reset --shell powershell) # PowerShell
63
69
  ```
64
70
 
65
71
  ## Commands
66
72
 
67
73
  | Command | Description |
68
74
  |---------|-------------|
75
+ | `ccx run [profile]` | **Launch Claude with a profile directly** |
76
+ | `ccx setup` | Interactive profile setup wizard |
77
+ | `ccx create <name>` | Create a new profile |
69
78
  | `ccx list` | List all profiles |
70
79
  | `ccx show <name>` | Show profile details |
71
- | `ccx create <name>` | Create a new profile |
72
80
  | `ccx edit <name>` | Edit an existing profile |
73
81
  | `ccx delete <name>` | Delete a profile |
74
82
  | `ccx use <name>` | Activate a profile (outputs shell script) |
75
83
  | `ccx reset` | Reset environment to default |
76
84
  | `ccx current` | Show current profile status |
77
85
  | `ccx templates` | List available provider templates |
78
- | `ccx setup` | Interactive profile setup wizard |
79
86
  | `ccx export <name>` | Export profile as JSON |
80
87
  | `ccx import <json>` | Import profile from JSON |
81
88
 
@@ -177,9 +184,9 @@ Set-Alias cc-switch Switch-Claude
177
184
 
178
185
  ## Troubleshooting
179
186
 
180
- ### "Profile not taking effect"
187
+ ### "Profile not taking effect" (when using `ccx use`)
181
188
 
182
- Make sure you're using `eval`:
189
+ Make sure you're using `eval` or `iex`:
183
190
  ```bash
184
191
  # Wrong
185
192
  ccx use work
@@ -188,6 +195,11 @@ ccx use work
188
195
  eval "$(ccx use work)"
189
196
  ```
190
197
 
198
+ **Or just use `ccx run` instead** - it handles everything for you:
199
+ ```bash
200
+ ccx run work
201
+ ```
202
+
191
203
  ### "Shell not detected correctly"
192
204
 
193
205
  Specify the shell explicitly:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ccenv-cli",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "Switch Claude Code backends instantly. Like nvm, but for AI providers. Zero server required.",
5
5
  "main": "dist/cli.js",
6
6
  "bin": {