nou-cli 0.5.6 → 0.5.10

package/dist/src/ui/Header.js

@@ -2,14 +2,39 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { memo } from "react";
 import path from "path";
 import { Box, Text, useAnimation } from "ink";
-import { C, SPINNER, gradient, ANIMATION_MS } from "./theme.js";
+import { C, gradient, ANIMATION_MS } from "./theme.js";
 import { useTerminalFocused } from "./focus.js";
 import { currentVersion } from "../update/index.js";
 const VERSION = `v${currentVersion()}`;
-export const Header = memo(function Header({ width, branch, changes, model, local, busy, update }) {
+/** What comes before the project (or the workspace tabs): " ◆ NOU v1.2.3  │  ". */
+const LEAD = ` ◆ NOU ${VERSION}  │  `;
+const tabLabel = (t, i) => ` ${i + 1} ${t.name}${t.busy ? " ●" : ""} `;
+/**
+ * Where each workspace tab, and the + that opens one, sits in the header row: for clicks. With one workspace
+ * (not hosted) there's just the project's name and the +.
+ */
+export function headerZones(tabs) {
+    const zones = [];
+    let x = LEAD.length;
+    if (!tabs.length) {
+        x += path.basename(process.cwd()).length + 1;
+    }
+    else {
+        tabs.forEach((t, i) => {
+            const w = tabLabel(t, i).length;
+            zones.push({ from: x, to: x + w, tab: i });
+            x += w + 1;
+        });
+    }
+    zones.push({ from: x, to: x + 3, tab: "new" });
+    return zones;
+}
+export const Header = memo(function Header({ width, branch, changes, model, local, busy, update, tabs = [] }) {
     // The spinner stops while Nou's window is in the background: nobody sees it, and each frame is a redraw.
     const windowFocused = useTerminalFocused();
     const { frame } = useAnimation({ interval: ANIMATION_MS, isActive: !!busy && windowFocused });
     const project = path.basename(process.cwd());
-    return (_jsxs(Box, { width: width, justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, flexGrow: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate-end", children: [" ", gradient("◆ NOU", busy ? frame : 0).map((g, i) => _jsx(Text, { bold: true, color: g.color, children: g.ch }, i)), _jsxs(Text, { color: C.dim, children: [" ", VERSION] }), _jsx(Text, { color: C.dim, children: "  \u2502  " }), _jsx(Text, { color: C.text, children: project }), branch && (_jsxs(_Fragment, { children: [_jsx(Text, { color: C.dim, children: "  \u2502  " }), _jsxs(Text, { color: C.accent2, children: ["\u2387 ", branch] }), changes > 0 && _jsxs(Text, { color: C.yellow, children: [" \u00B1", changes] })] })), busy && _jsxs(Text, { color: C.accent2, children: ["  ", SPINNER[frame % SPINNER.length], " ", busy] })] }) }), _jsx(Box, { flexShrink: 0, children: _jsxs(Text, { wrap: "truncate-end", children: [update && width >= 110 && _jsxs(Text, { color: C.green, bold: true, children: ["\u2B06 v", update, " available \u00B7 run `nou update`  "] }), _jsx(Text, { backgroundColor: local ? C.green : C.accent2, color: "black", bold: true, children: ` ${local ? "⌂ LOCAL" : "☁ CLOUD"} ` }), _jsx(Text, { backgroundColor: C.panel, color: C.text, children: ` ${model} ` }), " "] }) })] }));
+    return (_jsxs(Box, { width: width, justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, flexGrow: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate-end", children: [" ", gradient("◆ NOU", busy ? frame : 0).map((g, i) => _jsx(Text, { bold: true, color: g.color, children: g.ch }, i)), _jsxs(Text, { color: C.dim, children: [" ", VERSION] }), _jsx(Text, { color: C.dim, children: "  \u2502  " }), tabs.length
+                            ? tabs.map((t, i) => (_jsxs(Text, { children: [_jsx(Text, { ...(t.active ? { backgroundColor: C.panel } : {}), color: t.active ? C.accent : C.text, bold: t.active, children: tabLabel(t, i) }), " "] }, t.id)))
+                            : _jsxs(Text, { color: C.text, children: [project, " "] }), _jsx(Text, { color: C.accent2, children: " + " }), branch && (_jsxs(_Fragment, { children: [_jsx(Text, { color: C.dim, children: "  \u2502  " }), _jsxs(Text, { color: C.accent2, children: ["\u2387 ", branch] }), changes > 0 && _jsxs(Text, { color: C.yellow, children: [" \u00B1", changes] })] }))] }) }), _jsx(Box, { flexShrink: 0, children: _jsxs(Text, { wrap: "truncate-end", children: [update && width >= 110 && _jsxs(Text, { color: C.green, bold: true, children: ["\u2B06 v", update, " available \u00B7 run `nou update`  "] }), _jsx(Text, { backgroundColor: local ? C.green : C.accent2, color: C.onBadge, bold: true, children: ` ${local ? "⌂ LOCAL" : "☁ CLOUD"} ` }), _jsx(Text, { backgroundColor: C.panel, color: C.text, children: ` ${model} ` }), " "] }) })] }));
 });

