nou-cli 0.3.0 → 0.5.0

package/.env.example

@@ -29,6 +29,7 @@
 # A LiteLLM proxy, or any hosted OpenAI-compatible gateway (full cloud context, unlike NOU_BASE_URL):
 # LITELLM_BASE_URL=http://localhost:4000/v1
 # LITELLM_API_KEY=
+# (LITELLM_PROXY_API_BASE and LITELLM_PROXY_API_KEY, the names LiteLLM's SDK uses, work too.)
 # NOU_MODEL=litellm:<a model name from your proxy>
 # Or skip this file: /connect <provider> inside Nou saves keys to ~/.nou/credentials.json.
 

package/README.md

@@ -76,22 +76,40 @@ Every change is reviewed like a code review:
 
 | Key | Does |
 | --- | --- |
-| 🖱️ Mouse | wheel scrolls the pane under the pointer · click a pane to focus it · click a file to open it (hold <kbd>Shift</kbd> to select text; turn off in settings) |
-| <kbd>Shift</kbd>+<kbd>↑</kbd>/<kbd>↓</kbd>, <kbd>PgUp</kbd>/<kbd>PgDn</kbd> | scroll the chat history |
+| 🖱️ Mouse | wheel scrolls the pane under the pointer (<kbd>Shift</kbd>+wheel or a tilt wheel: sideways) · click or drag a scrollbar to jump · click a file to open it · **click in the code to edit right there**, drag to select · drag a border between panes to resize them (press <kbd>m</kbd> to turn the mouse off and select text in your terminal) |
+| <kbd>PgUp</kbd>/<kbd>PgDn</kbd>, <kbd>Shift</kbd>+<kbd>↑</kbd>/<kbd>↓</kbd> | scroll the chat; scrolled up, new replies wait below instead of yanking the view (<kbd>Ctrl</kbd>+<kbd>End</kbd> jumps back) |
+| <kbd>/</kbd> | start a command from any pane |
 | <kbd>Tab</kbd> | switch between files, code and chat |
+| <kbd>Shift</kbd>+<kbd>Tab</kbd> | ask → auto-edit (edits apply without asking) → auto (commands too); everything stays undoable |
 | <kbd>Ctrl</kbd>+<kbd>P</kbd> | fuzzy-find a file |
-| <kbd>e</kbd> | edit the open file (<kbd>Ctrl</kbd>+<kbd>S</kbd> save · <kbd>Ctrl</kbd>+<kbd>Z</kbd>/<kbd>Y</kbd> undo/redo · <kbd>Ctrl</kbd>+<kbd>K</kbd> info · <kbd>Ctrl</kbd>+<kbd>G</kbd> definition · <kbd>Esc</kbd> close) |
+| <kbd>e</kbd> or a click | edit the open file (see the editor keys below) |
 | <kbd>p</kbd> | Problems panel: every error and warning, <kbd>Enter</kbd> jumps to it |
 | <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: jump to files as Nou reads and edits them |
+| <kbd>f</kbd> | follow mode (off by default): jump to files as Nou reads and edits them |
+| <kbd>&lt;</kbd> / <kbd>&gt;</kbd> / <kbd>=</kbd> | make the focused pane narrower / wider / reset the layout |
+| <kbd>m</kbd> | mouse on/off, so you can select and copy text in the terminal |
 | <kbd>s</kbd> | settings: model, preferences, plugins |
-| <kbd>y</kbd> / <kbd>n</kbd> | accept / reject a proposed edit or command |
+| <kbd>y</kbd> / <kbd>n</kbd> | accept / reject a proposed edit or command, from any pane; the rest of Nou keeps working while it waits (<kbd>o</kbd> shows the edit) |
 | <kbd>Esc</kbd> | stop Nou · close a diff · back to chat |
 | <kbd>Ctrl</kbd>+<kbd>C</kbd> | stop Nou while it works · press twice to quit |
 
