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

package/README.md

@@ -14,6 +14,15 @@ npm i -g @thegitai/cli
 
 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
+only; the next start asks again. Ctrl+C quits without installing anything.
+
 ## Usage
 
 ```text
@@ -69,12 +78,18 @@ The agent can pause its current turn to ask up to four related questions in one
 form. Use **↑ / ↓**, the displayed option number, or **Enter** to choose, and
 **← / →** to move between questions. **Something else / add details** is the
 numbered final option; focus it and type, paste, or press **Enter** to add a
-single-line note. On single-select questions it is mutually exclusive with the
-listed choices, and **↑ / ↓** leaves its editor when the note is empty.
+single-line note; **Enter** commits it and moves on the way any other choice
+does — to the next question, or to **Submit answers** on the last one — without
+submitting the form. On single-select questions it is mutually exclusive with
+the listed choices, and **↑ / ↓** leaves its editor when the note is empty.
 Multi-select questions toggle choices. The last question has an explicit
 **Submit answers** row. **Esc** closes an open note first and otherwise cancels
 the form; **Ctrl+C** cancels the whole turn.
 
+Only the option you are on shows its description, so the whole form — every
+option, the note row, **Submit answers**, and the key hints — stays on screen
+without scrolling. Move between options to read the others.
+
 Answers return to the same turn, and completed question/answer records remain
 readable when the session is resumed. Default, Bypass all permissions, and Plan
 modes all support the form; Bypass all permissions does not choose answers for

package/dist/bin/ai.js

@@ -13,7 +13,8 @@ import { startBrowserDiscoveryInBackground } from '../src/browser/session-bridge
 import { appendPromptToFile } from '../src/ui/prompt-history-store.js';
 import { formatSessionExitNotice } from '../src/session-exit.js';
 import { formatUsageText } from '../src/usage.js';
-import { formatVersionLine } from '../src/version.js';
+import { getCliVersion, formatVersionLine } from '../src/version.js';
+import { offerUpdateAtStartup } from '../src/update-check.js';
 import { parseArgs } from '../src/cli-args.js';
 const { auth, chat, models, sessions } = ServerApi;
 function printUsage() {
@@ -220,6 +221,17 @@ export async function main() {
     if (offlineNotice) {
         console.error(chalk.yellow(`⚠ Couldn't reach TheGitAI (${offlineNotice}). Starting with cached settings — it will reconnect on your next message.`));
     }
