@nanobpm/nano-coder 0.21.1 → 0.22.0

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 (2) hide show
  1. package/README.md +19 -9
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -38,16 +38,25 @@ cargo run
38
38
 
39
39
  Starts the interactive REPL where you can chat with the agent and use slash commands.
40
40
 
41
- While a turn is running you can type a message and press Enter to **queue** it: the
42
- message waits in a queue and runs as a later prompt — one per turn, in the order you
43
- sent them. The status line shows how many are waiting. Edit the queue at any time
41
+ While a turn is running you can type a message and press **Enter** to **steer** the
42
+ agent: the message is added to the conversation before the agent's next step (after the
43
+ tool calls in flight finish), so it can change course without the turn being cancelled.
44
+ A steer that arrives as the turn finishes is queued instead, and one that arrives as the
45
+ turn is cancelled is dropped (with a note showing its text).
46
+
47
+ Press **Ctrl-Enter** (or Cmd-Enter) instead to **queue** the message: it waits in a queue
48
+ and runs as a later prompt — one per turn, in the order you sent them. Ctrl-Enter needs a
49
+ terminal that reports modified keys (modifyOtherKeys or the kitty keyboard protocol, e.g.
50
+ xterm, kitty, WezTerm, Ghostty, iTerm2); elsewhere use `/queue add message`. The status
51
+ line shows how many are waiting. Edit the queue at any time
44
52
  (even mid-turn) with `/queue`: `/queue` lists the waiting messages, `/queue remove N`
45
53
  drops one (or several, `/queue remove N M`), `/queue edit N new text` rewrites one, and
46
54
  `/queue clear` empties the queue. A queued message is never injected while the agent is
47
55
  asking for input (the `question` tool's picker owns the terminal until you answer).
48
56
  **Esc Esc** (twice within a second) or **Ctrl-C** cancels
49
57
  the running turn, killing any running bash command; a second Ctrl-C at the prompt exits.
50
- With piped (non-terminal) stdin, lines read during a turn are queued as later prompts.
58
+ With piped (non-terminal) stdin, lines read during a turn are queued as later prompts
59
+ (never steer).
51
60
 
52
61
  ### ACP Headless Mode (--acp flag)
53
62
 
@@ -309,7 +318,7 @@ argument: a type-ahead list narrows as you type and Tab completes it.
309
318
  - `/tools` - List registered tools
310
319
  - `/skills` - List the skills the agent can load, where each lives, and any loading warnings
311
320
  - `/plan` - Show the agent's task plan with all notes
312
- - `/queue [list|remove N...|edit N text|clear]` - Show or edit the queued messages. Works while a turn runs, so a queued message can be removed or rewritten before it is sent.
321
+ - `/queue [list|add text|remove N...|edit N text|clear]` - Show or edit the queued messages. Works while a turn runs, so a queued message can be removed or rewritten before it is sent.
313
322
  - `/model [provider/model]` - Show the current model and pick a new one: scroll the provider list, then the model list (Esc steps back). With an argument, switches directly (conversation is kept). Typing `/model ` shows a type-ahead of the current model, recently used models, and each configured provider's default model; Tab completes (a bare provider name completes to its default model). Recently used models are kept in `~/.local/share/nano-coder/recent-models.json`
314
323
  - `/mode [normal|plan|auto]` - Show or set the agent mode (Shift+Tab cycles it, at the prompt or mid-turn):
315
324
  - **normal** - full tools; reaching a positive turn cap asks whether to keep going
@@ -548,14 +557,15 @@ enabled (e.g. `extra_body = { thinking = { type = "enabled", budget_tokens = 400
548
557
  error).
549
558
 
550
559
  **Input.** On a terminal, input is read key by key. While a turn runs, what you type shows
551
- on the status line; Enter adds it to the message queue (one queued message runs per
552
- following turn; `/queue` lists, edits and removes them), Esc Esc or Ctrl-C cancels the turn. The prompt supports
560
+ on the status line; Enter sends it to steer the running turn, Ctrl-Enter (or Cmd-Enter)
561
+ adds it to the message queue (one queued message runs per following turn; `/queue` lists,
562
+ edits and removes them), and Esc Esc or Ctrl-C cancels the turn. The prompt supports
553
563
  editing: Left/Right move the cursor, Home/End (or Ctrl-A/Ctrl-E) jump to the start/end,
554
564
  Alt/Option-Left/Right (or Alt-B/Alt-F) move by word, and Up/Down recall submitted lines from
555
565
  the session's input history (Down past the newest restores what you were typing). The mouse is never captured, so the
556
566
  terminal keeps its native behaviour — the wheel scrolls the scrollback and drag selects text. Backspace and Delete remove the character before/under the cursor, Ctrl-U clears the
557
- input and Ctrl-W deletes the word before the cursor. Ctrl-Enter (or Cmd-Enter) inserts a
558
- newline without sending, and pasted text keeps its line breaks as a single multi-line input
567
+ input and Ctrl-W deletes the word before the cursor. At the prompt between turns,
568
+ Ctrl-Enter (or Cmd-Enter) inserts a newline without sending, and pasted text keeps its line breaks as a single multi-line input
559
569
  instead of sending line by line. Ctrl-D exits on an empty line.
560
570
 
561
571
  Streaming uses server-sent events. Set `stream = false` on a provider whose endpoint doesn't
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nanobpm/nano-coder",
3
- "version": "0.21.1",
3
+ "version": "0.22.0",
4
4
  "description": "A 6MB coding agent. Run a fleet on your laptop.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -31,9 +31,9 @@
31
31
  "node": ">=18"
32
32
  },
33
33
  "optionalDependencies": {
34
- "@nanobpm/nano-coder-darwin-arm64": "0.21.1",
35
- "@nanobpm/nano-coder-darwin-x64": "0.21.1",
36
- "@nanobpm/nano-coder-linux-arm64": "0.21.1",
37
- "@nanobpm/nano-coder-linux-x64": "0.21.1"
34
+ "@nanobpm/nano-coder-darwin-arm64": "0.22.0",
35
+ "@nanobpm/nano-coder-darwin-x64": "0.22.0",
36
+ "@nanobpm/nano-coder-linux-arm64": "0.22.0",
37
+ "@nanobpm/nano-coder-linux-x64": "0.22.0"
38
38
  }
39
39
  }