@datalabrotterdam/nova-ai-cli 1.2.0-alpha.1 → 1.2.0-alpha.11
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/CHANGELOG.md +172 -0
- package/README.md +76 -32
- package/dist/browser-setup-7SWHUQEL.js +57 -0
- package/dist/chunk-FMHWW3E6.js +11 -0
- package/dist/{chunk-ZKRZIF3S.js → chunk-KDAUUQBE.js} +49 -360
- package/dist/chunk-L77KQRGZ.js +170 -0
- package/dist/{headless-ZYUSTZDL.js → headless-BQXK7TNC.js} +29 -46
- package/dist/index.js +57 -19
- package/dist/{tui-XOKXPXN2.js → tui-TJFV6NC6.js} +719 -335
- package/dist/update-check-G3PYCRWM.js +23 -0
- package/package.json +25 -39
- package/dist/acp-ZYOQ6PON.js +0 -65
- package/dist/chunk-GZZ7PY3S.js +0 -8878
- package/dist/chunk-JAEXUFAS.js +0 -451
- package/dist/chunk-Q7WL3DXP.js +0 -19
- package/dist/index.d.ts +0 -1
- package/dist/login-6U7QS7EA.js +0 -118
- package/dist/webui-L4GGMXJ3.js +0 -9
- package/src/acp/web/dist/assets/index-CSccI7lJ.css +0 -1
- package/src/acp/web/dist/assets/index-DlCz3fmq.js +0 -1
- package/src/acp/web/dist/favicon.svg +0 -46
- package/src/acp/web/dist/index.html +0 -32
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.11](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.10...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.11) (2026-10-24)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Features
|
|
5
|
+
|
|
6
|
+
* **agent:** skills and MCP prompts as slash commands ([95bb049](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/95bb04932c9edc12f964832b3e5274b3100387d1))
|
|
7
|
+
|
|
8
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.10](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.9...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.10) (2026-10-24)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Bug Fixes
|
|
12
|
+
|
|
13
|
+
* **cli:** commit the vendored browser host build ([f54c98f](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/f54c98f2ef6319c243ab048842603490cab2e7ed))
|
|
14
|
+
* **cli:** update the vendored browser host ([0a9800a](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/0a9800a2e207c42873f0de18138d55f522a10624))
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
### Features
|
|
18
|
+
|
|
19
|
+
* **agent:** bundled skills are read-only and can only be switched off ([16f480c](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/16f480cb9d8f0da03f718d0c102dfb6485e5f47d))
|
|
20
|
+
* **cli:** depend on @datalabrotterdam/nova-ai-browser-host ([6214053](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/62140534c2f40d1f33d4d20ca81edae604a5d550))
|
|
21
|
+
* **cli:** set up the Nova AI browser integration at start-up ([4c9c049](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/4c9c049ecf8a9019b8d5de3082f841d173e1610e))
|
|
22
|
+
|
|
23
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.9](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.8...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.9) (2026-10-24)
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
### Features
|
|
27
|
+
|
|
28
|
+
* **agent:** autopilot mode, and autopilot in agent files ([c9d47ee](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/c9d47ee97f9f5e648592159678c24a71bdda4b5c))
|
|
29
|
+
|
|
30
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.8](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.7...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.8) (2026-10-24)
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
### Features
|
|
34
|
+
|
|
35
|
+
* slash commands from markdown files ([305f111](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/305f1112c6f8312ab8a0683954c4e5bc88d7b952))
|
|
36
|
+
|
|
37
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.7](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.6...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.7) (2026-10-24)
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
### Features
|
|
41
|
+
|
|
42
|
+
* **agent:** Claude Code compatible hooks ([227fe8b](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/227fe8b273ec2e211e9d57674e76af5c42a473bd))
|
|
43
|
+
* **agent:** install the shared Nova skills ([64139dd](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/64139dd612933343f04f165de1a9ab78832d6864))
|
|
44
|
+
* **agent:** mark and protect bundled skills ([6ef52eb](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/6ef52eb6d048f8a3b4e75686244aabcfd0f62d6e))
|
|
45
|
+
* **agent:** thinking effort for reasoning models ([8551fea](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/8551feacff3e1675f369030e20fb2b5071f0db7f))
|
|
46
|
+
* **agent:** web_search tool ([12985eb](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/12985eb9ca06d6c814d4e0162465c651889d9370))
|
|
47
|
+
* **cli:** /effort slider for thinking models ([8ca67f2](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/8ca67f2f5dcc8f6bff8c36409a2baba5d43c4a02))
|
|
48
|
+
* **cli:** remember the thinking level ([883196c](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/883196c9fdb089f4f26ac82b557cc87dfc0b1c0b))
|
|
49
|
+
* OAuth sign-in for MCP servers ([ba57c79](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/ba57c79642f902ab2bc20f59e4627fb2b774bb4a))
|
|
50
|
+
* the user's agent files as session modes ([3386de8](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/3386de88d07b0351bd1e44960fcacfef26e3d45b))
|
|
51
|
+
|
|
52
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.6](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.5...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.6) (2026-10-23)
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
### Bug Fixes
|
|
56
|
+
|
|
57
|
+
* **cli:** start the session before the first prompt ([0c26456](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/0c26456b8126e3b42a6de2e38212213ae5380e62))
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
### Features
|
|
61
|
+
|
|
62
|
+
* **agent:** set workspace trust over ACP ([cec4a89](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/cec4a8949a4232f46448219e4d5363289651215d))
|
|
63
|
+
|
|
64
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.5](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.4...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.5) (2026-10-23)
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
### Bug Fixes
|
|
68
|
+
|
|
69
|
+
* **cli:** keep the full-screen frame one row short of the terminal ([37355f4](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/37355f4efb8a237f204c061ad7008faf54a0dd9e))
|
|
70
|
+
* **cli:** pick the account's default model when none is set ([fb0f34c](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/fb0f34c7bac26f1b59c4b6b2245e6fb8365f99f1))
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
### Features
|
|
74
|
+
|
|
75
|
+
* **cli:** full-screen TUI with a pinned prompt and mouse-wheel scrolling ([a68d693](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/a68d6930945bd6440de22c709fc14ae32a9c9f65))
|
|
76
|
+
|
|
77
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.4](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.3...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.4) (2026-10-05)
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
### Bug Fixes
|
|
81
|
+
|
|
82
|
+
* **cli:** depend on the agent version the CLI was released with ([4931439](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/4931439d106063b81e24367d6aa9c3f285f4ad15))
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
### Features
|
|
86
|
+
|
|
87
|
+
* **cli:** offer npm updates at start-up, remind until installed, /update ([18defca](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/18defcaea988698f9d0909419bb2aa1fdedfa5a9))
|
|
88
|
+
|
|
89
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.3](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.2...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.3) (2026-10-04)
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
### Bug Fixes
|
|
93
|
+
|
|
94
|
+
* **agent:** never overwrite an unreadable settings file when switching a skill ([ca989ef](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/ca989ef1810fc903cea069cdadf3041fe164e364))
|
|
95
|
+
* **cli:** install the command as nova-ai only ([eda8064](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/eda806411af1738ff6f6b1404d23d4e84a74ced8))
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
### Features
|
|
99
|
+
|
|
100
|
+
* **agent,cli:** Nova skill folders, switching skills off, a budgeted skill list ([0891c79](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/0891c79248d3a645d638f12f46928a54652b0941))
|
|
101
|
+
* **cli:** update notice from npm for every channel, cached daily ([c3a0014](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/c3a001473336aac14d216cdeec0bedde4df34427))
|
|
102
|
+
|
|
103
|
+
# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.2](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.1...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.2) (2026-10-03)
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
### Features
|
|
107
|
+
|
|
108
|
+
* release the agent separately as @datalabrotterdam/nova-ai-agent ([32ecfc0](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/32ecfc0faa99bd5bb80cb2eaf2363abc050978f0))
|
|
109
|
+
|
|
110
|
+
# [1.2.0-alpha.1](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/v1.1.0...v1.2.0-alpha.1) (2026-10-03)
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
### Bug Fixes
|
|
114
|
+
|
|
115
|
+
* **acp:** bounded, cancellable client terminals in the workspace ([81f7099](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/81f70996d9dfc8d78e12282def1582ea859f2784))
|
|
116
|
+
* **acp:** isolate background prompt jobs from live session history ([8328a8b](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/8328a8bfa1f22871ef36ec38247987e6effcd044))
|
|
117
|
+
* **acp:** replay loaded sessions faithfully; page session/list ([d576171](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/d5761710890f7b2f5d1b340cdce7faafcd2e3561))
|
|
118
|
+
* **env:** no shells or Docker probes when a session starts ([dc3a449](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/dc3a4495f394c1a16e48e282efd76b765af09999))
|
|
119
|
+
* **mcp:** connect servers in parallel with timeouts and diagnostics ([db4c62c](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/db4c62cd9c8ec0f197ea1ae1ce76adcf9d397ed5))
|
|
120
|
+
* **models:** offer and default to chat models only ([5d3ade2](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/5d3ade2727110ca7555bfdfa5b174c9e75b151f9))
|
|
121
|
+
* **security:** harden sessions, setup auth, credentials, processes and file access ([7f02a1d](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/7f02a1d203128555c4d00e5ab4dc4786329b6225))
|
|
122
|
+
* **tui:** keep printed lines inside the terminal width ([dd5cd0a](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/dd5cd0a40592af392eca797399ce56c0e672110e))
|
|
123
|
+
* **tui:** redraw cleanly after the terminal width changes ([f0b2ec6](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/f0b2ec6d01b0bd8ebcf087330c8bfd82072aa08d))
|
|
124
|
+
|
|
125
|
+
|
|
126
|
+
### Features
|
|
127
|
+
|
|
128
|
+
* **acp:** agentInfo and env_var authentication in initialize ([b736e11](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/b736e115542b8fef083f9fc75514586327d3ac49))
|
|
129
|
+
* **acp:** namespace Nova extensions under _nova/ ([bf56cb9](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/bf56cb9e093dc90fc43b44008f1ddd86446a8cd0))
|
|
130
|
+
* **acp:** serialized turns, cancel, shutdown and proper error codes ([6688470](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/66884701af129ff2c1e9ad78b9e572d7ec64cc4b))
|
|
131
|
+
* **acp:** the agent owns permissions; clients only answer its questions ([7db651d](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/7db651d8d4883da2c170a831aeaa2952dc4444ac))
|
|
132
|
+
* **acp:** usage, session info, commands and model options as updates ([21d0816](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/21d08160c558ca9431deff8f8ead25e89a93d21c))
|
|
133
|
+
* added alpha stage on TUI ([3415411](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/3415411986ef4aefc2aa94dbb66fc73710fb6a5d))
|
|
134
|
+
* **cli:** proper entry point, -p/--print, login/logout, help and version ([73c8f94](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/73c8f9472099fa7c3cedccdd3c6a315d809e6a00))
|
|
135
|
+
* **core:** allow multiple tool calls per round ([f6a2171](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/f6a217145efac0722fddc49995808a7ad7bb2508))
|
|
136
|
+
* **core:** compact proactively at 80% of the model context window ([96afcbb](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/96afcbb7b68f4686a9b769bb80a73b00eebfe4a4))
|
|
137
|
+
* **core:** native tool calling with learned per-model text fallback ([6d71193](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/6d7119395b39a45026d676813ad3596382e2611a))
|
|
138
|
+
* **core:** share the ~/.nova-ai project layout with the VS Code extension ([aa75dde](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/aa75dde65218fdbd16b9f329bd849cc9ec608a28))
|
|
139
|
+
* **core:** validate tool args centrally before dispatch ([0a88e3e](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/0a88e3efb0d7c32611979e408b95e659873ec1e5))
|
|
140
|
+
* expand ACP runtime and terminal workflows ([bfbae15](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/bfbae157c301fbc1b7e88f5e267d25c8da126008))
|
|
141
|
+
* **mcp:** surface tool schemas, respect readOnlyHint, hint cwd args ([2b22be3](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/2b22be327b052788936e4badb010844f7ca3d057))
|
|
142
|
+
* **memory:** shared MEMORY.md index + typed notes, compatible with VS Code ([474c916](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/474c91694f4da58400426f39c290ac6888f4aa19))
|
|
143
|
+
* **modes:** plan mode can read, ask and keep the task list ([e253eaa](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/e253eaa66fd02478d61f34e734a27883068bf357))
|
|
144
|
+
* **policy:** agent-side permission policy with trust-gated rule sources ([234cd3a](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/234cd3adf06423c973c52497e5e31f6868d6b19a))
|
|
145
|
+
* **policy:** rule subjects for the extension's tool names ([5c188b6](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/5c188b610ff6e4ba8a715cc2ee10960736493b86))
|
|
146
|
+
* **tools:** add JSON schema validator for tool args ([24764ef](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/24764ef5100c14404f1923f89cc87c3d64de510d))
|
|
147
|
+
* **tools:** declare args schemas on every built-in tool ([79f6283](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/79f62833144f1a6aba9aaa65a2a19f18eb8793ca))
|
|
148
|
+
* **tools:** whitespace-tolerant edit_file with self-correction hints ([a350e14](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/a350e140e92c8469249d4c6297aad8f8161a217f))
|
|
149
|
+
* **tui:** Ink TUI with inline scrollback replaces pi-tui ([0725bae](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/0725bae27790829fd756afbdb5dd20574a1e0f00))
|
|
150
|
+
* **tui:** Shift+Enter inserts a new line where the terminal can report it ([b9c0b70](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/b9c0b7041057e2bdeb1675bbfa33a12fc3a664b9))
|
|
151
|
+
|
|
152
|
+
# [1.1.0](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/v1.0.1...v1.1.0) (2026-06-23)
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
### Features
|
|
156
|
+
|
|
157
|
+
* **acp-web:** theme support, favicon, font, and dep bumps ([0576402](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/0576402b6888a2cf6bc93123d733c4163358c63f))
|
|
158
|
+
* **acp:** add MCP server support (stdio/http/sse) ([ba98b0c](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/ba98b0c0b2e2461e8553331cafa1985e7673ee43))
|
|
159
|
+
|
|
160
|
+
## [1.0.1](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/v1.0.0...v1.0.1) (2026-06-22)
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
### Bug Fixes
|
|
164
|
+
|
|
165
|
+
* correct npm scope to [@datalabrotterdam](https://github.com/datalabrotterdam) ([6ab6bf8](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/6ab6bf88506cc1d4b778c1a30b123cd532a0a8de))
|
|
166
|
+
|
|
167
|
+
# 1.0.0 (2026-06-22)
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
### Features
|
|
171
|
+
|
|
172
|
+
* add ACP agent, tool calling, and alpha release channel ([15d19a7](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/15d19a7998b4651ba9ad279fc2607006ea14ed49))
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
<img src="
|
|
3
|
+
<img src="https://raw.githubusercontent.com/Datalab-Rotterdam/nova-ai-cli/main/assets/logo.png" width="96" height="96" alt="Nova logo" />
|
|
4
4
|
|
|
5
5
|
# @datalabrotterdam/nova-ai-cli
|
|
6
6
|
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
[](https://agentclientprotocol.com)
|
|
13
13
|
[](https://github.com/Datalab-Rotterdam/nova-ai-cli/issues)
|
|
14
14
|
|
|
15
|
-
[npm](https://www.npmjs.com/package/@datalabrotterdam/nova-ai-cli) · [Issues](https://github.com/Datalab-Rotterdam/nova-ai-cli/issues) · [ACP reference](
|
|
15
|
+
[npm](https://www.npmjs.com/package/@datalabrotterdam/nova-ai-cli) · [Issues](https://github.com/Datalab-Rotterdam/nova-ai-cli/issues) · [ACP reference](https://github.com/Datalab-Rotterdam/nova-ai-cli/blob/main/docs/ACP.md) · [Settings and memory](https://github.com/Datalab-Rotterdam/nova-ai-cli/blob/main/docs/NOVA_HOME.md)
|
|
16
16
|
|
|
17
17
|
</div>
|
|
18
18
|
|
|
@@ -44,6 +44,18 @@ nova-ai # start the terminal UI in your project
|
|
|
44
44
|
Or without installing: `npx @datalabrotterdam/nova-ai-cli login`, then
|
|
45
45
|
`npx @datalabrotterdam/nova-ai-cli`.
|
|
46
46
|
|
|
47
|
+
When a newer version is on npm, `nova-ai` asks before the terminal UI opens:
|
|
48
|
+
Enter installs it (`npm install -g`) and restarts, `n` asks again tomorrow, `s`
|
|
49
|
+
skips that version. Until it is installed, the status line keeps reminding you,
|
|
50
|
+
and `/update` installs it and restarts in the same session. `-p` and
|
|
51
|
+
`--version` print a notice (on stderr, only in a terminal). npm is asked at
|
|
52
|
+
most once a day; an alpha install also follows the `alpha` channel.
|
|
53
|
+
`NOVA_NO_UPDATE_CHECK=1` turns it off (it is off in CI).
|
|
54
|
+
|
|
55
|
+
nova-ai installs updates itself only when it was installed with
|
|
56
|
+
`npm install -g`; with npx, another package manager or a project dependency it
|
|
57
|
+
shows the command to run instead.
|
|
58
|
+
|
|
47
59
|
```
|
|
48
60
|
nova-ai [options] Interactive terminal UI
|
|
49
61
|
nova-ai -p [options] [prompt] Run one request headless (see nova-ai -p --help)
|
|
@@ -59,12 +71,18 @@ Interactive options:
|
|
|
59
71
|
|
|
60
72
|
## Terminal UI
|
|
61
73
|
|
|
62
|
-
The UI
|
|
63
|
-
|
|
64
|
-
|
|
74
|
+
The UI runs full screen (the terminal's alternate screen, like `less` or
|
|
75
|
+
`vim`) and gives your shell its screen back on exit. The mouse wheel or
|
|
76
|
+
PgUp/PgDn scroll the transcript, Esc jumps back to the newest output, and
|
|
77
|
+
while you read an answer the prompt that asked for it stays pinned on the top
|
|
78
|
+
row. To select text, hold Shift (Option in some macOS terminals) while dragging.
|
|
65
79
|
|
|
66
80
|
- **Modes** (Shift+Tab): `agent` does the work; `plan` reads the code, asks
|
|
67
|
-
questions and builds a task list but changes nothing; `ask` only answers
|
|
81
|
+
questions and builds a task list but changes nothing; `ask` only answers;
|
|
82
|
+
`autopilot` works on until the task is done, picking defaults instead of
|
|
83
|
+
asking (approvals still ask you).
|
|
84
|
+
Your own agents (`~/.nova-ai/agents/<name>.agent.md`, the format the VS Code
|
|
85
|
+
extension uses) are extra modes after these; `/mode` lists them.
|
|
68
86
|
- **Permissions**: before an edit or command you choose once, for this
|
|
69
87
|
session, always (saved as an exact rule) or deny. Ctrl+K switches between
|
|
70
88
|
asking, accepting edits, and bypass (never remembered).
|
|
@@ -81,16 +99,21 @@ streaming answer, running tools, the prompt and the status rows are redrawn.
|
|
|
81
99
|
| Enter / Shift+Enter | Send / new line (Shift+Enter where the terminal supports the kitty keyboard protocol: VS Code, kitty, WezTerm, Ghostty, foot, Alacritty, recent iTerm2; Alt+Enter, Ctrl+J or a trailing `\` work everywhere) |
|
|
82
100
|
| Esc | Cancel the running turn |
|
|
83
101
|
| Ctrl+C twice | Exit; prints `nova-ai --resume <id>` |
|
|
84
|
-
| Shift+Tab | Cycle agent / ask / plan |
|
|
102
|
+
| Shift+Tab | Cycle agent / ask / plan / autopilot and your own agents |
|
|
85
103
|
| Ctrl+R / Ctrl+P / Ctrl+K | Sessions / models / permission mode |
|
|
86
104
|
| Ctrl+O / Ctrl+T / Ctrl+B | Verbose tool output / tool inspector / background jobs |
|
|
87
105
|
| Alt+V | Paste a clipboard image |
|
|
88
106
|
|
|
89
|
-
Slash commands: `/help`, `/model`, `/mode`, `/permission`, `/session`,
|
|
107
|
+
Slash commands: `/help`, `/model`, `/effort` (thinking models), `/mode`, `/permission`, `/session`,
|
|
90
108
|
`/resume`, `/clear`, `/compact`, `/rewind [n]`, `/queue`, `/steer`, `/usage`,
|
|
91
109
|
`/tools`, `/mcp`, `/skills`, `/shell` and `/agent` (background jobs), `/trust`
|
|
92
|
-
and `/exit`.
|
|
93
|
-
|
|
110
|
+
and `/exit`. Your own commands are markdown files in `~/.nova-ai/commands/` or
|
|
111
|
+
the repository's `.nova-ai/commands/` (Claude Code's format, so
|
|
112
|
+
`.claude/commands` works too): the file is the prompt, `$ARGUMENTS` what you
|
|
113
|
+
type after the command, and they show up in the `/` menu, together with your
|
|
114
|
+
skills (`/<skill-name> <request>`) and your MCP servers' prompts
|
|
115
|
+
(`/mcp__<server>__<prompt>`). Details:
|
|
116
|
+
[`src/tui/README.md`](https://github.com/Datalab-Rotterdam/nova-ai-cli/blob/main/packages/cli/src/tui/README.md).
|
|
94
117
|
|
|
95
118
|
## Headless
|
|
96
119
|
|
|
@@ -131,8 +154,12 @@ always options, client file system and terminals, form questions, plans, usage
|
|
|
131
154
|
and title updates, MCP servers (stdio, HTTP, SSE), image prompts, and three
|
|
132
155
|
login methods (browser, `NOVA_API_KEY`, or `nova-ai login` in a terminal).
|
|
133
156
|
Nova-specific features (prompt queue, rewind, compaction, context usage,
|
|
134
|
-
background jobs) are `_nova/…` extension methods.
|
|
135
|
-
|
|
157
|
+
per-session settings, background jobs) are `_nova/…` extension methods. The agent is also published
|
|
158
|
+
on its own as
|
|
159
|
+
[`@datalabrotterdam/nova-ai-agent`](https://www.npmjs.com/package/@datalabrotterdam/nova-ai-agent)
|
|
160
|
+
(command `nova-ai-agent`), without the terminal UI, for integrations that only
|
|
161
|
+
need ACP. Everything is documented in
|
|
162
|
+
[docs/ACP.md](https://github.com/Datalab-Rotterdam/nova-ai-cli/blob/main/docs/ACP.md).
|
|
136
163
|
|
|
137
164
|
## Security model
|
|
138
165
|
|
|
@@ -149,6 +176,12 @@ background jobs) are `_nova/…` extension methods. Everything is documented in
|
|
|
149
176
|
private `~/.nova-ai/projects/<key>/settings.json`, outside the repository.
|
|
150
177
|
Compound commands (`a && b`, pipes) are checked part by part; substitutions
|
|
151
178
|
and nested shells need an exact rule.
|
|
179
|
+
- **Web pages are fetched only with approval.** `fetch_url` asks every time
|
|
180
|
+
unless a rule allows that URL (a URL can carry data out), and a redirect to
|
|
181
|
+
another site needs its own approval. `web_search` asks the same way, since
|
|
182
|
+
the query goes to the search providers (You.com, DuckDuckGo; your own
|
|
183
|
+
SearXNG server first when `~/.nova-ai/settings.json` has
|
|
184
|
+
`"webSearch": { "searxngUrl": "https://…" }`).
|
|
152
185
|
- **File access stays in the workspace** (symlinks resolved); commands run in
|
|
153
186
|
their own process group with a timeout, and the whole tree is stopped on
|
|
154
187
|
cancel.
|
|
@@ -168,11 +201,29 @@ VS Code extension: settings, per-project trust, sessions and memory.
|
|
|
168
201
|
- **Instructions**: `NOVA.md` and `AGENTS.md` in the workspace.
|
|
169
202
|
- **Memory**: a `MEMORY.md` index plus notes, globally and per project,
|
|
170
203
|
through the `memory_read` and `memory_write` tools (writes need approval).
|
|
171
|
-
- **Skills**: `SKILL.md` files under `.
|
|
172
|
-
|
|
204
|
+
- **Skills**: `SKILL.md` files under `.nova-ai/skills` in the workspace or
|
|
205
|
+
`~/.nova-ai/skills` for every project (`.agents`, `.claude` and `.codex`
|
|
206
|
+
skills folders are read too). `/skills` lists them; `/skills off <name>`
|
|
207
|
+
switches one off in this project (`--global`: everywhere). Only names and
|
|
208
|
+
short descriptions go into the prompt; Nova loads a skill when it fits.
|
|
209
|
+
Nova installs its own skills for Word, Excel, PowerPoint and PDF files
|
|
210
|
+
(`nova-docx`, `nova-xlsx`, `nova-pptx`, `nova-pdf`, from
|
|
211
|
+
[nova-ai-skills](https://github.com/Datalab-Rotterdam/nova-ai-skills)) in
|
|
212
|
+
`~/.nova-ai/skills` and keeps them up to date; they need Python 3.
|
|
213
|
+
- **Hooks**: Claude Code's `hooks` format in the same settings files (a
|
|
214
|
+
repository's own only once you trust the workspace): `PreToolUse`,
|
|
215
|
+
`PostToolUse`, `UserPromptSubmit`, `SessionStart` and `Stop`, with Claude
|
|
216
|
+
Code's tool names as matchers, so hooks from `.claude/settings.json` work
|
|
217
|
+
when copied over.
|
|
173
218
|
- **MCP servers**: `.mcp.json` or `mcpServers` in `.nova-ai/settings.json`.
|
|
219
|
+
HTTP servers that use OAuth show "needs sign-in" in `/mcp`; `/mcp login
|
|
220
|
+
<server>` opens the sign-in page in your browser (tokens are kept in
|
|
221
|
+
`~/.nova-ai/mcp-auth`, refreshed automatically), `/mcp logout <server>`
|
|
222
|
+
forgets them. A server that wants a client registered by hand takes
|
|
223
|
+
`"oauth": { "clientId", "clientSecret", "scope", "callbackPort" }` in
|
|
224
|
+
`.mcp.json`.
|
|
174
225
|
|
|
175
|
-
The complete layout and rule syntax: [docs/NOVA_HOME.md](
|
|
226
|
+
The complete layout and rule syntax: [docs/NOVA_HOME.md](https://github.com/Datalab-Rotterdam/nova-ai-cli/blob/main/docs/NOVA_HOME.md).
|
|
176
227
|
|
|
177
228
|
## Models
|
|
178
229
|
|
|
@@ -183,6 +234,12 @@ to a text protocol for models that don't support it. When the context window
|
|
|
183
234
|
fills up, older messages are summarized automatically (`/compact` does it by
|
|
184
235
|
hand).
|
|
185
236
|
|
|
237
|
+
Thinking models are marked ◆ in the model list. For those with levels the
|
|
238
|
+
status line shows the current one (`· thinking medium`) and `/effort` opens a
|
|
239
|
+
slider (←/→, Enter), or sets one directly (`/effort high`, `/effort off`). The
|
|
240
|
+
choice is remembered like the model; a model without that level uses its own
|
|
241
|
+
default.
|
|
242
|
+
|
|
186
243
|
| Environment | |
|
|
187
244
|
|---|---|
|
|
188
245
|
| `NOVA_API_KEY`, `NOVA_MODEL` | Use this key / model instead of the stored ones |
|
|
@@ -191,26 +248,13 @@ hand).
|
|
|
191
248
|
| `NOVA_TOOL_PROTOCOL` | Force `native` or `text` tool calling |
|
|
192
249
|
| `NOVA_NES_MODEL` | Separate model for next-edit suggestions (ACP) |
|
|
193
250
|
| `NOVA_KITTY_KEYBOARD` | `1`/`0`: force the kitty keyboard protocol on or off |
|
|
251
|
+
| `NOVA_NO_UPDATE_CHECK` | Don't ask npm for a newer version (also `NO_UPDATE_NOTIFIER`, or `CI`) |
|
|
194
252
|
|
|
195
253
|
## Development
|
|
196
254
|
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
npm run build # the login page and the CLI bundle in dist/
|
|
201
|
-
npm run dev # run from source with tsx
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
Tests never touch your `~/.nova-ai` or the real Nova API: they run with a
|
|
205
|
-
throwaway home folder and point the client at a local port. The ACP
|
|
206
|
-
conformance test starts the real `--acp` process against a fake gateway. CI
|
|
207
|
-
runs the suite on Linux, macOS and Windows with Node 22 and 24 (the PTY
|
|
208
|
-
scenario on Linux and macOS). Releases are cut by `semantic-release` from
|
|
209
|
-
`main` and `alpha`.
|
|
210
|
-
|
|
211
|
-
Planned: OIDC login against the Nova platform instead of a pasted API key,
|
|
212
|
-
and Remote Control (driving a running session from the Nova web UI or mobile
|
|
213
|
-
app). The standalone browser UI (`--web`) is experimental.
|
|
255
|
+
This package lives in the [nova-ai-cli repository](https://github.com/Datalab-Rotterdam/nova-ai-cli)
|
|
256
|
+
next to the agent package it depends on; see the repository README for
|
|
257
|
+
building and testing.
|
|
214
258
|
|
|
215
259
|
## License
|
|
216
260
|
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// src/browser-setup.ts
|
|
2
|
+
import { execFile, spawn } from "child_process";
|
|
3
|
+
import { existsSync } from "fs";
|
|
4
|
+
import { createRequire } from "module";
|
|
5
|
+
import { dirname, join } from "path";
|
|
6
|
+
var runInstaller = (node, args) => new Promise((resolve, reject) => {
|
|
7
|
+
execFile(node, args, { encoding: "utf8", timeout: 6e4, maxBuffer: 1024 * 1024 }, (error, stdout, stderr) => {
|
|
8
|
+
if (error) reject(new Error(`${error.message}${stderr ? `
|
|
9
|
+
${stderr}` : ""}`));
|
|
10
|
+
else resolve(stdout);
|
|
11
|
+
});
|
|
12
|
+
});
|
|
13
|
+
function browserSetupDisabled(env = process.env) {
|
|
14
|
+
return env.NOVA_AI_BROWSER_AUTO_SETUP === "0" || Boolean(env.CI);
|
|
15
|
+
}
|
|
16
|
+
function bundledInstaller(from = import.meta.url) {
|
|
17
|
+
try {
|
|
18
|
+
const manifest = createRequire(from).resolve("@datalabrotterdam/nova-ai-browser-host/package.json");
|
|
19
|
+
const installer = join(dirname(manifest), "dist", "cli.js");
|
|
20
|
+
return existsSync(installer) ? installer : void 0;
|
|
21
|
+
} catch {
|
|
22
|
+
return void 0;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
function parseSetupOutput(output) {
|
|
26
|
+
const line = output.trim().split("\n").reverse().find((entry) => entry.trim().startsWith("{"));
|
|
27
|
+
if (!line) throw new Error("The browser host installer printed no result.");
|
|
28
|
+
return JSON.parse(line);
|
|
29
|
+
}
|
|
30
|
+
var INSTALLER_ARGS = ["install", "--auto", "--json"];
|
|
31
|
+
async function setUpBrowser(run = runInstaller, installer = bundledInstaller()) {
|
|
32
|
+
if (!installer) throw new Error("The bundled Nova AI Browser host is missing from this installation.");
|
|
33
|
+
return parseSetupOutput(await run(process.execPath, [installer, ...INSTALLER_ARGS]));
|
|
34
|
+
}
|
|
35
|
+
function setUpBrowserInBackground(installer = bundledInstaller()) {
|
|
36
|
+
if (browserSetupDisabled() || !installer) return;
|
|
37
|
+
try {
|
|
38
|
+
spawn(process.execPath, [installer, ...INSTALLER_ARGS], { detached: true, stdio: "ignore" }).unref();
|
|
39
|
+
} catch {
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
function describeBrowserSetup(result) {
|
|
43
|
+
if (!result.browsers.length) {
|
|
44
|
+
return "Browser: no Chromium-based browser (Chrome, Edge, Brave, \u2026) found for this user.";
|
|
45
|
+
}
|
|
46
|
+
const restart = result.newBrowsers.length ? ` Restart ${result.newBrowsers.join(", ")} once so it picks this up.` : "";
|
|
47
|
+
return `Browser: Nova can use ${result.browsers.join(", ")} through the Nova AI browser extension.${restart}`;
|
|
48
|
+
}
|
|
49
|
+
export {
|
|
50
|
+
INSTALLER_ARGS,
|
|
51
|
+
browserSetupDisabled,
|
|
52
|
+
bundledInstaller,
|
|
53
|
+
describeBrowserSetup,
|
|
54
|
+
parseSetupOutput,
|
|
55
|
+
setUpBrowser,
|
|
56
|
+
setUpBrowserInBackground
|
|
57
|
+
};
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
// src/version.ts
|
|
2
|
+
import { readPackageVersion } from "@datalabrotterdam/nova-ai-agent/core/version.js";
|
|
3
|
+
var CLI_PACKAGE_NAME = "@datalabrotterdam/nova-ai-cli";
|
|
4
|
+
function cliVersion() {
|
|
5
|
+
return readPackageVersion(CLI_PACKAGE_NAME, import.meta.url);
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
export {
|
|
9
|
+
CLI_PACKAGE_NAME,
|
|
10
|
+
cliVersion
|
|
11
|
+
};
|