nou-cli 0.2.1 → 0.3.0

package/dist/src/ui/Settings.js

@@ -3,43 +3,82 @@ import { useEffect, useState } from "react";
 import { Box, Text, useAnimation, useInput } from "ink";
 import TextInput from "ink-text-input";
 import { AUTO_SAVE, EFFORTS } from "../config/index.js";
+import { saveCredentials } from "../config/credentials.js";
+import { originOf, setOutsideNou } from "../config/origins.js";
 import { PLUGIN_DIRS, isEnabled, trustState } from "../plugins/index.js";
 import { currentVersion } from "../update/index.js";
 import { describe, providers } from "../providers/index.js";
+import { ENGINES, isInstalled } from "../engines/index.js";
 import { C, SPINNER } from "./theme.js";
-const TABS = ["Model", "Preferences", "Plugins"];
+const TABS = ["Model", "Engine", "Preferences", "Plugins"];
 const PREFS = [
     { key: "effort", label: "Reasoning effort", help: "How hard Claude thinks (low → max). Higher is smarter but slower and pricier." },
     { 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: "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 },
 ];
-export function Settings({ width, height, settings, choice, plugins, onModel, onChange, onTogglePlugin, onRescanPlugins, onClose }) {
+export function Settings({ width, height, settings, choice, plugins, connectTo, onModel, onEngine, onChange, onTogglePlugin, onRescanPlugins, onClose }) {
     const [tab, setTab] = useState("Model");
-    const [row, setRow] = useState(0);
+    const [row, setRow] = useState(() => Math.max(0, providers.indexOf(connectTo ?? choice.provider)));
     const [column, setColumn] = useState("providers");
     const [modelRow, setModelRow] = useState(0);
     const [typing, setTyping] = useState(false);
     const [custom, setCustom] = useState("");
     const [models, setModels] = useState({});
+    const [connecting, setConnecting] = useState(connectTo?.connect ? { step: 0, values: {} } : null);
+    const [field, setField] = useState(() => (connectTo?.connect ? initialValue(connectTo.connect[0]) : ""));
     const { frame } = useAnimation({ interval: 80 });
     const provider = providers[row] ?? providers[0];
     const listed = models[provider.id];
     // Load the model list for the highlighted provider.
     useEffect(() => {
-        if (tab !== "Model" || provider.unavailable() || models[provider.id])
+        if (tab !== "Model" || connecting || provider.unavailable() || models[provider.id])
             return;
         setModels((m) => ({ ...m, [provider.id]: "loading" }));
         provider.listModels()
             .then((list) => setModels((m) => ({ ...m, [provider.id]: list })))
             .catch((error) => setModels((m) => ({ ...m, [provider.id]: { error: String(error.message ?? error) } })));
-    }, [tab, provider.id]);
+    }, [tab, provider.id, connecting]);
+    const startConnect = () => {
+        if (!provider.connect)
+            return;
+        setConnecting({ step: 0, values: {} });
+        setField(initialValue(provider.connect[0]));
+    };
+    /** Takes the current field's answer; after the last one, saves everything and shows the provider's models. */
+    const submitField = (value) => {
+        const fields = provider.connect;
+        const current = fields[connecting.step];
+        // Required, and nothing set yet: ask again.
+        if (!value.trim() && !current.optional && !process.env[current.env])
+            return;
+        const values = { ...connecting.values, [current.env]: value };
+        const next = connecting.step + 1;
+        if (next < fields.length) {
+            setConnecting({ step: next, values });
+            setField(initialValue(fields[next]));
+            return;
+        }
+        saveCredentials(values);
+        setConnecting(null);
+        setModels((m) => Object.fromEntries(Object.entries(m).filter(([id]) => id !== provider.id)));
+        if (!provider.unavailable()) {
+            setColumn("models");
+            setModelRow(0);
+        }
+    };
     const modelItems = Array.isArray(listed) ? listed : [];
-    const rowsFor = (t) => (t === "Model" ? providers.length : t === "Preferences" ? PREFS.length : plugins.length);
+    const rowsFor = (t) => (t === "Model" ? providers.length : t === "Engine" ? ENGINES.length : t === "Preferences" ? PREFS.length : plugins.length);
     useInput((input, key) => {
+        if (connecting) {
+            if (key.escape)
+                setConnecting(null);
+            return;
+        }
         if (typing) {
             if (key.escape)
                 setTyping(false);
@@ -48,7 +87,7 @@ export function Settings({ width, height, settings, choice, plugins, onModel, on
         if (key.tab) {
             const next = TABS[(TABS.indexOf(tab) + (key.shift ? TABS.length - 1 : 1)) % TABS.length];
             setTab(next);
-            setRow(next === "Model" ? Math.max(0, providers.indexOf(choice.provider)) : 0);
+            setRow(next === "Model" ? Math.max(0, providers.indexOf(choice.provider)) : next === "Engine" ? Math.max(0, ENGINES.findIndex((e) => e.id === settings.engine)) : 0);
             setColumn("providers");
             return;
         }
@@ -67,6 +106,8 @@ export function Settings({ width, height, settings, choice, plugins, onModel, on
                 setModelRow((r) => Math.min(count - 1, r + 1));
             else if (key.leftArrow)
                 setColumn("providers");
+            else if (input === "k")
+                startConnect();
             else if (key.return) {
                 if (modelRow === 0) {
                     setCustom("");
@@ -86,6 +127,14 @@ export function Settings({ width, height, settings, choice, plugins, onModel, on
                 setColumn("models");
                 setModelRow(0);
             }
+            else
+                startConnect();
+        }
+        else if (tab === "Model" && input === "k") {
+            startConnect();
+        }
+        else if (tab === "Engine" && (key.return || input === " ")) {
+            onEngine(ENGINES[row].id);
         }
         else if (tab === "Preferences" && (key.return || input === " " || key.leftArrow || key.rightArrow)) {
             const pref = PREFS[row];
@@ -112,16 +161,32 @@ export function Settings({ width, height, settings, choice, plugins, onModel, on
     const body = () => {
         if (tab === "Model") {
             const leftWidth = Math.min(46, Math.floor(width * 0.45));
+            // Room for the label next to the marker, "local"/"cloud" and the lock (plus the border).
+            const labelWidth = Math.max(10, leftWidth - 14);
             return (_jsxs(Box, { flexDirection: "row", height: boxHeight, children: [_jsxs(Box, { flexDirection: "column", width: leftWidth, borderStyle: "round", borderColor: column === "providers" ? C.accent : C.dim, children: [_jsx(Text, { color: C.dim, bold: true, children: " PROVIDER" }), providers.map((p, i) => {
                                 const problem = p.unavailable();
                                 const selected = i === row;
                                 const current = p.id === choice.provider.id;
-                                return (_jsxs(Text, { wrap: "truncate-end", ...(selected && column === "providers" ? { backgroundColor: C.panel } : {}), children: [_jsx(Text, { color: current ? C.green : C.dim, children: current ? " ● " : "   " }), _jsx(Text, { color: problem ? C.dim : C.text, bold: selected, children: p.label.padEnd(26).slice(0, 26) }), _jsx(Text, { color: p.local ? C.green : C.accent2, children: p.local ? " local" : " cloud" }), problem ? _jsx(Text, { color: C.dim, children: " \uD83D\uDD12" }) : null] }, p.id));
-                            })] }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, borderStyle: "round", borderColor: column === "models" ? C.accent : C.dim, paddingX: 1, children: [_jsxs(Text, { color: C.dim, bold: true, children: ["MODELS \u00B7 ", provider.label] }), provider.unavailable() ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: C.yellow, children: ["Not set up: ", provider.unavailable()] }), _jsx(Text, { color: C.dim, children: "Add it to a .env file in your project (see .env.example) or your environment, then restart Nou." })] })) : (_jsxs(_Fragment, { children: [typing ? (_jsxs(Text, { children: [_jsx(Text, { color: C.accent2, children: "\u270E " }), _jsx(TextInput, { value: custom, onChange: setCustom, onSubmit: (v) => {
+                                return (_jsxs(Text, { wrap: "truncate-end", ...(selected && column === "providers" ? { backgroundColor: C.panel } : {}), children: [_jsx(Text, { color: current ? C.green : C.dim, children: current ? " ● " : "   " }), _jsx(Text, { color: problem ? C.dim : C.text, bold: selected, children: p.label.padEnd(labelWidth).slice(0, labelWidth) }), _jsx(Text, { color: p.local ? C.green : C.accent2, children: p.local ? " local" : " cloud" }), problem ? _jsx(Text, { color: C.dim, children: " \uD83D\uDD12" }) : null] }, p.id));
+                            })] }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, borderStyle: "round", borderColor: column === "models" ? C.accent : C.dim, paddingX: 1, children: [_jsxs(Text, { color: C.dim, bold: true, children: ["MODELS \u00B7 ", provider.label] }), connecting && provider.connect ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: C.accent2, bold: true, children: ["Connect ", provider.label] }), provider.connect.map((f, i) => {
+                                        const entered = connecting.values[f.env];
+                                        const shown = (v) => (f.secret ? "•".repeat(Math.min(v.length, 12)) : v);
+                                        if (i < connecting.step) {
+                                            return _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["\u2713 ", f.label, ": ", entered ? shown(entered) : "unchanged"] }, f.env);
+                                        }
+                                        if (i > connecting.step)
+                                            return _jsxs(Text, { color: C.dim, children: ["  ", f.label, f.optional ? " (optional)" : ""] }, f.env);
+                                        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { color: C.accent2, children: ["\u270E ", f.label, f.optional ? " (optional)" : "", ": "] }), _jsx(TextInput, { value: field, onChange: setField, onSubmit: submitField, ...(f.secret ? { mask: "•" } : {}), ...(f.placeholder ? { placeholder: f.placeholder } : {}) })] }), _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["  ", f.env, process.env[f.env] ? (f.secret ? ` is set (from ${originOf(f.env)}); Enter keeps it` : "") : f.optional ? "; Enter skips" : ""] }), setOutsideNou(f.env) && (_jsxs(Text, { color: C.yellow, wrap: "wrap", children: ["  A new one works now, but ", originOf(f.env), " sets ", f.env, " too and wins when Nou restarts: change or remove it there."] }))] }, f.env));
+                                    }), _jsx(Text, { children: " " }), _jsx(Text, { color: C.dim, wrap: "truncate-end", children: "Saved to ~/.nou/credentials.json (only you can read it). Your environment and .env still win." })] })) : provider.unavailable() ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: C.yellow, children: ["Not set up: ", provider.unavailable()] }), provider.connect
+                                        ? _jsx(Text, { color: C.accent2, children: "Press Enter to connect it: paste your key here, no restart needed." })
+                                        : null, _jsx(Text, { color: C.dim, children: "Or add it to a .env file in your project (see .env.example) or your environment." })] })) : (_jsxs(_Fragment, { children: [typing ? (_jsxs(Text, { children: [_jsx(Text, { color: C.accent2, children: "\u270E " }), _jsx(TextInput, { value: custom, onChange: setCustom, onSubmit: (v) => {
                                                     setTyping(false);
                                                     if (v.trim())
                                                         onModel({ provider, model: v.trim() });
-                                                }, placeholder: `e.g. ${provider.defaultModel}` })] })) : (_jsx(Text, { ...(column === "models" && modelRow === 0 ? { backgroundColor: C.panel } : {}), color: C.accent2, children: "\u270E Type a model name\u2026" })), listed === "loading" && _jsxs(Text, { color: C.accent2, children: [SPINNER[frame % SPINNER.length], " loading models\u2026"] }), listed && typeof listed === "object" && !Array.isArray(listed) && _jsxs(Text, { color: C.red, children: ["Couldn't list models: ", listed.error] }), (() => {
+                                                }, placeholder: `e.g. ${provider.defaultModel}` })] })) : (_jsx(Text, { ...(column === "models" && modelRow === 0 ? { backgroundColor: C.panel } : {}), color: C.accent2, children: "\u270E Type a model name\u2026" })), listed === "loading" && _jsxs(Text, { color: C.accent2, children: [SPINNER[frame % SPINNER.length], " loading models\u2026"] }), listed && typeof listed === "object" && !Array.isArray(listed) && (_jsxs(_Fragment, { children: [_jsxs(Text, { color: C.red, children: ["Couldn't list models: ", listed.error] }), rejectedKey(listed.error) && provider.connect?.some((f) => f.secret) && (() => {
+                                                const key = provider.connect.find((f) => f.secret).env;
+                                                return _jsxs(Text, { color: C.yellow, wrap: "wrap", children: ["The ", key, " ", originOf(key) ? `from ${originOf(key)} ` : "", "was rejected. Press k to enter a different key."] });
+                                            })()] })), (() => {
                                         const visibleCount = Math.max(1, boxHeight - 6);
                                         const offset = Math.max(0, Math.min(modelRow - 1 - Math.floor(visibleCount / 2), modelItems.length - visibleCount));
                                         return modelItems.slice(offset, offset + visibleCount).map((m, i) => {
@@ -132,6 +197,13 @@ export function Settings({ width, height, settings, choice, plugins, onModel, on
                                         });
                                     })()] }))] })] }));
         }
