termux-dev 1.8.0 → 1.8.2

package/dist/cli/index.js

@@ -1,6 +1,5 @@
 import { Command } from 'commander';
 import * as p from '@clack/prompts';
-import { search, password, input } from '@inquirer/prompts';
 import pc from 'picocolors';
 import os from 'os';
 import path from 'path';
@@ -21,6 +20,8 @@ import { notifyDevice, acquireWakeLock, isTermux, notificationBody, sendDesktopN
 import { copyToClipboard } from './clipboard-write.js';
 import { REWIND_CURRENT, messageDraft, rewindItems, userEntries } from './rewind.js';
 import { runPicker } from './picker.js';
+import { runFinder, runTextInput } from './finder.js';
+import { renderWelcome } from './welcome.js';
 import { savePlanFile } from '../core/planfile.js';
 import { BASE_TITLE, RESTORE_TERMINAL_TITLE, SAVE_TERMINAL_TITLE, cleanTitle, generateChatTitle, provisionalTitle, terminalTitleSequence } from '../core/title.js';
 import { runDoctor } from './doctor.js';
@@ -32,7 +33,7 @@ import { SmoothStreamer } from './smooth.js';
 import { askPrompt } from './prompt.js';
 import { resolveAtMentions } from './files.js';
 import { runStartupUpdateCheck, checkForUpdates, performSelfUpdate } from './updater.js';
-import { setActiveTheme, getCurrentTheme, listThemes, findTheme, renderSwatch, renderThemePreview } from './theme.js';
+import { setActiveTheme, getCurrentTheme, listThemes, findTheme } from './theme.js';
 import { runHeadlessMode } from './headless.js';
 import { CustomCommandManager } from '../core/commands.js';
 import { UsageTracker } from '../core/usage.js';
@@ -41,6 +42,9 @@ import { SessionExporter } from './export.js';
 import { MCPManager, discoverProjectMcpServers, hashProjectMcpServers, readClaudeServers, removeUserServer, saveUserServers } from '../mcp/manager.js';
 import { writeSecureFile } from '../core/secure-file.js';
 import { applyLocalConfig, persistedConfig, withoutSessionOnlySettings } from '../core/local-config.js';
+import { cloneConfig, mergeConfigChanges } from '../core/config-merge.js';
+import { getBackgroundManager } from '../core/background.js';
+import { backgroundSummary, noteRows, runTasksCommand } from './background-ui.js';
 import { LiveTelemetryTracker } from './telemetry.js';
 import { renderPowerlineStatus, GitStatusCache } from './statusline.js';
 import { formatDiffBox } from './diff.js';
@@ -54,7 +58,7 @@ import { askConfirm, askPlanDecision, printFarewell } from './confirm.js';
 import { createCheckpoint, diffCheckpoint, restoreCheckpoint } from '../core/checkpoint.js';
 import { log, note } from './log.js';
 import { displayWidth, tailWidth } from './width.js';
-import { collapsedThoughtLine, messagesToItems, renderTranscript, toolResultRows } from './transcript.js';
+import { COMPACT_MARK, collapsedThoughtLine, renderItem, messagesToItems, renderTranscript, toolResultRows } from './transcript.js';
 import { chooseEffort, effortCommand } from './effort.js';
 import { effectiveReasoning, parseEffortArg, detectRoute, thinkLabel } from '../core/reasoning.js';
 import { catalogInfo, installCapabilities, refreshCapabilities, refreshCatalog } from '../core/capabilities.js';
@@ -63,7 +67,7 @@ import { contextBreakdown } from '../core/context-stats.js';
 import { runUsagePanel } from './usage-panel.js';
 import { TurnComposer } from './typeahead.js';
 import { EXTENDED_KEYS_OFF, normalizeKey, splitKeys } from './keys.js';
-import { getLanguage, setLanguage, t } from '../core/i18n.js';
+import { LANGUAGES, getLanguage, setLanguage, t } from '../core/i18n.js';
 import { anthropicOnlyModels, formatFromBaseUrl, refreshFormats } from '../core/formats.js';
 import { providerFormat } from '../providers/index.js';
 const CONFIG_PATH = path.join(os.homedir(), '.devxrc.json');
@@ -74,7 +78,18 @@ function maskApiKey(key) {
         return '****';
     return `${key.slice(0, 4)}...${key.slice(-4)}`;
 }
-async function saveConfig(config) {
+/**
+ * What this process last knew of the config file (its own settings after the start-up overrides,
+ * or what it wrote last). A save writes only the difference to it, see core/config-merge.ts.
+ */
+let configBaseline = null;
+let saveChain = Promise.resolve();
+/** Call once the start-up overrides (-m, project config) are applied: those are not saved by accident. */
+function markConfigBaseline(config) {
+    syncKeyMaps(config);
+    configBaseline = cloneConfig(persistedConfig(config));
+}
+function syncKeyMaps(config) {
     config.apiKeys = config.apiKeys || {};
     config.baseUrls = config.baseUrls || {};
     if (config.provider && config.apiKey) {
@@ -83,10 +98,38 @@ async function saveConfig(config) {
     if (config.provider && config.baseUrl) {
         config.baseUrls[config.provider] = config.baseUrl;
     }
+}
+async function writeConfigFile(config) {
+    syncKeyMaps(config);
     // Runtime-only flags and YOLO (one run only) must not end up in the user's config file.
-    const persisted = persistedConfig(config);
-    // The file holds API keys: owner-only permissions (0600).
-    await writeSecureFile(CONFIG_PATH, JSON.stringify(persisted, null, 2));
+    const mine = cloneConfig(persistedConfig(config));
+    // Another devx may have saved since we looked: write only our own changes on top of the file.
+    let disk = null;
+    try {
+        const parsed = JSON.parse(await fs.readFile(CONFIG_PATH, 'utf8'));
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+            disk = withoutSessionOnlySettings(parsed);
+    }
+    catch { }
+    const merged = disk ? mergeConfigChanges(configBaseline ?? {}, mine, disk) : mine;
+    // The file holds API keys: owner-only permissions (0600). Written aside and renamed, so a second
+    // process never reads half a file.
+    const tmp = `${CONFIG_PATH}.${process.pid}.tmp`;
+    try {
+        await writeSecureFile(tmp, JSON.stringify(merged, null, 2));
+        await fs.rename(tmp, CONFIG_PATH);
+    }
+    catch (err) {
+        await fs.rm(tmp, { force: true }).catch(() => null);
+        throw err;
+    }
+    configBaseline = mine;
+}
+async function saveConfig(config) {
+    // One save at a time inside this process; the read-merge-write of the next one sees the previous.
+    const run = saveChain.then(() => writeConfigFile(config));
+    saveChain = run.catch(() => undefined);
+    return run;
 }
 async function fetchModels(baseUrl, apiKey) {
     try {
@@ -138,9 +181,11 @@ const POPULAR_PROVIDER_MODELS = {
     groq: ['llama-3.3-70b-versatile', 'llama-3.1-8b-instant', 'mixtral-8x7b-32768'],
     mistral: ['mistral-large-latest', 'mistral-small-latest', 'codestral-latest'],
 };
-async function selectModel(baseUrl, apiKey, currentModel, providerId = '', allowCancel = true) {
+const formatContext = (n) => (n >= 1_000_000 ? `${(n / 1_000_000).toFixed(1)}M` : `${Math.round(n / 1000)}k`);
+/** `step` is "3/4" during the first run, so the card says where in the setup you are. */
+async function selectModel(baseUrl, apiKey, currentModel, providerId = '', _allowCancel = true, step) {
     const s = new UiSpinner();
-    s.start('Fetching available models from provider...');
+    s.start(t('onboard.model.fetching'));
     const result = await fetchModels(baseUrl, apiKey);
     // The same gateway may list more models (Claude) in its Anthropic format, with the same key.
     if (result.ok && probeEndpointsAllowed) {
@@ -160,201 +205,152 @@ async function selectModel(baseUrl, apiKey, currentModel, providerId = '', allow
             contextLength: getModelContextLimit(id)
         }));
     }
-    let modelChoice;
-    if (models.length > 0) {
-        try {
-            modelChoice = await search({
-                message: `Select a model (${models.length} available, type to filter):`,
-                source: async (term) => {
-                    const q = (term || '').trim().toLowerCase();
-                    const list = [];
-                    if (allowCancel) {
-                        list.push({ name: pc.yellow('← Back / Cancel'), value: '__cancel__', description: 'Keep current model' });
-                    }
-                    list.push({ name: pc.yellow('+ Type a custom model name...'), value: 'custom_input', description: 'Enter any model ID manually' });
-                    for (const m of models) {
-                        const isCurrent = m.id === currentModel;
-                        const prefix = isCurrent ? pc.cyan('› ') : '  ';
-                        const nameStr = isCurrent ? pc.bold(pc.cyan(m.id + ' (current)')) : m.id;
-                        const ctxStr = (m.viaAnthropic ? 'Anthropic format' + (m.contextLength ? ', ' : '') : '') + (m.contextLength ? `${m.contextLength >= 1_000_000 ? (m.contextLength / 1_000_000).toFixed(1) + 'M' : Math.round(m.contextLength / 1000) + 'k'} context` : '');
-                        list.push({
-                            name: prefix + nameStr,
-                            value: m.id,
-                            description: ctxStr
-                        });
-                    }
-                    if (!q)
-                        return list;
-                    return list.filter(item => item.value.toLowerCase().includes(q) || item.name.toLowerCase().includes(q));
-                },
-                pageSize: 10
-            });
-        }
-        catch {
-            return null;
-        }
-        if (modelChoice === '__cancel__') {
-            return null;
-        }
-        if (modelChoice === 'custom_input') {
-            try {
-                const customModel = await input({
-                    message: 'Type the model name (e.g. gpt-4o or claude-3-7-sonnet):',
-                });
-                if (!customModel || !customModel.trim())
-                    return null;
-                const name = customModel.trim();
-                return { model: name, contextLimit: getModelContextLimit(name) };
-            }
-            catch {
-                return null;
-            }
-        }
-        const found = models.find(m => m.id === modelChoice);
-        const limit = (found && found.contextLength) || getModelContextLimit(modelChoice);
-        return { model: modelChoice, contextLimit: limit };
-    }
-    else {
-        log.warn('Could not fetch models automatically.');
-        try {
-            const typedModel = await input({
-                message: 'Type the model name you want to use (e.g. gpt-4o):',
-                default: currentModel || ''
-            });
-            if (!typedModel || !typedModel.trim())
-                return null;
-            const name = typedModel.trim();
-            return { model: name, contextLimit: getModelContextLimit(name) };
-        }
-        catch {
+    const typeName = async (note) => {
+        const name = await runTextInput({
+            title: t('onboard.model.title'),
+            subtitle: step,
+            label: t('onboard.model.label'),
+            initial: models.length === 0 ? currentModel : '',
+            notes: note ? [note] : undefined,
+        });
+        return name ? { model: name, contextLimit: getModelContextLimit(name) } : null;
+    };
+    if (models.length === 0)
+        return typeName(t('onboard.model.manual'));
+    const CUSTOM = '__custom__';
+    for (;;) {
+        const choice = await runFinder({
+            title: t('onboard.model.title'),
+            subtitle: step ?? `${models.length}`,
+            placeholder: t('onboard.model.placeholder'),
+            current: currentModel,
+            items: [
+                { value: CUSTOM, label: t('onboard.model.custom'), detail: t('onboard.model.customDetail'), pinned: true },
+                ...models.map((m) => ({
+                    value: m.id,
+                    label: m.id,
+                    detail: [m.viaAnthropic ? t('onboard.model.anthropic') : '', m.contextLength ? t('onboard.model.context', { n: formatContext(m.contextLength) }) : ''].filter(Boolean).join(', '),
+                })),
+            ],
+        });
+        if (choice === undefined)
             return null;
+        if (choice === CUSTOM) {
+            const typed = await typeName();
+            if (typed)
+                return typed;
+            continue; // Esc in the field: back to the list
         }
+        const found = models.find(m => m.id === choice);
+        return { model: choice, contextLimit: (found && found.contextLength) || getModelContextLimit(choice) };
     }
 }
+/** The host of an address, for the detail column: `api.openai.com`. */
+const hostOf = (url) => url.replace(/^https?:\/\//, '').replace(/\/.*$/, '');
 async function selectProvider(currentConfig, allowCancel = true) {
     const apiKeys = currentConfig.apiKeys || {};
     const baseUrls = currentConfig.baseUrls || {};
     if (currentConfig.provider && currentConfig.apiKey) {
         apiKeys[currentConfig.provider] = currentConfig.apiKey;
     }
-    let providerId;
-    try {
-        providerId = await search({
-            message: 'Select AI Provider (type to filter, Esc to cancel):',
-            source: async (term) => {
-                const q = (term || '').trim().toLowerCase();
-                const filtered = q
-                    ? ALL_PROVIDERS.filter(pr => pr.label.toLowerCase().includes(q) || pr.value.toLowerCase().includes(q))
-                    : ALL_PROVIDERS;
-                const list = filtered.map(pr => {
-                    const isCurrent = pr.value === currentConfig.provider;
-                    const labelStr = isCurrent ? pc.bold(pc.cyan(pr.label + ' (current)')) : pr.label;
-                    const hasKey = apiKeys[pr.value] ? `[Key: ${maskApiKey(apiKeys[pr.value])}] ` : '';
-                    return {
-                        name: `${isCurrent ? pc.cyan('› ') : '  '}${labelStr}`,
-                        value: pr.value,
-                        description: `${hasKey}${pr.baseUrl || 'Custom endpoint'}`
-                    };
-                });
-                if (allowCancel) {
-                    list.unshift({
-                        name: pc.yellow('← Back / Cancel'),
-                        value: '__cancel__',
-                        description: 'Keep current provider'
-                    });
-                }
-                return list;
-            },
-            pageSize: 10
-        });
-    }
-    catch {
-        return null;
-    }
-    if (providerId === '__cancel__') {
-        return null;
-    }
-    const selectedProvider = ALL_PROVIDERS.find(pr => pr.value === providerId) || { baseUrl: '', label: providerId };
-    let baseUrl = baseUrls[providerId] || selectedProvider.baseUrl;
-    if (providerId === 'custom' || !baseUrl) {
-        try {
-            const customUrl = await input({
-                message: 'Enter Base URL (e.g. https://api.openai.com/v1):',
-                default: baseUrl || ''
+    const firstRun = !allowCancel;
+    const stepOf = (n) => (firstRun ? `${n}/5` : undefined);
+    let providerId = '';
+    let baseUrl = '';
+    let apiKey = '';
+    let stage = 'provider';
+    let modelRes = null;
+    while (!modelRes) {
+        if (stage === 'provider') {
+            const choice = await runFinder({
+                title: t('onboard.provider.title'),
+                subtitle: stepOf(3),
+                placeholder: t('onboard.provider.placeholder'),
+                current: currentConfig.provider,
+                notes: firstRun ? [t('onboard.provider.note')] : undefined,
+                items: ALL_PROVIDERS.map((pr) => ({
+                    value: pr.value,
+                    label: pr.label,
+                    detail: `${apiKeys[pr.value] ? maskApiKey(apiKeys[pr.value]) + '  ' : ''}${hostOf(pr.baseUrl || '')}`.trim(),
+                    keywords: `${pr.value} ${hostOf(pr.baseUrl || '')}`,
+                    pinned: pr.value === 'custom',
+                })),
             });
-            if (!customUrl || !customUrl.trim())
-                return null;
-            baseUrl = customUrl.trim();
-            baseUrls[providerId] = baseUrl;
+            if (choice === undefined)
+                return null; // Esc on the first step leaves the whole setup
+            providerId = choice;
+            const known = ALL_PROVIDERS.find(pr => pr.value === providerId);
+            baseUrl = baseUrls[providerId] || known?.baseUrl || '';
+            stage = providerId === 'custom' || !baseUrl ? 'url' : 'key';
         }
-        catch {
-            return null;
+        else if (stage === 'url') {
+            const url = await runTextInput({
+                title: t('onboard.baseUrl.title'),
+                subtitle: stepOf(3),
+                label: t('onboard.baseUrl.label'),
+                initial: baseUrl,
+                placeholder: t('onboard.baseUrl.placeholder'),
+            });
+            if (url === undefined) {
+                stage = 'provider';
+                continue;
+            }
+            baseUrl = url;
+            baseUrls[providerId] = baseUrl;
+            stage = 'key';
         }
-    }
-    let apiKey = '';
-    if (providerId === 'ollama') {
-        apiKey = 'ollama';
-    }
-    else {
-        const savedKey = apiKeys[providerId];
-        if (savedKey) {
-            let keyChoice;
-            try {
-                keyChoice = await search({
-                    message: `API key found for ${selectedProvider.label} (${maskApiKey(savedKey)}):`,
-                    source: async () => [
-                        { name: `● Continue with saved API key (${maskApiKey(savedKey)})`, value: 'use_saved' },
-                        { name: '+ Enter a new API key', value: 'new_key' },
-                        { name: pc.yellow('← Cancel'), value: '__cancel__' }
+        else if (stage === 'key') {
+            const label = ALL_PROVIDERS.find(pr => pr.value === providerId)?.label || providerId;
+            const back = providerId === 'custom' || !(ALL_PROVIDERS.find(pr => pr.value === providerId)?.baseUrl) ? 'url' : 'provider';
+            if (providerId === 'ollama') {
+                apiKey = 'ollama';
+                stage = 'model';
+                continue;
+            }
+            const saved = apiKeys[providerId];
+            let useSaved = false;
+            if (saved) {
+                const choice = await runPicker({
+                    title: t('onboard.key.title'),
+                    subtitle: label,
+                    items: [
+                        { value: 'saved', label: t('onboard.key.useSaved'), detail: maskApiKey(saved) },
+                        { value: 'new', label: t('onboard.key.enterNew') },
                     ],
-                    pageSize: 5
+                    notes: [t('onboard.key.savedTitle', { provider: label })],
                 });
+                if (choice === undefined) {
+                    stage = back;
+                    continue;
+                }
+                useSaved = choice === 'saved';
             }
-            catch {
-                return null;
-            }
-            if (keyChoice === '__cancel__')
-                return null;
-            if (keyChoice === 'use_saved') {
-                apiKey = savedKey;
+            if (useSaved) {
+                apiKey = saved;
             }
             else {
-                try {
-                    const key = await password({
-                        message: `Enter new API Key for ${selectedProvider.label}:`,
-                        mask: '•'
-                    });
-                    if (!key || !key.trim())
-                        return null;
-                    apiKey = key.trim();
-                    apiKeys[providerId] = apiKey;
-                }
-                catch {
-                    return null;
+                const key = await runTextInput({
+                    title: t('onboard.key.title'),
+                    subtitle: stepOf(4) ?? label,
+                    label: t('onboard.key.label', { provider: label }),
+                    secret: true,
+                    notes: [t('onboard.key.note')],
+                });
+                if (key === undefined) {
+                    stage = back;
+                    continue;
                 }
+                apiKey = key;
+                apiKeys[providerId] = apiKey;
             }
+            stage = 'model';
         }
         else {
-            try {
-                const key = await password({
-                    message: `Enter API Key for ${selectedProvider.label} (or press Esc to cancel):`,
-                    mask: '•'
-                });
-                if (!key || !key.trim())
-                    return null;
-                apiKey = key.trim();
-                apiKeys[providerId] = apiKey;
-            }
-            catch {
-                return null;
-            }
+            modelRes = await selectModel(baseUrl, apiKey, currentConfig.model || '', providerId, allowCancel, stepOf(5));
+            if (!modelRes)
+                stage = apiKey === 'ollama' ? 'provider' : 'key';
         }
     }
-    // Pick a model for this provider
-    const modelRes = await selectModel(baseUrl, apiKey, currentConfig.model || '', providerId, allowCancel);
-    if (!modelRes) {
-        return null;
-    }
     const updatedConfig = {
         ...currentConfig,
         provider: providerId,
@@ -369,15 +365,54 @@ async function selectProvider(currentConfig, allowCancel = true) {
     await saveConfig(updatedConfig);
     return updatedConfig;
 }
+/** The themes as a list; the interface takes the colours of the focused one at once, so you see what you pick. */
+async function chooseTheme(current, step) {
+    const before = current ?? getCurrentTheme().id;
+    const picked = await runPicker({
+        title: t('onboard.theme.title'),
+        subtitle: step,
+        items: listThemes().map((th) => ({ value: th.id, label: th.name, detail: th.desc })),
+        current: before,
+        labelWidth: 20,
+        notes: [t('onboard.theme.note')],
+        onFocus: (id) => { setActiveTheme(id); },
+    });
+    setActiveTheme(picked ?? before);
+    return picked;
+}
+/** First run: the welcome card, the language, then provider, key and model, each on its own small card. */
 async function runOnboarding() {
-    console.clear();
-    p.intro(pc.bgCyan(pc.black(' Welcome to devx ')));
-    p.note('No configuration found. Let\'s set up your AI provider.', 'Setup');
-    const res = await selectProvider({ apiKeys: {}, baseUrls: {} }, false);
+    const cols = () => process.stdout.columns || 80;
+    const show = (done) => {
+        process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+        console.log();
+        for (const line of renderWelcome(DEVX_VERSION, cols(), done))
+            console.log(line);
+        console.log();
+    };
+    show(0);
+    const language = await runPicker({
+        title: t('onboard.language.title'),
+        subtitle: '1/5',
+        items: LANGUAGES.map((l) => ({ value: l.id, label: l.name })),
+        current: getLanguage(),
+        notes: [t('onboard.language.note')],
+        labelWidth: 14,
+    });
+    if (language === undefined) {
+        process.exit(0);
+    }
+    setLanguage(language);
+    show(1);
+    const theme = await chooseTheme(undefined, '2/5');
+    show(2);
+    const res = await selectProvider({ apiKeys: {}, baseUrls: {}, language, ...(theme ? { theme } : {}), onboarded: true }, false);
     if (!res) {
         process.exit(0);
     }
-    p.outro(pc.green('Setup complete! Configuration saved to ~/.devxrc.json'));
+    show(5);
+    console.log(renderNotice('ok', t('onboard.done')));
+    console.log();
     return res;
 }
 /**
@@ -609,6 +644,11 @@ function formatToolGeneratingLabel(name, targetHint) {
         return `→ Clarifying questions...`;
     return `→ ${name}${target}...`;
 }
+/** `#ab526 · 2h ago · 12 msgs`: what tells two sessions with the same title apart. */
+function sessionDetail(s) {
+    const count = s.messages.filter((m) => m.role !== 'system').length;
+    return `#${s.id.split('_').pop()} · ${formatSessionTime(s.updatedAt)} · ${t('resume.msgs', { n: count })}`;
+}
 async function handleSessionDelete(bannerMode) {
     while (true) {
         const sessions = await SessionManager.listSessions();
@@ -617,36 +657,18 @@ async function handleSessionDelete(bannerMode) {
             log.warn('No saved sessions found.');
             break;
         }
-        let chosenSessionId;
-        try {
-            chosenSessionId = await search({
-                message: `Select session to DELETE (${sessions.length} sessions, Esc to finish):`,
-                source: async (term) => {
-                    const q = (term || '').trim().toLowerCase();
-                    const list = [
-                        { name: pc.yellow('← Done / Cancel'), value: '__cancel__', description: 'Return to chat' },
-                        { name: pc.red('× Delete ALL sessions'), value: '__all__', description: `Remove all ${sessions.length} saved sessions` }
-                    ];
-                    for (const s of sessions) {
-                        const timeStr = formatSessionTime(s.updatedAt);
-                        const msgCount = s.messages.filter(m => m.role !== 'system').length;
-                        const shortId = s.id.split('_').pop();
-                        list.push({
-                            name: `${pc.red('× ')} ${pc.dim(`[#${shortId}]`)} ${s.title}`,
-                            value: s.id,
-                            description: `${timeStr} • ${msgCount} msgs • ${s.model || 'default'}`
-                        });
-                    }
-                    if (!q)
-                        return list;
-                    return list.filter(item => item.name.toLowerCase().includes(q) || item.value.toLowerCase().includes(q));
-                },
-                pageSize: 10
-            });
-        }
-        catch {
-            break;
-        }
+        const DELETE_ALL = '__all__';
+        const chosen = await runFinder({
+            title: t('sessions.deleteTitle'),
+            subtitle: `${sessions.length}`,
+            placeholder: t('resume.placeholder'),
+            labelWidth: 36,
+            items: [
+                { value: DELETE_ALL, label: t('sessions.deleteAll', { n: sessions.length }), pinned: true },
+                ...sessions.map((s) => ({ value: s.id, label: s.title, detail: sessionDetail(s), keywords: `${s.id} ${s.model || ''}` })),
+            ],
+        });
+        const chosenSessionId = chosen ?? '__cancel__';
         if (!chosenSessionId || chosenSessionId === '__cancel__') {
             drawLogo(bannerMode);
             log.info('Session deletion finished.');
@@ -675,38 +697,17 @@ async function handleSessionDelete(bannerMode) {
     }
 }
 async function handleThemeSelect(config) {
-    const currentTh = getCurrentTheme();
-    const themeChoices = listThemes().map(t => ({
-        theme: t,
-        choice: {
-            name: `${renderSwatch(t)} ${t.boldFn(t.name.padEnd(18))} ${pc.dim(t.desc)} ${t.id === currentTh.id ? pc.green('(Active)') : ''}`,
-            value: t.id,
-            description: `${renderThemePreview(t)}\n\n${pc.dim(`${t.name}  ${t.hex}`)}`
-        }
-    }));
-    try {
-        const selected = await search({
-            message: `${pc.bold('Select UI Theme / Выберите цветовую тему')} ${pc.dim(`(${themeChoices.length} themes, type to filter):`)}`,
-            pageSize: 8,
-            source: async (term) => {
-                const q = (term || '').toLowerCase().trim();
-                return themeChoices
-                    .filter(({ theme: t }) => !q || `${t.id} ${t.name} ${t.desc}`.toLowerCase().includes(q))
-                    .map(({ choice }) => choice);
-            }
-        });
-        if (selected) {
-            config.theme = selected;
-            await saveConfig(config);
-            const th = setActiveTheme(selected);
-            // No redraw of the screen: that would wipe the conversation. New output uses the new colours.
-            if (config.ui?.layout === 'classic')
-                log.success(th.boldFn(`Theme switched to ${th.colorFn(th.symbol)} ${th.name}!`));
-            else
-                console.log(renderNotice('ok', `theme ${th.name}`));
-        }
+    const selected = await chooseTheme(config.theme);
+    if (selected) {
+        config.theme = selected;
+        await saveConfig(config);
+        const th = setActiveTheme(selected);
+        // No redraw of the screen: that would wipe the conversation. New output uses the new colours.
+        if (config.ui?.layout === 'classic')
+            log.success(th.boldFn(`Theme switched to ${th.colorFn(th.symbol)} ${th.name}!`));
+        else
+            console.log(renderNotice('ok', `theme ${th.name}`));
     }
-    catch { }
 }
 async function handleSettings(config) {
     const initial = {
@@ -809,6 +810,8 @@ export async function main() {
         config.model = options.model;
         config.maxContextTokens = resolveContextLimit({ ...config, maxContextTokens: 0 }).limit;
     }
+    // -m and the project config are for this run: only what changes from here on is saved.
+    markConfigBaseline(config);
     if (options.yolo) {
         config.autoApprove = true;
     }
@@ -863,31 +866,11 @@ export async function main() {
         };
     };
     if (!config.onboarded) {
-        const themeChoices = listThemes().map(t => ({
-            theme: t,
-            choice: {
-                name: `${renderSwatch(t)} ${t.boldFn(t.name.padEnd(18))} ${pc.dim(t.desc)}`,
-                value: t.id,
-                description: `${renderThemePreview(t)}\n\n${pc.dim('You can change this anytime with /theme')}`
-            }
-        }));
-        try {
-            clearTerminalScreen();
-            const selected = await search({
-                message: `${pc.bold('Pick a theme to personalize your workspace:')}`,
-                source: async (term) => {
-                    const q = (term || '').toLowerCase().trim();
-                    return themeChoices
-                        .filter(({ theme: t }) => !q || `${t.id} ${t.name} ${t.desc}`.toLowerCase().includes(q))
-                        .map(({ choice }) => choice);
-                },
-                pageSize: 8
-            });
-            if (selected) {
-                config.theme = selected;
-            }
-        }
-        catch { }
+        // A config from before the first-run setup had a theme step: ask it once.
+        clearTerminalScreen();
+        const selected = await chooseTheme(config.theme);
+        if (selected)
+            config.theme = selected;
         config.onboarded = true;
         await saveConfig(config);
     }
@@ -918,6 +901,10 @@ export async function main() {
     const checkpoints = [];
     // What the user allowed on the approval card for this session ("Session"); "Always" goes to the config.
     const permissionMemory = newPermissionMemory();
+    // Commands the agent keeps running in the background (servers, watchers): shown in the prompt frame, listed by /tasks.
+    const bg = getBackgroundManager();
+    const seenBgFailures = new Set();
+    const bgSummary = () => backgroundSummary(bg, seenBgFailures);
     // The most a session may cost (USD, 0 = no limit); "continue" at the limit raises it for this session only.
     let costLimitRaised = null;
     let costWarned = false;
@@ -946,6 +933,11 @@ export async function main() {
     // and start from a clean slate: history, cost, usage counters, undo stack, screen.
     const startFreshSession = async () => {
         sessionManager.startNewSession(config.model, planMode);
+        // The tasks belonged to the conversation that is being left.
+        await bg.stopAll().catch(() => 0);
+        bg.clearFinished();
+        bg.takeNotes();
+        seenBgFailures.clear();
         transcript.length = 0;
         checkpoints.length = 0;
         windowTitle = '';
@@ -1026,6 +1018,8 @@ export async function main() {
             }
         }
         let answer = '';
+        // Set when this turn starts by itself, from the news of a background task (not from the user).
+        let wakeNotes = '';
         if (autoTriggerPrompt) {
             answer = autoTriggerPrompt;
             autoTriggerPrompt = '';
@@ -1057,7 +1051,19 @@ export async function main() {
                 dirty: GitStatusCache.getStatus()?.isDirty,
                 contextPercent: usagePercent,
                 cost: sessionCost.total,
-                costState: sessionCost.state()
+                costState: sessionCost.state(),
+                background: bgSummary,
+                subscribe: (signal) => {
+                    const onChange = () => signal('redraw');
+                    // A task ended or printed what the agent asked to hear about: the agent takes it up by itself.
+                    const onNote = () => signal(config.backgroundAutoWake === false ? 'redraw' : 'wake');
+                    bg.on('change', onChange);
+                    bg.on('note', onNote);
+                    return () => {
+                        bg.off('change', onChange);
+                        bg.off('note', onNote);
+                    };
+                },
             });
             if (inputStr.startsWith('__TOGGLE_MODE__:')) {
                 currentDraft = inputStr.slice('__TOGGLE_MODE__:'.length);
@@ -1072,19 +1078,31 @@ export async function main() {
                 }
                 continue;
             }
-            currentDraft = '';
-            if (inputStr === '__CANCEL__') {
-                const confirmExit = await askConfirm({ title: t('confirm.exitTitle'), question: t('confirm.exit'), record: false });
-                if (confirmExit) {
-                    resetTerminalTheme();
-                    printFarewell(t('confirm.goodbye'));
-                    break;
-                }
-                else {
+            if (inputStr.startsWith('__WAKE__:')) {
+                // The prompt was closed by news from a background task: the agent answers it. What was typed stays.
+                currentDraft = inputStr.slice('__WAKE__:'.length);
+                wakeNotes = bg.takeNotes();
+                if (!wakeNotes)
                     continue;
+                console.log(noteRows(wakeNotes).map((r) => renderNotice('info', r)).join('\n'));
+                console.log();
+                answer = wakeNotes;
+            }
+            else {
+                currentDraft = '';
+                if (inputStr === '__CANCEL__') {
+                    const confirmExit = await askConfirm({ title: t('confirm.exitTitle'), question: t('confirm.exit'), record: false });
+                    if (confirmExit) {
+                        resetTerminalTheme();
+                        printFarewell(t('confirm.goodbye'));
+                        break;
+                    }
+                    else {
+                        continue;
+                    }
                 }
+                answer = inputStr.trim();
             }
-            answer = inputStr.trim();
         }
         if (!answer)
             continue;
@@ -1106,7 +1124,7 @@ export async function main() {
                     '/settings', '/update', '/model', '/provider', '/providers',
                     '/plan', '/agent', '/image', '/serve', '/memory', '/permissions', '/copy', '/rename', '/title', '/rewind', '/undo',
                     '/diff', '/commit', '/status', '/compact', '/init', '/doctor',
-                    '/config', '/clear', '/exit', '/quit', '/help', '/effort'
+                    '/config', '/clear', '/exit', '/quit', '/help', '/effort', '/tasks', '/bg', '/jobs'
                 ];
                 if (!VALID_COMMANDS.includes(cmd)) {
                     const customList = await CustomCommandManager.listCommands();
@@ -1131,6 +1149,7 @@ export async function main() {
                         { name: '/plan         - Switch to PLAN mode (architect)', value: '/plan' },
                         { name: '/agent        - Switch to AGENT mode (coder)', value: '/agent' },
                         { name: '/serve        - Start local web server for web preview', value: '/serve' },
+                        { name: '/tasks        - Background tasks (list, output, stop)', value: '/tasks' },
                         { name: '/memory       - View or edit project memory bank', value: '/memory' },
                         { name: '/permissions  - What is allowed without asking', value: '/permissions' },
                         { name: '/copy         - Copy the last answer to the clipboard', value: '/copy' },
@@ -1148,21 +1167,17 @@ export async function main() {
                         ...customSlashItems
                     ];
                     try {
-                        const picked = await search({
-                            message: 'Commands (type to search or select):',
-                            source: async (term) => {
-                                const q = (term || '').trim().toLowerCase();
-                                const list = [
-                                    { name: pc.yellow('← Cancel'), value: '__cancel__' },
-                                    ...SLASH_COMMANDS
-                                ];
-                                if (!q)
-                                    return list;
-                                return list.filter(item => item.name.toLowerCase().includes(q) || item.value.toLowerCase().includes(q));
-                            },
-                            pageSize: 12
+                        const picked = await runFinder({
+                            title: t('commands.title'),
+                            subtitle: `${SLASH_COMMANDS.length}`,
+                            placeholder: t('commands.placeholder'),
+                            labelWidth: 14,
+                            items: SLASH_COMMANDS.map((c) => {
+                                const [name, ...rest] = c.name.split(/\s+-\s+/);
+                                return { value: c.value, label: name.trim(), detail: rest.join(' - ') };
+                            }),
                         });
-                        if (!picked || picked === '__cancel__') {
+                        if (!picked) {
                             continue;
                         }
                         if (picked === '/session del') {
@@ -1238,43 +1253,21 @@ export async function main() {
                     log.warn('No saved sessions found.');
                     continue;
                 }
-                let chosenSessionId;
-                try {
-                    chosenSessionId = await search({
-                        message: 'Select a session to resume (type to filter, Esc to cancel):',
-                        source: async (term) => {
-                            const q = (term || '').trim().toLowerCase();
-                            const list = [
-                                { name: pc.yellow('← Back / Cancel'), value: '__cancel__', description: 'Return to chat' },
-                                { name: pc.red('× Delete sessions... (/session del)'), value: '__delete_mode__', description: 'Selectively delete saved sessions' }
-                            ];
-                            for (const s of sessions) {
-                                const timeStr = formatSessionTime(s.updatedAt);
-                                const msgCount = s.messages.filter(m => m.role !== 'system').length;
-                                const shortId = s.id.split('_').pop();
-                                list.push({
-                                    name: `${pc.dim(`[#${shortId}]`)} ${s.title}`,
-                                    value: s.id,
-                                    description: `${timeStr} • ${msgCount} msgs • ${s.model || 'default'}`
-                                });
-                            }
-                            if (!q)
-                                return list;
-                            return list.filter(item => item.name.toLowerCase().includes(q) || item.value.toLowerCase().includes(q));
-                        },
-                        pageSize: 10
-                    });
-                }
-                catch {
-                    continue;
-                }
-                if (chosenSessionId === '__cancel__') {
-                    continue;
-                }
-                if (chosenSessionId === '__delete_mode__') {
-                    await handleSessionDelete(config.banner || 'full');
+                const picked = await runFinder({
+                    title: t('resume.title'),
+                    subtitle: `${sessions.length}`,
+                    placeholder: t('resume.placeholder'),
+                    labelWidth: 36,
+                    items: sessions.map((s) => ({
+                        value: s.id,
+                        label: s.title,
+                        detail: sessionDetail(s),
+                        keywords: `${s.id} ${s.model || ''}`,
+                    })),
+                });
+                if (picked === undefined)
                     continue;
-                }
+                const chosenSessionId = picked;
                 const loaded = await SessionManager.loadSession(chosenSessionId);
                 if (loaded) {
                     sessionManager.setLoadedSession(loaded);
@@ -1514,9 +1507,12 @@ export async function main() {
                     // A user message, not an assistant one: the Anthropic format cannot start with the assistant.
                     history.addMessage({
                         role: 'user',
-                        content: `[CONVERSATION COMPACTED] Summary of our conversation so far:\n${res.content}`
+                        content: `${COMPACT_MARK} Summary of our conversation so far:\n${res.content}`
                     });
-                    log.success(pc.bold(pc.green('Context successfully compacted! Freed up tokens while retaining task summary.')));
+                    const item = { kind: 'compact', summary: res.content };
+                    transcript.push(item);
+                    console.log();
+                    console.log(renderItem(item, { cols: process.stdout.columns || 80, thinkingExpanded, outputExpanded }).join('\n'));
                 }
                 catch (err) {
                     s.stop();
@@ -1555,6 +1551,12 @@ export async function main() {
                 await runDoctor(config);
                 continue;
             }
+            if (cmd === '/tasks' || cmd === '/bg' || cmd === '/jobs') {
+                const rows = await runTasksCommand(parts.slice(1).filter(Boolean), bg, process.stdout.columns || 80, (ids) => ids.forEach((id) => seenBgFailures.add(id)));
+                console.log(rows.join('\n'));
+                console.log();
+                continue;
+            }
             if (cmd === '/serve') {
                 const sub = parts[1]?.toLowerCase();
                 if (sub === 'stop') {
@@ -1981,7 +1983,10 @@ export async function main() {
             }
         }
         // Resolve @file and @image mentions
-        const { text: cleanAnswer, attachments, images, warnings: attachWarnings } = await resolveAtMentions(answer);
+        // News from a background task is output of a program, not a message of the user: no @file in it is read.
+        const { text: cleanAnswer, attachments, images, warnings: attachWarnings } = wakeNotes
+            ? { text: answer, attachments: [], images: [], warnings: [] }
+            : await resolveAtMentions(answer);
         for (const warning of attachWarnings)
             log.warn(warning);
         let finalContent = cleanAnswer;
@@ -2022,9 +2027,12 @@ export async function main() {
             if (turnCheckpoint)
                 checkpoints.push(turnCheckpoint);
         }
-        transcript.push({ kind: 'user', text: answer });
+        if (wakeNotes)
+            transcript.push({ kind: 'raw', rows: noteRows(wakeNotes).map((r) => renderNotice('info', r)) });
+        else
+            transcript.push({ kind: 'user', text: answer });
         // Until the model has named the chat, the start of the first message stands in for the name.
-        if (!windowTitle && !sessionManager.hasGeneratedTitle)
+        if (!wakeNotes && !windowTitle && !sessionManager.hasGeneratedTitle)
             setWindowTitle(provisionalTitle(answer));
         history.addMessage({
             role: 'user',
@@ -2346,8 +2354,12 @@ export async function main() {
                 contextPercent: Math.min(100, Math.round((used / (config.maxContextTokens || getModelContextLimit(config.model))) * 100)),
                 cost: sessionCost.total,
                 costState: sessionCost.state(),
+                background: bgSummary(),
             };
         }, undefined, statusLine, sendQueuedNow);
+        // A task started or ended during the turn: the frame shows the new count.
+        const onBgChange = () => composer.refresh();
+        bg.on('change', onBgChange);
         composer.live = liveThought;
         composer.onToggle = toggleView;
         const releasePauseHook = registerPauseHook(() => {
@@ -2404,6 +2416,8 @@ export async function main() {
             for await (const event of agent.run(abortController.signal, {
                 takePending: async () => Promise.all(composer.takeQueued().map(queuedToMessage)),
                 hasPending: () => composer.hasQueued(),
+                takeNotes: () => bg.takeNotes(),
+                hasNotes: () => bg.hasNotes(),
             })) {
                 if (aborted)
                     break;
@@ -2693,6 +2707,22 @@ export async function main() {
                     else
                         log.info(event.message);
                 }
+                else if (event.type === 'background_note') {
+                    // A background task ended or printed what the agent asked to hear about.
+                    if (spinnerActive) {
+                        s.stop();
+                        spinnerActive = false;
+                    }
+                    finishThinking(true);
+                    streamer.finish();
+                    endText();
+                    const rows = noteRows(event.content);
+                    transcript.push({ kind: 'raw', rows: rows.map((r) => renderNotice('info', r)) });
+                    for (const row of rows)
+                        console.log(cleanUi ? renderNotice('info', row) : pc.dim(row));
+                    s.start(cleanUi ? t('status.waiting') : 'Connecting...');
+                    spinnerActive = true;
+                }
             }
             finishThinking(true);
             streamer.finish();
@@ -2703,6 +2733,7 @@ export async function main() {
             endText();
             // Hand the bottom of the screen back. Whatever was typed but not sent waits in the next prompt;
             // a message that arrived too late for the agent starts the next turn by itself.
+            bg.off('change', onBgChange);
             const leftover = composer.stop();
             if (interruptPrompt) {
                 autoTriggerPrompt = interruptPrompt;
@@ -2828,6 +2859,7 @@ export async function main() {
             }
         }
         finally {
+            bg.off('change', onBgChange);
             const unsent = composer.stop();
             if (process.stdout.isTTY)
                 process.stdout.write('\x1b[?1004l');