sapper-iq 1.1.39 → 1.1.40
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 +46 -6
- package/package.json +1 -1
- package/sapper.mjs +2974 -508
package/README.md
CHANGED
|
@@ -39,11 +39,11 @@ Sapper presents three distinct screens during a session, each with a focused pur
|
|
|
39
39
|
When Sapper launches it immediately displays the full state of the current working directory before asking for any input.
|
|
40
40
|
|
|
41
41
|
```
|
|
42
|
-
Sapper terminal workspace
|
|
42
|
+
Sapper terminal coding workspace
|
|
43
43
|
Local models, live tools, and focused coding in one loop
|
|
44
44
|
/your/project · v1.1.38
|
|
45
45
|
|
|
46
|
-
Quick start @file attach · /
|
|
46
|
+
Quick start @file attach · /commands palette · /agents modes
|
|
47
47
|
|
|
48
48
|
┌──────────────────────────────────────────────────────────────┐
|
|
49
49
|
│ [workspace] 5 files · 0 symbols · indexed 36103m ago │
|
|
@@ -264,13 +264,20 @@ Run these inside Sapper at the prompt:
|
|
|
264
264
|
|
|
265
265
|
| Command | Description |
|
|
266
266
|
|---|---|
|
|
267
|
-
| `/help` | Show
|
|
267
|
+
| `/help` | Show the full command palette |
|
|
268
|
+
| `/commands` | Alias for `/help` |
|
|
269
|
+
| `Tab` | Autocomplete slash commands while typing |
|
|
268
270
|
| `/reset` | Start a new conversation session |
|
|
269
271
|
| `/clear-session` | Alias for `/reset` |
|
|
270
272
|
| `/session-info` | Display current session metadata |
|
|
271
273
|
| `/summary` | View or change auto-summarization settings |
|
|
272
274
|
| `/summary phases off` | Hide summarization step list |
|
|
273
275
|
| `/summary trigger 60` | Set summarization trigger to 60 % of context |
|
|
276
|
+
| `/ui` | Show current frontend style and compact mode |
|
|
277
|
+
| `/ui style clean` | Switch to a cleaner Codex/OpenCode-like frontend style |
|
|
278
|
+
| `/ui style ultra` | Switch to an ultra-clean single-line frontend style |
|
|
279
|
+
| `/ui style sapper` | Switch back to the default Sapper frontend style |
|
|
280
|
+
| `/ui compact auto` | Set responsive compact rendering mode |
|
|
274
281
|
| `/shell` | Inspect shell config and list tracked background sessions |
|
|
275
282
|
| `/shell read <id>` | Read buffered output from a background session |
|
|
276
283
|
| `/shell stop <id>` | Stop a tracked background shell session |
|
|
@@ -279,8 +286,12 @@ Run these inside Sapper at the prompt:
|
|
|
279
286
|
| `/git` | Inspect repository state and git shortcuts |
|
|
280
287
|
| `/symbol <name>` | Search for a code symbol via AST index |
|
|
281
288
|
| `/recall <query>` | Search semantic memory for past context |
|
|
289
|
+
| `/memory` | Inspect markdown long-memory notes |
|
|
290
|
+
| `/memory add <title> ::: <note> ::: <tags>` | Save durable project notes/patterns in markdown |
|
|
291
|
+
| `/memory search <query>` | Search markdown long-memory notes |
|
|
282
292
|
| `/log` | View the current session activity log |
|
|
283
293
|
| `/attach <file>` | Attach a file to the next prompt |
|
|
294
|
+
| `//text` | Send literal text that starts with `/` |
|
|
284
295
|
| `exit` | Exit Sapper |
|
|
285
296
|
|
|
286
297
|
---
|
|
@@ -373,7 +384,7 @@ Skills follow the same format and are injected into the system prompt as reusabl
|
|
|
373
384
|
|
|
374
385
|
## Configuration
|
|
375
386
|
|
|
376
|
-
Sapper writes `.sapper/config.json` on first run. All fields are optional; missing values use the defaults shown below.
|
|
387
|
+
Sapper writes `.sapper/config.json` on first run. The file supports JSON-style comments (`//` and `/* ... */`). All fields are optional; missing values use the defaults shown below.
|
|
377
388
|
|
|
378
389
|
```json
|
|
379
390
|
{
|
|
@@ -396,10 +407,30 @@ Sapper writes `.sapper/config.json` on first run. All fields are optional; missi
|
|
|
396
407
|
"showHeartbeat": true,
|
|
397
408
|
"idleNoticeSeconds": 4
|
|
398
409
|
},
|
|
410
|
+
"ui": {
|
|
411
|
+
"compactMode": "auto",
|
|
412
|
+
"style": "sapper"
|
|
413
|
+
},
|
|
399
414
|
"prompt": {
|
|
400
415
|
"prepend": "",
|
|
401
416
|
"append": "",
|
|
402
|
-
"coreOverride": ""
|
|
417
|
+
"coreOverride": "",
|
|
418
|
+
"system": {
|
|
419
|
+
"core": "...",
|
|
420
|
+
"nativeTools": "...",
|
|
421
|
+
"legacyTools": "...",
|
|
422
|
+
"importantContext": "..."
|
|
423
|
+
},
|
|
424
|
+
"ui": {
|
|
425
|
+
"bannerTitle": "Sapper",
|
|
426
|
+
"bannerSubtitle": "terminal coding workspace",
|
|
427
|
+
"bannerTagline": "Model selection, live tools, and focused sessions in one loop"
|
|
428
|
+
},
|
|
429
|
+
"questions": {
|
|
430
|
+
"resumeSession": "Resume session",
|
|
431
|
+
"agentName": "\\nAgent name (lowercase, no spaces): ",
|
|
432
|
+
"skillName": "\\nSkill name (lowercase, no spaces): "
|
|
433
|
+
}
|
|
403
434
|
}
|
|
404
435
|
}
|
|
405
436
|
```
|
|
@@ -419,11 +450,16 @@ Sapper writes `.sapper/config.json` on first run. All fields are optional; missi
|
|
|
419
450
|
| `streaming.showPhaseStatus` | `true` | Show status lines during tool execution and model turns |
|
|
420
451
|
| `streaming.showHeartbeat` | `true` | Update progress line during quiet streaming phases |
|
|
421
452
|
| `streaming.idleNoticeSeconds` | `4` | Print an idle notice after N seconds of no visible output |
|
|
453
|
+
| `ui.compactMode` | `"auto"` | `auto` / `on` / `off` — compact layout for smaller terminals |
|
|
454
|
+
| `ui.style` | `"sapper"` | `sapper` / `clean` / `ultra` — default style, clean minimal, or ultra-clean single-line frontend |
|
|
422
455
|
| `prompt.prepend` | `""` | Inject custom instructions before the default system prompt |
|
|
423
456
|
| `prompt.append` | `""` | Inject custom instructions after the default system prompt |
|
|
424
457
|
| `prompt.coreOverride` | `""` | Replace the core prompt block entirely (tool and context sections are preserved) |
|
|
458
|
+
| `prompt.system.*` | built-in text | Full system prompt sections, including core behavior, tool instructions, agent wrapper, and skill wrapper |
|
|
459
|
+
| `prompt.ui.*` | built-in text | Startup banner, model picker labels, unknown-command title, and other UI labels |
|
|
460
|
+
| `prompt.questions.*` | built-in text | Interactive confirmations and questions shown during approval, attach, agent creation, skill creation, and step mode |
|
|
425
461
|
|
|
426
|
-
Configuration is hot-reloaded — edit the file while Sapper is running and changes take effect on the next prompt turn.
|
|
462
|
+
Configuration is hot-reloaded — edit the file while Sapper is running and changes take effect on the next prompt turn. Prompt text is now managed from config, so you can inspect and customize the major system, UI, and question prompts directly in `.sapper/config.json`. Sapper preserves and regenerates built-in explanatory comments when it rewrites the file.
|
|
427
463
|
|
|
428
464
|
---
|
|
429
465
|
|
|
@@ -441,6 +477,10 @@ Sapper maintains two layers of memory per project:
|
|
|
441
477
|
│ Chunked text embedded with cosine similarity │
|
|
442
478
|
│ Recalled automatically on relevant prompts │
|
|
443
479
|
│ Searchable manually with /recall <query> │
|
|
480
|
+
├─────────────────────────────────────────────────────┤
|
|
481
|
+
│ Durable notes → .sapper/long-memory.md │
|
|
482
|
+
│ Markdown project patterns/decisions/fixes │
|
|
483
|
+
│ Managed with /memory add, /memory search, /memory │
|
|
444
484
|
└─────────────────────────────────────────────────────┘
|
|
445
485
|
```
|
|
446
486
|
|