+        if (tab === "Engine") {
+            return (_jsxs(Box, { flexDirection: "column", height: boxHeight, borderStyle: "round", borderColor: C.accent, paddingX: 1, children: [ENGINES.map((engine, i) => {
+                        const selected = i === row;
+                        const active = engine.id === settings.engine;
+                        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: active ? C.green : C.dim, bold: true, children: active ? "● " : "○ " }), _jsx(Text, { color: C.text, bold: selected, children: engine.label.padEnd(14) }), _jsxs(Text, { color: C.dim, children: [active ? "in use · " : "", isInstalled(engine) ? "" : "installs on first use · ", "model: ", engine.model(choice)] })] }), _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["    ", engine.description] }), engine.approvals === "after" && _jsx(Text, { color: C.orange, wrap: "truncate-end", children: "    Nou can't ask before its edits; it shows them afterwards so you can undo them." })] }, engine.id));
+                    }), _jsx(Text, { color: C.dim, wrap: "truncate-end", children: "The engine is the agent that answers in the chat. Diffs, approvals, undo and problems work with each one." })] }));
+        }
         if (tab === "Preferences") {
             return (_jsx(Box, { flexDirection: "column", height: boxHeight, borderStyle: "round", borderColor: C.accent, paddingX: 1, children: PREFS.map((pref, i) => {
                     const selected = i === row;
@@ -152,15 +224,21 @@ export function Settings({ width, height, settings, choice, plugins, onModel, on
                             (p.plugin.diagnostics ?? []).length && "checker",
                         ].filter(Boolean)
                         : [];
-                    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { ...(selected ? { backgroundColor: C.panel } : {}), children: [_jsx(Text, { color: selected ? C.accent2 : C.dim, children: selected ? "▸ " : "  " }), toggle(enabled), _jsxs(Text, { color: C.text, bold: true, children: [" ", p.plugin?.name ?? p.id] }), _jsxs(Text, { color: C.dim, children: [" ", p.plugin?.version ? `v${p.plugin.version} · ` : "", p.scope, parts.length ? ` · ${parts.join(", ")}` : ""] })] }), state === "changed"
+                    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { ...(selected ? { backgroundColor: C.panel } : {}), children: [_jsx(Text, { color: selected ? C.accent2 : C.dim, children: selected ? "▸ " : "  " }), p.scope === "starter" ? _jsx(Text, { color: C.accent2, bold: true, children: "+ ADD" }) : toggle(enabled), _jsxs(Text, { color: C.text, bold: true, children: [" ", p.plugin?.name ?? p.id] }), _jsxs(Text, { color: C.dim, children: [" ", p.plugin?.version ? `v${p.plugin.version} · ` : "", p.scope === "starter" ? "starter, optional" : p.scope, parts.length ? ` · ${parts.join(", ")}` : ""] })] }), state === "changed"
                                 ? _jsx(Text, { color: C.yellow, wrap: "truncate-end", children: "    \u26A0 Changed since you enabled it. Review the code, then press Enter to enable again." })
                                 : p.error
                                     ? _jsxs(Text, { color: C.red, wrap: "truncate-end", children: ["    \u2716 ", p.error] })
                                     : _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["    ", p.plugin?.description ?? (enabled ? "" : "Enable to load it.")] })] }, p.id));
