iclavue 13.9.4 → 13.9.6
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 +34 -34
- package/dist/clavue.js +1 -1
- package/dist/cli.js +113 -113
- package/dist/native/clavue-pager +0 -0
- package/dist/native/clavue-pager-darwin-arm64 +0 -0
- package/dist/native/clavue-pager-darwin-x64 +0 -0
- package/dist/native/clavue-pager-linux-x64 +0 -0
- package/dist/native/manifest.json +17 -17
- package/dist/openai-responses-adapter.js +3 -3
- package/dist/provider-setup.js +1 -1
- package/docs/clavue-pager-interaction-contract.md +7 -0
- package/docs/protocol/clavue-ui-v1.md +1 -0
- package/install.sh +18 -17
- package/package.json +2 -5
- package/repair.sh +6 -6
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
# Clavue v13.9.
|
|
1
|
+
# Clavue v13.9.6
|
|
2
2
|
|
|
3
3
|

|
|
4
4
|
|
|
5
|
-
`
|
|
5
|
+
`iclavue` (`code`) is an execution-first AI coding CLI for real software work. It keeps the terminal as the control surface, uses direct repo tools for inspection/editing/verification, treats API providers as configurable routes, and includes native workflows for review, recovery, team inspection, and long-running sessions.
|
|
6
6
|
|
|
7
7
|
> **npm package name:** install from **`iclavue`** on the public registry (`npm install -g iclavue`).
|
|
8
|
-
> **Launch commands
|
|
9
|
-
> The older unscoped
|
|
8
|
+
> **Launch commands:** **`iclavue`** · **`code`**.
|
|
9
|
+
> Global `clavue` is reserved for **clavue-v1** — this package does not install it. The older unscoped npm name `clavue` remains under a security hold and must not be used.
|
|
10
10
|
|
|
11
11
|
|
|
12
12
|
## Install / upgrade (recommended)
|
|
@@ -15,7 +15,7 @@ The npm registry is the source of truth for the latest version (`npm view iclavu
|
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
17
|
npm install -g iclavue@latest && hash -r
|
|
18
|
-
|
|
18
|
+
iclavue --version # 13.9.6 (Clavue)
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
One-liner without a global install, or the install script (also npm-backed):
|
|
@@ -28,11 +28,11 @@ curl -fsSL https://unpkg.com/iclavue/install.sh | bash
|
|
|
28
28
|
Pin a version:
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
|
-
npm install -g iclavue@13.9.
|
|
32
|
-
curl -fsSL https://unpkg.com/iclavue@13.9.
|
|
31
|
+
npm install -g iclavue@13.9.6
|
|
32
|
+
curl -fsSL https://unpkg.com/iclavue@13.9.6/install.sh | bash -s -- 13.9.6
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
Inside a running session `/update` (or `
|
|
35
|
+
Inside a running session `/update` (or `iclavue update`) checks `npm view iclavue@latest` and reinstalls. From 13.9.6 the package only installs `iclavue` and `code` — global `clavue` is reserved for clavue-v1. If `iclavue --version` still prints an old number after an upgrade, run `iclavue --version --detail`; `npm install -g iclavue@latest` re-links it, `repair.sh` cleans a half-finished install.
|
|
36
36
|
|
|
37
37
|
> The website mirror (`https://www.clavue.com/cli/install.sh`, `/downloads/clavue/VERSION`) is maintained separately by the site operator and may lag behind npm; when it does, use the npm / unpkg paths above.
|
|
38
38
|
|
|
@@ -100,16 +100,17 @@ npx -y iclavue
|
|
|
100
100
|
Run a specific version with `npx`:
|
|
101
101
|
|
|
102
102
|
```bash
|
|
103
|
-
npx -y iclavue@13.9.
|
|
104
|
-
npx -y iclavue@13.9.
|
|
103
|
+
npx -y iclavue@13.9.6 --version
|
|
104
|
+
npx -y iclavue@13.9.6
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
Install globally from npm when you want the `
|
|
107
|
+
Install globally from npm when you want the `iclavue` / `code` commands to stay available:
|
|
108
108
|
|
|
109
109
|
```bash
|
|
110
110
|
npm install -g iclavue
|
|
111
|
-
|
|
112
|
-
|
|
111
|
+
iclavue --version
|
|
112
|
+
code --version
|
|
113
|
+
iclavue
|
|
113
114
|
```
|
|
114
115
|
|
|
115
116
|
One-line global install:
|
|
@@ -121,10 +122,10 @@ curl -fsSL https://unpkg.com/iclavue/install.sh | bash
|
|
|
121
122
|
Install a specific version globally:
|
|
122
123
|
|
|
123
124
|
```bash
|
|
124
|
-
curl -fsSL https://unpkg.com/iclavue@13.9.
|
|
125
|
+
curl -fsSL https://unpkg.com/iclavue@13.9.6/install.sh | bash -s -- 13.9.6
|
|
125
126
|
```
|
|
126
127
|
|
|
127
|
-
### Troubleshooting: `ENOTEMPTY` / `bash:
|
|
128
|
+
### Troubleshooting: `ENOTEMPTY` / `bash: iclavue: No such file or directory`
|
|
128
129
|
|
|
129
130
|
`npm install -g iclavue` can fail with:
|
|
130
131
|
|
|
@@ -138,7 +139,7 @@ This is a generic npm bug that strikes large global packages (iclavue is
|
|
|
138
139
|
~74 MB unpacked / 4251 files) when an earlier install was interrupted.
|
|
139
140
|
npm's atomic-rename leaves behind a `.iclavue-<rand>` staging directory
|
|
140
141
|
that blocks every future install at the same path. The bin symlink also
|
|
141
|
-
goes missing, so `
|
|
142
|
+
goes missing, so `iclavue` exits with `No such file or directory`.
|
|
142
143
|
|
|
143
144
|
One-liner fix:
|
|
144
145
|
|
|
@@ -147,7 +148,7 @@ curl -fsSL https://unpkg.com/iclavue/repair.sh | bash
|
|
|
147
148
|
```
|
|
148
149
|
|
|
149
150
|
The repair script removes live package dirs, staging leftovers, dangling
|
|
150
|
-
`bin/
|
|
151
|
+
`bin/iclavue` / `bin/code` (and legacy `clavue`/`agent`/`ai`/`chat`) dangling symlinks, then reinstalls `iclavue@latest`.
|
|
151
152
|
Set `CLAVUE_NO_INSTALL=1` to clean only.
|
|
152
153
|
|
|
153
154
|
Manual fallback if the script is unreachable:
|
|
@@ -158,8 +159,8 @@ sudo rm -rf "$PREFIX/lib/node_modules/iclavue" \
|
|
|
158
159
|
"$PREFIX/lib/node_modules/.iclavue-"* \
|
|
159
160
|
"$PREFIX/lib/node_modules/clavue" \
|
|
160
161
|
"$PREFIX/lib/node_modules/.clavue-"* \
|
|
161
|
-
"$PREFIX/bin/
|
|
162
|
-
"$PREFIX/bin/
|
|
162
|
+
"$PREFIX/bin/iclavue" \
|
|
163
|
+
"$PREFIX/bin/code"
|
|
163
164
|
npm install -g iclavue@latest
|
|
164
165
|
```
|
|
165
166
|
|
|
@@ -168,13 +169,13 @@ npm install -g iclavue@latest
|
|
|
168
169
|
Fastest path for custom API users:
|
|
169
170
|
|
|
170
171
|
1. Install with `curl -fsSL https://unpkg.com/iclavue/install.sh | bash`
|
|
171
|
-
2. Start with `
|
|
172
|
+
2. Start with `iclavue` (or `code`)
|
|
172
173
|
3. At `请选择 API 配置模式`, choose `自定义 API 配置`.
|
|
173
174
|
4. At `请选择模型路由模式`, choose the family that matches your models.
|
|
174
175
|
5. At `请选择操作`, choose `1. 添加配置`.
|
|
175
176
|
6. Enter a profile name, API base URL, authentication type (`API Key` or `Auth Token`), credential, and model slots.
|
|
176
177
|
7. After saving, choose `no` at `返回主菜单?` to enter Clavue with the saved default profile.
|
|
177
|
-
8. Run `/provider` inside Clavue, or `
|
|
178
|
+
8. Run `/provider` inside Clavue, or `iclavue provider` from the shell, to reopen the provider manager.
|
|
178
179
|
9. Run `/model` only for main-session model selection. In combination mode it follows the current `/provider` Primary slot; helper and planning slots remain owned by `/provider`.
|
|
179
180
|
|
|
180
181
|
Recommended model-slot setup:
|
|
@@ -247,7 +248,7 @@ You can also run `/permissions` and choose `Autonomous development` from the mod
|
|
|
247
248
|
|
|
248
249
|
This package is intended for users who want an execution-first coding CLI with direct repository tools, native workflow orchestration, explicit permission control, and configurable provider routing when compatible providers or gateways are part of the setup.
|
|
249
250
|
|
|
250
|
-
On macOS, `
|
|
251
|
+
On macOS, `iclavue` 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 iclavue`.
|
|
251
252
|
|
|
252
253
|
## Long-Running Session Memory
|
|
253
254
|
|
|
@@ -256,36 +257,35 @@ Clavue automatically restarts normal long-running sessions with `--max-old-space
|
|
|
256
257
|
Useful controls:
|
|
257
258
|
|
|
258
259
|
```bash
|
|
259
|
-
CLAVUE_MAX_OLD_SPACE_SIZE_MB=12288
|
|
260
|
-
CLAVUE_DISABLE_HEAP_REEXEC=1
|
|
261
|
-
NODE_OPTIONS="--max-old-space-size=12288"
|
|
260
|
+
CLAVUE_MAX_OLD_SPACE_SIZE_MB=12288 iclavue
|
|
261
|
+
CLAVUE_DISABLE_HEAP_REEXEC=1 iclavue
|
|
262
|
+
NODE_OPTIONS="--max-old-space-size=12288" iclavue
|
|
262
263
|
```
|
|
263
264
|
|
|
264
|
-
`
|
|
265
|
+
`iclavue --version` stays on the zero-load fast path and does not restart.
|
|
265
266
|
|
|
266
267
|
## CLI Entry Points
|
|
267
268
|
|
|
268
269
|
Version check:
|
|
269
270
|
|
|
270
271
|
```bash
|
|
271
|
-
|
|
272
|
+
iclavue --version
|
|
273
|
+
code --version
|
|
272
274
|
npx -y iclavue --version
|
|
273
|
-
npx -y iclavue@13.9.
|
|
274
|
-
# available after a global install and launcher setup
|
|
275
|
-
clavue --version
|
|
275
|
+
npx -y iclavue@13.9.6 --version
|
|
276
276
|
```
|
|
277
277
|
|
|
278
278
|
Provider/config entry point:
|
|
279
279
|
|
|
280
280
|
```bash
|
|
281
|
-
|
|
281
|
+
iclavue provider
|
|
282
282
|
```
|
|
283
283
|
|
|
284
284
|
Anthropic account login/token commands:
|
|
285
285
|
|
|
286
286
|
```bash
|
|
287
|
-
|
|
288
|
-
|
|
287
|
+
iclavue auth login
|
|
288
|
+
iclavue setup-token
|
|
289
289
|
```
|
|
290
290
|
|
|
291
291
|
`clavue auth login` and `clavue setup-token` are only for Anthropic account auth flows. They are not the provider-profile entrypoint.
|
|
@@ -354,7 +354,7 @@ Typing `agent teams` at the start of a prompt opens the same native `/team` flow
|
|
|
354
354
|
## Package And Release Model
|
|
355
355
|
|
|
356
356
|
- Source repo: `https://github.com/mycode699/clavue`
|
|
357
|
-
- Public package: `https://www.npmjs.com/package/iclavue` (CLI
|
|
357
|
+
- Public package: `https://www.npmjs.com/package/iclavue` (CLI: `iclavue` / `code`; `clavue` reserved for clavue-v1)
|
|
358
358
|
- Public install entrypoint: `npx -y iclavue`
|
|
359
359
|
- `src/` is the development surface for new changes, while the checked-in `dist/` bundle is the current shipped runtime artifact
|
|
360
360
|
- `types/generated/` holds generated contract types that stay outside authored runtime source
|
package/dist/clavue.js
CHANGED
|
@@ -16,7 +16,7 @@ const __isVersion =
|
|
|
16
16
|
__clavueArgs[0] === '-v' ||
|
|
17
17
|
__clavueArgs[0] === '-V');
|
|
18
18
|
if (__isVersion) {
|
|
19
|
-
console.log("13.9.
|
|
19
|
+
console.log("13.9.6 (Clavue)");
|
|
20
20
|
const __detail =
|
|
21
21
|
__clavueArgs.includes('--detail') ||
|
|
22
22
|
__clavueArgs.includes('--path') ||
|