package/dist/src/ui/Pane.js

@@ -3,6 +3,6 @@ import { Box, Text } from "ink";
 import { C } from "./theme.js";
 /** A bordered panel with a title row. Content gets `width - 2` columns and `height - 3` rows. */
 export function Pane({ title, width, height, focused, accent, children }) {
-    const color = accent ?? (focused ? C.accent : C.dim);
-    return (_jsxs(Box, { flexDirection: "column", width: width, height: height, borderStyle: focused || accent ? "round" : "single", borderColor: color, overflow: "hidden", children: [_jsx(Text, { bold: true, color: focused || accent ? color : C.dim, wrap: "truncate-end", children: title }), children] }));
+    const color = accent ?? (focused ? C.accent : C.border);
+    return (_jsxs(Box, { flexDirection: "column", width: width, height: height, borderStyle: focused || accent ? "round" : "single", borderColor: color, overflow: "hidden", children: [_jsx(Text, { bold: true, color: focused || accent ? color : C.text, wrap: "truncate-end", children: title }), children] }));
 }

package/dist/src/ui/QuickOpen.js

@@ -58,7 +58,7 @@ export function score(file, query) {
     return { score: total - file.length * 0.05, hits };
 }
 /** Ctrl+P: find a file. Start with ">" (or press ?) for every action Nou has, with its shortcut. */