-                }), _jsx(Text, { children: " " }), _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["Add your own: drop a .js/.mjs file into ", PLUGIN_DIRS.map((d) => d.dir).join(" or "), ", then press r."] }), _jsx(Text, { color: C.dim, wrap: "truncate-end", children: "Example: examples/plugins/word-count.mjs in the Nou repo." })] }));
+                }), _jsx(Text, { children: " " }), _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["Starters: Enter adds one to ", PLUGIN_DIRS.find((d) => d.scope === "user").dir, ", where you can edit it."] }), _jsxs(Text, { color: C.dim, wrap: "truncate-end", children: ["Write your own: /plugins new <name>, or drop a .js/.mjs file into ", PLUGIN_DIRS.map((d) => d.dir).join(" or "), ", then press r."] })] }));
     };
     const hints = tab === "Model"
-        ? column === "models" ? "↑↓ choose · Enter use model · ← providers" : "↑↓ provider · Enter/→ pick a model"
-        : tab === "Preferences" ? "↑↓ move · Enter/Space toggle · ←→ change option" : "↑↓ move · Enter toggle · r rescan";
+        ? connecting ? "Enter next · Esc cancel" : column === "models" ? `↑↓ choose · Enter use model · ← providers${provider.connect ? " · k change key" : ""}` : `↑↓ provider · Enter/→ ${provider.unavailable() ? "connect" : "pick a model"}${provider.connect ? " · k change key" : ""}`
+        : tab === "Engine" ? "↑↓ move · Enter use this engine" : tab === "Preferences" ? "↑↓ move · Enter/Space toggle · ←→ change option" : "↑↓ move · Enter toggle · r rescan";
     return (_jsxs(Box, { flexDirection: "column", width: width, height: height, paddingX: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: C.accent2, bold: true, children: "\u2699 Settings  " }), TABS.map((t) => (_jsx(Text, { ...(t === tab ? { backgroundColor: C.accent2, color: "black" } : { color: C.dim }), bold: t === tab, children: ` ${t} ` }, t))), _jsx(Text, { color: C.dim, children: "   current: " }), _jsx(Text, { color: C.green, children: describe(choice) }), _jsxs(Text, { color: C.dim, children: ["   nou v", currentVersion()] })] }), _jsx(Text, { children: " " }), body(), _jsxs(Text, { color: C.dim, children: [" Tab next section \u00B7 ", hints, " \u00B7 Esc close   ", _jsx(Text, { color: C.dim, children: "saved to ~/.nou/config.json" })] })] }));
 }
