kodenique-agent 0.8.0 → 0.8.1

package/README.md

@@ -14,7 +14,7 @@ kodenique-agent
 ```
 
 Update with `npm install -g kodenique-agent@latest`.
-A release archive can also be installed with `npm install -g ./kodenique-agent-0.8.0.tgz`.
+A release archive can also be installed with `npm install -g ./kodenique-agent-0.8.1.tgz`.
 
 The wizard asks for their API key (hidden while typing), optional Anthropic workspace ID, model from the live Claude API list, and whether to enable thinking summaries. Use a separate key per teammate; don't include your personal key in the package.
 
@@ -59,11 +59,15 @@ node /path/to/kodenique-agent/cli.mjs /path/to/project
   ❯ 1. Yes
     2. Yes, and auto-approve edits this session
     3. No
+    4. Show full change
+  ↑/↓ to select · Enter to confirm · Esc = No
 
 ⏺ Fixed: getDay() returned the weekday, not the day of month.
   ⎿  Done · 9.4s · session tokens 5120 in / 640 out
 ```
 
+Menus never need typing: approvals, `/model`, `/approval` and `/thinking` open a list. Move with **↑/↓** (or j/k), confirm with **Enter**, press a number to pick directly, and **Esc** cancels (for approvals, Esc means No). Typing `/` shows matching commands under the prompt; use ↑/↓ to highlight one, **Tab** to fill it in, **Enter** to run it.
+
 Keys: **Esc** interrupts the current turn. The partial turn is removed from context and nothing more runs, but a shell command that already started finishes. **Shift+Tab** at the prompt cycles approval modes (ask → auto-edit → auto-all). Replies can use up to 16,000 output tokens (32,000 with thinking).
 
 Thinking is optional. Enable with `/thinking on`, disable with `/thinking off`. It requests adaptive thinking with summarized display; use a compatible model such as Sonnet 4.6. Summaries are exactly what the API returns, not full private reasoning. Claude can skip thinking for simple prompts. Thinking can consume additional tokens, and the app makes no fixed-cost guarantee.
@@ -84,7 +88,7 @@ Thinking is optional. Enable with `/thinking on`, disable with `/thinking off`.
 | `/help` | Show help |
 | `/compact` | Replace the conversation with a model-written summary to free up context |
 | `/clear` | Reset conversation context |
-| `/thinking on` or `/thinking off` | Toggle thinking for this session |
+| `/thinking` (or `/thinking on`/`off`) | Choose thinking on or off for this session |
 | `/usage` | Show reported session input/output tokens |
 | `/exit` or Ctrl+C | Exit |
 
@@ -112,7 +116,7 @@ The package allowlist contains only the CLI, agent, stream parser, config and mo
 
 ## Validation and protocol
 
-Fourteen tests cover file restrictions and approvals, concurrent edits, real local HTTP request/response and errors, workspace headers, fragmented streamed thinking/text/tool JSON, signature preservation, interrupted streams, private config/environment overrides, paginated model discovery/selection, approval mode enforcement, UI previews, and local project selection/completion. They do not establish live model availability or account billing. No live Claude request was made for this release.
+Sixteen tests cover file restrictions and approvals, concurrent edits, real local HTTP request/response and errors, workspace headers, fragmented streamed thinking/text/tool JSON, signature preservation, interrupted streams, private config/environment overrides, paginated model discovery/selection, approval mode enforcement, UI previews, and local project selection/completion. They do not establish live model availability or account billing. No live Claude request was made for this release.
 
 API contract: POST `https://api.anthropic.com/v1/messages`, `x-api-key`, `anthropic-version: 2023-06-01`, optional `anthropic-workspace-id`. Streaming uses SSE. Thinking blocks/signatures are preserved in conversation history, followed by all matching tool results.
 

package/cli.mjs

@@ -5,11 +5,13 @@ import {commands,completeCommand,resolveProject} from './commands.mjs';
 import { executeTool, printable, requestMessage, runTurn } from './agent.mjs';
 import {createUI,parseArgs,approvalModes,nextMode,VERSION} from './ui.mjs';
 import {turnHandlers} from './render.mjs';
+import {createInputFrame} from './input.mjs';
+import {createKeys,select} from './select.mjs';
 import { pickModel } from './models.mjs';
 import { configPath, loadConfig, saveConfig, resolveConfig } from './config.mjs';
 
 const args=process.argv.slice(2);
