@thegitai/cli 1.0.0-preview.45 → 1.0.0-preview.47

package/README.md

@@ -17,10 +17,10 @@ Supports Node.js 22 and newer. Node.js 24 is recommended.
 ## Updates
 
 `ai` checks for a newer release each time it starts, and offers to install it
-for you. TheGitAI serves the current release only, so an older CLI can fail
-partway through a session. Press Enter to update — the CLI installs it and asks
-you to start `ai` again, so the whole session runs one version — or choose
-**Skip** to go on with the version you have. Skipping lasts for that session
+for you. TheGitAI works best on the latest version, and an older CLI may not
+work optimally. **Update now** is already selected, so Enter takes it — the CLI
+installs the update and asks you to start `ai` again, so the whole session runs
+one version — while ↑/↓ moves to **Skip** to go on with the version you have. Skipping lasts for that session
 only; the next start asks again. Ctrl+C quits without installing anything.
 
 ## Usage

package/dist/src/agent-mode.js

@@ -148,12 +148,9 @@ export function agentModeLabel(mode) {
         return 'Bypass all permissions';
     if (mode === 'plan')
         return 'Plan · read-only';
-    return 'Default · asks to edit & run unless permitted';
+    return 'Default · Ask for Approval';
 }
 export function agentModeLabelTiers(mode) {
-    if (mode === 'default') {
-        return [agentModeLabel(mode), 'Default · asks to edit & run'];
-    }
     return [agentModeLabel(mode)];
 }
 export function agentModeShortLabel(mode) {

package/dist/src/browser/bridge.js

@@ -13,6 +13,13 @@ export class BrowserBridgeError extends Error {
         this.code = code;
     }
 }
