clavue 8.8.80 → 8.8.82

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/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # Clavue v8.8.80
1
+ # Clavue v8.8.82
2
2
 
3
3
  ![Clavue cover](https://unpkg.com/clavue/image.png)
4
4
 
@@ -37,6 +37,8 @@ Clavue is built around a simple operating model: the user owns the workflow, the
37
37
 
38
38
  For full user-facing usage and learning documentation, start in [study/README.md](./study/README.md).
39
39
 
40
+ For provider and model routing setup, see [Clavue Provider And Model Best Practices](./docs/clavue-provider-model-best-practices.md).
41
+
40
42
  ## Install
41
43
 
42
44
  Requirements:
@@ -83,7 +85,7 @@ curl -fsSL https://unpkg.com/clavue/install.sh | bash
83
85
  Install a specific version:
84
86
 
85
87
  ```bash
86
- curl -fsSL https://unpkg.com/clavue@8.8.80/install.sh | bash -s -- 8.8.80
88
+ curl -fsSL https://unpkg.com/clavue@8.8.82/install.sh | bash -s -- 8.8.82
87
89
  ```
88
90
 
89
91
  ## Quick Start: Custom API
@@ -140,6 +142,20 @@ This package is intended for users who want an execution-first coding CLI with e
140
142
 
141
143
  On macOS, `clavue` avoids Keychain by default and stores local credentials in `~/.clavue/.credentials.json` so startup does not trigger system Keychain prompts. If you explicitly want the old Keychain behavior back, launch with `CLAVUE_USE_KEYCHAIN=1 clavue`.
142
144
 
145
+ ## Long-Running Session Memory
146
+
147
+ Clavue automatically restarts normal long-running sessions with `--max-old-space-size=8192` before loading the full CLI. This prevents the common Node default ~4GB heap limit from killing large coding sessions with `Reached heap limit Allocation failed - JavaScript heap out of memory`.
148
+
149
+ Useful controls:
150
+
151
+ ```bash
152
+ CLAVUE_MAX_OLD_SPACE_SIZE_MB=12288 clavue
153
+ CLAVUE_DISABLE_HEAP_REEXEC=1 clavue
154
+ NODE_OPTIONS="--max-old-space-size=12288" clavue
155
+ ```
156
+
157
+ `clavue --version` stays on the zero-load fast path and does not restart.
158
+
143
159
  ## CLI Entry Points
144
160
 
145
161
  Version check: