nou-cli 0.5.14 → 0.5.16

package/README.md

@@ -104,7 +104,7 @@ Every change is reviewed like a code review:
 | <kbd>u</kbd> | undo Nou's last edit |
 | <kbd>v</kbd> | diff the open file vs git `HEAD`, Nou's last edit, or this session · <kbd>n</kbd>/<kbd>N</kbd> jump between changes · <kbd>[</kbd>/<kbd>]</kbd> previous/next file in a session diff |
 | <kbd>c</kbd> | in the file tree: show only changed files |
-| <kbd>f</kbd> | follow mode (off by default): watch along as Nou works. Each file it reads (the exact lines, highlighted) is shown a step at a time, a little behind it, and its edits as they happen. The status bar shows how many steps behind it is; set the speed in settings → Preferences (slow · normal · fast · instant) |
+| <kbd>f</kbd> or `/follow [on\|off]` | follow mode (off by default, and your choice is remembered): watch along as Nou works, with any engine (Codex's `sed`/`cat` reads count too). Each file it reads (the exact lines, highlighted) is shown a step at a time, a little behind it, and its edits as they happen. The status bar shows how many steps behind it is; set the speed in settings → Preferences (slow · normal · fast · instant) |
 | <kbd>&lt;</kbd> / <kbd>&gt;</kbd> / <kbd>=</kbd> | make the focused pane narrower / wider / reset the layout |
 | <kbd>`</kbd> | a terminal under the code, like VS Code's (also `/terminal`): Enter runs a command, Ctrl+C stops it, ↑↓ history, Esc back to the code, × or `exit` closes it; drag its top border (or <kbd>Alt</kbd>+↑/↓) to make it taller or shorter. Commands run through your shell one at a time, so full-screen programs like vim don't draw there |
 | <kbd>z</kbd> | in the code view: fold every function and block to its first line, or open them all again (also `/fold`, `/unfold`); click a ▾/▸ beside a line number to fold or open just that one |

package/dist/src/cli.js

@@ -16,9 +16,10 @@ import { installFastOutput } from "./ui/fast-output.js";
 import { RENDER_OPTIONS } from "./ui/render-options.js";
 import { setScreenClear } from "./ui/redraw.js";
 import { detectTerminal } from "./ui/background.js";
+import { setTerminalTitle } from "./ui/title.js";
 import { setPalette } from "./ui/theme.js";
 import { runHost, workspaceFolder } from "./workspaces/host.js";
-import { pendingWorkspaces } from "./workspaces/client.js";
+import { isHosted, pendingWorkspaces } from "./workspaces/client.js";
 import { spawn } from "child_process";
 import { appendFileSync, mkdirSync } from "fs";
 import path from "path";
@@ -97,6 +98,7 @@ async function main() {
         const uiTheme = loadSettings().uiTheme;
         // Every workspace uses the colors found for this terminal (they can't ask it themselves from the background).
         // The host asks the terminal once and tells every workspace (in the background they can't ask it).
+        setTerminalTitle();
         const term = await detectTerminal();
         process.env.NOU_PALETTE = uiTheme === "dark" || uiTheme === "light" ? uiTheme : term.palette ?? "dark";
         if (term.kitty !== null)
@@ -108,6 +110,9 @@ async function main() {
         console.error("Nou needs an interactive terminal (try Windows Terminal, PowerShell, or Terminal/iTerm on macOS).");
         process.exit(1);
     }
+    // The tab says Nou CLI, not the shell it runs in (a workspace's host already set it).
+    if (!isHosted())
+        setTerminalTitle();
     p.intro(chalk.cyan(`${artWork} \n Hello I am Nou! 🌞  ${chalk.dim(`v${currentVersion()}`)}`));
     // A folder's files can run things (its MCP servers, plugins, the commands Nou is asked to run), so a
     // folder is trusted once, like Claude Code and VS Code ask.

package/dist/src/engines/claude.js

@@ -1,7 +1,7 @@
 import { readFileSync } from "fs";
 import path from "path";
 import { toRelative } from "../commands/index.js";
-import { ExternalEngine, replaceIn } from "./external.js";
+import { ExternalEngine, readsInCommand, replaceIn } from "./external.js";
 import { loadPackage } from "./index.js";
 const EFFORTS = new Set(["low", "medium", "high", "xhigh", "max"]);
 /** Claude Code tools that change files; Nou previews and approves them. */
@@ -95,8 +95,16 @@ export class ClaudeCodeEngine extends ExternalEngine {
                     ? { hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: `This edit introduced problems; fix them:\n${problems}` } }
                     : {};
             }
-            if (tool === "Read" && args.file_path)
-                this.hooks.onRead(toRelative(args.file_path));
+            if (tool === "Read" && args.file_path) {
+                // A part of the file (offset and limit, in lines): follow mode shows those lines.
+                const from = typeof args.offset === "number" ? Math.max(1, args.offset) : undefined;
+                const to = from && typeof args.limit === "number" ? from + args.limit - 1 : undefined;
+                this.hooks.onRead(toRelative(args.file_path), from, to);
+            }
+            if ((tool === "Bash" || tool === "PowerShell") && typeof args.command === "string") {
+                for (const read of readsInCommand(args.command))
+                    this.hooks.onRead(read.path, read.line, read.to);
+            }
             this.hooks.onEntry({ kind: "tool", text: tool === "Bash" || tool === "PowerShell" ? `Ran: ${args.command}` : describeTool(tool, args) });
             return {};
         };
@@ -149,6 +157,9 @@ export class ClaudeCodeEngine extends ExternalEngine {
                     if (!signal.aborted)
                         this.hooks.onEntry({ kind: "error", text: `Claude Code: ${detail}` });
                 }
+                // The turn is over: don't wait for Claude Code's process to close its stream as well. Something it
+                // left running (a background command, an MCP server) kept that open, and Nou "working" forever.
+                break;
             }
         }
         if (signal.aborted)

package/dist/src/engines/codex.js

@@ -3,7 +3,7 @@ import { realpathSync, statSync } from "fs";
 import path from "path";
 import { transientMessage } from "../agent/index.js";
 import { listAllFiles } from "../ui/QuickOpen.js";
-import { ExternalEngine } from "./external.js";
+import { ExternalEngine, readsInCommand } from "./external.js";
 import { loadPackage } from "./index.js";
 const EFFORTS = new Set(["low", "medium", "high", "xhigh", "max"]);
 const MAX_FILES = 5000;
@@ -166,6 +166,9 @@ export class CodexEngine extends ExternalEngine {
         }
         else if (event.type === "item.started" && event.item.type === "command_execution") {
             this.hooks.onBusy(`Codex: ${event.item.command}`);
+            // Codex reads files with shell commands: follow mode shows them as it would a read.
+            for (const read of readsInCommand(event.item.command))
+                this.hooks.onRead(read.path, read.line, read.to);
         }
         else if (event.type === "item.completed") {
             const item = event.item;

package/dist/src/engines/external.js

@@ -1,4 +1,4 @@
-import { readFileSync } from "fs";
+import { readFileSync, statSync } from "fs";
 import path from "path";
 import { newSessionId } from "../agent/index.js";
 import { isInProject, toRelative } from "../commands/index.js";
@@ -10,6 +10,53 @@ function readOrNull(filePath) {
         return null;
     }
 }
+/**
+ * The files a shell command reads, so follow mode can show them: engines like Codex read with `sed -n
+ * '10,80p' f`, `cat f`, `nl -ba f`, `head -n 40 f` instead of a read tool. Only files that exist in the
+ * project count; anything it can't make sense of is no read.
+ */
+export function readsInCommand(command) {
+    // Codex runs `bash -lc '<script>'`: look inside the quotes.
+    const wrapped = command.match(/^\S*(?:bash|sh|zsh)\s+-l?c\s+(['"])([\s\S]*)\1\s*$/);
+    const script = wrapped ? wrapped[2] : command;
+    const reads = [];
+    for (const part of script.split(/\s*(?:&&|\|\||;|\||\n)\s*/)) {
+        const words = (part.match(/'[^']*'|"[^"]*"|\S+/g) ?? []).map((w) => w.replace(/^(['"])(.*)\1$/, "$2"));
+        const [tool, ...args] = words;
+        if (!tool)
+            continue;
+        const files = args.filter((a) => !a.startsWith("-") && /[./]|\w\.\w/.test(a));
+        let range = {};
+        if (tool === "sed" && args.includes("-n")) {
+            const m = args.join(" ").match(/(\d+)\s*,\s*(\d+)\s*p/) ?? args.join(" ").match(/(\d+)p/);
+            if (!m)
+                continue;
+            range = { line: Number(m[1]), to: Number(m[2] ?? m[1]) };
+            files.splice(0, files.length, ...files.filter((f) => !/^\d+(,\d+)?p$/.test(f)));
+            // `nl -ba f | sed -n '5,9p'`: the lines are of the file read just before it in the pipe.
+            const last = reads.at(-1);
+            if (!files.length && last && last.line === undefined)
+                Object.assign(last, range);
+        }
+        else if (tool === "head") {
+            const n = Number(args.join(" ").match(/-n\s*(\d+)|-(\d+)/)?.slice(1).find(Boolean) ?? 10);
+            range = { line: 1, to: n };
+        }
+        else if (!["cat", "nl", "bat", "less", "more", "tail"].includes(tool))
+            continue;
+        for (const file of files) {
+            try {
+                if (!statSync(path.resolve(process.cwd(), file)).isFile() || !isInProject(file))
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            reads.push({ path: toRelative(file), ...range });
+        }
+    }
+    return reads;
+}
 /** Replaces `oldText` with `newText`, as edit tools do; null if it isn't there (the tool will fail on its own). */
 export function replaceIn(text, oldText, newText, all = false) {
     if (!oldText || !text.includes(oldText))

package/dist/src/guide/index.js

@@ -148,8 +148,25 @@ export function showPlacesTool(onStops) {
         },
     };
 }
-/** The fenced block other engines (which can't call Nou's tools) list their places in. */
-const SHOW_BLOCK = /```nou-show\s*\n([\s\S]*?)\n```/;
+/**
+ * The fenced block other engines (which can't call Nou's tools) list their places in. Models also write it
+ * with ~~~, with CRLF, with the closing fence on the JSON's last line, or (unfenced) as a "nou-show" line
+ * followed by the JSON array at the end of the reply.
+ */
+const SHOW_BLOCK = /(?:```|~~~)[ \t]*nou-show[ \t]*\r?\n([\s\S]*?)\r?\n?[ \t]*(?:```|~~~)|(?:^|\n)[ \t]*nou-show[ \t]*\r?\n[ \t]*(\[[\s\S]*\])\s*$/;
+/**
+ * A reply as the chat shows it: Nou's blocks (nou-show, nou-steps) are for Nou, not you, so they're never
+ * drawn, including one still arriving mid-stream.
+ */
+export function hideNouBlocks(text) {
+    if (!text.includes("nou-"))
+        return text;
+    return text
+        .replace(/(?:```|~~~)[ \t]*nou-(?:show|steps)[ \t]*\r?\n[\s\S]*?(?:```|~~~)/g, "")
+        .replace(/(?:```|~~~)[ \t]*nou-(?:show|steps)[\s\S]*$/, "")
+        .replace(/(?:^|\n)[ \t]*nou-(?:show|steps)[ \t]*\r?\n[ \t]*\[[\s\S]*$/, "")
+        .trimEnd();
+}
 /**
  * For Claude Code, Codex and pi, which can't call show_places: how to point at places, added to what they
  * know about the project, so explaining "where does X happen" opens the files on any engine.
@@ -166,7 +183,7 @@ export function stopsFromReply(text) {
     if (!m)
         return null;
     try {
-        const stops = tidyStops(JSON.parse(m[1]));
+        const stops = tidyStops(JSON.parse((m[1] ?? m[2])));
         return { stops, rest: text.replace(m[0], "").trim() };
     }
     catch {

package/dist/src/ui/App.js

@@ -1457,6 +1457,17 @@ export function App({ initialModel, permContext, resume }) {
         if (!followTimer.current)
             playFollow();
     };
+    /** Turns follow mode on or off (`to`), or flips it; remembered for next time, and the chat says what it does. */
+    const toggleFollow = (to) => {
+        const on = to ?? !followRef.current;
+        followRef.current = on;
+        setFollow(on);
+        if (settingsRef.current.followMode !== on)
+            updateSettings({ followMode: on });
+        info(on
+            ? "Follow on: the code view now shows each file Nou reads or edits as it works (f, the follow chip or /follow off to stop)."
+            : "Follow off: the code view stays on what you have open. Edits waiting for your OK still show.");
+    };
     const followStepRef = useRef(followStep);
     followStepRef.current = followStep;
     useEffect(() => {
@@ -1570,7 +1581,7 @@ export function App({ initialModel, permContext, resume }) {
             setChatPrefill((p) => ({ text: "/", nonce: (p?.nonce ?? 0) + 1 }));
         }
         else if (input === "f")
-            setFollow((f) => !f);
+            toggleFollow();
         else if (input === "m")
             toggleMouse();
         else if (input === "`")
@@ -1752,6 +1763,12 @@ ${snippet}
                     return info(`No file matches "${wanted}". To find where something is in the code, ask in the chat.`, "error");
                 return openRef({ path: file, ...(m[2] ? { line: Number(m[2]) } : {}), ...(m[3] ? { to: Number(m[3]) } : {}) });
             }
+            case "follow": {
+                const want = arg.trim().toLowerCase();
+                if (want && !/^(on|off)$/.test(want))
+                    return info("Use /follow on or /follow off (or just /follow to switch).", "error");
+                return toggleFollow(want ? want === "on" : undefined);
+            }
             case "effort": {
                 // Speed vs smarts, by name: /effort smarter (or the effort itself: /effort xhigh).
                 const options = EFFORTS.map((e) => EFFORT_LABELS[e].name.toLowerCase()).join(", ");
@@ -2549,7 +2566,7 @@ ${snippet}
         { title: "Ask before every edit and command", keys: "Shift+Tab", run: () => cycleAutoMode("ask") },
         { title: "Auto-edit: apply edits without asking", keys: "Shift+Tab", run: () => cycleAutoMode("auto-edit") },
         { title: "Auto: edits and commands without asking", keys: "Shift+Tab", run: () => cycleAutoMode("auto") },
-        { title: `Follow mode ${follow ? "off" : "on"}: jump to files Nou works on`, keys: "f", run: () => setFollow((f) => !f) },
+        { title: `Follow mode ${follow ? "off" : "on"}: jump to files Nou works on`, keys: "f", run: () => toggleFollow() },
         { title: `Replay speed for follow mode: ${settings.followSpeed} (next: ${FOLLOW_SPEEDS[(FOLLOW_SPEEDS.indexOf(settings.followSpeed) + 1) % FOLLOW_SPEEDS.length]})`, keys: "settings", run: () => updateSettings({ followSpeed: FOLLOW_SPEEDS[(FOLLOW_SPEEDS.indexOf(settings.followSpeed) + 1) % FOLLOW_SPEEDS.length] }) },
         { title: `Mouse ${settings.mouse ? "off (select text in the terminal)" : "on"}`, keys: "m", run: toggleMouse },
         { title: "Copy the last reply", keys: "/copy", run: () => void runCommand("/copy") },
@@ -2625,7 +2642,7 @@ ${snippet}
             x += width;
         };
         add(` ${autoMode} `.length, () => cycleAutoMode());
-        add(followChip.length, () => setFollow((f) => !f));
+        add(followChip.length, () => toggleFollow());
         add(` ✗ ${totals.errors} ▲ ${totals.warnings} `.length, toggleProblems);
         if (checking.length)
             add(3 + checking.join(", ").length);

package/dist/src/ui/Chat.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { hideNouBlocks } from "../guide/index.js";
 import { memo, useEffect, useMemo, useRef, useState } from "react";
 import { Box, Text, useAnimation, useInput } from "ink";
 import { statSync } from "fs";
@@ -54,7 +55,7 @@ function entryLines(entry, inner, links = true) {
     }
     else if (entry.kind === "assistant") {
         out.push({ text: "◆ nou", color: C.accent2, bold: true, lead: BAR, leadColor: C.accent2 });
-        for (const line of renderMarkdown(entry.text, inner - 3, links ? isProjectFile : undefined)) {
+        for (const line of renderMarkdown(hideNouBlocks(entry.text), inner - 3, links ? isProjectFile : undefined)) {
             const color = line.kind === "heading" ? C.accent2 : line.kind === "quote" ? C.dim : undefined;
             out.push({ text: "", spans: line.spans, ...(color ? { color } : {}), lead: BAR, leadColor: C.accent2 });
         }

package/dist/src/ui/FileTree.js

@@ -192,6 +192,6 @@ export const FileTree = memo(function FileTree({ width, height, focused, openFil
                             const room = Math.max(1, inner - marker.length - 1);
                             const shown = label.length > room ? `${label.slice(0, room - 1)}…` : label.padEnd(room);
                             const iconAt = shown.indexOf(icon);
-                            return (_jsxs(Text, { wrap: "truncate-end", ...(selected && focused ? { backgroundColor: C.panel } : {}), children: [_jsx(Text, { ...(nameColor ? { color: nameColor } : {}), bold: isOpen, children: shown.slice(0, iconAt) }), _jsx(Text, { color: color, children: shown.slice(iconAt, iconAt + icon.length) }), working?.has(node.path) ? (_jsx(Text, { bold: true, inverse: selected && focused, children: gradient(shown.slice(iconAt + icon.length), frame).map((g, j) => _jsx(Text, { color: g.color, children: g.ch }, j)) })) : (_jsx(Text, { ...(nameColor ? { color: nameColor } : {}), bold: isOpen, inverse: selected && focused, children: shown.slice(iconAt + icon.length) })), _jsxs(Text, { color: markerColor, children: [" ", marker] })] }, node.path));
+                            return (_jsxs(Text, { wrap: "truncate-end", ...(isOpen ? { backgroundColor: C.openRow } : selected && focused ? { backgroundColor: C.panel } : {}), children: [_jsx(Text, { ...(nameColor ? { color: nameColor } : {}), bold: isOpen, children: shown.slice(0, iconAt) }), _jsx(Text, { color: color, children: shown.slice(iconAt, iconAt + icon.length) }), working?.has(node.path) ? (_jsx(Text, { bold: true, inverse: selected && focused, children: gradient(shown.slice(iconAt + icon.length), frame).map((g, j) => _jsx(Text, { color: g.color, children: g.ch }, j)) })) : (_jsx(Text, { ...(nameColor ? { color: nameColor } : {}), bold: isOpen, inverse: selected && focused, children: shown.slice(iconAt + icon.length) })), _jsxs(Text, { color: markerColor, children: [" ", marker] })] }, node.path));
                         })] }), _jsx(Scrollbar, { total: nodes.length, top: start, rows: rows, focused: focused })] }) }));
 });