-const help=`kodenique-agent [project-folder] [--approval ask|auto-edit|auto-all]\nkodenique-agent --auto      Auto-approve edits and commands for this session\nkodenique-agent setup       Configure your own API key and workspace\nkodenique-agent --version\n\nChat: / /project [folder] /files /approval /status /model /models /help /compact /clear /thinking on|off /usage /exit\nEnvironment overrides: ANTHROPIC_API_KEY, ANTHROPIC_WORKSPACE_ID,\nANTHROPIC_MODEL, ANTHROPIC_THINKING=on|off\nRequires Node.js 22+, macOS or Linux. Ask is the default. Auto-all runs shell commands with your full permissions.`;
+const help=`kodenique-agent [project-folder] [--approval ask|auto-edit|auto-all]\nkodenique-agent --auto      Auto-approve edits and commands for this session\nkodenique-agent setup       Configure your own API key and workspace\nkodenique-agent --version\n\nChat: / /project [folder] /files /approval /status /model /models /help /compact /clear /thinking [on|off] /usage /exit\nEnvironment overrides: ANTHROPIC_API_KEY, ANTHROPIC_WORKSPACE_ID,\nANTHROPIC_MODEL, ANTHROPIC_THINKING=on|off\nRequires Node.js 22+, macOS or Linux. Ask is the default. Auto-all runs shell commands with your full permissions.`;
 if(args.includes('--help')) { console.log(help); process.exit(0); }
 if(args.includes('--version')) { console.log(`kodenique-agent ${VERSION}`); process.exit(0); }
 let options;