-Chat commands: `/settings` · `/model [provider:model]` · `/models [provider]` · `/pull <model>` · `/engine [name]` · `/undo` · `/rewind` · `/history` · `/diff [file or n]` · `/sessions` · `/problems` · `/compact` · `/clear` · `/help`
+In the editor:
+
+| Key | Does |
+| --- | --- |
+| <kbd>Shift</kbd>+arrows, <kbd>Shift</kbd>+<kbd>Home</kbd>/<kbd>End</kbd>, mouse drag | select · <kbd>Ctrl</kbd>+<kbd>A</kbd> select all |
+| <kbd>Ctrl</kbd>+<kbd>C</kbd> / <kbd>X</kbd> / <kbd>V</kbd> | copy / cut / paste (the whole line when nothing is selected); your terminal's own paste works too |
+| <kbd>Ctrl</kbd>+<kbd>←</kbd>/<kbd>→</kbd>, <kbd>Ctrl</kbd>+<kbd>Backspace</kbd> or <kbd>Ctrl</kbd>+<kbd>W</kbd> | move by word, delete a word · <kbd>Ctrl</kbd>+<kbd>Home</kbd>/<kbd>End</kbd> start / end of the file |
+| <kbd>Ctrl</kbd>+<kbd>F</kbd> · <kbd>Ctrl</kbd>+<kbd>L</kbd> | find (<kbd>Enter</kbd>/<kbd>↓</kbd> next, <kbd>Shift</kbd>+<kbd>Enter</kbd>/<kbd>↑</kbd> previous) · go to line |
+| <kbd>Ctrl</kbd>+<kbd>/</kbd> · <kbd>Ctrl</kbd>+<kbd>D</kbd> · <kbd>Alt</kbd>+<kbd>↑</kbd>/<kbd>↓</kbd> | comment the line or selection · duplicate it · move it up / down |
+| <kbd>Tab</kbd> / <kbd>Shift</kbd>+<kbd>Tab</kbd> | indent / outdent (whole lines with a selection) · <kbd>Enter</kbd> keeps the indent, one more after `{`, `(`, `[` |
+| <kbd>Ctrl</kbd>+<kbd>S</kbd> · <kbd>Ctrl</kbd>+<kbd>Z</kbd>/<kbd>Y</kbd> | save (auto-save is on by default) · undo / redo |
+| <kbd>Ctrl</kbd>+<kbd>K</kbd> · <kbd>Ctrl</kbd>+<kbd>G</kbd> | hover info · go to definition (with a language server) |
+| <kbd>Esc</kbd> | clear the selection, or leave the editor |
+
+Chat commands: `/settings` · `/model [provider:model]` · `/models [provider]` · `/pull <model>` · `/engine [name]` · `/auto [ask|auto-edit|auto]` · `/copy [code|file]` · `/undo` · `/rewind` · `/history` · `/diff [file or n]` · `/sessions` · `/problems` · `/compact` · `/clear` · `/help`
 
 ## 🧠 Models
 
@@ -108,9 +126,9 @@ If you haven't set a key, Nou uses the API key from Claude Code (`~/.claude/sett
 | 🖥️ LM Studio | 🟢 local | start its local server |
 | ⚙️ llama.cpp server | 🟢 local | start `llama-server` |
 | 🔧 Any OpenAI-compatible server | 🟢 local | `NOU_BASE_URL`, optional `NOU_API_KEY` |