+function rejectDisconnectedRequests(browser) {
+    for (const pending of browser.pending.values()) {
+        clearTimeout(pending.timer);
+        pending.reject(new BrowserBridgeError(`The browser disconnected while ${pending.op} was in flight, so its outcome is unknown. Check the page before doing anything that could repeat.`, 'disconnected'));
+    }
+    browser.pending.clear();
+}
 function safeUnlink(target) {
     try {
         fs.unlinkSync(target);
@@ -28,15 +35,20 @@ export function startBrowserBridge({ sessionKey, label, cwd, env = process.env,
     if (socketIsFile())
         safeUnlink(socketPath);
     const browsers = new Map();
+    const sockets = new Set();
     const listeners = new Set();
     let selected = null;
+    let everConnected = false;
     let closed = false;
     const registration = registerNativeHost({ env });
     const server = net.createServer((socket) => {
         socket.setNoDelay(true);
+        sockets.add(socket);
         let buffer = '';
         let key = null;
         socket.on('data', (chunk) => {
+            if (socket.destroyed)
+                return;
             buffer += chunk.toString('utf8');
             let newline = buffer.indexOf('\n');
             while (newline !== -1) {
@@ -62,7 +74,12 @@ export function startBrowserBridge({ sessionKey, label, cwd, env = process.env,
                     }
                     const announced = frame.browser?.key ?? crypto.randomUUID();
                     const existing = key ? browsers.get(key) : null;
-                    if (existing) {
+                    const displaced = browsers.get(announced);
+                    if (displaced && displaced.socket !== socket) {
+                        displaced.socket.destroy();
+                        rejectDisconnectedRequests(displaced);
+                    }
+                    if (existing?.socket === socket) {
                         if (announced !== key) {
                             browsers.delete(key);
                             browsers.set(announced, existing);
@@ -82,13 +99,14 @@ export function startBrowserBridge({ sessionKey, label, cwd, env = process.env,
                             selected = announced;
                     }
                     key = announced;
+                    everConnected = true;
                     for (const listener of listeners) {
                         listener('connected', { browser: frame.browser });
                     }
                     continue;
                 }
                 const browser = key ? browsers.get(key) : null;
-                if (!browser)
+                if (!browser || browser.socket !== socket)
                     continue;
                 if (frame.t === 'res') {
                     const pending = browser.pending.get(frame.id);
@@ -109,16 +127,16 @@ export function startBrowserBridge({ sessionKey, label, cwd, env = process.env,
             }
         });
         const drop = () => {
+            sockets.delete(socket);
             if (!key)
                 return;
             const browser = browsers.get(key);
+            if (!browser || browser.socket !== socket)
+                return;
             browsers.delete(key);
             if (selected === key)
                 selected = browsers.keys().next().value ?? null;
-            for (const pending of browser?.pending.values() ?? []) {
-                clearTimeout(pending.timer);
-                pending.reject(new BrowserBridgeError(`The browser disconnected while ${pending.op} was in flight, so its outcome is unknown. Check the page before doing anything that could repeat.`, 'disconnected'));
-            }
+            rejectDisconnectedRequests(browser);
             for (const listener of listeners)
                 listener('disconnected', { browser: key });
         };
@@ -152,7 +170,10 @@ export function startBrowserBridge({ sessionKey, label, cwd, env = process.env,
             return;
         closed = true;
         for (const browser of browsers.values())
-            browser.socket.destroy();
+            rejectDisconnectedRequests(browser);
+        for (const socket of sockets)
+            socket.destroy();
+        sockets.clear();
         browsers.clear();
         server.close();
         safeUnlink(socketPath);
@@ -164,12 +185,21 @@ export function startBrowserBridge({ sessionKey, label, cwd, env = process.env,
         status() {
             return {
                 connected: browsers.size > 0,
+                everConnected,
                 browsers: [...browsers.values()].map((browser) => browser.identity),
                 selected,
                 socketPath,
                 registrationErrors: registration.errors,
             };
         },
+        resync() {
+            if (closed || browsers.size > 0 || sockets.size === 0)
+                return false;
+            for (const socket of sockets)
+                socket.destroy();
+            sockets.clear();
+            return true;
+        },
         selectBrowser(key) {
             if (browsers.has(key))
                 selected = key;

package/dist/src/browser/native-host.js

@@ -201,9 +201,19 @@ export function chromiumProcessRunning(platform = process.platform) {
             timeout: 2000,
             stdio: ['ignore', 'pipe', 'ignore'],
         });
-        return /(google[- ]?chrome|chromium|brave|msedge|microsoft edge|vivaldi)/i.test(output);
+        return output.split('\n').some((line) => isBrowserProcessName(line));
     }
     catch {
         return false;
     }
 }
+const BROWSER_PROCESS_NAME = /^(google[ -]?chrome|chrome|chromium|brave|msedge|microsoft[ -]?edge|vivaldi)/i;
+const NOT_A_BROWSER_PROCESS = /crashpad|crashhandler|native|sandbox|driver|updater?\b/i;
+export function isBrowserProcessName(psLine) {
+    const name = psLine.trim().split('/').pop()?.trim() ?? '';
+    if (!name)
+        return false;
+    if (NOT_A_BROWSER_PROCESS.test(name))
+        return false;
+    return BROWSER_PROCESS_NAME.test(name);
+}

package/dist/src/browser/session-bridge.js

@@ -86,19 +86,31 @@ export function browserAvailability(options) {
     if (status.connected) {
         return {
             connected: true,
+            everConnected: true,
             browsers: status.browsers,
             selected: status.selected,
         };
     }
     const hint = status.registrationErrors.length
         ? `TheGitAI could not register its browser bridge with Chrome: ${status.registrationErrors[0]}`
-        : chromiumProcessRunning()
-            ? 'Chrome is running but the TheGitAI extension has not connected. Install or enable the extension, then reload it from chrome://extensions.'
-            : 'Chrome does not appear to be running. Open Chrome with the TheGitAI extension installed.';
+        : status.everConnected
+            ? 'The browser was connected to this session and dropped. Nothing needs reinstalling — it reconnects on its own, usually within a second or two. If it does not, open the TheGitAI icon in Chrome.'
+            : chromiumProcessRunning()
+                ? 'Chrome is running but the TheGitAI extension has not connected. Install or enable the extension, then reload it from chrome://extensions.'
+                : 'Chrome does not appear to be running. Open Chrome with the TheGitAI extension installed.';
     return {
         connected: false,
+        everConnected: status.everConnected,
         browsers: [],
         selected: null,
         hint,
     };
 }
+export function resyncBrowserBridge(options) {
+    try {
+        return ensureBrowserBridge(options).resync();
+    }
+    catch {
+        return false;
+    }
+}

package/dist/src/help-text.js

@@ -46,10 +46,12 @@ const HELP_MARKDOWN = [
     '## Updates',
     '',
     '- On start, `ai` says when a newer release is published and offers to install',
-    '  it. TheGitAI serves the current release only, so an older CLI can fail',
-    '  partway through a session, in ways the transcript cannot explain.',
-    '- Enter takes the update; the CLI installs it and asks you to start `ai`',
-    '  again, so the whole session runs one version.',
+    '  it. TheGitAI works best on the latest version, and an older CLI may not',
+    '  work optimally.',
+    '- **Update now** is selected when the offer appears, so **Enter** takes the',
+    '  update; **↑/↓** moves to **Skip**, and the number keys still jump straight',
+    '  to a row. The CLI installs the update and asks you to start `ai` again, so',
+    '  the whole session runs one version.',
     '- Skipping starts the session on the version you have and asks again next',
     '  time. A release cannot be silenced for good — that is what keeps a broken',
     '  combination from lasting.',
@@ -64,10 +66,10 @@ const HELP_MARKDOWN = [
     '',
     '## Modes',
     '',
-    '- Default · asks to edit & run unless permitted — asks before creating,',
-    '  editing or deleting files, before running commands, and before touching a',
-    '  website. Each answer can be remembered for the rest of the session, and',
-    '  once it is, Default stops asking for that action; see Safety & approvals.',
+    '- Default · Ask for Approval — asks before creating, editing or deleting',
+    '  files, before running commands, and before touching a website. Each answer',
+    '  can be remembered for the rest of the session, and once it is, Default',
+    '  stops asking for that action; see Safety & approvals.',
     '- Bypass all permissions — approves every command, file edit, deletion and',
     '  browser action for the rest of the session, without asking. Shown in red',
     '  in the footer. Blocked commands stay blocked.',
@@ -117,6 +119,11 @@ const HELP_MARKDOWN = [
     '',
     '## Chat commands',
     '',
+    '- Type `/` to open the command picker. It ranks what you type, so a typo or',
+    '  a stray plural (`/moddel`, `/models`) still finds the command, and a word',
+    '  from the description does too (`/bug` finds `/report`). It shows the five',
+    '  best matches and counts the rest; **↑/↓** chooses, **Tab** or **Enter**',
+    '  accepts, **Esc** closes it.',
     '- `/help` — show this help',
     '- `/about` — show version and platform info',
     '- `/report` — file a bug privately through the TheGitAI website in your',

package/dist/src/tools/browser.js

@@ -3,11 +3,13 @@ import path from 'node:path';
 import { normalizeProjectRelativePath } from '../artifact-policy.js';
 import { BrowserBridgeError } from '../browser/bridge.js';
 import { storeSessionImageBytes } from '../core/session-image-store.js';
-import { browserAvailability, drainBrowserEvents, ensureBrowserBridge, } from '../browser/session-bridge.js';
+import { browserAvailability, drainBrowserEvents, ensureBrowserBridge, resyncBrowserBridge, } from '../browser/session-bridge.js';
 import { ensurePermission, originForUrl } from '../permissions.js';
 const READ_TIMEOUT_MS = 20000;
 const NAVIGATE_TIMEOUT_MS = 45000;
 const MAX_UPLOAD_BYTES = 10 * 1024 * 1024;
+const RECONNECT_GRACE_MS = 2500;
+const SCAN_GRACE_MS = 1200;
 export const READ_ONLY_BROWSER_TOOLS = new Set([
     'browser',
     'browser_tabs',
@@ -31,13 +33,26 @@ function missing(argument, tool) {
         },
     };
 }
-function notConnected(context) {
-    const availability = browserAvailability({
-        cwd: context.rootDir,
-        env: context.env,
-    });
+async function waitForBrowser(options, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    let availability = browserAvailability(options);
+    while (!availability.connected && Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        availability = browserAvailability(options);
+    }
+    return availability;
+}
+async function notConnected(context) {
+    const options = { cwd: context.rootDir, env: context.env };
+    let availability = browserAvailability(options);
     if (availability.connected)
         return { ok: true };
+    if (availability.everConnected) {
+        const grace = resyncBrowserBridge(options) ? RECONNECT_GRACE_MS : SCAN_GRACE_MS;
+        availability = await waitForBrowser(options, grace);
+        if (availability.connected)
+            return { ok: true };
+    }
     return {
         ok: false,
         error: `TheGitAI is not connected to a browser. ${availability.hint ?? ''}`.trim(),
@@ -45,7 +60,9 @@ function notConnected(context) {
         failureDetails: {
             category: 'external_service',
             tool: 'browser',
-            action: 'Report the connection instructions. The extension is a separate installation. Do not retry in a loop or invent a download URL.',
+            action: availability.everConnected
+                ? 'The link to a browser that was working dropped and did not come back. Nothing is missing and nothing needs installing, so do not send the user to reinstall anything. Say what happened, and that reopening the TheGitAI icon in Chrome restores it. Do not retry in a loop.'
+                : 'Report the connection instructions. The extension is a separate installation. Do not retry in a loop or invent a download URL.',
         },
     };
 }
@@ -106,10 +123,10 @@ function attachEvents(result) {
     };
 }
 export async function browserGateway(context) {
+    const guard = await notConnected(context);
+    if (guard.ok === false)
+        return guard;
     const availability = browserAvailability({ cwd: context.rootDir, env: context.env });
-    if (!availability.connected) {
-        return notConnected(context);
-    }
     const platform = availability.browsers[0]?.platform ?? process.platform;
     return {
         ok: true,
@@ -125,7 +142,7 @@ export async function browserGateway(context) {
     };
 }
 export async function browserTabs(context, args) {
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     try {
@@ -139,7 +156,7 @@ export async function browserTabs(context, args) {
     }
 }
 export async function browserTabNew(context) {
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     try {
@@ -151,7 +168,7 @@ export async function browserTabNew(context) {
     }
 }
 export async function browserTabClose(context, args) {
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     const tabId = Number(args.tabId ?? args.tab_id);
@@ -166,7 +183,7 @@ export async function browserTabClose(context, args) {
     }
 }
 export async function browserNavigate(context, args) {
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     const url = String(args.url ?? '').trim();
@@ -199,7 +216,7 @@ export async function browserNavigate(context, args) {
     }
 }
 async function gatedTabCall(context, { tool, op, args, summary, timeoutMs = READ_TIMEOUT_MS, }) {
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     const tabId = Number(args.tabId ?? args.tab_id);
@@ -389,7 +406,7 @@ export async function browserDownloads(context, args) {
             error: `Plan mode blocked browser_downloads ${action}. Listing downloads is allowed; saving or cancelling one changes the user's disk. Switch to Default mode to decide on a download.`,
         };
     }
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     if (action === 'list') {
@@ -459,7 +476,7 @@ export function browserResize(context, args) {
     });
 }
 export async function browserFileUpload(context, args) {
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     const ref = String(args.ref ?? '').trim();
@@ -580,7 +597,7 @@ const BATCH_TOOLS = {
     browser_downloads: browserDownloads,
 };
 export async function browserBatch(context, args) {
-    const guard = notConnected(context);
+    const guard = await notConnected(context);
     if (guard.ok === false)
         return guard;
     const actions = Array.isArray(args.actions) ? args.actions : [];

package/dist/src/ui/repl.js

@@ -7,7 +7,8 @@ import { backendFor, createNotificationQueue, } from './tui/desktop-notification
 import { readPreferences, writePreferences } from '../preferences.js';
 import { createTerminalTitleController } from './tui/terminal-title.js';
 import { captureTerminalWrites, releaseTerminalWrites, } from './tui/terminal-writes.js';
-export { getSlashCommandSuggestions } from './tui/build-frame.js';
+import { getInputCommandToken, getSlashCommandSuggestions, SLASH_COMMANDS, slashCommandMatchesToken, } from './slash-commands.js';
+export { getInputCommandToken, getSlashCommandSuggestions, SLASH_COMMANDS, slashCommandMatchesToken, };
 import { composerInputWidth, frameContentWidth } from './tui/composer-layout.js';
 import { agentModeLabel, nextAgentMode, } from '../agent-mode.js';
 import { chat, models } from '../api/index.js';
@@ -110,52 +111,6 @@ export function buildTurnFailureHintEntries(cancelled) {
         },
     ];
 }
-export const SLASH_COMMANDS = [
-    {
-        command: '/help',
-        description: 'Show available chat commands',
-    },
-    {
-        command: '/about',
-        description: 'Show version and platform info',
-    },
-    {
-        command: '/report',
-        description: 'Report a bug privately on the TheGitAI website',
-    },
-    {
-        command: '/usage',
-        description: 'Show account usage percentage and reset times',
-    },
-    {
-        command: '/model',
-        description: 'Switch the active model',
-    },
-    {
-        command: '/resume',
-        description: 'Open the session picker',
-    },
-    {
-        command: '/jobs',
-        description: 'Background jobs: pick to view output or kill',
-    },
-    {
-        command: '/notify',
-        description: 'Toggle desktop notifications when a turn ends (Ctrl+G)',
-    },
-    {
-        command: '/new',
-        description: 'start a new conversation; this session remains saved',
-    },
-    {
-        command: '/logout',
-        description: 'Sign out and quit',
-    },
-    {
-        command: '/exit',
-        description: 'Quit the current session',
-    },
-];
 export function composerAttachmentsAfterCancel(queuedAttachments, inFlightAttachments) {
     const seen = new Set();
     const kept = [];
@@ -1255,16 +1210,6 @@ export const EXIT_CTRL_C_CONFIRM_MS = 3000;
 export function isExitConfirmActive(exitConfirmUntil, now = Date.now()) {
     return exitConfirmUntil != null && now < exitConfirmUntil;
 }
-export function getInputCommandToken(input) {
-    const trimmed = String(input ?? '').trim();
-    if (!trimmed.startsWith('/'))
-        return '';
-    const firstSpaceIndex = trimmed.indexOf(' ');
-    const token = firstSpaceIndex === -1 ? trimmed : trimmed.slice(0, firstSpaceIndex);
-    if (token.indexOf('/', 1) !== -1)
-        return '';
-    return token;
-}
 function shouldShowCommandPalette(state) {
     const trimmed = String(state.input ?? '').trim();
     return (!state.busy &&
@@ -1272,8 +1217,9 @@ function shouldShowCommandPalette(state) {
         !state.modelPickerOpen &&
         !state.resumePickerOpen &&
         trimmed.startsWith('/') &&
-        !trimmed.includes(' ') &&
-        getInputCommandToken(trimmed) !== '');
+        !String(state.input ?? '').includes(' ') &&
+        getInputCommandToken(trimmed) !== '' &&
+        getSlashCommandSuggestions(trimmed).length > 0);
 }
 export function shouldRemountLiveFrameForComposerInputChange(current, nextInput) {
     const currentShowsCommands = shouldShowCommandPalette(current);
@@ -1296,9 +1242,6 @@ export function applySlashCommandSuggestion(currentInput, suggestion) {
         input: `${before}${suggestion.command}${after}`,
     };
 }
-export function isExactSlashCommandToken(token) {
-    return SLASH_COMMANDS.some((command) => command.command === token);
-}
 export function insertAtCursor(state, text) {
     const before = state.input.slice(0, state.cursor);
     const after = state.input.slice(state.cursor);

package/dist/src/ui/slash-commands.js

@@ -0,0 +1,121 @@
+export const SLASH_COMMANDS = [
+    { command: '/model', description: 'Switch the active model' },
+    { command: '/help', description: 'Show available chat commands' },
+    { command: '/usage', description: 'Show account usage percentage and reset times' },
+    {
+        command: '/resume',
+        description: 'Open the session picker to resume a previous session',
+    },
+    { command: '/new', description: 'start a new conversation; this session remains saved' },
+    { command: '/jobs', description: 'Background jobs: pick to view output or kill' },
+    {
+        command: '/notify',
+        description: 'Toggle desktop notifications when a turn ends (Ctrl+G)',
+    },
+    { command: '/report', description: 'Report a bug privately on the TheGitAI website' },
+    { command: '/about', description: 'Show version and platform info' },
+    { command: '/logout', description: 'Sign out and quit' },
+    { command: '/exit', description: 'Quit the current session', aliases: ['/quit'] },
+];
+export const SLASH_COMMAND_SUGGESTION_LIMIT = 5;
+export function getInputCommandToken(input) {
+    const trimmed = String(input ?? '').trimStart();
+    const match = trimmed.match(/^\/[^\s]*/);
+    const token = match?.[0] ?? '';
+    if (token.indexOf('/', 1) !== -1)
+        return '';
+    return token;
+}
+export function slashCommandMatchesToken(option, token) {
+    return option.command === token || (option.aliases?.includes(token) ?? false);
+}
+const MATCH_EXACT = 0;
+const MATCH_PREFIX = 100;
+const MATCH_OVERTYPED = 200;
+const MATCH_TYPO = 300;
+const MATCH_IN_NAME = 400;
+const MATCH_IN_DESCRIPTION = 500;
+const MATCH_NONE = 600;
+function typoBudget(body) {
+    if (body.length <= 3)
+        return 0;
+    if (body.length <= 5)
+        return 1;
+    return 2;
+}
+function editDistanceWithin(a, b, max) {
+    if (a === b)
+        return 0;
+    if (max <= 0)
+        return null;
+    if (Math.abs(a.length - b.length) > max)
+        return null;
+    const width = b.length + 1;
+    let beforePrevious = [];
+    let previous = Array.from({ length: width }, (_, index) => index);
+    for (let i = 1; i <= a.length; i += 1) {
+        const current = new Array(width);
+        current[0] = i;
+        let best = i;
+        for (let j = 1; j < width; j += 1) {
+            const substitution = a[i - 1] === b[j - 1] ? 0 : 1;
+            let cost = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + substitution);
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                cost = Math.min(cost, beforePrevious[j - 2] + 1);
+            }
+            current[j] = cost;
+            if (cost < best)
+                best = cost;
+        }
+        if (best > max)
+            return null;
+        beforePrevious = previous;
+        previous = current;
+    }
+    const distance = previous[b.length];
+    return distance <= max ? distance : null;
+}
+function scoreSlashCommand(option, token) {
+    const command = option.command;
+    const body = token.slice(1);
+    if (!body)
+        return MATCH_PREFIX;
+    const spellings = [command, ...(option.aliases ?? [])];
+    if (slashCommandMatchesToken(option, token))
+        return MATCH_EXACT;
+    if (spellings.some((spelling) => spelling.startsWith(token)))
+        return MATCH_PREFIX;
+    const overtyped = spellings.find((spelling) => token.startsWith(spelling));
+    if (overtyped) {
+        return MATCH_OVERTYPED + Math.min(token.length - overtyped.length, 99);
+    }
+    const distances = spellings
+        .map((spelling) => editDistanceWithin(body, spelling.slice(1), typoBudget(body)))
+        .filter((distance) => distance !== null);
+    if (distances.length)
+        return MATCH_TYPO + Math.min(...distances);
+    if (command.includes(body))
+        return MATCH_IN_NAME;
+    if (option.description.toLowerCase().includes(body))
+        return MATCH_IN_DESCRIPTION;
+    return MATCH_NONE;
+}
+function rankSlashCommands(input) {
+    const token = getInputCommandToken(input).toLowerCase();
+    if (!token)
+        return [];
+    return SLASH_COMMANDS.map((option, order) => ({
+        option,
+        order,
+        score: scoreSlashCommand(option, token),
+    }))
+        .filter((entry) => entry.score < MATCH_NONE)
+        .sort((a, b) => a.score - b.score || a.order - b.order)
+        .map((entry) => entry.option);
+}
+export function getSlashCommandSuggestions(input) {
+    return rankSlashCommands(input).slice(0, SLASH_COMMAND_SUGGESTION_LIMIT);
+}
+export function getHiddenSlashCommandCount(input) {
+    return Math.max(0, rankSlashCommands(input).length - SLASH_COMMAND_SUGGESTION_LIMIT);
+}

package/dist/src/ui/tui/build-frame.js

@@ -1,6 +1,7 @@
 import { agentModeColor, agentModeLabelTiers, agentModeShortLabel, } from '../../agent-mode.js';
 import { singleLinePreview, truncate } from '../../utils.js';
 import { formatClientTokenUsage } from '../repl.js';
+import { getHiddenSlashCommandCount, getSlashCommandSuggestions, } from '../slash-commands.js';
 import { renderFormattedBodyLines, renderPreformattedBodyLines, } from './markdown-render.js';
 import { displayWidth, line, padToWidth, plainLine, sliceToWidth, span, wrapText, } from './text.js';
 import { isDarkTerminalBackground, mutedColor, mutedStyle } from './terminal-theme.js';
@@ -189,19 +190,6 @@ export function formatPromptDirectoryLabel(projectRoot, homeDir = process.env.HO
 export function formatPromptSessionIdLabel(showSessionId, sessionId) {
     return showSessionId ? String(sessionId ?? '').trim() : '';
 }
-const CLIENT_SLASH_COMMANDS = [
-    { command: '/help', description: 'Show available chat commands' },
-    { command: '/about', description: 'Show version and platform info' },
-    { command: '/usage', description: 'Show account usage percentage and reset times' },
-    { command: '/model', description: 'Switch the active model' },
-    { command: '/resume', description: 'Open the session picker to resume a previous session' },
-    { command: '/jobs', description: 'Background jobs: pick to view output or kill' },
-    { command: '/notify', description: 'Toggle desktop notifications when a turn ends (Ctrl+G)' },
-    { command: '/report', description: 'Report a bug privately on the TheGitAI website' },
-    { command: '/new', description: 'start a new conversation; this session remains saved' },
-    { command: '/logout', description: 'Sign out and quit' },
-    { command: '/exit', description: 'Quit the current session' },
-];
 function buildModelPickerOptions(currentModelId, serverModels) {
     return serverModels.map((model) => ({
         id: model.id,
@@ -213,38 +201,7 @@ function buildModelPickerOptions(currentModelId, serverModels) {
         note: model.description,
     }));
 }
-function getInputCommandToken(input) {
-    const trimmed = String(input ?? '').trimStart();
-    const match = trimmed.match(/^\/[^\s]*/);
-    const token = match?.[0] ?? '';
-    if (token.indexOf('/', 1) !== -1)
-        return '';
-    return token;
-}
-function scoreSlashCommand(option, token) {
-    if (option.command === token)
-        return 0;
-    if (option.command.startsWith(token))
-        return 1;
-    if (option.command.includes(token.slice(1)))
-        return 2;
-    if (option.description.toLowerCase().includes(token.slice(1)))
-        return 3;
-    return 4;
-}
-export function getSlashCommandSuggestions(input) {
-    const token = getInputCommandToken(input).toLowerCase();
-    if (!token)
-        return [];
-    const ranked = [...CLIENT_SLASH_COMMANDS].sort((a, b) => {
-        const scoreDiff = scoreSlashCommand(a, token) - scoreSlashCommand(b, token);
-        if (scoreDiff !== 0)
-            return scoreDiff;
-        return a.command.localeCompare(b.command);
-    });
-    const matches = ranked.filter((option) => scoreSlashCommand(option, token) < 4);
-    return (matches.length ? matches : ranked).slice(0, 5);
-}
+export { getSlashCommandSuggestions };
 function formatModelLabel(modelId, serverModels) {
     return serverModels.find((model) => model.id === modelId)?.label ?? 'Unknown model';
 }
@@ -1061,7 +1018,7 @@ function commandPaletteItemLines(option, selected, innerWidth) {
         modelPickerPanelSideLine(line(span(`${MODEL_PICKER_META_INDENT}${option.description}`, { color: 'gray' })), innerWidth),
     ];
 }
-function buildCommandPalettePanel(suggestions, selectedIndex, width) {
+function buildCommandPalettePanel(suggestions, selectedIndex, hiddenCount, width) {
     const panelWidth = Math.max(28, Math.min(width, MODEL_PICKER_PANEL_MAX_WIDTH));
     const innerWidth = Math.max(1, panelWidth - 4);
     const margin = Array.from({ length: MODEL_PICKER_PANEL_MARGIN_LINES }, () => plainLine(''));
@@ -1080,6 +1037,12 @@ function buildCommandPalettePanel(suggestions, selectedIndex, width) {
             body.push(commandPaletteSeparatorLine(innerWidth));
         }
     });
+    if (hiddenCount > 0) {
+        body.push(commandPaletteSeparatorLine(innerWidth), modelPickerPanelSideLine(plainLine(`  ${hiddenCount} more  •  keep typing to narrow`, {
+            color: 'gray',
+            dim: true,
+        }), innerWidth));
+    }
     body.push(modelPickerPanelSideLine(plainLine(''), innerWidth), modelPickerPanelSideLine(line(span('─'.repeat(innerWidth), { color: MODEL_PICKER_BORDER_COLOR })), innerWidth), modelPickerPanelSideLine(plainLine('↑/↓ choose  •  Tab or Enter accept  •  Esc cancel', { color: 'gray' }), innerWidth), plainLine(`╰${'─'.repeat(panelWidth - 2)}╯`, { color: MODEL_PICKER_BORDER_COLOR }));
     return [...margin, ...body, ...margin];
 }
@@ -1329,7 +1292,7 @@ function buildOverlayLines(state, width, height, nowMs) {
         state.input.trimStart().startsWith('/') &&
         !state.input.includes(' ') &&
         suggestions.length > 0) {
-        lines.push(...buildCommandPalettePanel(suggestions, state.commandCursor, width));
+        lines.push(...buildCommandPalettePanel(suggestions, state.commandCursor, getHiddenSlashCommandCount(state.input), width));
     }
     return lines;
 }

package/dist/src/ui/tui/shell-input.js

@@ -3,7 +3,7 @@ import { moveComposerCursorVertically } from './composer-layout.js';
 import { readClipboardImage, readClipboardText } from '../../core/clipboard.js';
 import { MAX_IMAGES_PER_MESSAGE, MAX_TOTAL_IMAGE_BYTES_PER_MESSAGE, approximateBase64DecodedBytes, totalAttachmentBytes, } from '../../core/image-limits.js';
 import { tryCacheAttachmentBytes } from '../../core/session-image-store.js';
-import { applySlashCommandSuggestion, buildModelPickerOptions, deleteAtCursor, deleteBeforeCursor, getInputCommandToken, getNextApprovalCursor, getNextModelPickerIndex, getSlashCommandSuggestions, insertAtCursor, isExactSlashCommandToken, navigatePromptHistory, shouldRemountLiveFrameForComposerInputChange, } from '../repl.js';
+import { applySlashCommandSuggestion, buildModelPickerOptions, deleteAtCursor, deleteBeforeCursor, getInputCommandToken, getNextApprovalCursor, getNextModelPickerIndex, getSlashCommandSuggestions, insertAtCursor, navigatePromptHistory, shouldRemountLiveFrameForComposerInputChange, slashCommandMatchesToken, } from '../repl.js';
 import { buildPastePlaceholder, shouldCollapsePaste, } from '../paste-collapse.js';
 import { handleUserInputPromptEvent, } from './user-input.js';
 const APPROVAL_PREVIEW_PAGE_ROWS = 3;
@@ -56,7 +56,9 @@ function shouldShowCommandPalette(state) {
         return false;
     }
     const token = getInputCommandToken(state.input);
-    return token.startsWith('/') && !token.includes(' ');
+    if (!token.startsWith('/') || state.input.includes(' '))
+        return false;
+    return getSlashCommandSuggestions(state.input).length > 0;
 }
 function insertPastedText(store, handlers, text) {
     const current = store.getState();
@@ -549,10 +551,10 @@ export function handleShellKeyEvent(store, handlers, event) {
     }
     if (key.returnKey) {
         const token = getInputCommandToken(state.input);
-        if (commandPaletteActive && !isExactSlashCommandToken(token)) {
-            const suggestion = commandSuggestions[Math.min(state.commandCursor, commandSuggestions.length - 1)];
-            if (!suggestion)
-                return;
+        const suggestion = commandSuggestions[Math.min(state.commandCursor, commandSuggestions.length - 1)];
+        if (commandPaletteActive &&
+            suggestion &&
+            !slashCommandMatchesToken(suggestion, token)) {
             store.update((current) => {
                 const nextInput = applySlashCommandSuggestion(current.input, suggestion);
                 prepareForComposerInputChange(current, nextInput.input);

package/dist/src/update-check.js

@@ -1,6 +1,7 @@
 import { spawn } from 'node:child_process';
 import path from 'node:path';
 import { stdin as input, stdout as output } from 'node:process';
+import { emitKeypressEvents } from 'node:readline';
 import readline from 'node:readline/promises';
 import { fileURLToPath } from 'node:url';
 import chalk from './colors.js';
@@ -35,21 +36,55 @@ export function buildUpdateOffer({ currentVersion, latestVersion, moduleDir, })
         display: [program, ...args].join(' '),
     };
 }
-export function formatUpdateScreen(offer) {
+export const UPDATE_OPTIONS = ['update', 'skip'];
+const UPDATE_KEY_HINT = '↑/↓ choose  •  Enter accepts  •  Ctrl+C quits';
+function formatUpdateHeader(offer) {
     return [
         '',
         `  ${chalk.yellow('✨ Update available')} — ${chalk.dim(offer.currentVersion)} → ${chalk.bold(offer.latestVersion)}`,
         '',
-        '  TheGitAI supports the current release only. On an older CLI a session',
-        '  can fail partway through, in ways this terminal cannot explain.',
+        '  TheGitAI works best with the latest version. TheGitAI may not work',
+        '  optimally if not updated.',
         '',
-        `  ${chalk.cyan('1.')} Update now ${chalk.dim(`(runs \`${offer.display}\`)`)}`,
-        `  ${chalk.cyan('2.')} Skip ${chalk.dim('(Agent may not work optimally)')}`,
+    ].join('\n');
+}
+export function formatUpdateOptions(offer, selectedIndex = 0) {
+    const rows = [
+        { note: `(runs \`${offer.display}\`)`, text: 'Update now' },
+        { note: '(Agent may not work optimally)', text: 'Skip' },
+    ];
+    return [
+        ...rows.map(({ note, text }, index) => index === selectedIndex
+            ? `  ${chalk.cyan(`› ${index + 1}. ${text}`)} ${chalk.dim(note)}`
+            : `    ${chalk.dim(`${index + 1}.`)} ${text} ${chalk.dim(note)}`),
         '',
-        `  ${chalk.dim('Press Enter to update, or 2 to skip.')}`,
+        `  ${chalk.dim(UPDATE_KEY_HINT)}`,
         '',
     ].join('\n');
 }
+export function formatUpdateScreen(offer, selectedIndex = 0) {
+    return `${formatUpdateHeader(offer)}\n${formatUpdateOptions(offer, selectedIndex)}`;
+}
+export function readUpdateKey(key, selectedIndex) {
+    const name = key.name ?? '';
+    if (key.ctrl && (name === 'c' || name === 'd')) {
+        return { kind: 'answer', answer: 'cancel' };
+    }
+    if (name === 'return' || name === 'enter') {
+        return { kind: 'answer', answer: UPDATE_OPTIONS[selectedIndex] ?? 'update' };
+    }
+    if (name === 'up' || (name === 'tab' && key.sequence === '\u001b[Z')) {
+        return { kind: 'select', index: Math.max(selectedIndex - 1, 0) };
+    }
+    if (name === 'down' || name === 'tab') {
+        return { kind: 'select', index: Math.min(selectedIndex + 1, UPDATE_OPTIONS.length - 1) };
+    }
+    const digit = Number.parseInt(key.sequence ?? '', 10);
+    if (Number.isInteger(digit) && digit >= 1 && digit <= UPDATE_OPTIONS.length) {
+        return { kind: 'answer', answer: UPDATE_OPTIONS[digit - 1] };
+    }
+    return { kind: 'ignore' };
+}
 export function readUpdateChoice(answer) {
     const value = answer.trim().toLowerCase();
     if (value === '' || value === '1' || value === 'y' || value === 'yes') {
@@ -67,7 +102,56 @@ export async function resolveUpdateAnswer(question) {
         throw error;
     }
 }
-async function askUpdateChoice() {
+export function renderedRowCount(text, columns) {
+    const width = Math.max(1, columns);
+    const lines = text.split('\n');
+    if (lines[lines.length - 1] === '')
+        lines.pop();
+    return lines.reduce((rows, line) => {
+        const visible = [...line.replace(/\x1b\[[0-9;]*m/g, '')].length;
+        return rows + Math.max(1, Math.ceil(visible / width));
+    }, 0);
+}
+async function askUpdateChoiceWithKeys(offer) {
+    let selected = 0;
+    const show = (index) => {
+        const rows = renderedRowCount(`${formatUpdateOptions(offer, selected)}\n`, output.columns ?? 80);
+        selected = index;
+        output.write(`\u001b[${rows}A\u001b[0J${formatUpdateOptions(offer, selected)}\n`);
+    };
+    emitKeypressEvents(input);
+    const wasRaw = input.isRaw === true;
+    input.setRawMode(true);
+    input.resume();
+    try {
+        return await new Promise((resolve) => {
+            const onKeypress = (_text, key) => {
+                const action = readUpdateKey(key ?? {}, selected);
+                if (action.kind === 'ignore')
+                    return;
+                if (action.kind === 'select') {
+                    if (action.index !== selected)
+                        show(action.index);
+                    return;
+                }
+                const chosen = UPDATE_OPTIONS.indexOf(action.answer);
+                if (chosen >= 0 && chosen !== selected)
+                    show(chosen);
+                input.off('keypress', onKeypress);
+                resolve(action.answer);
+            };
+            input.on('keypress', onKeypress);
+        });
+    }
+    finally {
+        if (!wasRaw)
+            input.setRawMode(false);
+        input.pause();
+    }
+}
+async function askUpdateChoice(offer) {
+    if (input.isTTY && output.isTTY)
+        return await askUpdateChoiceWithKeys(offer);
     const rl = readline.createInterface({ input, output });
     try {
         return await resolveUpdateAnswer(() => rl.question('  ▸ '));
@@ -93,7 +177,7 @@ export async function offerUpdateAtStartup({ currentVersion, latestVersion, ask
     if (!offer)
         return 'none';
     write(`${formatUpdateScreen(offer)}\n`);
-    const answer = await ask();
+    const answer = await ask(offer);
     if (answer === 'cancel') {
         write(`\n  ${chalk.dim('Cancelled. Nothing was installed.')}\n\n`);
         return 'cancelled';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegitai/cli",
-  "version": "1.0.0-preview.45",
+  "version": "1.0.0-preview.47",
   "description": "TheGitAI is an agentic AI coding tool for your terminal. It reads and searches your repository, writes and edits files, runs your tests, and verifies the change before handing it back.",
   "keywords": [
     "agentic-ai",
@@ -44,11 +44,11 @@
     "@lydell/node-pty-linux-x64": "1.1.0",
     "@lydell/node-pty-win32-arm64": "1.1.0",
     "@lydell/node-pty-win32-x64": "1.1.0",
-    "@thegitai/tui-darwin-arm64": "1.0.0-preview.45",
-    "@thegitai/tui-darwin-x64": "1.0.0-preview.45",
-    "@thegitai/tui-linux-arm64": "1.0.0-preview.45",
-    "@thegitai/tui-linux-x64": "1.0.0-preview.45",
-    "@thegitai/tui-win32-x64": "1.0.0-preview.45",
+    "@thegitai/tui-darwin-arm64": "1.0.0-preview.47",
+    "@thegitai/tui-darwin-x64": "1.0.0-preview.47",
+    "@thegitai/tui-linux-arm64": "1.0.0-preview.47",
+    "@thegitai/tui-linux-x64": "1.0.0-preview.47",
+    "@thegitai/tui-win32-x64": "1.0.0-preview.47",
     "@vscode/ripgrep": "1.18.0"
   },
   "repository": {