@@ -17,11 +19,12 @@ try { options=parseArgs(args); } catch(e) {console.error(e.message);process.exit
 const state={approval:options.mode,approving:false};
 let turn=null;
 if(!process.stdin.isTTY) { console.error('Run in an interactive terminal.'); process.exit(1); }
-let muted=false;
-const terminalOutput=new Writable({write(chunk,encoding,done){ if(!muted) process.stdout.write(chunk); done(); }});
+let muted=false,input=null;
+const terminalOutput=new Writable({write(chunk,encoding,done){ if(!muted) {process.stdout.write(chunk);input?.schedule();} done(); }});
 terminalOutput.isTTY=true;
-const rl=createInterface({input:process.stdin,output:terminalOutput,terminal:true,completer:completeCommand});
-rl.on('SIGINT',()=>{ muted=false; console.log('\nExited.'); rl.close(); process.exit(130); });
+const keys=createKeys();
+const rl=createInterface({input:keys.input,output:terminalOutput,terminal:true,completer:completeCommand});
+rl.on('SIGINT',()=>{ muted=false; process.stdout.write('\r\n\x1b[0J'); console.log('Exited.'); rl.close(); process.exit(130); });
 const ask=async(prompt,secret=false)=>{
   if(!secret) return (await rl.question(prompt)).trim();
   process.stdout.write(prompt); muted=true;
@@ -32,18 +35,13 @@ let config;
 const clean=value=>printable(config?.key ? String(value).split(config.key).join('[REDACTED]') : value);
 const show=value=>console.log(clean(value));
 const ui=createUI(clean);
+const choose=opts=>select({keys,ui,...opts});
+input=createInputFrame({rl,ui,keys,onShiftTab:()=>{state.approval=nextMode(state.approval);},getStatus:()=>ui.modeLine({...frame,mode:state.approval})});
 const commandMenu=()=>{ui.label('Commands · type a command, Tab completes');for(const [command,description] of commands) show(`  ${command.padEnd(16)} ${description}`);};
 let chatPrompt=false;
-let frame=null;
+let frame={model:'',root:'',thinking:false};
 process.stdin.on('keypress',(text,key)=>{
   if(key?.name==='escape' && turn && !state.approving) turn.abort();
-  if(chatPrompt && frame && key?.name==='tab' && key.shift) {
-    state.approval=nextMode(state.approval);
-    process.stdout.write('\x1b7\x1b[1A\r\x1b[2K'+ui.modeLine({...frame,mode:state.approval})+'\x1b8');
-  }
-  if(chatPrompt && text==='/' && rl.line==='/') {
-    process.stdout.write('\n'); commandMenu(); rl.prompt(true);
-  }
 });
 try {
   const saved=await loadConfig(); config=resolveConfig(saved);
@@ -53,7 +51,7 @@ try {
     if(!key) throw Error('API key required.');
     const workspaceId=await ask(`Anthropic workspace ID [${config.workspaceId||'optional for scoped keys'}] (- clears): `);
     const selectedWorkspace=workspaceId==='-'?'':workspaceId||config.workspaceId||'';
-    const model=await pickModel({...config,key,workspaceId:selectedWorkspace},{ask,show});
+    const model=await pickModel({...config,key,workspaceId:selectedWorkspace},{ask,show,choose});
     const thinking=await ask(`Enable Claude thinking summaries? [${config.thinking?'Y/n':'y/N'}]: `);
     const next={key,workspaceId:selectedWorkspace,model:model||config.model,thinking:thinking?thinking.toLowerCase()==='y':config.thinking};
     await saveConfig(next); config=resolveConfig(next);
@@ -68,8 +66,9 @@ try {
     while(!rl.closed) {
       chatPrompt=true;
       frame={model:config.model,root,thinking:config.thinking};
-      ui.inputFrame({...frame,mode:state.approval});
+      input.open();
       const prompt=await ask(ui.prompt(state.approval));
+      input.close(prompt);
       chatPrompt=false;
       if(!prompt) continue;
       if(prompt==='/exit') break;
@@ -92,7 +91,7 @@ try {
       if(prompt==='/help') { show(help); continue; }
       if(prompt==='/clear') { messages=[]; show('Conversation cleared.'); continue; }
       if(prompt==='/model' || prompt==='/models') {
-        const model=await pickModel(config,{ask,show});
+        const model=await pickModel(config,{ask,show,choose});
         if(model!==config.model) {
           try { await saveConfig({...await loadConfig(),model}); }
           catch(e) { show(`Could not save model: ${e.message}. Current model unchanged.`);continue; }
@@ -104,7 +103,7 @@ try {
       }
       if(prompt==='/status') {ui.header({model:config.model,root,mode:state.approval,thinking:config.thinking});continue;}
       if(prompt==='/approval' || prompt.startsWith('/approval ')) {
-        const next=prompt==='/approval'?await ask(`Approval mode: ask / auto-edit / auto-all [${state.approval}]: `):prompt.slice(10).trim();
+        const next=prompt==='/approval'?approvalModes[await choose({title:'Approval mode',initial:approvalModes.indexOf(state.approval),options:[{label:'ask',hint:'ask before edits & commands'},{label:'auto-edit',hint:'auto-approve file edits, ask for commands'},{label:'auto-all',hint:'auto-approve edits and shell commands'}]})]:prompt.slice(10).trim();
         if(!next) continue;
         if(!approvalModes.includes(next)) {ui.error('Choose ask, auto-edit, or auto-all.');continue;}
         state.approval=next;ui.success(`Approval mode: ${state.approval} (this session only)`);
@@ -125,6 +124,7 @@ try {
         continue;
       }
       if(prompt==='/usage') { show(`Session usage: ${usage.input} input / ${usage.output} output tokens (reported by API).`); continue; }
+      if(prompt==='/thinking') {const i=await choose({title:'Thinking summaries',initial:config.thinking?0:1,options:[{label:'On',hint:'show thinking summaries (uses more tokens)'},{label:'Off'}]});if(i>=0){config.thinking=i===0;ui.done(`Thinking summaries ${config.thinking?'on':'off'} for this session`);}continue;}
       if(prompt==='/thinking on' || prompt==='/thinking off') { config.thinking=prompt.endsWith(' on'); show(`Thinking summaries ${config.thinking?'on':'off'} for this session.`); continue; }
       if(prompt.startsWith('/')) { show('Unknown command. Use /help.'); continue; }
       const before=messages.length;
@@ -132,7 +132,7 @@ try {
       const start=Date.now();
       turn=new AbortController();
       try {
-        const {request,execute}=turnHandlers({ui,config,root,ask,show,state,signal:turn.signal});
+        const {request,execute}=turnHandlers({ui,config,root,choose,show,state,signal:turn.signal});
         await runTurn({messages,streamed:true,signal:turn.signal,output:show,onUsage:u=>{usage.input+=u.input_tokens||0;usage.output+=u.output_tokens||0;},request,execute});
         ui.done(`Done · ${((Date.now()-start)/1000).toFixed(1)}s · session tokens ${usage.input} in / ${usage.output} out`);
       } catch(e) {

package/commands.mjs

@@ -7,8 +7,7 @@ export const commands=[
  ['/files','List files in the current project'],
  ['/model','Fetch and choose a Claude model'],
  ['/approval','Choose ask, auto-edit, or auto-all'],
- ['/thinking on','Enable thinking summaries'],
- ['/thinking off','Disable thinking summaries'],
+ ['/thinking','Turn thinking summaries on or off'],
  ['/status','Show project, model, and approval mode'],
  ['/usage','Show session token usage'],
  ['/compact','Summarize the conversation to free up context'],

package/input.mjs

@@ -0,0 +1,93 @@
+import { commands } from './commands.mjs';
+
+const ANSI = /\x1b\[[0-9;]*m/g;
+const plain = s => String(s).replace(ANSI, '');
+
+// Commands matching what's typed so far ("/co" → /compact).
+export function commandMatches(line) {
+  if (!line.startsWith('/') || line.includes(' ')) return [];
+  return commands.filter(([c]) => c.startsWith(line));
+}
+
+// Claude Code–style input: a rule above and below the prompt, with the mode
+// line (or selectable /command suggestions) underneath. Readline clears
+// everything below the cursor on refresh, so the footer is redrawn after writes.
+export function createInputFrame({ rl, ui, getStatus, keys, onShiftTab, output = process.stdout }) {
+  let active = false, pending = false, selected = 0, lastLine = '', unhook = null;
+  const cols = () => Math.max(20, output.columns || 80);
+  const rule = () => ui.paint('2', '─'.repeat(cols() - 1));
+  const fit = row => (plain(row).length < cols() ? row : ui.paint('2', plain(row).slice(0, cols() - 2) + '…'));
+  const rowsOf = text => {
+    try { return rl._getDisplayPos(text).rows; } catch { return Math.floor(plain(text).length / cols()); }
+  };
+  const matches = () => {
+    const line = rl.line || '';
+    if (line !== lastLine) { lastLine = line; selected = 0; }
+    const found = commandMatches(line).slice(0, 8);
+    if (selected >= found.length) selected = 0;
+    return found;
+  };
+
+  const footer = () => {
+    const line = rl.line || '';
+    const found = matches();
+    const rows = found.length
+      ? found.map(([c, d], i) => (i === selected ? ui.paint('38;5;209', '❯ ' + c.padEnd(16)) : '  ' + ui.paint('36', c.padEnd(16))) + ui.paint('2', d))
+      : line.startsWith('/') && !line.includes(' ') ? [ui.paint('2', '  No matching commands')] : [getStatus()];
+    if (found.length) rows.push(ui.paint('2', '  ↑/↓ to select · Tab to fill in · Enter to run'));
+    return [rule(), ...rows].map(fit);
+  };
+
+  const draw = () => {
+    pending = false;
+    if (!active) return;
+    const { rows, cols: col } = rl.getCursorPos();
+    const end = Math.max(rows, rowsOf(rl.getPrompt() + (rl.line || '')));
+    const f = footer();
+    output.write(
+      (end > rows ? `\x1b[${end - rows}B` : '') + '\r\n' +
+      f.map(r => '\x1b[2K' + r).join('\r\n') + '\x1b[0J' +
+      `\x1b[${f.length + end - rows}A\x1b[${col + 1}G`,
+    );
+  };
+
+  // Replace the typed line as if the user had typed it.
+  const setLine = text => {
+    rl.write(null, { ctrl: true, name: 'e' });
+    rl.write(null, { ctrl: true, name: 'u' });
+    rl.write(text);
+    lastLine = rl.line || ''; selected = 0;
+  };
+
+  const hook = (s, key = {}) => {
+    if (key.name === 'tab' && key.shift) { onShiftTab?.(); frame.schedule(); return true; }
+    const found = matches();
+    if (!found.length) return false;
+    if (key.name === 'up') { selected = (selected - 1 + found.length) % found.length; frame.schedule(); return true; }
+    if (key.name === 'down') { selected = (selected + 1) % found.length; frame.schedule(); return true; }
+    if (key.name === 'tab') { setLine(found[selected][0]); return true; }
+    if (key.name === 'return' || key.name === 'enter') {
+      if (!commands.some(([c]) => c === (rl.line || '').trim())) setLine(found[selected][0]);
+      return false; // let readline submit the line
+    }
+    return false;
+  };
+
+  const frame = {
+    schedule() { if (active && !pending) { pending = true; setImmediate(draw); } },
+    open() {
+      output.write('\n' + rule() + '\n');
+      active = true; selected = 0; lastLine = '';
+      unhook = keys?.push(hook) ?? null;
+    },
+    // After Enter: remove the frame and echo the message like Claude Code.
+    close(answer) {
+      active = false; unhook?.(); unhook = null;
+      const up = rowsOf(rl.getPrompt() + answer) + 2;
+      output.write(`\x1b[${up}A\r\x1b[0J`);
+      if (answer) output.write(ui.paint('2', '> ') + plain(ui.paint('0', answer)) + '\n');
+    },
+  };
+  output.on?.('resize', () => frame.schedule());
+  return frame;
+}

package/models.mjs

@@ -20,12 +20,17 @@ export async function listModels(config) {
   throw Error('Model list exceeded pagination limit');
 }
 
-export async function pickModel(config,{ask,show}) {
+export async function pickModel(config,{ask,show,choose}) {
   show('Fetching models from Claude…');
   let models;
   try { models=await listModels(config); }
   catch(e) { show(`Could not fetch models: ${e.message}`); return config.model; }
   if(!models.length) { show('No available models returned. Keeping current model.');return config.model; }
+  if(choose) {
+    const current=Math.max(0,models.findIndex(m=>m.id===config.model));
+    const i=await choose({title:'Select a model',initial:current,options:models.map(m=>({label:m.display_name||m.id,hint:m.id+(m.id===config.model?' · current':'')+(m.lifecycle==='deprecated'?' · deprecated':'')}))});
+    return i<0?config.model:models[i].id;
+  }
   models.forEach((m,i)=>show(`${i+1}. ${m.display_name||m.id} · ${m.id}${m.id===config.model?' [current]':''}${m.lifecycle==='deprecated'?' [deprecated]':''}`));
   while(true) {
     const choice=await ask(`Choose number or model ID (Enter keeps ${config.model}): `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodenique-agent",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Your team's terminal coding agent, powered directly by the Claude API",
   "type": "module",
   "engines": {
@@ -21,6 +21,8 @@
     "models.mjs",
     "ui.mjs",
     "render.mjs",
+    "input.mjs",
+    "select.mjs",
     "commands.mjs",
     "README.md"
   ],

package/render.mjs

@@ -20,7 +20,7 @@ export function summarize(call, result) {
   return [text.slice(0, 200)];
 }
 
-export function turnHandlers({ ui, config, root, ask, show, state, signal, output = process.stdout }) {
+export function turnHandlers({ ui, config, root, choose, show, state, signal, output = process.stdout }) {
   const request = async history => {
     let open = false, mode = null, pending = '';
     const key = config.key || '\0';
@@ -58,22 +58,21 @@ export function turnHandlers({ ui, config, root, ask, show, state, signal, outpu
     if (write) ui.diff(editPreview(action.before, action.after));
     else ui.note('     $ ' + action.command);
     if (autoApproves(state.approval, action.tool)) { ui.done(`Auto-approved (${state.approval})`); return true; }
-    ui.approvalMenu({
-      question: write ? `Do you want to ${action.before == null ? 'create' : 'make this edit to'} ${action.path}?` : 'Do you want to run this command?',
-      optionTwo: write ? 'Yes, and auto-approve edits this session' : "Yes, and don't ask again for commands this session",
-    });
+    const question = write ? `Do you want to ${action.before == null ? 'create' : 'make this edit to'} ${action.path}?` : 'Do you want to run this command?';
+    const options = ['Yes', write ? 'Yes, and auto-approve edits this session' : "Yes, and don't ask again for commands this session", 'No', { label: 'Show full change', hint: write ? 'complete before/after' : 'complete command' }];
     state.approving = true;
     try {
       for (;;) {
-        const a = String((await ask('  ❯ ')) ?? '').trim().toLowerCase();
-        if (a === '/full') { show(description); continue; }
-        if (['1', 'y', 'yes'].includes(a)) return true;
-        if (a === '2') {
+        output.write('\n');
+        const i = await choose({ title: question, options, footer: '↑/↓ to select · Enter to confirm · Esc = No' });
+        if (i === 3) { show(description); continue; }
+        if (i === 0) { ui.done('Approved'); return true; }
+        if (i === 1) {
           state.approval = write && state.approval !== 'auto-all' ? 'auto-edit' : 'auto-all';
-          ui.done(`Approval mode: ${state.approval} (this session)`);
+          ui.done(`Approved · approval mode: ${state.approval} (this session)`);
           return true;
         }
-        return false;
+        ui.done('Denied'); return false;
       }
     } finally { state.approving = false; }
   };

package/select.mjs

@@ -0,0 +1,65 @@
+import { EventEmitter } from 'node:events';
+import { emitKeypressEvents } from 'node:readline';
+
+// Readline reads keys from this proxy, so menus can claim keys first.
+// Ctrl+C always reaches readline so exiting keeps working.
+export function createKeys(stdin = process.stdin) {
+  emitKeypressEvents(stdin);
+  const input = new EventEmitter();
+  input.isTTY = true;
+  input.setRawMode = mode => { stdin.setRawMode?.(mode); return input; };
+  input.resume = () => { stdin.resume(); return input; };
+  input.pause = () => { stdin.pause(); return input; };
+  const hooks = [];
+  const dispatch = (s, key) => {
+    if (!(key?.ctrl && key.name === 'c')) for (let i = hooks.length - 1; i >= 0; i--) if (hooks[i](s, key)) return;
+    input.emit('keypress', s, key);
+  };
+  stdin.on('keypress', dispatch);
+  return {
+    input,
+    dispatch,
+    // A hook returns true to swallow the key. Returns a remover.
+    push(hook) { hooks.push(hook); return () => { const i = hooks.lastIndexOf(hook); if (i >= 0) hooks.splice(i, 1); }; },
+  };
+}
+
+// Arrow-key menu. Resolves to the chosen index, or -1 on Esc.
+// options: strings or {label, hint}.
+export function select({ keys, ui, output = process.stdout, title, options, initial = 0, footer = '↑/↓ to select · Enter to confirm · Esc to cancel', max = 10 }) {
+  const items = options.map(o => (typeof o === 'string' ? { label: o } : o));
+  let index = Math.min(Math.max(initial, 0), items.length - 1), drawn = 0;
+  const render = () => {
+    const start = Math.max(0, Math.min(index - Math.floor(max / 2), items.length - max));
+    const visible = items.slice(start, start + max);
+    const rows = [];
+    if (title) rows.push('  ' + ui.paint('1', title));
+    if (start > 0) rows.push(ui.paint('2', `    ↑ ${start} more`));
+    visible.forEach((item, n) => {
+      const i = start + n, text = `${i + 1}. ${item.label}`;
+      const hint = item.hint ? ui.paint('2', '  ' + item.hint) : '';
+      rows.push(i === index ? '  ' + ui.paint('38;5;209', '❯ ' + text) + hint : '    ' + text + hint);
+    });
+    if (start + max < items.length) rows.push(ui.paint('2', `    ↓ ${items.length - start - max} more`));
+    rows.push(ui.paint('2', '  ' + footer));
+    const up = drawn > 1 ? `\x1b[${drawn - 1}A` : '';
+    output.write((drawn ? up + '\r' : '\x1b[?25l') + rows.map(r => '\x1b[2K' + r).join('\n') + '\x1b[0J');
+    drawn = rows.length;
+  };
+  return new Promise(resolve => {
+    const finish = value => {
+      remove();
+      output.write((drawn > 1 ? `\x1b[${drawn - 1}A` : '') + '\r\x1b[0J\x1b[?25h');
+      resolve(value);
+    };
+    const remove = keys.push((s, key = {}) => {
+      if (key.name === 'up' || key.name === 'k' || (key.name === 'p' && key.ctrl)) { index = (index - 1 + items.length) % items.length; render(); }
+      else if (key.name === 'down' || key.name === 'j' || (key.name === 'n' && key.ctrl)) { index = (index + 1) % items.length; render(); }
+      else if (key.name === 'return' || key.name === 'enter') finish(index);
+      else if (key.name === 'escape') finish(-1);
+      else if (/^[1-9]$/.test(s || '') && Number(s) <= items.length) { index = Number(s) - 1; render(); finish(index); }
+      return true; // menus swallow every other key
+    });
+    render();
+  });
+}

package/ui.mjs

@@ -1,5 +1,5 @@
 import os from 'node:os';
-export const VERSION='0.8.0';
+export const VERSION='0.8.1';
 export const nextMode=mode=>approvalModes[(approvalModes.indexOf(mode)+1)%approvalModes.length];
 export const approvalModes=['ask','auto-edit','auto-all'];
 export function autoApproves(mode,tool) {
@@ -88,7 +88,7 @@ export function createUI(clean,output=process.stdout) {
       line(paint('2',' Tips for getting started:'));
       line(paint('2','  1. Ask questions, edit files, or run commands in this project'));
       line(paint('2','  2. Be specific for the best results'));
-      line(paint('2','  3. Type / for commands, Tab to complete, /project to switch folders'));
+      line(paint('2','  3. Type / for commands (↑/↓ to pick, Enter to run) · shift+tab switches approval mode'));
     },
     commandMenu:commands=>{
       for(const [command,description] of commands) line('  '+paint('36',command.padEnd(16))+paint('2',description));