-| 🚅 LiteLLM proxy or any hosted gateway | ☁️ cloud | `/connect litellm`, or `LITELLM_BASE_URL` + `LITELLM_API_KEY` |
+| 🚅 LiteLLM proxy or any hosted gateway | ☁️ cloud | `/connect litellm`, or `LITELLM_BASE_URL` + `LITELLM_API_KEY` (LiteLLM's `LITELLM_PROXY_API_BASE` + `LITELLM_PROXY_API_KEY` work too) |
 | 🟣 Anthropic (Claude) | ☁️ cloud | `ANTHROPIC_API_KEY` |
-| ⚪ OpenAI | ☁️ cloud | `OPENAI_API_KEY` |
+| ⚪ OpenAI | ☁️ cloud | `OPENAI_API_KEY`, optional `OPENAI_BASE_URL` |
 | 🔷 Google Gemini | ☁️ cloud | `GEMINI_API_KEY` |
 | 🔀 OpenRouter | ☁️ cloud | `OPENROUTER_API_KEY` |
 | ⚡ Groq | ☁️ cloud | `GROQ_API_KEY` |

package/dist/index.js

@@ -14,6 +14,8 @@ import { borrowToolConfig, ensureLocalModel, pickStartingModel } from "./src/set
 import { checkForUpdate, currentVersion, installUpdate, relaunch } from "./src/update/index.js";
 import { lsp } from "./src/lsp/index.js";
 import { App } from "./src/ui/App.js";
+import { installFastOutput } from "./src/ui/fast-output.js";
+import { RENDER_OPTIONS } from "./src/ui/render-options.js";
 const HELP = `nou ${currentVersion()}: an AI coding assistant for your terminal
 
 Usage:
@@ -92,11 +94,8 @@ async function main() {
     p.log.info(`Model: ${chalk.yellow(describe(choice))}  (change it any time with /model)`);
     await ensureProjectContext(choice);
     const permContext = await loadPermanentContext();
-    // Ctrl+C is handled inside the app: press it twice to quit, so a stray press doesn't lose work.
-    const app = render(createElement(App, { initialModel: choice, permContext }), {
-        alternateScreen: true,
-        exitOnCtrlC: false,
-    });
+    await installFastOutput();
+    const app = render(createElement(App, { initialModel: choice, permContext }), RENDER_OPTIONS);
     await app.waitUntilExit();
     lsp.stopAll();
     p.outro(chalk.cyan("Bye bye!"));

package/dist/src/agent/index.js

@@ -1,7 +1,7 @@
 import { randomUUID } from "crypto";
 import { toolDefs } from "../tools/index.js";
 import { applyChange, capOutput, fileTree, isInProject, proposeEdit, proposeWrite, readForModel, runCommand, toRelative, } from "../commands/index.js";
-import { describe } from "../providers/index.js";
+import { describe, keyHint } from "../providers/index.js";
 import { newCallId } from "../providers/ids.js";
 import { globFiles, grep } from "../search/index.js";
 /** Model requests per user message before stopping; real tasks (explore, edit, test, fix) take a few dozen. */
@@ -272,7 +272,8 @@ export class Agent {
                 this.hooks.onEntry({ kind: "info", text: "Cancelled." });
             }
             else {
-                this.hooks.onEntry({ kind: "error", text: `${describe(this.choice)}: ${error.message}` });
+                const hint = keyHint(this.choice.provider, String(error.message));
+                this.hooks.onEntry({ kind: "error", text: `${describe(this.choice)}: ${error.message}${hint ? `\n${hint}` : ""}` });
             }
             this.dropUnansweredCalls();
         }

package/dist/src/config/index.js

@@ -9,13 +9,14 @@ export const DEFAULT_SETTINGS = {
     model: "",
     engine: "nou",
     effort: "high",
-    followMode: true,
+    followMode: false,
     autoApproveEdits: false,
     autoApproveCommands: false,
     gitContext: true,
     autoSave: "delay",
     mouse: true,
     reuseToolConfig: true,
+    paneWidths: null,
     plugins: {},
     trustedPlugins: {},
 };

package/dist/src/env.js

@@ -7,6 +7,9 @@ if (major < 22 || (major === 22 && minor < 12)) {
     console.error(`Nou needs Node.js 22.12 or newer (you have ${process.versions.node}). Get it from https://nodejs.org`);
     process.exit(1);
 }