-export function QuickOpen({ width, top, files, recent = [], actions, initialQuery = "", onPick, onRun, onClose }) {
+export function QuickOpen({ width, top, files, recent = [], actions, initialQuery = "", placeholder = "Go to file…  (> for commands)", onPick, onRun, onClose }) {
     const [query, setQuery] = useState(initialQuery);
     const [cursor, setCursor] = useState(0);
     const boxWidth = Math.min(80, Math.max(40, width - 10));
@@ -107,12 +107,17 @@ export function QuickOpen({ width, top, files, recent = [], actions, initialQuer
                             setCursor(0);
                         }, onSubmit: () => {
                             if (commandMode) {
-                                if (found[cursor])
+                                // A number picks that row of a numbered list (/resume's: "1. ...", "2. ...").
+                                const n = /^\s*(\d+)\s*$/.exec(query.slice(1))?.[1];
+                                const numbered = n ? actions.find((a) => a.title.startsWith(`${n}. `)) : undefined;
+                                if (numbered)
+                                    onRun(numbered);
+                                else if (found[cursor])
                                     onRun(found[cursor].action);
                             }
                             else if (results[cursor])
                                 onPick(results[cursor].file);
-                        }, placeholder: "Go to file\u2026  (> for commands)" }), _jsx(Text, { children: " ".repeat(Math.max(0, inner - 4 - Math.max(query.length, 29))) })] }), _jsx(Text, { color: C.dim, children: "─".repeat(inner) }), commandMode && found.length === 0 && _jsx(Text, { color: C.dim, children: pad("  No matching commands") }), commandMode && found.slice(first, first + rowsShown).map((r, i) => {
+                        }, placeholder: placeholder }), _jsx(Text, { children: " ".repeat(Math.max(0, inner - 4 - Math.max(query.length, 29))) })] }), _jsx(Text, { color: C.dim, children: "─".repeat(inner) }), commandMode && found.length === 0 && _jsx(Text, { color: C.dim, children: pad("  No matching commands") }), commandMode && found.slice(first, first + rowsShown).map((r, i) => {
                 const selected = first + i === cursor;
                 const keys = r.action.keys ?? "";
                 const room = inner - 3 - keys.length - 1;

package/dist/src/ui/Settings.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useEffect, useState } from "react";
 import { Box, Text, useAnimation, useInput } from "ink";
 import TextInput from "ink-text-input";
-import { AUTO_SAVE, CODE_THEMES, EFFORTS, FOLLOW_SPEEDS } from "../config/index.js";
+import { AUTO_SAVE, CODE_THEMES, UI_THEMES, EFFORT_LABELS, EFFORTS, FOLLOW_SPEEDS } from "../config/index.js";
 import { highlightLines } from "./text.js";
 import { GAMES } from "../games/index.js";
 import { saveCredentials } from "../config/credentials.js";
@@ -19,13 +19,15 @@ export function greet(name: string, times = 2): string {
 }`;
 const TABS = ["Model", "Engine", "Preferences", "Plugins", "Games"];
 const PREFS = [
-    { key: "effort", label: "Reasoning effort", help: "How hard Claude thinks (low → max). Higher is smarter but slower and pricier." },
+    { key: "effort", label: "Speed vs smarts", help: "How hard the model thinks before it answers (Claude, Codex, pi and Nou's engine with Claude)." },
     { key: "followSpeed", label: "Follow mode speed", help: "How long each file Nou reads stays on screen in follow mode (f): slow, normal, fast, or as it happens." },
+    { key: "uiTheme", label: "Nou's colors", help: "For a dark or a light terminal; auto asks the terminal which it is. Applies when Nou next starts." },
     { key: "codeTheme", label: "Code colors", help: "The theme for code. ←/→ to try them; github-light is for light terminals." },
     { key: "autoSave", label: "Auto-save", help: "delay: a second after you stop typing · focus: when you leave the editor · off: only Ctrl+S." },
     { key: "mouse", label: "Mouse", help: "Wheel scrolls the pane under the pointer; click to focus or open files. Hold Shift to select text." },
     { key: "followMode", label: "Follow mode on start", help: "The code view jumps to files Nou reads and edits." },
     { key: "reuseToolConfig", label: "Use Claude Code / Codex keys", help: "Use the API keys from Claude Code's or Codex's settings when you haven't set one. Applies on restart." },
+    { key: "sendNowWhileBusy", label: "Send while Nou works", help: "On: Enter stops Nou and sends your message now (Alt+Enter queues it). Off: Enter queues it for when Nou finishes." },
     { key: "gitContext", label: "Git context", help: "Give the model your branch, changes and commits, plus git tools." },
     { key: "autoApproveEdits", label: "Auto-approve edits", help: "Apply file edits without asking (diffs are still shown).", warn: true },
     { key: "autoApproveCommands", label: "Auto-approve commands", help: "Run shell commands without asking. Only turn on if you trust the model.", warn: true },
@@ -159,6 +161,9 @@ export function Settings({ width, height, settings, choice, plugins, connectTo,
             else if (pref.key === "codeTheme") {
                 onChange({ codeTheme: CODE_THEMES[(CODE_THEMES.indexOf(settings.codeTheme) + step + CODE_THEMES.length) % CODE_THEMES.length] });
             }
+            else if (pref.key === "uiTheme") {
+                onChange({ uiTheme: UI_THEMES[(UI_THEMES.indexOf(settings.uiTheme) + step + UI_THEMES.length) % UI_THEMES.length] });
+            }
             else if (pref.key === "autoSave") {
                 onChange({ autoSave: AUTO_SAVE[(AUTO_SAVE.indexOf(settings.autoSave) + step + AUTO_SAVE.length) % AUTO_SAVE.length] });
             }
@@ -251,9 +256,11 @@ export function Settings({ width, height, settings, choice, plugins, connectTo,
                         const value = settings[pref.key];
                         return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Text, { ...(selected ? { backgroundColor: C.panel } : {}), children: [_jsx(Text, { color: selected ? C.accent2 : C.dim, children: selected ? "▸ " : "  " }), _jsx(Text, { color: C.text, bold: selected, children: pref.label.padEnd(26) }), pref.key === "codeTheme"
                                             ? _jsxs(Text, { children: [_jsx(Text, { color: C.dim, children: "\u2039 " }), _jsx(Text, { color: C.accent2, bold: true, children: String(value) }), _jsxs(Text, { color: C.dim, children: [" \u203A  ", CODE_THEMES.indexOf(value) + 1, "/", CODE_THEMES.length] })] })
-                                            : pref.key === "effort" || pref.key === "autoSave" || pref.key === "followSpeed"
-                                                ? _jsx(Text, { children: (pref.key === "effort" ? EFFORTS : pref.key === "autoSave" ? AUTO_SAVE : FOLLOW_SPEEDS).map((e) => _jsx(Text, { color: e === value ? C.accent2 : C.dim, bold: e === value, children: e === value ? `[${e}]` : ` ${e} ` }, e)) })
-                                                : toggle(value, pref.warn)] }), _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["    ", pref.help] }), pref.key === "codeTheme" && selected
+                                            : pref.key === "effort"
+                                                ? _jsx(Text, { children: EFFORTS.map((e) => _jsx(Text, { color: e === value ? C.accent2 : C.dim, bold: e === value, children: e === value ? `[${EFFORT_LABELS[e].name}]` : ` ${EFFORT_LABELS[e].name} ` }, e)) })
+                                                : pref.key === "autoSave" || pref.key === "followSpeed" || pref.key === "uiTheme"
+                                                    ? _jsx(Text, { children: (pref.key === "autoSave" ? AUTO_SAVE : pref.key === "uiTheme" ? UI_THEMES : FOLLOW_SPEEDS).map((e) => _jsx(Text, { color: e === value ? C.accent2 : C.dim, bold: e === value, children: e === value ? `[${e}]` : ` ${e} ` }, e)) })
+                                                    : toggle(value, pref.warn)] }), _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["    ", pref.key === "effort" ? `${EFFORT_LABELS[settings.effort].tradeoff}` : pref.help] }), pref.key === "codeTheme" && selected
                                     ? highlightLines("preview.ts", THEME_PREVIEW).map((line, n) => _jsxs(Text, { wrap: "truncate-end", children: ["    ", line] }, n))
                                     : null] }, pref.key));
                     }), prefWindow.last < PREFS.length ? _jsxs(Text, { color: C.dim, children: ["  \u2193 ", PREFS.length - prefWindow.last, " more"] }) : null] }));

package/dist/src/ui/Terminal.js

@@ -8,7 +8,7 @@ const COLORS = { out: C.text, command: C.accent, info: C.dim, error: C.red };
  * what you type goes to it; Ctrl+C stops it. ↑↓ go through what you ran, Ctrl+L clears, Esc leaves.
  * Drag its top border (or Alt+↑/↓) to make it taller or shorter.
  */
-export const Terminal = memo(function Terminal({ shell, version, width, height, focused, wheel, onLeave, onResize }) {
+export const Terminal = memo(function Terminal({ shell, version, width, height, focused, wheel, onLeave, onClose, onResize }) {
     const [input, setInput] = useState("");
     const [history, setHistory] = useState([]);
     const [back, setBack] = useState(-1);
@@ -48,6 +48,12 @@ export const Terminal = memo(function Terminal({ shell, version, width, height,
         if (key.ctrl && typed === "l")
             return shell.clear();
         if (key.return) {
+            // Each command runs in its own shell, so `exit` would end only that one and nothing would seem to
+            // happen: at the prompt it closes the terminal instead.
+            if (!shell.running && /^\s*(exit|logout)(\s+\d+)?\s*$/.test(input)) {
+                setInput("");
+                return onClose();
+            }
             if (!shell.running && input.trim())
                 setHistory((h) => [...h.filter((c) => c !== input.trim()), input.trim()].slice(-100));
             if (shell.running)

package/dist/src/ui/background.js

@@ -0,0 +1,58 @@
+/**
+ * Whether the terminal's background is light or dark, so Nou can pick colors that are readable on it.
+ *
+ * COLORFGBG (set by rxvt, Konsole and others: "foreground;background" as color numbers) answers at once.
+ * Otherwise Nou asks the terminal for its background color (OSC 11, answered by iTerm2, Terminal.app,
+ * kitty, Ghostty, WezTerm, Alacritty, foot, GNOME's and VS Code's terminals and recent Windows Terminal).
+ * A terminal that doesn't answer within `timeoutMs` gets null, and Nou keeps its dark colors.
+ */
+export async function detectBackground(timeoutMs = 150) {
+    const fromEnv = paletteFromColorFgBg(process.env.COLORFGBG);
+    if (fromEnv)
+        return fromEnv;
+    const stdin = process.stdin;
+    if (!stdin.isTTY || !process.stdout.isTTY || typeof stdin.setRawMode !== "function")
+        return null;
+    return new Promise((resolve) => {
+        let reply = "";
+        const wasRaw = stdin.isRaw;
+        const finish = (result) => {
+            clearTimeout(timer);
+            stdin.off("data", onData);
+            stdin.setRawMode(wasRaw);
+            stdin.pause();
+            resolve(result);
+        };
+        const onData = (data) => {
+            reply += data.toString("latin1");
+            const palette = paletteFromOsc11(reply);
+            if (palette)
+                finish(palette);
+        };
+        const timer = setTimeout(() => finish(null), timeoutMs);
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.on("data", onData);
+        // ST-terminated (ESC \): the form most terminals answer in kind.
+        process.stdout.write("\x1b]11;?\x1b\\");
+    });
+}
+/** "15;0" (light text on black) → dark; "0;15" → light. The last number is the background's color index. */
+export function paletteFromColorFgBg(value) {
+    const bg = Number(value?.split(";").at(-1));
+    if (!value || !Number.isInteger(bg))
+        return null;
+    // 7 (light gray) and 9-15 (bright colors, white) are light backgrounds; 0-6 and 8 are dark.
+    return bg === 7 || (bg >= 9 && bg <= 15) ? "light" : "dark";
+}
+/** The terminal's answer to OSC 11: ESC ] 11 ; rgb:RRRR/GGGG/BBBB (1-4 hex digits a channel), then BEL or ESC \. */
+export function paletteFromOsc11(reply) {
+    // eslint-disable-next-line no-control-regex -- the reply starts with ESC
+    const m = reply.match(/\x1b\]11;rgba?:([0-9a-f]{1,4})\/([0-9a-f]{1,4})\/([0-9a-f]{1,4})/i);
+    if (!m)
+        return null;
+    const channel = (hex) => parseInt(hex, 16) / (16 ** hex.length - 1);
+    const [r, g, b] = [channel(m[1]), channel(m[2]), channel(m[3])];
+    // Perceived brightness (Rec. 709 weights); above half is a light background.
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b > 0.5 ? "light" : "dark";
+}

package/dist/src/ui/commands.js

@@ -2,19 +2,58 @@
  * 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(["fold", "unfold", "redraw", "new", "tab", "close", "terminal", "games", "open", "settings", "auto", "diff", "sessions", "history", "problems", "copy", "help", "version", "cancel"]);
+const INSTANT = new Set(["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
+ * ("/termial", "/terminall"). Only when exactly one command fits, so a typo never runs the wrong one.
+ */
+export function closestCommand(name, names) {
+    const word = name.toLowerCase();
+    if (word.length < 3)
+        return null;
+    const sorted = (s) => [...s].sort().join("");
+    const anagrams = names.filter((n) => n.length === word.length && sorted(n) === sorted(word));
+    if (anagrams.length === 1)
+        return anagrams[0];
+    if (anagrams.length > 1)
+        return null;
+    const near = names.filter((n) => editDistance(word, n) <= 1);
+    return near.length === 1 ? near[0] : null;
+}
+/** Levenshtein distance, stopping early once it's over 1 (all closestCommand needs). */
+function editDistance(a, b) {
+    if (Math.abs(a.length - b.length) > 1)
+        return 2;
+    let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
+    for (let i = 1; i <= a.length; i++) {
+        const row = [i];
+        for (let j = 1; j <= b.length; j++)
+            row[j] = Math.min(prev[j] + 1, row[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        if (Math.min(...row) > 1)
+            return 2;
+        prev = row;
+    }
+    return prev[b.length];
+}
 export function runsWhileBusy(text) {
     const [name, ...rest] = text.slice(1).trim().split(/\s+/);
-    if (name === "showme" || name === "teach")
-        return !rest.length || /^(next|skip|stop|end)$/.test(rest.join(" "));
-    return text.startsWith("/") && INSTANT.has(name ?? "");
+    if (name === "showme" || name === "teach" || name === "teachme")
+        return !rest.length || /^(next|skip|back|prev|previous|stop|end|done)$/.test(rest.join(" "));
+    if (!text.startsWith("/") || !name)
+        return false;
+    return INSTANT.has(name) || INSTANT.has(closestCommand(name, SLASH_COMMANDS.map((c) => c.name)) ?? "");
 }
+/** Whether a command only changes what's on screen, so running it for a typo can't do harm. */
+export const onlyChangesScreen = (name) => INSTANT.has(name);
 export const SLASH_COMMANDS = [
     { name: "model", args: "[provider:model]", description: "show or switch the model" },
     { 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: "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: "now", description: "stop Nou and send your queued messages right away (or click them)" },
     { name: "settings", description: "models, engine, preferences and plugins" },
     { name: "auto", args: "[ask|auto-edit|auto]", description: "how much Nou does without asking" },
     { name: "engine", args: "[name]", description: "which agent answers: nou, claude-code, codex or pi" },
@@ -28,8 +67,8 @@ export const SLASH_COMMANDS = [
     { name: "copy", args: "[code|file]", description: "copy the last reply, its last code block, or the open file" },
     { name: "compact", description: "summarize the conversation to free up context" },
     { name: "clear", description: "start a fresh conversation" },
-    { name: "showme", args: "<what you want>", description: "Nou shows you how, step by step, and you type it (with the code shown ahead of your cursor)" },
-    { name: "teach", args: "<what you want>", description: "same as /showme: Nou teaches you to make the change yourself, step by step" },
+    { name: "showme", args: "<question>", description: "Nou explains it and opens the places in the code, highlighted (next/back step through them); any engine" },
+    { name: "teach", args: "<what you want>", description: "Nou walks you through making the change yourself, step by step, with the code shown ahead of your cursor" },
     { name: "new", description: "a new conversation tab: another agent, working alongside this one" },
     { name: "tab", args: "[n]", description: "list the conversation tabs, or switch to tab n" },
     { name: "close", description: "close this conversation tab (it stays saved for /resume)" },

package/dist/src/ui/theme.js

@@ -1,6 +1,9 @@
 import path from "path";
-/** Tokyo Night inspired palette (truecolor; Windows Terminal supports it). */
-export const C = {
+/**
+ * Tokyo Night inspired palette (truecolor; Windows Terminal supports it). Secondary text ("dim") is still at
+ * least 4.5:1 against common dark backgrounds, so hints and help lines stay easy to read.
+ */
+const DARK = {
     accent: "#7aa2f7",
     accent2: "#bb9af7",
     cyan: "#7dcfff",
@@ -9,27 +12,70 @@ export const C = {
     orange: "#ff9e64",
     red: "#f7768e",
     text: "#c0caf5",
-    dim: "#565f89",
+    dim: "#8b93c0",
+    /** Lines around panes that aren't focused: quieter than text, since they aren't read. */
+    border: "#565f89",
     panel: "#1f2335",
+    /** Text on a colored badge (CHAT, CLOUD, EDITING...). */
+    onBadge: "#1a1b26",
 };
+/** For terminals with a light background: the same roles, dark enough to read on white (4.5:1 or more). */
+const LIGHT = {
+    accent: "#2e59c9",
+    accent2: "#7341c2",
+    cyan: "#007197",
+    green: "#3b7a1e",
+    yellow: "#8f5e00",
+    orange: "#b4501b",
+    red: "#c2264b",
+    text: "#1f2335",
+    dim: "#5a607a",
+    border: "#a8aecb",
+    panel: "#e6e7ed",
+    onBadge: "#ffffff",
+};
+/** The colors in use: dark unless the terminal is light (see setPalette). Read at render time, so set it first. */
+export const C = { ...DARK };
+let current = "dark";
+export const palette = () => current;
+/** Switches every color to the dark or light set. Call before the first render. */
+export function setPalette(which) {
+    current = which;
+    Object.assign(C, which === "light" ? LIGHT : DARK);
+    Object.assign(GIT_COLORS, gitColors());
+    for (const [ext, color] of Object.entries(iconColors()))
+        ICONS[ext][1] = color;
+}
 /** Every spinner and shimmer ticks on this one interval, so they redraw together in a single frame. */
 export const ANIMATION_MS = 100;
 export const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-const GRADIENT = [C.accent, "#8c9cf7", C.accent2, "#c39af2", "#e08ad6", C.red, C.orange, C.yellow, C.green, C.cyan];
+const gradientColors = () => current === "light"
+    ? [C.accent, "#4b4fc4", C.accent2, "#8a3fb0", "#a8327f", C.red, C.orange, C.yellow, C.green, C.cyan]
+    : [C.accent, "#8c9cf7", C.accent2, "#c39af2", "#e08ad6", C.red, C.orange, C.yellow, C.green, C.cyan];
 /** Colors for each character of a label, shifted by `frame` so it shimmers when animated. */
 export function gradient(text, frame = 0) {
-    return [...text].map((ch, i) => ({ ch, color: GRADIENT[(i + frame) % GRADIENT.length] }));
+    const colors = gradientColors();
+    return [...text].map((ch, i) => ({ ch, color: colors[(i + frame) % colors.length] }));
 }
-export const GIT_COLORS = {
-    M: C.yellow, A: C.green, "?": C.green, D: C.red, R: C.cyan, U: C.orange,
+const gitColors = () => ({ M: C.yellow, A: C.green, "?": C.green, D: C.red, R: C.cyan, U: C.orange });
+export const GIT_COLORS = gitColors();
+/** Each file type's icon color: language colors, with JavaScript's yellow darkened on a light background. */
+const iconColors = () => {
+    const js = current === "light" ? "#8a7400" : "#f1e05a";
+    return {
+        ".ts": "#3178c6", ".tsx": C.cyan, ".mts": "#3178c6", ".cts": "#3178c6",
+        ".js": js, ".jsx": C.cyan, ".mjs": js, ".cjs": js,
+        ".py": "#3572a5", ".json": C.yellow, ".md": C.text, ".css": C.accent2,
+        ".html": C.orange, ".yml": C.red, ".yaml": C.red, ".go": C.cyan,
+        ".rs": C.orange, ".sh": C.green, ".ps1": C.accent, ".lock": C.dim,
+    };
 };
-const ICONS = {
-    ".ts": ["◆", "#3178c6"], ".tsx": ["◆", C.cyan], ".mts": ["◆", "#3178c6"], ".cts": ["◆", "#3178c6"],
-    ".js": ["◆", "#f1e05a"], ".jsx": ["◆", C.cyan], ".mjs": ["◆", "#f1e05a"], ".cjs": ["◆", "#f1e05a"],
-    ".py": ["◆", "#3572a5"], ".json": ["◇", C.yellow], ".md": ["≡", C.text], ".css": ["◆", C.accent2],
-    ".html": ["◆", C.orange], ".yml": ["◇", C.red], ".yaml": ["◇", C.red], ".go": ["◆", C.cyan],
-    ".rs": ["◆", C.orange], ".sh": ["$", C.green], ".ps1": ["$", C.accent], ".lock": ["◌", C.dim],
+const ICON_SHAPES = {
+    ".ts": "◆", ".tsx": "◆", ".mts": "◆", ".cts": "◆", ".js": "◆", ".jsx": "◆", ".mjs": "◆", ".cjs": "◆",
+    ".py": "◆", ".json": "◇", ".md": "≡", ".css": "◆", ".html": "◆", ".yml": "◇", ".yaml": "◇", ".go": "◆",
+    ".rs": "◆", ".sh": "$", ".ps1": "$", ".lock": "◌",
 };
+const ICONS = Object.fromEntries(Object.entries(iconColors()).map(([ext, color]) => [ext, [ICON_SHAPES[ext], color]]));
 export function fileIcon(file) {
     const base = path.basename(file).toLowerCase();
     if (base.startsWith(".env"))

package/dist/src/workspaces/client.js

@@ -0,0 +1,69 @@
+import net from "net";
+import path from "path";
+import { useSyncExternalStore } from "react";
+let tabs = [];
+const listeners = new Set();
+let socket = null;
+/** Whether this Nou is one workspace of several (run by the host). */
+export const isHosted = () => !!process.env.NOU_HOST_PORT && !!process.env.NOU_WORKSPACE_ID;
+export function workspaceTabs() {
+    return tabs;
+}
+export function useWorkspaceTabs() {
+    return useSyncExternalStore((fn) => {
+        listeners.add(fn);
+        return () => listeners.delete(fn);
+    }, workspaceTabs, workspaceTabs);
+}
+/** One JSON message a line. */
+export function lineReader(onMessage) {
+    let carry = "";
+    return (chunk) => {
+        carry += String(chunk);
+        let at;
+        while ((at = carry.indexOf("\n")) >= 0) {
+            const line = carry.slice(0, at);
+            carry = carry.slice(at + 1);
+            try {
+                onMessage(JSON.parse(line));
+            }
+            catch {
+                // not ours
+            }
+        }
+    };
+}
+/** Connects to the host (when hosted) and passes on what it says. */
+export function connectToHost(on) {
+    if (!isHosted() || socket)
+        return;
+    const s = net.connect(Number(process.env.NOU_HOST_PORT), "127.0.0.1");
+    s.unref(); // never what keeps Nou running once you quit it
+    socket = s;
+    s.on("connect", () => sendToHost({ type: "hello", id: process.env.NOU_WORKSPACE_ID, token: process.env.NOU_HOST_TOKEN ?? "" }));
+    s.on("data", lineReader((msg) => {
+        if (msg.type === "tabs") {
+            tabs = msg.tabs;
+            for (const fn of listeners)
+                fn();
+        }
+        else if (msg.type === "redraw")
+            on.redraw();
+        else if (msg.type === "error")
+            on.error(msg.text);
+    }));
+    s.on("error", () => { });
+    s.on("close", () => (socket = null));
+}
+export function sendToHost(msg) {
+    if (!socket || socket.destroyed)
+        return false;
+    socket.write(`${JSON.stringify(msg)}\n`);
+    return true;
+}
+/** What a tab is called: the folder's name. */
+export const tabName = (folder) => path.basename(path.resolve(folder)) || folder;
+/** Set when this Nou should reopen as a workspaces window as it quits (see cli.ts). */
+let reopenAs = null;
+export const reopenAsWorkspaces = (folders) => (reopenAs = folders);
+export const pendingWorkspaces = () => reopenAs;

package/dist/src/workspaces/host.js

@@ -0,0 +1,144 @@
+import { randomBytes } from "crypto";
+import { existsSync, statSync } from "fs";
+import net from "net";
+import os from "os";
+import path from "path";
+import { loadPackage } from "../engines/index.js";
+import { lineReader, tabName } from "./client.js";
+/** The pseudo-terminal package workspaces run in, installed on first use into ~/.nou/engines like an engine. */
+export const PTY_PACKAGE = "@lydell/node-pty";
+/** A folder for a new workspace: `~` and relative paths (from `from`) resolved; null when it isn't a folder. */
+export function workspaceFolder(folder, from) {
+    const raw = folder.trim().replace(/^["']|["']$/g, "") || from;
+    const full = path.resolve(from, raw.startsWith("~") ? path.join(os.homedir(), raw.slice(1)) : raw);
+    try {
+        return existsSync(full) && statSync(full).isDirectory() ? full : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Runs the workspaces window: each folder becomes a workspace, a whole Nou in its own pseudo-terminal. Only
+ * the active one is drawn; the others keep working (their agents too) and draw everything again when you
+ * switch to them. `firstArgs` go to the first workspace (e.g. --continue, to pick its conversation back up).
+ * Resolves with the exit code once the last workspace is closed.
+ */
+export async function runHost(folders, firstArgs, command = [process.execPath, process.argv[1]]) {
+    const mod = await loadPackage(PTY_PACKAGE);
+    const spawnPty = mod.spawn ?? mod.default?.spawn;
+    const token = randomBytes(16).toString("hex");
+    const workspaces = [];
+    let active = null;
+    let nextId = 1;
+    const size = () => ({ cols: process.stdout.columns || 120, rows: process.stdout.rows || 40 });
+    const send = (w, msg) => w.socket?.write(`${JSON.stringify(msg)}\n`);
+    const tabs = () => workspaces.map((w) => ({ id: w.id, name: tabName(w.folder), folder: w.folder, busy: w.busy, active: w === active }));
+    const broadcast = () => {
+        const list = tabs();
+        for (const w of workspaces)
+            send(w, { type: "tabs", tabs: list });
+    };
+    const activate = (w) => {
+        active = w;
+        broadcast();
+        send(w, { type: "redraw" });
+    };
+    const server = net.createServer((socket) => {
+        socket.on("data", lineReader((msg) => {
+            const from = workspaces.find((w) => w.socket === socket);
+            if (msg.type === "hello") {
+                const w = workspaces.find((x) => x.id === msg.id);
+                if (!w || msg.token !== token)
+                    return socket.destroy(); // only our own workspaces
+                w.socket = socket;
+                send(w, { type: "tabs", tabs: tabs() });
+                if (w === active)
+                    send(w, { type: "redraw" });
+                return;
+            }
+            if (!from)
+                return;
+            if (msg.type === "state") {
+                from.busy = msg.busy;
+                broadcast();
+            }
+            else if (msg.type === "switch") {
+                const to = workspaces[msg.index];
+                if (to && to !== active)
+                    activate(to);
+            }
+            else if (msg.type === "new") {
+                const folder = workspaceFolder(msg.folder, from.folder);
+                if (!folder)
+                    return send(from, { type: "error", text: `No such folder: ${msg.folder}` });
+                activate(open(folder, []));
+            }
+        }));
+        socket.on("error", () => { });
+    });
+    await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+    const port = server.address().port;
+    let finish = () => { };
+    const done = new Promise((resolve) => (finish = resolve));
+    function open(folder, args) {
+        const id = String(nextId++);
+        const { cols, rows } = size();
+        const pty = spawnPty(command[0], [...command.slice(1), ...args], {
+            name: "xterm-256color",
+            cols,
+            rows,
+            cwd: folder,
+            env: { ...process.env, NOU_HOST_PORT: String(port), NOU_HOST_TOKEN: token, NOU_WORKSPACE_ID: id },
+        });
+        const w = { id, folder, pty, busy: false, socket: null };
+        workspaces.push(w);
+        pty.onData((data) => {
+            if (w === active)
+                process.stdout.write(data);
+        });
+        pty.onExit(({ exitCode }) => {
+            const at = workspaces.indexOf(w);
+            if (at >= 0)
+                workspaces.splice(at, 1);
+            w.socket?.destroy();
+            if (!workspaces.length)
+                return finish(exitCode);
+            if (w === active)
+                activate(workspaces[Math.min(at, workspaces.length - 1)]);
+            else
+                broadcast();
+        });
+        return w;
+    }
+    // Keys and mouse go to the workspace on screen; a resize goes to all of them.
+    const stdin = process.stdin;
+    if (stdin.isTTY)
+        stdin.setRawMode(true);
+    stdin.resume();
+    const onInput = (data) => active?.pty.write(data.toString("utf-8"));
+    stdin.on("data", onInput);
+    const onResize = () => {
+        const { cols, rows } = size();
+        for (const w of workspaces)
+            w.pty.resize(cols, rows);
+    };
+    process.stdout.on("resize", onResize);
+    const killAll = () => {
+        for (const w of workspaces)
+            w.pty.kill();
+    };
+    process.on("exit", killAll);
+    folders.forEach((folder, i) => open(folder, i === 0 ? firstArgs : []));
+    active = workspaces[workspaces.length - 1] ?? null; // the one just opened is the one you asked for
+    broadcast();
+    const code = await done;
+    stdin.off("data", onInput);
+    if (stdin.isTTY)
+        stdin.setRawMode(false);
+    stdin.pause();
+    process.stdout.off("resize", onResize);
+    process.off("exit", killAll);
+    server.close();
+    return code;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nou-cli",
-  "version": "0.5.6",
+  "version": "0.5.10",
   "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": {
@@ -61,6 +61,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@lydell/node-pty": "1.2.0-beta.18",
     "@types/node": "^22.20.5",
     "@types/react": "^19.3.0",
     "eslint": "^10.2.0",