package/dist/src/ui/commands.js

@@ -2,7 +2,7 @@
  * Commands that only change what's on screen (or handle a busy Nou themselves): they run right away
  * while Nou works instead of waiting in the queue behind it.
  */
-const INSTANT = new Set(["files", "actions", "palette", "zoom", "now", "fold", "unfold", "redraw", "new", "tab", "close", "terminal", "games", "open", "settings", "auto", "diff", "sessions", "history", "problems", "copy", "help", "version", "cancel"]);
+const INSTANT = new Set(["follow", "files", "actions", "palette", "zoom", "now", "fold", "unfold", "redraw", "new", "tab", "close", "terminal", "games", "open", "settings", "auto", "diff", "sessions", "history", "problems", "copy", "help", "version", "cancel"]);
 /** Whether a typed command runs right away while Nou works (see INSTANT); `/showme` counts only to look or step. */
 /**
  * The command a mistyped name means: the same letters in another order ("/termnial"), or one letter off
@@ -51,6 +51,7 @@ export const SLASH_COMMANDS = [
     { name: "models", args: "[provider]", description: "list the models a provider offers" },
     { name: "connect", args: "<provider>", description: "enter an API key (and URL) for a provider" },
     { name: "open", args: "<file>[:line]", description: "open a file in the code view (part of its name is enough)" },
+    { name: "follow", args: "[on|off]", description: "the code view shows each file the agent reads or edits as it works" },
     { name: "effort", args: "[fastest|fast|balanced|smarter|smartest]", description: "speed vs smarts: how hard the model thinks (cheaper + faster, or smarter)" },
     { name: "workspace", args: "[new <folder> | n]", description: "several projects in this window, a tab each in the header: open one, or switch" },
     { name: "files", description: "find a file by part of its name (also Ctrl+P)" },

package/dist/src/ui/theme.js

@@ -16,6 +16,8 @@ const DARK = {
     /** Lines around panes that aren't focused: quieter than text, since they aren't read. */
     border: "#565f89",
     panel: "#1f2335",
