@spinalfluid/ultrac 0.1.11 → 0.1.14

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 (3) hide show
  1. package/README.md +15 -9
  2. package/dist/cli.js +810 -256
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -142,11 +142,21 @@ Inside a session:
142
142
 
143
143
  - Type to talk to Ultrac; it inspects the repository with tools as needed.
144
144
  - On supported terminals, the full-width input box stays at the bottom while tools and replies
145
- run above it. The footer shows the current model, elapsed task time, reported token usage,
146
- and estimated context usage. Unreported token counts appear as unknown.
145
+ run above it. The footer shows only the current model. `/usage` and `/context` show token and context details.
146
+ Thinking and tool activity lines show their own live elapsed timers and retain the measured
147
+ duration when finished. Sub-second durations are hidden. Tool actions stay in a collapsed activity group;
148
+ click it or press Ctrl+O to expand, then click an action for command and output details. Green and red
149
+ dots show success and failure. Use `/output` for full saved results. Slash suggestions use aligned
150
+ command and description columns on the terminal background.
147
151
  - Type `/` to browse built-in commands and available skills. Type to filter, use arrow keys
148
152
  to select, and press Tab or Enter to fill the command. Press Enter again to run it;
149
153
  Esc dismisses the menu. `/skill <name> [args]` runs a skill without a custom command.
154
+ - Drop a PNG, JPEG or WebP screenshot into the composer: it displays as `[Image 1]`,
155
+ and Cosmic receives the pixels. Images are resized to fit 1024 × 1024, with one active image
156
+ at a time; follow-up questions retain it until another image replaces it. Normalized images
157
+ are included in the private saved-session checkpoint so resumed tasks can inspect them.
158
+ - When a newer public npm release exists, choose Update now, Skip, or Skip until next version.
159
+ Installing requires an explicit choice and verifies the selected installed CLI version.
150
160
  - Multiple-choice questions accept arrow keys and Enter, or a mouse click where the terminal
151
161
  supports mouse reporting. You can also type a number or your own answer.
152
162
  - You can type another message while Ultrac is working. It is queued and inserted after the current
@@ -447,15 +457,11 @@ and tool-step restore; later direct messages and `ask_user` answers cannot be re
447
457
  files.
448
458
 
449
459
  The window defaults to 262,144 tokens and is set with `--context-tokens`, `ULTRAC_MODEL_CONTEXT_TOKENS`,
450
- or `"contextTokens"` in the config, in that order of precedence. The session banner prints the
451
- budget it started with:
452
-
453
- ```
454
- tools 16 (mode default) ≈ 9,152 chars · window 262,144 tokens · tool results capped at 6,000 chars
455
- ```
460
+ or `"contextTokens"` in the config, in that order of precedence. Use `/context` to inspect the
461
+ current budget. The startup header shows the model, authenticated plan and workspace.
456
462
 
457
463
  Every `ask`, `run`, and interactive process creates a private `0600` JSONL lifecycle log under
458
- `.ultrac/logs` and prints its path. It records correlated provider attempts, request heartbeats,
464
+ `.ultrac/logs`. Use `/logs` to see its path in an interactive session. It records correlated provider attempts, request heartbeats,
459
465
  first chunks, retries, cancellation, compaction, tools, subagents, and checkpoints. Prompt text,
460
466
  tool arguments/results, request bodies, headers, and credentials are replaced by lengths and
461
467
  SHA-256 fingerprints; they are never written raw. The directory is ignored by workspace discovery