@compass-ai/nova 1.0.87 → 1.0.88

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 (4) hide show
  1. package/README.md +32 -16
  2. package/dist/cli.js +956 -1152
  3. package/dist/index.js +671 -861
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -111,17 +111,28 @@ During a session, use these slash commands:
111
111
  | Command | Description |
112
112
  |---------|-------------|
113
113
  | `/help` | Show available commands |
114
- | `/model [name]` | Switch between Opus, Sonnet, Haiku |
114
+ | `/model [name]` | Switch between models (e.g. `/model opus`, `/model haiku`) |
115
115
  | `/commit` | Generate conventional commits from staged changes |
116
116
  | `/approve [mode]` | Toggle approval modes (manual/auto/strict) |
117
117
  | `/tokens` | View token usage stats |
118
118
  | `/cost` | Display estimated API costs |
119
- | `/undo` | Undo last file operation |
119
+ | `/context` | Show context window usage |
120
120
  | `/export` | Export conversation as Markdown/JSON/HTML |
121
121
  | `/compact` | Summarize conversation to free context |
122
122
  | `/index` | Reindex project for semantic search |
123
+ | `/files` | List tracked project files |
123
124
  | `/agents` | Switch to specialized agents |
124
125
  | `/config` | View/modify configuration |
126
+ | `/mcp` | Manage Model Context Protocol servers |
127
+ | `/update` | Check for and install Nova updates |
128
+ | `/personality` | Change communication style |
129
+ | `/unleash` | Toggle unguarded mode |
130
+ | `/wrap` | Consolidate memory at end of session |
131
+ | `/purge` | Clean up old backups and logs |
132
+ | `/attach` | Attach a file to the conversation |
133
+ | `/paste` | Paste clipboard content into conversation |
134
+ | `/ask` | Sideband Q&A without affecting main context |
135
+ | `/logout` | Log out of Compass platform |
125
136
  | `/clear` | Clear conversation history |
126
137
  | `/exit` | Exit Nova |
127
138
 
@@ -169,7 +180,7 @@ Fix issue #$1 following our coding standards.
169
180
 
170
181
  Usage: `/fix-issue 123`
171
182
 
172
- See [Custom Commands Documentation](docs/custom-commands.md) for full details.
183
+ See [Custom Commands Documentation](docs/tools/README.md) for full details.
173
184
 
174
185
  ## Agents & Skills
175
186
 
@@ -177,17 +188,17 @@ Nova includes specialized agents for different workflows:
177
188
 
178
189
  | Agent | Purpose |
179
190
  |-------|---------|
180
- | **Explorer** | Codebase navigation and understanding |
181
- | **Code Reviewer** | Security and quality analysis |
182
- | **Debugger** | Error diagnosis and fixes |
183
- | **Planner** | Architecture and implementation planning |
191
+ | **Explorer** | Fast codebase navigation, file search, and pattern matching |
192
+ | **Code Reviewer** | Security, quality, and best practices analysis |
193
+ | **Debugger** | Root cause analysis, error diagnosis, and fixes |
194
+ | **Planner** | Architecture design and implementation planning with impact analysis |
184
195
 
185
196
  Switch agents with `/agents` or create custom agents in `agents.md`:
186
197
 
187
198
  ```markdown
188
199
  ---
189
200
  name: security-audit
190
- model: sonnet-4-20250514
201
+ model: sonnet
191
202
  approval-mode: strict
192
203
  ---
193
204
  Focus on: OWASP Top 10, dependency vulnerabilities, secret detection
@@ -208,7 +219,7 @@ Nova uses a hierarchical configuration system:
208
219
 
209
220
  ```bash
210
221
  ANTHROPIC_API_KEY=your_api_key_here # When using Anthropic models
211
- COMPASS_MODEL=sonnet # Model configuration
222
+ COMPASS_MODEL=sonnet # Default model (see aliases above)
212
223
  COMPASS_DEBUG=true # Enable debug logging
213
224
  NO_COLOR=1 # Disable colored output
214
225
  ```
@@ -227,13 +238,18 @@ Nova is designed with privacy and security as core principles:
227
238
 
228
239
  Nova supports multiple AI models — switch anytime with `/model`:
229
240
 
230
- | Model | Best For |
231
- |-------|----------|
232
- | **Claude Opus 4.5** | Complex reasoning, architecture decisions |
233
- | **Claude Sonnet 4.5** | Balanced performance (default) |
234
- | **Claude Haiku 4.5** | Fast iterations, quick tasks |
235
- | **Ollama** | Cloud/Local/Private, offline capable |
236
- | **GLM 4.7, Minimax, Kimi, Gemini** | Alternative models |
241
+ | Model | Alias | Best For |
242
+ |-------|-------|----------|
243
+ | **Claude Opus 4.6** | `opus`, `o` | Complex reasoning, architecture decisions, extended thinking |
244
+ | **Claude Sonnet 4.6** | `sonnet`, `s` | Balanced performance (default) |
245
+ | **Claude Opus 4.5** | `opus-4.5` | Previous-gen complex reasoning |
246
+ | **Claude Sonnet 4.5** | `sonnet-4.5` | Previous-gen balanced performance |
247
+ | **Claude Haiku 4.5** | `haiku`, `h` | Fast iterations, quick tasks |
248
+ | **Z.AI GLM 5** | `glm-5`, `g` | Cloud-hosted, open-source alternative |
249
+ | **Z.AI GLM 4.7** | `glm-4.7` | Cloud-hosted, open-source |
250
+ | **MiniMax M2.7** | `minimax-m2.7`, `m` | Versatile cloud alternative |
251
+ | **Kimi K2.5** | `kimi-k2.5`, `k` | Deep reasoning alternative |
252
+ | **Gemini 3 Pro** | `gemini-3-pro`, `p` | Creative cloud alternative |
237
253
 
238
254
  All models support:
239
255
  - 200K token context window