ikie-cli 0.1.14 → 0.1.15

package/dist/repl.js

@@ -1,7 +1,7 @@
 import * as readline from 'node:readline';
 import { execSync, exec } from 'child_process';
 import { restoreStdinListeners } from './agent.js';
-import { c, PROMPT, CONTINUE_PROMPT, PROMPT_ARROW, printPromptHeader, modeTag, drawBanner, infoLine, successLine, errorLine, THEMES, setTheme, stripAnsi, contextRing, } from './theme.js';
+import { c, PROMPT, CONTINUE_PROMPT, PROMPT_ARROW, printPromptHeader, modeTag, drawBanner, infoLine, successLine, errorLine, THEMES, setTheme, stripAnsi, contextRing, renderSlashMenu, } from './theme.js';
 import { renderMarkdown } from './renderer.js';
 import { loadAllMemory } from './memory.js';
 import { HOME_DIR, saveConfig, DEFAULT_MODEL, IKIE_HOST, IKIE_API_BASE, isLoggedIn, getApiKey } from './config.js';
@@ -102,22 +102,36 @@ const SLASH_CMDS = [
     { name: 'logout', desc: 'Sign out of ikie account' },
     { name: 'exit', desc: 'Exit Ikie' },
 ];
-function slashCompleter(line) {
+/**
+ * Compute live slash-menu items for the current input line.
+ * Returns rich items (name/desc/insert) plus the typed fragment to highlight.
+ */
+function computeSlashMenu(line) {
     if (!line.startsWith('/'))
-        return [[], line];
-    const parts = line.slice(1).split(/\s+/);
+        return { items: [], fragment: '' };
+    const afterSlash = line.slice(1);
+    const parts = afterSlash.split(/\s+/);
     const cmd = parts[0]?.toLowerCase() ?? '';
+    // Sub-command stage: "/cmd <frag>" where cmd has subs.
     if (parts.length >= 2) {
-        const match = SLASH_CMDS.find(c => c.name === cmd);
-        if (match?.subs) {
-            const sub = parts[1].toLowerCase();
-            const hits = match.subs.filter(s => s.name.startsWith(sub)).map(s => `/${cmd} ${s.name}`);
-            return [hits, line];
-        }
-        return [[], line];
+        const match = SLASH_CMDS.find(s => s.name === cmd);
+        if (!match?.subs)
+            return { items: [], fragment: '' };
+        const frag = parts[1].toLowerCase();
+        const items = match.subs
+            .filter(s => s.name.startsWith(frag))
+            .map(s => ({ name: `${cmd} ${s.name}`, desc: s.desc, insert: `/${cmd} ${s.name} ` }));
+        return { items, fragment: frag };
     }
-    const hits = SLASH_CMDS.filter(c => c.name.startsWith(cmd)).map(c => '/' + c.name);
-    return [hits, line];
+    // Command-name stage: "/<frag>".
+    const items = SLASH_CMDS
+        .filter(s => s.name.startsWith(cmd))
+        .map(s => ({
+        name: s.name,
+        desc: s.desc,
+        insert: `/${s.name}${s.subs || s.args ? ' ' : ''}`,
+    }));
+    return { items, fragment: cmd };
 }
 function printHelp() {
     console.log(`
@@ -847,7 +861,6 @@ export async function startREPL(agent, config, projectContext, oneShot) {
         terminal: true,
         historySize: MAX_HISTORY,
         prompt: PROMPT,
-        completer: slashCompleter,
     });
     let multilineBuffer = '';
     let busy = false;
@@ -860,6 +873,77 @@ export async function startREPL(agent, config, projectContext, oneShot) {
     let pasteMode = false;
     let pasteBuffer = '';
     const pastedBlocks = new Map();
+    // ── Live slash-command menu state ──────────────────────────────────────────
+    let currentPrompt = PROMPT; // the prompt string readline is showing
+    let menuOpen = false;
+    let menuItems = [];
+    let menuFragment = '';
+    let menuSel = 0;
+    let menuRows = 0; // menu lines currently drawn below input
+    const inputCol = () => stripAnsi(currentPrompt).length + (rl.cursor ?? 0);
+    const eraseMenu = () => {
+        if (menuRows === 0)
+            return;
+        let out = '\r';
+        for (let i = 0; i < menuRows; i++)
+            out += '\n\x1b[2K';
+        out += `\x1b[${menuRows}A\r`;
+        const col = inputCol();
+        if (col > 0)
+            out += `\x1b[${col}C`;
+        process.stdout.write(out);
+        menuRows = 0;
+    };
+    const drawMenu = () => {
+        eraseMenu();
+        if (!menuOpen || menuItems.length === 0)
+            return;
+        const cols = Math.max(40, process.stdout.columns ?? 80);
+        const rows = renderSlashMenu(menuItems, menuSel, menuFragment, cols);
+        let out = '\r';
+        for (const r of rows)
+            out += `\n\x1b[2K${r}`;
+        out += `\x1b[${rows.length}A\r`;
+        const col = inputCol();
+        if (col > 0)
+            out += `\x1b[${col}C`;
+        process.stdout.write(out);
+        menuRows = rows.length;
+    };
+    const closeMenu = () => {
+        if (!menuOpen && menuRows === 0)
+            return;
+        menuOpen = false;
+        eraseMenu();
+    };
+    const updateMenu = () => {
+        const line = rl.line ?? '';
+        const { items, fragment } = computeSlashMenu(line);
+        // Hide when the sole match is exactly what's typed (nothing left to suggest).
+        const exhausted = items.length === 1 && line === `/${items[0].name}`;
+        if (items.length && line.startsWith('/') && !exhausted) {
+            menuItems = items;
+            menuFragment = fragment;
+            menuSel = 0;
+            menuOpen = true;
+            drawMenu();
+        }
+        else {
+            closeMenu();
+        }
+    };
+    const acceptSelection = () => {
+        if (!menuOpen || !menuItems[menuSel])
+            return;
+        const insert = menuItems[menuSel].insert;
+        eraseMenu();
+        menuOpen = false;
+        // Replace the line via public readline API (cursor→end, kill line, write).
+        rl.write(null, { ctrl: true, name: 'e' });
+        rl.write(null, { ctrl: true, name: 'u' });
+        rl.write(insert);
+        updateMenu(); // a trailing space may surface a sub-command menu
+    };
     const readlineDataListeners = process.stdin.rawListeners('data').slice();
     for (const fn of readlineDataListeners) {
         process.stdin.removeListener('data', fn);
@@ -886,8 +970,52 @@ export async function startREPL(agent, config, projectContext, oneShot) {
     };
     const routeInputData = (data) => {
         const text = data.toString('utf8');
+        // ── Live slash-menu navigation (only while the menu is open) ──
+        if (menuOpen) {
+            if (text === '\x1b[A') {
+                menuSel = (menuSel - 1 + menuItems.length) % menuItems.length;
+                drawMenu();
+                return;
+            }
+            if (text === '\x1b[B') {
+                menuSel = (menuSel + 1) % menuItems.length;
+                drawMenu();
+                return;
+            }
+            if (text === '\t') {
+                acceptSelection();
+                return;
+            }
+            if (text === '\x1b') {
+                closeMenu();
+                return;
+            }
+            if (text === '\r' || text === '\n') {
+                const item = menuItems[menuSel];
+                if (item) {
+                    // Fill the highlighted command. If it takes no args/subs (no trailing
+                    // space) submit it immediately; otherwise keep editing for the arg.
+                    const submit = !item.insert.endsWith(' ');
+                    eraseMenu();
+                    menuOpen = false;
+                    rl.write(null, { ctrl: true, name: 'e' });
+                    rl.write(null, { ctrl: true, name: 'u' });
+                    rl.write(item.insert);
+                    if (submit)
+                        forwardToReadline(Buffer.from('\r'));
+                    else
+                        updateMenu();
+                }
+                else {
+                    closeMenu();
+                    forwardToReadline(data);
+                }
+                return;
+            }
+        }
         // Shift+Tab (CSI Z) → cycle agent⇄plan mode live at the prompt.
         if (text === '\x1b[Z') {
+            closeMenu();
             const next = agent.getMode() === 'agent' ? 'plan' : 'agent';
             agent.setMode(next);
             const saved = rl.line || '';
@@ -900,6 +1028,7 @@ export async function startREPL(agent, config, projectContext, oneShot) {
         }
         // Check for Ctrl+V (0x16) - try to paste image from clipboard
         if (data.length === 1 && data[0] === 0x16) {
+            closeMenu();
             // Check if clipboard has an image
             if (hasClipboardImage()) {
                 try {
@@ -923,6 +1052,7 @@ export async function startREPL(agent, config, projectContext, oneShot) {
             return;
         }
         if (!pasteMode && !text.includes('\x1b[200~') && /[\r\n]/.test(text.trim()) && text.length > 3) {
+            closeMenu();
             const normalized = text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
             rl.write(normalized);
             return;
@@ -946,11 +1076,13 @@ export async function startREPL(agent, config, projectContext, oneShot) {
             const start = rest.indexOf('\x1b[200~');
             if (start === -1) {
                 forwardToReadline(Buffer.from(rest, 'utf8'));
+                updateMenu();
                 return;
             }
             if (start > 0) {
                 forwardToReadline(Buffer.from(rest.slice(0, start), 'utf8'));
             }
+            closeMenu();
             pasteMode = true;
             rest = rest.slice(start + '\x1b[200~'.length);
         }
@@ -976,7 +1108,9 @@ export async function startREPL(agent, config, projectContext, oneShot) {
         return `${expanded}\n\n${attachments.join('\n\n')}`;
     };
     const showPrompt = () => {
+        closeMenu();
         if (multilineBuffer) {
+            currentPrompt = CONTINUE_PROMPT;
             rl.setPrompt(CONTINUE_PROMPT);
         }
         else {
@@ -991,6 +1125,7 @@ export async function startREPL(agent, config, projectContext, oneShot) {
                 const labels = imageState.pending.map(image => `[Image #${image.id}]`).join(' ');
                 process.stdout.write(`${c.muted('   attached')} ${c.secondary(labels)}\n`);
             }
+            currentPrompt = prompt;
             rl.setPrompt(prompt);
         }
         rl.prompt();
@@ -1013,6 +1148,7 @@ export async function startREPL(agent, config, projectContext, oneShot) {
         showPrompt();
     });
     const handleLine = async (raw) => {
+        closeMenu();
         const line = raw.trim();
         if (!line) {
             showPrompt();

package/dist/theme.d.ts

@@ -74,6 +74,13 @@ interface DiffOpts {
 export declare function toolDiffBlock(oldStr: string, newStr: string, ms: number, opts?: DiffOpts): string;
 export declare function toolSuccessLine(ms: number, preview?: string): string;
 export declare function toolErrorLine(msg: string): string;
+export interface SlashMenuItem {
+    name: string;
+    desc: string;
+    insert: string;
+}
+/** Render the live slash-command dropdown as an array of fully-styled rows. */
+export declare function renderSlashMenu(items: SlashMenuItem[], sel: number, fragment: string, cols: number): string[];
 export declare function successLine(msg: string): string;
 export declare function errorLine(msg: string): string;
 export declare function warnLine(msg: string): string;

package/dist/theme.js

@@ -545,6 +545,33 @@ function formatDuration(ms) {
     const s = ms / 1000;
     return s < 10 ? `${s.toFixed(1)}s` : `${Math.round(s)}s`;
 }
+/** Render the live slash-command dropdown as an array of fully-styled rows. */
+export function renderSlashMenu(items, sel, fragment, cols) {
+    if (!items.length)
+        return [];
+    const nameW = Math.min(22, Math.max(...items.map(i => i.name.length)));
+    const frag = fragment.toLowerCase();
+    return items.map((item, i) => {
+        const selected = i === sel;
+        const bar = selected ? c.primary('▌') : ' ';
+        // Highlight the matched prefix within the command name.
+        let name;
+        if (frag && item.name.toLowerCase().startsWith(frag)) {
+            const hit = item.name.slice(0, frag.length);
+            const rest = item.name.slice(frag.length);
+            name = `${c.accent.bold(hit)}${selected ? c.white.bold(rest) : c.white(rest)}`;
+        }
+        else {
+            name = selected ? c.white.bold(item.name) : c.white(item.name);
+        }
+        const namePadded = name + ' '.repeat(Math.max(0, nameW - item.name.length));
+        // Description, clamped to the remaining width.
+        const used = 2 /* bar+space */ + 1 + nameW + 2; // leading "/" + gap
+        const descMax = Math.max(8, cols - used - 2);
+        const desc = item.desc.length > descMax ? item.desc.slice(0, descMax - 1) + '…' : item.desc;
+        return `${bar} ${c.primary('/')}${namePadded}  ${c.dim(desc)}`;
+    });
+}
 export function successLine(msg) {
     return `  ${c.success('ok')} ${c.muted(msg)}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ikie-cli",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Agentic coding CLI — your terminal AI pair programmer",
   "type": "module",
   "bin": {