+/** What a connect field starts with: the current URL to edit (keys stay hidden, so they start empty). */
+function initialValue(f) {
+    return f.secret ? "" : process.env[f.env] ?? "";
+}
+/** Whether a provider error means the API key is wrong (rather than, say, the server being down). */
+const rejectedKey = (error) => /\b(401|403)\b|api key|unauthori[sz]ed|authentication/i.test(error);

package/dist/src/ui/text.js

@@ -98,3 +98,15 @@ export function changedLines(before, after) {
     }
     return lines;
 }
+/** Lines added and removed, for summaries like "+12 -3". */
+export function lineCounts(before, after) {
+    let added = 0;
+    let removed = 0;
+    for (const part of diffLines(before.replace(/\r\n/g, "\n"), after.replace(/\r\n/g, "\n"))) {
+        if (part.added)
+            added += part.count ?? 0;
+        else if (part.removed)
+            removed += part.count ?? 0;
+    }
+    return { added, removed };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nou-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "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": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "dist",
+    "plugins",
     ".env.example",
     "README.md"
   ],
@@ -19,7 +20,8 @@
     "build": "tsc -p tsconfig.build.json && node scripts/copy-grammars.mjs",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit -p .",
-    "lint": "eslint index.ts src",
+    "lint": "eslint index.ts src evals plugins",
+    "eval": "tsx evals/run.ts",
     "prepublishOnly": "npm run build",
     "screenshot": "node -e \"process.env.FORCE_COLOR='3';require('child_process').execSync('npx tsx scripts/screenshot.tsx',{stdio:'inherit'})\"",
     "test": "tsx tests/unit.ts && tsx tests/e2e.tsx"