+    const updateOutcome = await offerUpdateAtStartup({
+        currentVersion: getCliVersion(),
+        latestVersion: whoami.release?.latestVersion ?? null,
+    });
+    if (updateOutcome === 'updated') {
+        return;
+    }
+    if (updateOutcome === 'cancelled') {
+        process.exitCode = 130;
+        return;
+    }
     const selectedModelId = models.selectServerModel({
         requestedModelId: sourceSnapshot?.modelId ?? null,
         cached: cachedModels,

package/dist/src/api/auth.js

@@ -61,11 +61,15 @@ export async function fetchWhoamiResponse({ config, fetchImpl = globalThis.fetch
     if (!data?.customer?.email) {
         throw new Error('Server returned an invalid whoami response.');
     }
+    const latestVersion = data.release?.latestVersion;
     return {
         customer: data.customer,
         debugUi: {
             showSessionId: data.debugUi?.showSessionId === true,
         },
+        ...(typeof latestVersion === 'string' && latestVersion
+            ? { release: { latestVersion } }
+            : {}),
         ...(data.usage ? { usage: data.usage } : {}),
     };
 }

package/dist/src/api/browser-login.js

@@ -6,6 +6,7 @@ import os from 'node:os';
 import { openUrl } from '../core/open-url.js';
 import { ServerApiError, createTraceContext, failureCode, failureMessage, normalizeServerUrl, readJsonResponse, } from './http.js';
 import { DEFAULT_THEGITAI_HOST } from './default-host.js';
+import { isAbortError } from '../utils.js';
 const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
 function shutDownServer(server) {
     server.closeAllConnections?.();
@@ -20,10 +21,6 @@ export class SignInCancelledError extends Error {
 export function isSignInCancelled(error) {
     return error instanceof SignInCancelledError;
 }
-function isAbortError(error) {
-    const err = error;
-    return err?.name === 'AbortError' || err?.code === 'ABORT_ERR';
-}
 export function resolveWebsiteUrl() {
     return DEFAULT_THEGITAI_HOST.replace(/\/+$/, '');
 }

package/dist/src/help-text.js

@@ -43,6 +43,19 @@ const HELP_MARKDOWN = [
     '- Sessions are stored locally and can be listed or resumed in the same repo.',
     '  Continuing one requires the TheGitAI account used for that session.',
     '',
+    '## 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.',
+    '- 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.',
+    '- **Ctrl+C** at the prompt quits without installing anything and without',
+    '  starting the session.',
+    '',
     '## Options',
     '',
     '- `-y, --yes` — start in Bypass all permissions mode',
@@ -90,6 +103,18 @@ const HELP_MARKDOWN = [
         ? ['- On Mac laptops without dedicated keys, **Home/End** are `Fn+←` / `Fn+→`.']
         : []),
     '',
+    '## Questions',
+    '',
+    '- The agent can pause a turn to ask up to four questions in one form.',
+    '  **↑/↓** moves, the option number or **Enter** chooses, **←/→** moves',
+    '  between questions, and the last question has a **Submit answers** row.',
+    '- Only the option you are on shows its description, so the whole form fits',
+    '  on screen. Move to an option to read what it means.',
+    '- **Something else / add details** is the numbered final option: focus it',
+    '  and type. **Enter** commits the note and moves to the next question, or to',
+    '  Submit on the last one — it never submits the form for you.',
+    '- **Esc** closes an open note first, and otherwise cancels the form.',
+    '',
     '## Chat commands',
     '',
     '- `/help` — show this help',

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

@@ -44,6 +44,7 @@ export function footerNotificationHint(status) {
 }
 const FOOTER_CYCLE_HINT = ' (shift+tab to cycle)';
 const OVERLAY_PANEL_MAX_WIDTH = 86;
+const USER_INPUT_PANEL_MAX_WIDTH = 120;
 const OVERLAY_PANEL_MARGIN_LINES = 2;
 const OVERLAY_PANEL_MARGIN_MIN_ROWS = 30;
 const OVERLAY_BORDER_COLOR = 'yellow';
@@ -817,8 +818,8 @@ function overlayPanelContentBudget(height) {
     const margins = overlayPanelMarginLineCount(height) * 2;
     return Math.max(1, Math.floor(height) - margins - 2);
 }
-function buildOverlayPanel(rows, width, color, height = Number.POSITIVE_INFINITY) {
-    const panelWidth = Math.max(24, Math.min(width, OVERLAY_PANEL_MAX_WIDTH));
+function buildOverlayPanel(rows, width, color, height = Number.POSITIVE_INFINITY, maxWidth = OVERLAY_PANEL_MAX_WIDTH) {
+    const panelWidth = Math.max(24, Math.min(width, maxWidth));
     const innerWidth = Math.max(1, panelWidth - 4);
     const margin = Array.from({
         length: overlayPanelMarginLineCount(height),
@@ -1104,6 +1105,9 @@ export function buildWorkingClockLine(state, elapsedSeconds) {
 export function approvalPanelInnerWidth(width) {
     return Math.max(1, Math.max(24, Math.min(width, OVERLAY_PANEL_MAX_WIDTH)) - 4);
 }
+export function userInputPanelInnerWidth(width) {
+    return Math.max(1, Math.max(24, Math.min(width, USER_INPUT_PANEL_MAX_WIDTH)) - 4);
+}
 export function approvalPaddingEnabled(height) {
     return height >= APPROVAL_PADDING_MIN_ROWS;
 }
@@ -1212,7 +1216,7 @@ function buildOverlayLines(state, width, height, nowMs) {
         if (height < 3) {
             return [];
         }
-        return buildOverlayPanel(buildUserInputOverlayLines(state.userInputPrompt, innerWidth, overlayPanelContentBudget(height)), width, USER_INPUT_BORDER_COLOR, height);
+        return buildOverlayPanel(buildUserInputOverlayLines(state.userInputPrompt, userInputPanelInnerWidth(width), overlayPanelContentBudget(height)), width, USER_INPUT_BORDER_COLOR, height, USER_INPUT_PANEL_MAX_WIDTH);
     }
     if (state.approvalPrompt) {
         const prompt = state.approvalPrompt;
@@ -1337,7 +1341,7 @@ export function userInputViewportForFrame(state, cols, rows, spinnerFrame, elaps
     const liveRows = buildLiveLines(state, contentWidth, spinnerFrame, elapsedSeconds, nowMs).length;
     const overlayHeight = Math.max(0, rows - liveRows - composerFooterLines(state, contentWidth).length);
     return {
-        width: approvalPanelInnerWidth(contentWidth),
+        width: userInputPanelInnerWidth(contentWidth),
         maxRows: overlayPanelContentBudget(overlayHeight),
     };
 }

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

@@ -139,9 +139,19 @@ function editOpenNote(state, event) {
     const question = currentQuestion(state);
     const current = state.customText[question.id] ?? '';
     const cursor = Math.max(0, Math.min(state.noteCursor, current.length));
-    if (event.escape || event.returnKey) {
+    if (event.escape) {
         return { ...state, noteOpen: false };
     }
+    if (event.returnKey) {
+        const closed = { ...state, noteOpen: false };
+        if (question.multiSelect || !current.trim()) {
+            return closed;
+        }
+        const index = questionIndex(closed);
+        return index < closed.questions.length - 1
+            ? setQuestion(closed, index + 1)
+            : setCursor(closed, question, SUBMIT_CURSOR);
+    }
     if (event.tab)
         return state;
     if ((event.upArrow || event.downArrow) && !current.trim()) {
@@ -433,8 +443,10 @@ function buildUserInputContent(state, width) {
         }), ...(recommendation
             ? [span(recommendation, { color: 'green' })]
             : [])));
-        for (const description of wrapText(option.description, Math.max(8, width - 5))) {
-            lines.push(plainLine(`     ${description}`, { color: 'gray' }));
+        if (focused) {
+            for (const description of wrapText(option.description, Math.max(8, width - 5))) {
+                lines.push(plainLine(`     ${description}`, { color: 'gray' }));
+            }
         }
         if (state.contentScrollAnchor === option.id) {
             anchorRange = { start: blockStart, end: lines.length - 1 };
@@ -490,23 +502,38 @@ function buildUserInputContent(state, width) {
     if (state.validationMessage) {
         lines.push(plainLine(state.validationMessage, { color: 'yellow' }));
     }
-    lines.push(plainLine(state.noteOpen
-        ? 'Type a single-line note • ↑/↓ moves when empty • Enter saves • Esc closes • PgUp/PgDn scroll'
+    const footer = plainLine(state.noteOpen
+        ? 'Type a single-line note • ↑/↓ moves when empty • Enter saves • Esc closes'
         : question.multiSelect
-            ? `↑/↓ move • 1–${otherNumber} choose • Enter toggles/edits • ←/→ questions • PgUp/PgDn scroll • Esc cancels`
-            : `↑/↓ move • 1–${otherNumber} choose • Enter selects/edits • ←/→ questions • PgUp/PgDn scroll • Esc cancels`, { color: 'gray' }));
+            ? `↑/↓ move • 1–${otherNumber} choose • Enter toggles/edits • ←/→ questions • Esc cancels`
+            : `↑/↓ move • 1–${otherNumber} choose • Enter selects/edits • ←/→ questions • Esc cancels`, { color: 'gray' });
     return {
         anchorRange,
+        footer: clipLineToWidth(footer, width),
         lines: lines.map((row) => clipLineToWidth(row, width)),
     };
 }
 function buildUserInputWindow(state, width, maxRows) {
     const content = buildUserInputContent(state, width);
-    if (!Number.isFinite(maxRows) || content.lines.length <= maxRows) {
-        return { lines: content.lines, maxOffset: 0, offset: 0 };
+    if (!Number.isFinite(maxRows)) {
+        return {
+            lines: [...content.lines, content.footer],
+            maxOffset: 0,
+            offset: 0,
+        };
     }
     const rowBudget = Math.max(1, Math.floor(maxRows));
-    const visibleRowBudget = rowBudget === 1 ? 1 : rowBudget - 1;
+    if (rowBudget === 1) {
+        return { lines: [content.footer], maxOffset: 0, offset: 0 };
+    }
+    if (content.lines.length <= rowBudget - 1) {
+        return {
+            lines: [...content.lines, content.footer],
+            maxOffset: 0,
+            offset: 0,
+        };
+    }
+    const visibleRowBudget = Math.max(1, rowBudget - 2);
     const maxOffset = Math.max(0, content.lines.length - visibleRowBudget);
     let offset = Math.max(0, Math.min(state.contentScrollOffset, maxOffset));
     const range = content.anchorRange;
@@ -527,13 +554,11 @@ function buildUserInputWindow(state, width, maxRows) {
         offset = Math.max(0, Math.min(offset, maxOffset));
     }
     const visible = content.lines.slice(offset, offset + visibleRowBudget);
-    if (rowBudget === 1) {
-        return { lines: visible, maxOffset, offset };
-    }
     return {
         lines: [
             ...visible,
             plainLine(fitText(`Rows ${offset + 1}–${offset + visible.length} of ${content.lines.length} · PgUp/PgDn scroll`, width), { color: 'gray' }),
+            content.footer,
         ],
         maxOffset,
         offset,

package/dist/src/update-check.js

@@ -0,0 +1,121 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { stdin as input, stdout as output } from 'node:process';
+import readline from 'node:readline/promises';
+import { fileURLToPath } from 'node:url';
+import chalk from './colors.js';
+import { isAbortError } from './utils.js';
+import { compareCliVersions, UNKNOWN_CLI_VERSION } from './version.js';
+const PACKAGE_NAME = '@thegitai/cli';
+export function resolveInstallCommand(version, moduleDir = path.dirname(fileURLToPath(import.meta.url))) {
+    const spec = `${PACKAGE_NAME}@${version}`;
+    const location = moduleDir.replace(/\\/g, '/').toLowerCase();
+    if (location.includes('/pnpm/global/')) {
+        return { program: 'pnpm', args: ['add', '-g', spec] };
+    }
+    if (location.includes('/.bun/install/global/')) {
+        return { program: 'bun', args: ['add', '-g', spec] };
+    }
+    return { program: 'npm', args: ['install', '-g', spec] };
+}
+export function buildUpdateOffer({ currentVersion, latestVersion, moduleDir, }) {
+    if (!latestVersion)
+        return null;
+    if (currentVersion === UNKNOWN_CLI_VERSION)
+        return null;
+    const ordering = compareCliVersions(currentVersion, latestVersion);
+    if (ordering === null || ordering >= 0)
+        return null;
+    const { program, args } = resolveInstallCommand(latestVersion, moduleDir);
+    return {
+        currentVersion,
+        latestVersion,
+        program,
+        args,
+        display: [program, ...args].join(' '),
+    };
+}
+export function formatUpdateScreen(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.',
+        '',
+        `  ${chalk.cyan('1.')} Update now ${chalk.dim(`(runs \`${offer.display}\`)`)}`,
+        `  ${chalk.cyan('2.')} Skip ${chalk.dim('(Agent may not work optimally)')}`,
+        '',
+        `  ${chalk.dim('Press Enter to update, or 2 to skip.')}`,
+        '',
+    ].join('\n');
+}
+export function readUpdateChoice(answer) {
+    const value = answer.trim().toLowerCase();
+    if (value === '' || value === '1' || value === 'y' || value === 'yes') {
+        return 'update';
+    }
+    return 'skip';
+}
+export async function resolveUpdateAnswer(question) {
+    try {
+        return readUpdateChoice(await question());
+    }
+    catch (error) {
+        if (isAbortError(error))
+            return 'cancel';
+        throw error;
+    }
+}
+async function askUpdateChoice() {
+    const rl = readline.createInterface({ input, output });
+    try {
+        return await resolveUpdateAnswer(() => rl.question('  ▸ '));
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function runUpdate(offer) {
+    return await new Promise((resolve) => {
+        const child = spawn(offer.program, offer.args, {
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+        child.on('error', () => resolve(false));
+        child.on('close', (code) => resolve(code === 0));
+    });
+}
+export async function offerUpdateAtStartup({ currentVersion, latestVersion, ask = askUpdateChoice, install = runUpdate, write = (text) => {
+    process.stdout.write(text);
+}, }) {
+    const offer = buildUpdateOffer({ currentVersion, latestVersion });
+    if (!offer)
+        return 'none';
+    write(`${formatUpdateScreen(offer)}\n`);
+    const answer = await ask();
+    if (answer === 'cancel') {
+        write(`\n  ${chalk.dim('Cancelled. Nothing was installed.')}\n\n`);
+        return 'cancelled';
+    }
+    if (answer === 'skip') {
+        write(`\n  ${chalk.yellow(`Continuing on ${offer.currentVersion} — you'll be asked again next time.`)}\n\n`);
+        return 'skipped';
+    }
+    write(`\n  ${chalk.dim(`$ ${offer.display}`)}\n\n`);
+    if (await install(offer)) {
+        write(`\n  ${chalk.green(`✓ Updated to ${offer.latestVersion}.`)} Run ${chalk.bold('ai')} again to start.\n\n`);
+        return 'updated';
+    }
+    write([
+        '',
+        `  ${chalk.red('✖ The update did not complete.')} Run this yourself, then start ${chalk.bold('ai')} again:`,
+        '',
+        `    ${chalk.bold(offer.display)}`,
+        '',
+        `  ${chalk.dim(`Starting on ${offer.currentVersion} for now.`)}`,
+        '',
+        '',
+    ].join('\n'));
+    return 'failed';
+}

package/dist/src/utils.js

@@ -1,3 +1,7 @@
+export function isAbortError(error) {
+    const err = error;
+    return err?.name === 'AbortError' || err?.code === 'ABORT_ERR';
+}
 export function cosineSimilarity(a, b) {
     let dot = 0;
     let magA = 0;

package/dist/src/version.js

@@ -2,7 +2,7 @@ import { readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 const PACKAGE_NAME = '@thegitai/cli';
-const UNKNOWN_VERSION = '0.0.0';
+export const UNKNOWN_CLI_VERSION = '0.0.0';
 export function getCliVersion() {
     let dir = path.dirname(fileURLToPath(import.meta.url));
     for (let depth = 0; depth < 6; depth++) {
@@ -19,7 +19,7 @@ export function getCliVersion() {
             break;
         dir = parent;
     }
-    return UNKNOWN_VERSION;
+    return UNKNOWN_CLI_VERSION;
 }
 export function getPlatformTag() {
     return `${process.platform}-${process.arch}`;
@@ -27,3 +27,53 @@ export function getPlatformTag() {
 export function formatVersionLine() {
     return `ai ${getCliVersion()} (${getPlatformTag()}, node ${process.version})`;
 }
+const VERSION_PATTERN = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+function parseVersion(value) {
+    const match = VERSION_PATTERN.exec(String(value ?? '').trim());
+    if (!match)
+        return null;
+    return {
+        core: [Number(match[1]), Number(match[2]), Number(match[3])],
+        prerelease: match[4] ? match[4].split('.') : [],
+    };
+}
+function comparePrereleaseIdentifier(left, right) {
+    const leftNumeric = /^\d+$/.test(left);
+    const rightNumeric = /^\d+$/.test(right);
+    if (leftNumeric && rightNumeric) {
+        const a = Number(left);
+        const b = Number(right);
+        return a === b ? 0 : a < b ? -1 : 1;
+    }
+    if (leftNumeric !== rightNumeric)
+        return leftNumeric ? -1 : 1;
+    return left === right ? 0 : left < right ? -1 : 1;
+}
+export function isReadableCliVersion(value) {
+    return parseVersion(value) !== null;
+}
+export function compareCliVersions(left, right) {
+    const a = parseVersion(left);
+    const b = parseVersion(right);
+    if (!a || !b)
+        return null;
+    for (let index = 0; index < 3; index++) {
+        if (a.core[index] !== b.core[index]) {
+            return a.core[index] < b.core[index] ? -1 : 1;
+        }
+    }
+    if (!a.prerelease.length || !b.prerelease.length) {
+        if (a.prerelease.length === b.prerelease.length)
+            return 0;
+        return a.prerelease.length ? -1 : 1;
+    }
+    const shared = Math.min(a.prerelease.length, b.prerelease.length);
+    for (let index = 0; index < shared; index++) {
+        const ordering = comparePrereleaseIdentifier(a.prerelease[index], b.prerelease[index]);
+        if (ordering !== 0)
+            return ordering;
+    }
+    if (a.prerelease.length === b.prerelease.length)
+        return 0;
+    return a.prerelease.length < b.prerelease.length ? -1 : 1;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegitai/cli",
-  "version": "1.0.0-preview.43",
+  "version": "1.0.0-preview.45",
   "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.43",
-    "@thegitai/tui-darwin-x64": "1.0.0-preview.43",
-    "@thegitai/tui-linux-arm64": "1.0.0-preview.43",
-    "@thegitai/tui-linux-x64": "1.0.0-preview.43",
-    "@thegitai/tui-win32-x64": "1.0.0-preview.43",
+    "@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",
     "@vscode/ripgrep": "1.18.0"
   },
   "repository": {