+    /** The band behind the file that's open, wherever it's listed: every name color stays 4.5:1 on it. */
+    openRow: "#2a3352",
     /** Text on a colored badge (CHAT, CLOUD, EDITING...). */
     onBadge: "#1a1b26",
 };
@@ -32,6 +34,7 @@ const LIGHT = {
     dim: "#5a607a",
     border: "#a8aecb",
     panel: "#e6e7ed",
+    openRow: "#edf1fc",
     onBadge: "#ffffff",
 };
 /** The colors in use: dark unless the terminal is light (see setPalette). Read at render time, so set it first. */

package/dist/src/ui/title.js

@@ -0,0 +1,16 @@
+/**
+ * The terminal's window or tab title. Windows Terminal, iTerm2, Ghostty and the rest show the running shell
+ * ("Windows PowerShell") unless the program sets its own with OSC 0, which Nou does: "Nou CLI".
+ * The title before is saved (CSI 22;0t) and put back (CSI 23;0t) on the way out, in terminals that keep a
+ * title stack (xterm, kitty, Ghostty, WezTerm, iTerm2); the others ignore those codes, and the shell retitles
+ * its tab soon after.
+ */
+export const TITLE = "Nou CLI";
+let set = false;
+export function setTerminalTitle(title = TITLE) {
+    if (set || !process.stdout.isTTY)
+        return;
+    set = true;
+    process.stdout.write(`\x1b[22;0t\x1b]0;${title}\x07`);
+    process.on("exit", () => process.stdout.write("\x1b[23;0t"));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nou-cli",
-  "version": "0.5.14",
+  "version": "0.5.16",
   "description": "Nou: an IDE-style AI coding assistant for your terminal. Local (Ollama, LM Studio) and cloud (Claude, OpenAI, Gemini...) models, live diffs, git-aware, built-in editor.",
   "type": "module",
   "bin": {