envcc 0.1.0 → 0.1.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 +69 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,2 +1,70 @@
1
1
  # envcc
2
- env setup for claude code
2
+
3
+ A terminal UI for configuring [Claude Code](https://claude.ai/code) environment variables.
4
+
5
+ Browse, search, and toggle all available Claude Code env vars from a single TUI. Settings are saved to `.claude/settings.json` so they're picked up automatically when you run Claude Code.
6
+
7
+ ![envcc screenshot](screenshot.png)
8
+
9
+ ## Install
10
+
11
+ **npm / npx** (no install needed):
12
+ ```sh
13
+ npx envcc
14
+ ```
15
+
16
+ **Cargo**:
17
+ ```sh
18
+ cargo install envcc
19
+ ```
20
+
21
+ **From source**:
22
+ ```sh
23
+ git clone https://github.com/niewinny/envcc.git
24
+ cd envcc
25
+ cargo install --path .
26
+ ```
27
+
28
+ ## Usage
29
+
30
+ Run `envcc` in any project directory:
31
+
32
+ ```sh
33
+ envcc
34
+ ```
35
+
36
+ - Type to search/filter variables
37
+ - **Up/Down** arrows to navigate the list
38
+ - **Space/Enter** to toggle booleans or edit string/integer values
39
+ - **Del** to clear a value
40
+ - **Left/Right** arrows to scroll the description
41
+ - **F2** to save and quit
42
+ - **Esc** to quit (prompts to save if there are changes)
43
+ - **Backspace** to clear search
44
+
45
+ Settings are saved to `.claude/settings.json` under the `env` key. Run `envcc` again to modify existing settings - everything is preserved.
46
+
47
+ ## How it works
48
+
49
+ 1. Fetches the latest environment variables from the [official Claude Code docs](https://code.claude.com/docs/en/env-vars)
50
+ 2. Caches them locally at `~/.cache/envcc/vars.json` for offline use
51
+ 3. On next run, checks if the docs have changed and updates the cache
52
+ 4. Reads existing `.claude/settings.json` if present
53
+ 5. Lets you browse and configure env vars through the TUI
54
+ 6. Saves only the `env` key - all other settings (permissions, hooks, etc.) are preserved
55
+
56
+ ## Example output
57
+
58
+ ```json
59
+ {
60
+ "env": {
61
+ "CLAUDE_CODE_DISABLE_THINKING": "1",
62
+ "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
63
+ "ANTHROPIC_MODEL": "claude-sonnet-4-6-20250514"
64
+ }
65
+ }
66
+ ```
67
+
68
+ ## License
69
+
70
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "envcc",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "TUI for configuring Claude Code environment variables",
5
5
  "license": "MIT",
6
6
  "repository": {