+// React and Ink pick their build from NODE_ENV when they load: without this every render runs React's
+// development build, which is several times slower and checks every update.
+process.env.NODE_ENV ??= "production";
 // Load the project's .env (API keys, base URLs). Providers read their settings when they load,
 // so loading .env later would be too late for them.
 if (existsSync(".env")) {

package/dist/src/providers/index.js

@@ -1,4 +1,5 @@
 import { loadSettings, saveSettings } from "../config/index.js";
+import { originOf } from "../config/origins.js";
 import { anthropicProvider } from "./anthropic.js";
 import { ollamaProvider } from "./ollama.js";
 import { OPENAI_COMPATIBLE, openAICompatibleProvider } from "./openai.js";
@@ -24,6 +25,21 @@ export function resolveModel(spec) {
     return { provider: providers[0], model: trimmed };
 }
 export const describe = (choice) => `${choice.provider.id}:${choice.model}`;
+/** Whether a provider error means the API key is wrong (rather than, say, the server being down). */
+export const rejectedKey = (error) => /\b(401|403)\b|api key|unauthori[sz]ed|authentication/i.test(error);
+/**
+ * For an error that says the key was rejected: which key, where it was set, and how to fix it.
+ * The usual cause is a project's .env holding a key for the app rather than for Nou.
+ */
+export function keyHint(provider, error) {
+    const key = provider.connect?.find((f) => f.secret)?.env;
+    if (!key || !rejectedKey(error))
+        return null;
+    const origin = originOf(key);
+    const others = providers.filter((p) => p !== provider && !p.local && !p.unavailable()).map((p) => p.id);
+    return `The ${key}${origin ? ` from ${origin}` : ""} was rejected. Enter another with /connect ${provider.id}`
+        + (others.length ? `, or switch with /model ${others.join(" · /model ")}.` : ", or connect another provider (e.g. /connect litellm).");
+}
 /** NOU_MODEL wins, then the model saved in settings, then local Ollama. */
 export function initialModel() {
     if (process.env.NOU_MODEL)

package/dist/src/providers/openai.js

@@ -2,14 +2,16 @@ import OpenAI from "openai";
 import { newCallId } from "./ids.js";
 /** Everything that speaks the OpenAI chat completions API. */
 export const OPENAI_COMPATIBLE = [
-    { id: "openai", label: "OpenAI", baseURL: "https://api.openai.com/v1", keyEnv: "OPENAI_API_KEY", defaultModel: "gpt-5", local: false },
+    { id: "openai", label: "OpenAI", baseURL: "https://api.openai.com/v1", urlEnv: "OPENAI_BASE_URL", keyEnv: "OPENAI_API_KEY", defaultModel: "gpt-5", local: false },
     { id: "gemini", label: "Google Gemini", baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/", keyEnv: "GEMINI_API_KEY", defaultModel: "gemini-2.5-pro", local: false },
     { id: "openrouter", label: "OpenRouter", baseURL: "https://openrouter.ai/api/v1", keyEnv: "OPENROUTER_API_KEY", defaultModel: "anthropic/claude-opus-5-5", local: false },
     { id: "groq", label: "Groq", baseURL: "https://api.groq.com/openai/v1", keyEnv: "GROQ_API_KEY", defaultModel: "llama-3.3-70b-versatile", local: false },
     { id: "deepseek", label: "DeepSeek", baseURL: "https://api.deepseek.com/v1", keyEnv: "DEEPSEEK_API_KEY", defaultModel: "deepseek-chat", local: false },
     { id: "fireworks", label: "Fireworks AI", baseURL: "https://api.fireworks.ai/inference/v1", keyEnv: "FIREWORKS_API_KEY", defaultModel: "accounts/fireworks/models/kimi-k2-instruct", local: false, keyHint: "fireworks.ai/account/api-keys" },
     // A LiteLLM proxy, or any hosted OpenAI-compatible gateway: cloud-sized context, unlike "custom".
-    { id: "litellm", label: "LiteLLM / gateway", baseURL: "", urlEnv: "LITELLM_BASE_URL", keyEnv: "LITELLM_API_KEY", defaultModel: "gpt-5", local: false, keyHint: "your proxy's virtual key or master key" },
+    { id: "litellm", label: "LiteLLM / gateway", baseURL: "", urlEnv: "LITELLM_BASE_URL", keyEnv: "LITELLM_API_KEY", defaultModel: "gpt-5", local: false, keyHint: "your proxy's virtual key or master key",
+        // The names LiteLLM's own SDK uses for a proxy (its litellm_proxy provider).
+        aliases: { url: ["LITELLM_PROXY_API_BASE"], key: ["LITELLM_PROXY_API_KEY"] } },
     { id: "lmstudio", label: "LM Studio", baseURL: "http://localhost:1234/v1", urlEnv: "LMSTUDIO_BASE_URL", defaultModel: "local-model", local: true },
     { id: "llamacpp", label: "llama.cpp server", baseURL: "http://localhost:8080/v1", urlEnv: "LLAMACPP_BASE_URL", defaultModel: "local-model", local: true },
     { id: "custom", label: "Custom OpenAI-compatible", baseURL: "", urlEnv: "NOU_BASE_URL", keyEnv: "NOU_API_KEY", defaultModel: "default", local: true },
@@ -41,8 +43,9 @@ function toOpenAI(system, messages) {
 }
 export function openAICompatibleProvider(preset) {
     // Read when used, not when loaded: keys found in other tools' config (see setup/) are added at startup.
-    const baseURL = () => (preset.urlEnv && process.env[preset.urlEnv]) || preset.baseURL;
-    const apiKey = () => (preset.keyEnv && process.env[preset.keyEnv]) || (preset.local ? "not-needed" : "");
+    const first = (names) => names.map((n) => n && process.env[n]).find(Boolean);
+    const baseURL = () => first([preset.urlEnv, ...(preset.aliases?.url ?? [])]) || preset.baseURL;
+    const apiKey = () => first([preset.keyEnv, ...(preset.aliases?.key ?? [])]) || (preset.local ? "not-needed" : "");
     // Rebuilt when the URL or key changes (they can be entered while Nou runs).
     let client = null;
     const getClient = () => {

package/dist/src/syntax/index.js

@@ -66,8 +66,17 @@ function parse(file, text) {
         load(name);
     if (!lang || typeof lang === "string" || !parser)
         return null;
-    parser.setLanguage(lang);
-    return parser.parse(text);
+    try {
+        parser.setLanguage(lang);
+        return parser.parse(text);
+    }
+    catch {
+        // Some shipped grammars call into the runtime with functions it doesn't have (e.g. YAML's scanner).
+        // Don't use that grammar again; callers fall back to highlight.js.
+        languages.set(name, "failed");
+        parser = new Parser();
+        return null;
+    }
 }
 export function hasGrammar(file) {
     return grammarFor(file) !== undefined;