package/plugins/fetch-url.mjs

@@ -0,0 +1,82 @@
+// Starter plugin: lets the model read a web page (docs, an issue, a changelog) as plain text.
+const MAX_CHARS = 20_000;
+const TIMEOUT_MS = 15_000;
+
+const ENTITIES = { nbsp: " ", lt: "<", gt: ">", quot: "\"", "#39": "'", amp: "&" };
+
+/** Elements whose contents aren't page text. */
+const SKIPPED = new Set(["script", "style", "noscript", "svg"]);
+/** Tags that end a line of text. */
+const BREAKS = new Set(["br", "/p", "/div", "/li", "/tr", "/h1", "/h2", "/h3", "/h4", "/h5", "/h6"]);
+
+/**
+ * Keeps the text between tags. Every "<" starts a tag (page text writes a literal one as &lt;), which
+ * runs to the next ">"; skipped elements lose their contents too. Nothing tag-like can survive.
+ */
+function stripTags(html) {
+  const lower = html.toLowerCase();
+  let out = "";
+  let i = 0;
+  while (i < html.length) {
+    const open = lower.indexOf("<", i);
+    if (open < 0) return out + html.slice(i);
+    out += html.slice(i, open);
+    const end = lower.indexOf(">", open);
+    if (end < 0) return out; // a tag that never closes: the rest is inside it
+    // "p" for <p class=x>, "/p" for </p>, "br" for <br/>.
+    const inner = lower.slice(open + 1, end);
+    const closing = inner.startsWith("/");
+    const name = `${closing ? "/" : ""}${inner.slice(closing ? 1 : 0).split(/[\s/]/)[0]}`;
+    if (BREAKS.has(name)) out += "\n";
+    i = end + 1;
+    if (SKIPPED.has(name)) {
+      const close = lower.indexOf(`</${name}`, i);
+      if (close < 0) return out; // never closed: the rest is its contents
+      const closeEnd = lower.indexOf(">", close);
+      i = closeEnd < 0 ? html.length : closeEnd + 1;
+    }
+  }
+  return out;
+}
+
+/** Rough HTML to text: drops scripts, styles and tags, keeps the words. */
+export function htmlToText(html) {
+  // Entities after the tags, in one pass, so "&amp;lt;" becomes "&lt;", not "<".
+  return stripTags(html)
+    .replace(/&(nbsp|lt|gt|quot|#39|amp);/g, (_, name) => ENTITIES[name])
+    .replace(/[ \t]+/g, " ")
+    .replace(/\n\s*\n+/g, "\n\n")
+    .trim();
+}
+
+async function fetchText(url) {
+  if (!/^https?:\/\//i.test(url)) throw new Error("only http(s) URLs");
+  const response = await fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS), headers: { "user-agent": "nou-fetch-url" } });
+  const type = response.headers.get("content-type") ?? "";
+  const body = await response.text();
+  const text = type.includes("html") ? htmlToText(body) : body;
+  const cut = text.length > MAX_CHARS ? `${text.slice(0, MAX_CHARS)}\n[... ${text.length - MAX_CHARS} more chars cut]` : text;
+  return `${response.status} ${response.statusText} · ${url}\n\n${cut}`;
+}
+
+export default {
+  name: "Fetch URL",
+  version: "0.1.0",
+  description: "Adds a fetch_url tool so the model can read docs and web pages (asks first).",
+
+  tools: [
+    {
+      // Not read-only: it reaches the network, so you approve each URL.
+      definition: {
+        name: "fetch_url",
+        description: "Fetch a web page or file over http(s) and return it as text",
+        parameters: {
+          type: "object",
+          properties: { url: { type: "string", description: "The http(s) URL" } },
+          required: ["url"],
+        },
+      },
+      run: (args) => fetchText(String(args.url)),
+    },
+  ],
+};

package/plugins/project-rules.mjs

@@ -0,0 +1,43 @@
+// Starter plugin: gives the model the instructions you already wrote for other coding agents
+// (AGENTS.md, CLAUDE.md, Cursor and Copilot rules), so you don't have to repeat them in NOU.md.
+import { existsSync, readFileSync } from "fs";
+import path from "path";
+import process from "process";
+
+const FILES = ["AGENTS.md", "CLAUDE.md", "GEMINI.md", ".cursorrules", ".github/copilot-instructions.md"];
+const MAX_CHARS = 8_000;
+
+function readRules(cwd) {
+  return FILES.filter((file) => existsSync(path.join(cwd, file)))
+    .map((file) => {
+      const text = readFileSync(path.join(cwd, file), "utf-8").trim();
+      return { file, text: text.length > MAX_CHARS ? `${text.slice(0, MAX_CHARS)}\n[... cut]` : text };
+    })
+    .filter((rule) => rule.text);
+}
+
+export default {
+  name: "Project rules",
+  version: "0.1.0",
+  description: "Reads AGENTS.md, CLAUDE.md, .cursorrules and Copilot instructions into the system prompt. /rules lists them.",
+
+  // A getter, so edits to those files are picked up whenever the prompt is rebuilt.
+  get systemPrompt() {
+    const rules = readRules(process.cwd());
+    if (!rules.length) return undefined;
+    return `Follow the project's own instructions:\n${rules.map((r) => `--- ${r.file} ---\n${r.text}`).join("\n\n")}`;
+  },
+
+  commands: [
+    {
+      name: "rules",
+      description: "Show which instruction files are in use",
+      run(args, ctx) {
+        const rules = readRules(ctx.cwd);
+        return rules.length
+          ? `Using: ${rules.map((r) => `${r.file} (${r.text.length} chars)`).join(", ")}`
+          : `None found. Looked for ${FILES.join(", ")}.`;
+      },
+    },
+  ],
+};

package/plugins/run-tests.mjs

@@ -0,0 +1,89 @@
+// Starter plugin: lets the model (and you, with /test) run the project's tests.
+// It's yours to edit: set TEST_COMMAND if the guess below picks the wrong command.
+import { spawn } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import path from "path";
+import process from "process";
+
+/** e.g. "npm run test:unit". Leave null to guess from the project files. */
+const TEST_COMMAND = null;
+const TIMEOUT_MS = 5 * 60 * 1000;
+const MAX_OUTPUT = 12_000;
+
+function guessCommand(cwd) {
+  const has = (file) => existsSync(path.join(cwd, file));
+  if (has("package.json")) {
+    const test = JSON.parse(readFileSync(path.join(cwd, "package.json"), "utf-8")).scripts?.test;
+    if (test && !test.includes("no test specified")) {
+      if (has("pnpm-lock.yaml")) return "pnpm test";
+      if (has("yarn.lock")) return "yarn test";
+      if (has("bun.lock") || has("bun.lockb")) return "bun test";
+      return "npm test";
+    }
+  }
+  if (has("Cargo.toml")) return "cargo test";
+  if (has("go.mod")) return "go test ./...";
+  if (has("pyproject.toml") || has("pytest.ini") || has("setup.py") || has("tox.ini")) return "python -m pytest -q";
+  if (has("Makefile") && /^test:/m.test(readFileSync(path.join(cwd, "Makefile"), "utf-8"))) return "make test";
+  return null;
+}
+
+/** Runs the tests; extra arguments (a file, a filter) go after the command. */
+function runTests(cwd, extra) {
+  const base = TEST_COMMAND ?? guessCommand(cwd);
+  if (!base) return Promise.resolve({ command: null, code: null, output: "Couldn't tell how to run this project's tests. Set TEST_COMMAND in the run-tests plugin." });
+  const separator = extra && /^(npm|pnpm) /.test(base) ? " --" : "";
+  const command = extra ? `${base}${separator} ${extra}` : base;
+  return new Promise((resolve) => {
+    let output = "";
+    const child = spawn(command, { cwd, shell: true, env: { ...process.env, CI: "1", FORCE_COLOR: "0" } });
+    const timer = setTimeout(() => child.kill(), TIMEOUT_MS);
+    child.stdout.on("data", (d) => (output += d));
+    child.stderr.on("data", (d) => (output += d));
+    child.on("error", (error) => (output += `\n${error.message}`));
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      // The end of a test run (failures, summary) matters most.
+      const text = output.length > MAX_OUTPUT ? `[... ${output.length - MAX_OUTPUT} chars cut]\n${output.slice(-MAX_OUTPUT)}` : output;
+      resolve({ command, code, output: text.trim() });
+    });
+  });
+}
+
+export default {
+  name: "Run tests",
+  version: "0.1.0",
+  description: "Adds a run_tests tool and /test. Works out npm/pnpm/yarn/bun, cargo, go, pytest or make.",
+  systemPrompt: "After changing code, use run_tests to check your work, and fix any failures you caused.",
+
+  tools: [
+    {
+      // Running tests runs project code, so you approve each run.
+      definition: {
+        name: "run_tests",
+        description: "Run the project's test suite (or part of it) and return the output",
+        parameters: {
+          type: "object",
+          properties: { args: { type: "string", description: "Optional extra arguments, e.g. a test file or name filter" } },
+        },
+      },
+      async run(args, ctx) {
+        const { command, code, output } = await runTests(ctx.cwd, args.args?.trim());
+        return command ? `$ ${command}\nexit code ${code}\n${output}` : output;
+      },
+    },
+  ],
+
+  commands: [
+    {
+      name: "test",
+      description: "Run the tests: /test [args]",
+      async run(args, ctx) {
+        const { command, code, output } = await runTests(ctx.cwd, args.trim());
+        if (!command) return output;
+        const tail = output.split("\n").slice(-25).join("\n");
+        return `${code === 0 ? "✓ passed" : `✗ failed (exit ${code})`}: ${command}\n${tail}`;
+      },
+    },
+  ],
+};

package/plugins/todos.mjs

@@ -0,0 +1,81 @@
+// Starter plugin: finds TODO / FIXME / HACK comments, for you (/todos) and the model (find_todos).
+import { execFileSync } from "child_process";
+import { readdirSync, readFileSync, statSync } from "fs";
+import path from "path";
+
+const MARKERS = /\b(TODO|FIXME|HACK|XXX)\b:?\s*(.*)/;
+const SKIP_DIRS = new Set(["node_modules", ".git", "dist", "build", "out", "target", "vendor", ".venv", "__pycache__", "coverage"]);
+const MAX_FILE_BYTES = 1_000_000;
+const MAX_RESULTS = 200;
+
+/** Files git knows about (so .gitignore is respected), or a plain walk outside a repo. */
+function listFiles(cwd, under) {
+  try {
+    const out = execFileSync("git", ["ls-files", "-co", "--exclude-standard", "--", under || "."], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] });
+    return out.split("\n").filter(Boolean);
+  } catch {
+    const files = [];
+    const walk = (dir) => {
+      for (const name of readdirSync(path.join(cwd, dir))) {
+        if (SKIP_DIRS.has(name) || files.length > 20_000) continue;
+        const rel = path.join(dir, name);
+        if (statSync(path.join(cwd, rel)).isDirectory()) walk(rel);
+        else files.push(rel);
+      }
+    };
+    walk(under || ".");
+    return files;
+  }
+}
+
+function findTodos(cwd, under) {
+  const found = [];
+  for (const file of listFiles(cwd, under)) {
+    if (found.length >= MAX_RESULTS) break;
+    try {
+      const full = path.join(cwd, file);
+      if (statSync(full).size > MAX_FILE_BYTES) continue;
+      const text = readFileSync(full, "utf-8");
+      if (text.includes("\0")) continue; // binary
+      text.split("\n").forEach((line, i) => {
+        const match = MARKERS.exec(line);
+        if (match && found.length < MAX_RESULTS) found.push(`${file.replaceAll("\\", "/")}:${i + 1}  ${match[1]} ${match[2].trim()}`);
+      });
+    } catch {
+      // unreadable or deleted: skip
+    }
+  }
+  return found;
+}
+
+const report = (found) =>
+  found.length ? `${found.length}${found.length === MAX_RESULTS ? "+" : ""} found:\n${found.join("\n")}` : "No TODO/FIXME/HACK comments found.";
+
+export default {
+  name: "TODOs",
+  version: "0.1.0",
+  description: "Lists TODO / FIXME / HACK comments. Adds a find_todos tool and /todos.",
+
+  tools: [
+    {
+      readOnly: true,
+      definition: {
+        name: "find_todos",
+        description: "List TODO, FIXME, HACK and XXX comments in the project (file:line and the note)",
+        parameters: {
+          type: "object",
+          properties: { path: { type: "string", description: "Optional folder to search, relative to the project" } },
+        },
+      },
+      run: (args, ctx) => report(findTodos(ctx.cwd, args.path)),
+    },
+  ],
+
+  commands: [
+    {
+      name: "todos",
+      description: "List TODO/FIXME comments: /todos [folder]",
+      run: (args, ctx) => report(findTodos(ctx.cwd, args.trim())),
+    },
+  ],
+};